Data Display Basics

Data generated by a simulation, as well as data that has been imported from other sources, such as a network analyzer or CITIfile, is stored in a dataset. The Data Display window enables you to view and analyze a dataset.

In a Data Display window you can:

Data can be plotted on rectangular plots, polar plots, Smith charts, and stacked plots. Data can be displayed as linear traces, histograms, scatter plots, and spectral plots, as well as in digital and wide-word (bus) data formats. In addition to graphical displays of data, data can be viewed numerically in lists.

The basic process of creating a data display consists of the following steps.

The various plot and trace types enable you to display data in different formats. In addition, you can use equations to perform complex mathematical operations on data for further analysis.





Opening and Closing Data Display Windows

To open a Data Display window:

To open additional windows from a Data Display window:

To open an existing data display:

To close a data display:

The basic elements of a data display window are:

Inserting Pages

The Data Display enables you to add multiple pages to the display area. Multiple pages provide you with additional display area that can be used to display and organize large amounts of data. To insert a new page:

  1. Choose Page > New Page.... The New Page dialog box appears.
  2. Enter a new name for the page.
  3. Click the OK button to close the dialog box and insert the page.

Viewing Multiple Pages

When you have more than one data display page, you can quickly page through using the View Previous Page and View Next Page buttons on the toolbar.

Alternatively, you can choose Page > Next Page or Page > Previous Page from the Page pull-down menu item.
Note that all of the buttons and menu items described above are deactivated when there is only one data display page available to view.

Creating a Data Display

The basic process of creating a data display consists of:

The various plot and trace types enable you to display data in different formats. Equations enable you to perform complex mathematical operations on data for further analysis.

Optionally, you can enhance your data display by adding:

Using a Dataset

The numerical data presented in a data display window comes from two sources, datasets and equations. Datasets collect and store data either from internal sources, such as a simulation, or from external sources, such as a network analyzer or Touchstone file.

Using the data file tool, you can read a data file (i.e., Touchstone, MDIF, Citifile, or ICCAP) into a dataset, or you can write a data file from a dataset. To use the data file tool, choose the Tools > Data File Tool menu item. The dftool/mainWindow appears. Note that you may need to expand your window to view all available options.

For detailed information on using the data file tool, refer to Reading from and Writing to Files in Chapter 4 of the Using Circuit Simulation documentation.

For information on how to write equations, refer to Equations.

Choosing a Dataset

When you open a Data Display window, all datasets defined for the current project are available for display. One dataset is selected as the default; it will be used as the source of data unless a different dataset is chosen. If no datasets have been defined for the current project, the label on the drop-down menu displays the current design name.

You can also view datasets that are stored under other projects or are not part of a project, such as a dataset that contains measured instrument data. This can be useful for comparing simulated versus actual results or comparing results between projects.

The data display does not store any data, it only retrieves and displays the data within a dataset. Thus, if the data in the dataset changes (for example, if you alter a design and re-simulate), the data display will be updated to reflect the most current information in the dataset.

To choose a dataset:

  1. Click the arrow to view the drop-down list of currently defined datasets.
  2. Choose the name of the desired dataset. The Datasets and Equations list box is updated to reflect the data variables contained in the selected dataset.

Adding a Dataset
To view a dataset outside of the current project:

  1. Choose Insert > Plot.
  2. Position the pointer, click, and select a plot type.
  3. Click the Manage Datasets button in the Plot Traces& Attributes dialog box. The Dataset Alias Manager dialog box appears.
  4. By default, datasets are saved with the .ds extension under the <project_name>/data directory. Navigate to the file of interest and select the file. For more information, refer to Dataset Aliasing.
  5. Click OK.

Using the Dataset Browser

The Dataset Browser enables you to clearly identify the hierarchy associated with a dataset variable name by displaying information in a tree structure. The browser also enables you to examine or select dataset variables from more than one dataset at a time.

The Dataset Browser is activated using the Show Hierarchy option. This option is a toggle checkbox that is available from three different dialog boxes in the Data Display:

Example

To browse through the datasets and equations hierarchy using the dataset browser:

  1. Choose Insert > Plot.
  2. Position the pointer and click. The Plot Traces & Attributes dialog box appears.
  3. Select a dataset from the Datasets and Equations drop-down menu.
  4. Select a dataset variable from the list box and activate the Show Hierarchy checkbox. Note that the variable you selected in the flat view remains selected in the tree view. The dataset variables that are available in a dataset are displayed in the Datasets and Equations list box in a tree structure.
    Note
    In the tree view, when variables are selected and added to the trace list on the right, they are displayed in the trace list with the short unique name (same as in the flat view).

  5. Use the + / - to further expand or collapse each item in the list. When a dataset is expanded, the hierarchy of the dataset variables within the dataset is displayed.
    Note that only the lowest level nodes can be selected in the dataset. More than one dataset variable may be selected in a dataset and the variables do not need to be included in the same dataset.
    Note
    When Show Hierarchy is toggled back to the flat view, the last item selected or expanded in the tree view is displayed in the flat view.
  6. Deactivate the Show Hierarchy checkbox to return to the default (flat) view. Only the shortest unique names are displayed in the flat view.

Dataset Aliasing

The Dataset Alias Manager enables you to assign a shorter alias name to a dataset and use it within the Data Display in place of the longer dataset path name. Aliases and their associated datasets can be saved and made available between sessions.

Using the Dataset Manager

Dataset alias names are managed using the Dataset Alias Manager in the Data Display. From within the Dataset Alias Manager you can:

To access the Dataset Alias Manager from a Data Display window:
Choose File > Manage Dataset Aliases. The Dataset Alias Manager window appears.

You can access the Dataset Alias Manager window from several other locations in the Data Display window.
From the Plot Traces & Attributes dialog box:

From the Enter Equations dialog box:

To add a new alias to the Dataset Alias Manager window:

  1. Click the Add Alias button. The Add Dataset form appears.
  2. Click the Browse button and use the dataset browser to locate a dataset. Click the Add button in the browser window to add the specified dataset to the Add Dataset form.
  3. In the Add Dataset form, a unique alias name is supplied by default for newly selected datasets. You can choose your own unique alias and override the default name by simply typing over it in the Alias field.
    Note
    When choosing an alias name, try to select a unique name to avoid conflicts with existing aliases.
  4. Click OK to add your new alias. Aliases are checked for unique names. If a conflict occurs, an message is displayed asking you to resolve the conflict. Choose a different alias name or remove the existing alias in conflict.
  5. After you have added the new alias to the Dataset Manager window, click OK in the Dataset Manager window to save your changes.

To edit an existing alias from the Dataset Alias Manager window:

  1. Select an alias in the Dataset Manager window and click the Edit Alias button. The Edit Alias form appears.
  2. Modify the alias and/or dataset of the selected entry.
  3. Click OK to implement your changes. The modified alias appears in the Dataset Manager.

To delete an existing alias from the Dataset Alias Manager window:

  1. Select an alias in the Dataset Manager and click the Remove Alias button. A confirmation message appears asking if you are sure you want to remove the alias.
  2. Click OK to confirm removing the alias or Cancel to abort the process.

Saving a Data Display
There are three commands available for saving a data display: Save, Save As, and Save Copy As.

Exporting a Data Display Plot or List


Data displayed in rectangular plots, polar plots, Smith charts, stacked plots, and lists can be saved to a tab-delimited ASCII file.

To export a data display plot or list to a tab-delimited ASCII file:

  1. Select one or more plots or lists.
  2. Choose File > Export > Write selected item to tab-delimited ASCII. The Write Data To ASCII File window appears.
  3. Enter a filename then click OK. A file suffix of .txt is automatically appended to the selected file name.

Using a Template in Your Display

Templates are files that contain only the items that are placed in a display area. Templates enable you to store pre-configured plots and other graphical items, which you can use in any data display. For example, you may have a standard set of plots that you use in different projects. Rather than reinsert the plots and edit them for each data display, you design it once and save it as a template. You can then add these plots to any data display window by inserting the template.

Templates can include not only plots but traces, markers, annotation, or any other item that can be inserted in the display area. The only thing that is not saved in a data display template is the default dataset.

To save a data display as a template:

  1. Choose File > Save As Template in the Data Display window. The Component Library/Save Template Browser appears.
  2. In the Libraries list, select a directory in which to save the template.
    • Product - This selection contains templates that are shipped with the product. Templates in this section are located in $HPEESOF_DIR/circuit/templates
    • User - This selection provides a location for personal templates. Templates in this section are located in $HOME/hpeesof/circuit/templates.
    • Customized - This selection is where site specific templates should be placed. This category may not appear in the browser if there are no templates stored in this location. Templates in this section are located in $HPEESOF_DIR/custom/circuit/templates.
      Note
      The Product and Customized directories are typically specified as read only so you may not have permissions to save to these directories.
  3. Supply a name and click OK. The extension .ddt is automatically appended to filenames of data display templates.

To insert a data display template in an existing data display:

  1. From the Data Display window, choose Insert > Template.
  2. Navigate to the name of the template file that you want to use.
  3. Click OK.

To insert a data display template in a new data display:

  1. From a Data Display window, choose File > New.
  2. Choose Insert > Template.
  3. Navigate to the name of the template file that you want to use.
  4. Click OK.

Built-in Data Display Templates shows a number of built-in templates that are available to facilitate setting up common measurements.

Template Description
BJT_curve_tracer BJT curve tracer with power consumption calculation.
FET_curve_tracer FET curve tracer with power consumption calculation.
S_ParamsQuad_Smith_Plr S11, S22 on Smith Charts; S12, S21 on polar plots.
S_Params_Quad_dB_Smith S11, S22 on Smith Charts; dB(S12), dB(S21) on rect. plots.
S_Params_Quad_dB_Smith_Log S11, S22 on Smith Charts; dB(S12), dB(S21) on rect. Log plots.
S_ParamsLargeSignal Displays the S-parameters as a function of frequency and input signal power, as simulated by the S_ParamsLargeSignal schematic template. Is also computes the Rollett stability factor, K, and group delay from these S-parameters.
SProbeT Use with SProbeT schematic template
SProbePairT Use with SProbePairT schematic template
S_21_11_wZoom dB(S21), S11 with "zoomed-in" frequency ranges.
Circles_Ga_NF Available gain and noise figure circles.
Circles_Ga_Stab Available gain and stability circles.
Circles_Stability Source and load stability circles and K.
HB1Tone Output power, gain, and harmonic distortion.
HB1ToneSwptFreq Output power, gain, harmonic distortion vs. frequency.
HB1ToneSwptPwr Output power, gain, harmonic distortion vs. power.
HB2Tone Output power, gain, TOI.
HB2ToneSwptPwr Output power, gain, TOI vs. power.
MixConvGainNF Mixer conversion gain, NF, noise contributors.
MixTOI Mixer output power, conversion gain, TOI.
SP_NWA_T Use with SP_NWA_T schematic template
SP_NWA_LogT Use with SP_NWA_LogT schematic template
SP_NWA_4PortT Use with SP_NWA_4PortT schematic template
SP_NWA_4PortLogT Use with SP_NWA_4PortLogT schematic template
SP_NWA_4PortBiasT Use with SP_NWA_4PortBiasT schematic template
SP_NWA_4PortBiasLogT Use with SP_NWA_4PortBiasLogT schematic template
SP_FET_T Use with SP_FET_T schematic template
SP_DiffT Use with SP_DiffT schematic template
SP_BJT_T Use with SP_BJT_T schematic template
LinearStepRespT Use with LinearStepRespT schematic template
LinearPulseRespT Use with LinearPulseRespT schematic template
DC_FET_T Use with DC_FET_T schematic template
DC_BJT_T Use with DC_BJT_T schematic template
ConvStepRespT Use with ConvStepRespT schematic template
ConvPulseRespT Use with ConvPulseRespT schematic template

Viewing the Display Area

To aid in viewing your work, the following commands are available from the View menu and as buttons on the toolbar.

Command Button Description
View > View All View All View all graphical objects on the display area
View > Redraw View Redraw View Redraw the current view in the display area
View > Zoom > Zoom Area Zoom Rectangle Zoom in so the selected area fills the window
View > Zoom > Zoom In x2 Zoom x2 Zoom in to make objects appear twice as large
View > Zoom > Zoom Out x2 Zoom x1/2 Zoom out to make objects appear twice as small
View > Zoom > Actual Size Actual Size View objects at actual size

Like other windows in the product, the Data Display window has scroll bars along the window edges so you can pan across the display area.

Scrolling through Lists and Traces

The scroll buttons in the toolbar enable you to scroll through long lists of data in listing columns. This also works with other types of plots. If you turn off automatic scaling to display smaller portions of data on a plot, you can use these buttons to move data horizontally across the plot.

To use the scroll buttons:

  1. Choose View > Scroll Data.
  2. Select the list or trace you want to scroll.
  3. Select scroll buttons as shown in the figures below.

Editing a Data Display

You can make changes to the data display as you work. The typical sequence is to select the object you wish to edit, then perform the operation. In some cases, you can select the command first and then the object. If an edit command has this capability, it is noted.

Selecting Objects

You can select one, several, or all objects on a data display area to facilitate editing your work. A selected item is enclosed with a dashed outline and handles. A selected trace has a thicker, dashed appearance.


The following select options are available.

Option Action
Select one object Click the object.
Select several objects Shift+click the objects.
Select all objects Choose Edit > Select All.

Deselecting an Object

If you want to deselect an object, click anywhere on the display area that is not occupied by the object.

Moving Objects

You can move an object anywhere on the display area.
To move an object:

  1. Select the object.
  2. Drag the object to the new position.
  3. The object remains selected and can be moved again.
    To move several objects:
  1. Select the objects.
  2. Hold down the Shift key and drag the objects to the new position.
    Hint
    You can use the automatic panning feature by dragging an object to the edge of the data display window. While dragging an object, the window will automatically pan when the cursor is placed at the very edge (within a few pixels) of the display area. Note that you must be within the window, not the window border or scroll area.

Scaling Objects

To scale an object:

  1. Select the item.
  2. Drag one of the object handles to reduce or enlarge the object to the desired size.

Arranging Objects

Arranging objects is useful when you have overlapping objects. Select the object of interest and choose an arranging option.The following options are available.

Command Description
Edit > Arrange > Move to Front Displays the selected object in front of all other objects
Edit > Arrange > Send to Back Displays the selected object behind all other objects
Edit > Arrange > Move Forward Exchanges the positions of the selected object and the object in front of it
Edit > Arrange > Move Backward Exchanges the positions of the selected object and the object behind it

Activating or Deactivating Objects

If you want to selectively deactivate a plot or an equation in a data display:

  1. Select the object or objects.
  2. Click the Toggle Activation of Object button on the toolbar or choose Edit > Toggle Activation.

    Once an object is deactivated, a red 'X' is drawn through the object to indicate that it has been deactivated. The object will not respond to any dataset updates while inactive. Equations are also removed from the variables list when inactive. This feature can be helpful in troubleshooting or when trying to speed up the re-draw process.

To activate a previously deactivated object:

  1. Select the object or objects.
  2. Click the Toggle Activation of Object button on the toolbar or choose Edit > Toggle Activation.

Cutting, Copying, Pasting, and Deleting


You can perform cut, copy, paste, and delete operations in the Data Display much like other windows in the product. First select an item in the display area, then choose a command.

Command Action Keyboard Shortcut
Edit > Cut Erase the selected object from the display area and place it on the clipboard CTRL + X
Edit > Copy Place a copy of the selected object on the clipboard CTRL + C
Edit > Paste Place the object on the clipboard in the display area CTRL + V
Edit > Delete Erase the selected object without placing it on the clipboard DEL

Setting Data Display Preferences

The appearance of each type of graphical object can be customized in a number of ways, depending on the type of object. Objects are drawn initially using program defaults, but you can change these characteristics and use them as new defaults for all projects, or you can save your settings to a file for use in an individual project.
To set new defaults for all projects:

  1. Choose Options > Preferences.
  2. Modify any or all settings as desired and click Save.
  3. Save the modified settings in $HOME/hpeesof/config/ddsdefaults.ael.
  4. Click OK.
    Note
    Preferences are saved when you exit the program. These settings will be the defaults used when you restart the data display.

To save preferences for an individual project:

  1. Choose Options > Preferences.
  2. Modify any or all settings as desired and click Save.
  3. Type the desired filename and click OK.

To read a preferences file:

  1. Choose Options > Preferences.
  2. Click Read. Navigate to the preferences file, then select the file. Objects will be drawn using the new preferences.
  3. Click OK.

You can save different sets of preferences to different files. You can update a Data Display window at any time with a new preferences file. Reading in new preferences overwrites the existing ones.
For information on the characteristics you can change for the different types of objects, refer to the appropriate chapter.

Preferences to be Edited Refer to
Plots and lists Plots and Lists
Traces Traces
Equations Equations
Lines, polylines, rectangles, circles, polygons, and text Annotating the Data Display
Markers Markers

Printing

The Data Display's print functions enable you to print the current page, selected item, or all pages. The print functions are available from the File menu. For information on setting up printers, refer to the ADS "Schematic Capture and Layout" documentation.

Locating Data Display Examples

Many of the designs in the ADS Examples directory include data displays. The data displays use a variety of plots, trace formats, markers, and many include equations. These examples can help you design your own data displays so that you can analyze simulation data effectively. A list of some of the examples is given below.

Examples Subdirectory Project Data Displays
Com_Sys BER_prj Displays bit-error rate data in lists, as time-domain waveforms, and on scatter plots.
  cdmafilter_prj Displays the frequency response, unit step response, and unit pulse response of a filter.
  DeltaSigma_prj Displays the magnitude of the output of a delta-sigma modulator on a rectangular plot.
  gsm_prj Displays a variety of waveforms generated in a basic GSM 0.3 GSM system, including the output data, recovered clock, recovered carrier, modulated spectrum, and MSK trajectory.
  IS95_prj Displays the spectrum of a simple IS95 forward channel carrier on a rectangular plot.
  rfsystem_prj Displays a wide range of simulation results, including TOI in spectral format, budget data in lists, and channel spectra.
  widebandcdma_prj Displays waveforms generated in a wide CDMA modulator.
DSP CHBT_TH_prj Displays a wide range of results simulating the output from a Sine wave.
Momentum Balun_prj Compares S-parameters of a balun in magnitude and phase on rectangular plots.
  BoxExample_prj Compares the S-parameters from the box example to a set of reference S-parameters.
  Coupled_Stubs_prj Displays S-parameters in magnitude and phase on rectangular plots.
  CPW_line_prj Displays S-parameters in magnitude and phase on rectangular plots.
  Hairpin_filter_prj Displays the response of the filter.
  Low_pass_filter_prj Compares measured S(2,1) data to Momentum and Advanced Design simulations.
  Lp4_8Ghz_prj Identifies the numerical noise floor of the filter.
MW_Ckts LNA_prj Displays a wide range of results from the simulations of a low-noise amplifier, including the S-parameters of an optimized amplifier displayed using lists, Smith charts, and rectangular plots; sweeps of collector-emitter voltage and collector current that display similar to a curve tracer; and the amplifier output from multiple input tones, displayed in spectral format.
  mw_filter_prj Displays the S-parameters of a 12 GHz bandpass filter, scaled for display on a rectangular plot.

Customizing Keyboard Shortcuts

You can redefine default keyboard shortcuts as well as create new ones. These shortcuts are maintained individually for the different windows.

To change or add a keyboard shortcut:

  1. Choose Options > Hot Key/Toolbar Configuration and click the Hot Key tab in the dialog box that appears.
  2. Select the menu name or menu/command sequence from the Category list box.
  3. Select the command from the Item list box. If a shortcut currently exists for the item, the current assignment is displayed.
  4. Select the modifier key(s)-Ctrl, Alt, Shift-and type the letter(s) you want to use in the Key field (UNIX is case-sensitive; the PC is not). If the combination you choose is currently assigned to another command sequence, you are warned and given the choice to proceed or to select another key sequence.
    Note
    If you use Alt as the modifier key, and a letter that is already assigned as an accelerator for a menu (see the underscored letters on the menu bar), the menu accelerator is replaced by your custom shortcut (with no warning).
  5. To replace the assignment with your own choice, continue, otherwise choose a new key combination and click Apply. When you are through making all keyboard changes, click OK to dismiss the dialog box.

Shortcut Keys

Shortcut Keys lists the default keyboard shortcuts found in the Data Display windows. Some of the ADS individual tools also offer the ability to customize shortcut keys. For details on customizing these shortcuts, refer to the section, Customizing Keyboard Shortcuts.

Shortcut Keys
File Commands
New Ctrl + n
Open Ctrl + o
Save Ctrl + s
Print Ctrl + p
Edit Commands
End Command Esc
Undo Ctrl + z
Redo Ctrl + y
Cut Ctrl + x
Copy Ctrl + c
Paste Ctrl + v
Delete Del
Select All Ctrl + a
View Commands
View All Ctrl + f
Window Commands
New Ctrl + Shift + D
Close Ctrl + F4
Help Commands
What's This? Shift + F1
Topics and Index F1

Sorted Default Shortcut Keys lists the default shortcut keys, in alphabetical order, to enable you to see at a glance which ones are in use. If you attempt to assign any of these to other commands, you are warned and given the choice to proceed or to select another key sequence (see footnote for Alt).

Sorted Default Shortcut Keys
Ctrl Ctrl + Shift Shift Alt Others
Ctrl + a   Shift F1   Del
Ctrl + c       Esc
Ctrl + f       F1
Ctrl + f4        
Ctrl + n        
Ctrl + o        
Ctrl + p        
Ctrl + s        
Ctrl + v        
Ctrl + x        
Ctrl + y        
Ctrl + z        
If you use Alt as the modifier key (when creating custom shortcuts), and a letter that is already assigned as an accelerator for a menu (listed in this table), the menu accelerator is replaced by your custom shortcut with no warning.

Configuring Toolbars

By default, the toolbar in each data display window contains:

You can reconfigure these default toolbars and create your own to better meet your design needs ( Options > Hot Key/Toolbar Configuration ).

Customizing an Existing Toolbar

To reconfigure an existing toolbar:

  1. Choose Options > Hot Key/Toolbar Configuration and click the Toolbar tab in the dialog box that appears.
  2. In the Toolbar Group list box, select the name of the toolbar you want to change.
  3. To add or delete icons, use one of the following methods:
    • To delete an icon from the toolbar, select the associated command in the Tool Item list box, and click the Cut button.
    • To add an icon to the toolbar, select the appropriate menu/command sequence from the Menu Category list box, select the command from the Menu Item list box, and click the Add button. The command is added to the Tool Item list box.
      Hint
      When you add a button to the toolbar, its position relative to the other buttons is determined by its position in the Tool Item list box. Before you click the Add button, be sure to highlight the command that the new command should precede. In this example, Zoom Rectangle was highlighted before the Add button was clicked so that View All would come before Zoom Rectangle.
  4. If you want to edit another toolbar, click Apply to effect these changes and begin the process again. When you are through making changes to the toolbars, click OK.

Creating a New Toolbar

To create a custom toolbar:

  1. Choose Options > Hot Key/Toolbar Configuration and click the Toolbar tab in the Configuration dialog box that appears.
    Hint
    The position of the new toolbar, relative to the position of any existing toolbars, is determined by its position in the Toolbar Group list box; the new name is added below the name that is highlighted when you click the Add button. For example, if you keep both default toolbars and want to add a third one below them, highlight the bottom one before you click the Add button.
  2. Supply a name in the Toolbar Name field and click Add. The name you supply is added to the Toolbar Group list box.
  3. Select the desired Menu Category, select the desired Menu Item and click the Add button above the Menu Item. The command name is added to the Tool Item list box.
  4. When you are through making changes to this toolbar, click Apply to effect the changes.
  5. When you are through making changes to all toolbars, click OK.
 

Privacy Statement  | Terms of Use  | Legal | Contact Us  | © Agilent 2000-2008 

Contents
Additional Resources