Viewing the Parameter Grid Pane
Exporting/Importing to/from *.csv File
Navigating to Object Instances
The parameter grid pane is a powerful tool, which provides a convenient and efficient means to display and modify the parameters or properties of a wide range of objects and functions. Viewable in the parameter grid are:
Components (includes modules, transmission lines, cables and sticky notes)
Simulation Tasks (including project setting and layer overrides)
The parameter grid pane can be viewed by simply selecting it in the Panes drop list button, under the View tab of the ribbon control bar.
Once selected, dock the pane in a preferred location in the application environment.
To populate the contents of the parameter grid, select an object, right-click and select View Parameter Grid. If a View Parameter Grid option is not available in the right-click context menu, then the object is not supported by the parameter grid.
|
|
|
|
|
Components |
Graphs |
Simulation Tasks |
Transmission Lines |
Sticky Notes |
The parameter grid will immediately populate with data from all instances of whichever object was chosen. There will be one row of parameters for each existing instance of that unique object. A parameter grid initialized for all output channel components is shown below:
The instances displayed can be sorted by both parameter category, and module where the object resides. To bring up the Filters dialog, right-click and select View Filters, or click the Filters icon:
In this example project, there are a total of four modules (including the Main page). Choices for sorting are either of the three modules or all of them. The output channel component possesses only one category called Configuration.
Filtering by module can also be accomplished quickly by using the module drop down list:
The power of the parameter grid lies in its allowance for modifying parameter values en masse. Multiple parameters (columns) and multiple component instances (rows) can be modified simultaneously by simply selecting the appropriate cells, right-click and select Edit... (or press Alt + Ins).
Upon selection of Edit..., a special parameter dialog will be dynamically constructed depending on which parameters (columns) were selected. For the above example, the resulting dialog will appear as follows:
The default setting for each parameter is default value defined in the corresponding object definition. If the dialog is closed at this point no parameters will be modified. Let us say that we want to modify the Scale Factor of each of the selected output channels to say, 33.33.
We now press the OK button, and the parameter values will change accordingly.
Parameter grid contents can be imported or exported to file in comma separated variable (*.csv) format. Right-click and choose either Import or Export, or click the Export or Import buttons, or:
|
|
Right-Click |
Buttons |
You will be presented with a dialog to save the file to a specified folder.
Each object instance is given its own row of text in the *.csv file. Changes made to *.csv file externally will correspond to the component whose ID matches ID in the file. This helps to ensure that changes to parameter values correspond to the proper component instance.
A typical file format, containing multiple component instance data, is shown below:
, Name, Group, UseSignalName, enab, Display, Scale, Units, mrun, Pol, Max, Min 23625392, Delta Gamma Error, Inverter, 0, 1, 1, 33.33, , 0, 0, 2.0, -2.0 23638896, Alpha Order, Inverter, 0, 1, 1, 33.33, , 0, 0, 2.0, -2.0 23646232, Current (filtered), Inverter, 0, 1, 1, 33.33, , 0, 0, 2.0, -2.0 23648160, Gamma, Inverter, 0, 1, 1, 33.33, , 0, 0, 2.0, -2.0 23654672, Voltage Dep. Current Limit, Inverter, 0, 1, 1, 33.33, , 0, 0, 2.0, -2.0 23656640, Rectifier Current Order, Inverter, 0, 1, 1, 1.0, , 0, 0, 2.0, -2.0 23673168, Power, Inverter, 0, 1, 1, 1.0, , 0, 0, 2.0, -2.0 23684944, DC Voltage (compensated), Inverter, 0, 1, 1, 1.0, , 0, 0, 2.0, -2.0 |
Note that the above file displays eight instances of output channel components (existing in the project being studied), each with a unique component ID number. Each instance also includes the symbol name and corresponding value of each of its parameters. If a change is made in this file to say, the first instance (i.e. 23625392), the changes will be applied to that particular instance when the file is imported back into the project.
Note also that the parameter grid can be used to generate a master *.csv file, from which users can import parameter information directly to individual components. See Importing/Exporting Parameters to/from File for more details.
Cell contents may be copied and pasted at any time. Either right-click and select Copy/Paste, or use the Ctrl + c/Ctrl + v hot keys.
You can easily navigate to each instance of a particular component definition by simply clicking the navigable link in the Id column.
|
|
Click the ID Link |
Navigates to the Object Instance |
If there are an unruly amount of parameters (columns), or a large number of object instances (rows), you can select rows/columns to freeze in the parameter grid pane, so as to keep them in view while scrolling:
|
|
Freeze Column |
Scroll |
To turn freeze off, simply right-click on the row or column again and select Unfreeze Row or Unfreeze Column.
You may at any point, reset any values to their respective default. Select the appropriate cells, right-click and select Reset.
