Editing Documents
- Updated2025-10-09
- 5 minute(s) read
Editing Values
As you enter or edit a value, the field displays blue text with a blue border. To commit the value, press <Enter>, <Tab>, or click another location in the view. To revert the change, press <Esc>. The field displays red text with a red border and a tooltip to indicate an error. To revert the change after an error, press <Esc> while the cursor is in the red highlighted field.
When you use the <Delete> key to clear the contents of a cell, the pattern document displays a dash (-) for the time set to repeat the previous time set and an X for the pin item values to ignore the value.
Adding and Deleting Vectors in Pattern Documents
Right-click a cell in a row in the pattern document and use the context menu to insert new vectors or scan items or delete selected vectors or scan items from the pattern. When you insert a new vector or scan item, the pattern document inserts a row and uses a dash (-) for the time set to repeat the previous time set and an X for the pin item values to ignore the value. Selecting all the cells in a row and pressing <Delete> also removes the vector or scan item.
Adding and Deleting Pin Item Columns in Pattern Documents
Right-click a cell in the pattern document and use the context menu to insert or delete pin item columns from a list of pins and pin groups that exist in the active pin map file. When you insert a new pin item column, the pattern document inserts the column to the left of the cell you selected and uses X for the pin item values. Pins can appear in a pattern only once. You cannot add pin groups that contain pins that already exist in the pattern until you remove the existing pin references from the pattern.
Change Pin Type
Right-click a pin and select Change Pin Type from the context menu to change the pin type to Scan Input, Scan Output, or Input/Output (default).
Reorder Pin Item Columns in Pattern Documents
Right-click a cell in the pattern document and use the context menu to move selected pin item columns left or right. You cannot reorder pins in a pin group from the editor.
Filling and Inverting Pin State Data
Select and right-click pin state data cells and then select Fill Pin States, Invert Pin State Logic, or Invert Pin State Drive/Compare from the context menu to fill or invert the cells you selected. Select from the list of valid pin state values to fill the cells. Inverting cells inverts only drives and high and low compares and leaves all other pin state data cells unchanged. Selecting pin group cells applies the fill or inversion operation to all pins in the selected pin group.
Updating Pin Group Pins from Pin Map
Right-click in the pattern document and select Update Pin Group Pins from Pin Map from the context menu to update the contents of all pin groups in the pattern to match the contents of the pin groups as defined in the active pin map file. Use this technique to update the ordering of a pin group or to add or remove pins from a pin group to match changes made in the active pin map file. The editor moves pins that have been removed from the pin group in the active pin map file out of the pin group column, but the pins remain in the pattern to preserve the pin states. Delete the pin item column if you want to remove the pin from the pattern.
Locating Vectors in Pattern Documents and History RAM View
Click the
Find in Pattern button
on the document toolbar or press <Ctrl+F> to launch a dialog box in which you can specify the text you want to search for. The document highlights cells that include the search text. Use the
Find Previous and
Find Next buttons in the dialog box or on the document toolbar to navigate among the results. If you close the
Find in Pattern dialog box, you can continue to browse through results by selecting
to see previous results or
F3 to see the next results. Enable the
Match Pin Columns option to limit the search to a serial pattern of pin state values, such as HLHL, only in the pin or pin group data columns of the pattern. For pin groups, you must expand the columns you want to search.
Click the
Go To Vector button
on the pattern document toolbar or press <Ctrl+G> to launch a dialog box in which you can enter a vector number to highlight and locate in the pattern document. You must select a vector number in the valid range. You can specify a scan cycle in a scan vector by specifying the scan vector followed by a colon and the scan cycle, for example,
vectorNumber:scanCycle.
Copying and Pasting Data in Pattern Documents
You can copy and paste rows or groups of cells in the pattern document. You can paste to and from spreadsheet applications and text editors that support tab-delimited clipboard text. The behavior of the copy and paste operation depends on what you select to copy and the target location you select for the paste operation, as described in the following table.
| Select for Copy Operation | Select for Paste Operation | Resulting Behavior |
|---|---|---|
| Full row (vector) | Single cell | Inserts the copied vectors into the pattern as new vectors immediately above the vector in which you selected the single cell as the target location. |
| Contiguous rectangular set of cells | More than one cell | Pastes the copied cell values into the cells you selected as the target location, repeating the values horizontally and vertically as necessary to fill all cells in the target location selection. |
| Set of cells that are not all full rows | Single cell | Pastes the copied cell values into the existing vectors starting at the single cell you selected as the target location. |
Saving Pattern Documents
Changes you make in the pattern document are not committed to disk until you explicitly save the file. You must save the pattern before you can load or burst it on the digital pattern instrument. The Digital Pattern Editor prompts you to save modified files before loading and bursting a pattern.
Keyboard Shortcuts within the Pattern Document
| Action | Shortcut |
|---|---|
| Load a pattern | <Ctrl+L> |
| Burst a pattern | F5 |
| Launch a dialog box in which you can indicate a vector number to highlight and locate in the pattern document | <Ctrl+G> |
| Select active editor | <Ctrl+E> |
| Expand all scan vectors | <Ctrl+Shift+Add Sign>
Note Use the Add Sign (+) on the numeric keyboard.
|
| Collapse all scan vectors | <Ctrl+Shift+Minus Sign>
Note Use the Minus Sign (-) on the numeric keyboard.
|
Related Information
- Specifications
Use the specifications document to view, create, modify, and save specifications files (.specs). An asterisk (*) next to a filename in the Project Explorer window and in the document tab indicates that the file has been modified but not saved.
- Timing
Use the timing document to view, create, modify, save, and apply timing files (.digitiming). Timing files include period, edge multiplier (edge x), drive format, and edge information for pattern execution. Timing files currently can contain only one timing sheet, which is a collection of time sets. An asterisk (*) next to a filename in the Project Explorer window and in the document tab indicates that the file has been modified but not saved.
- Pattern Grid View
Click the Grid tab on the pattern document toolbar to launch the pattern grid view. Use this view to see components of the binary pattern file, including time sets, labels, opcodes, vector numbers, pin state data that indicates drives and compares, comments for each vector, exported labels, and comments from the top of the file. Use the pattern waveform view for a graph-based representation of the pattern. You can select and right-click vectors in the pattern grid view and select Show Vectors in Waveform View from the context menu to launch the pattern waveform view. You can also click the Waveform tab on the pattern document toolbar to launch the pattern waveform view. An asterisk (*) next to a filename in the Project Explorer window and in the document tab indicates that the file has been modified but not saved.
- Bursting Patterns and Viewing Results
- History RAM View
Use this view to see the History RAM results for the flow of pattern execution for the last pattern burst across all executed patterns for the number of samples you specify in the Instrument Settings pane, including vectors with repeat opcodes. The view also includes the corresponding time sets, labels, opcodes, pattern names, vectors/cycles, pin state data, and comments. Rebursting a pattern overwrites the data in the History RAM View.
- Levels
Use the pin levels sheet (.digilevels) to view, create, modify, save, and apply levels to your project. The sheet displays voltage and current levels for pins and pin groups connected to digital pattern instruments and NI-DCPower instruments. Pins and pin groups must be defined in the pin and channel map file.
- Pin Values
Use the following guidelines when setting pin values within a pin levels sheet in your project.
- Levels File XML Structure