Invoking the Component Properties Viewer
Saving Component Properties to a File
The complexity of a component may range from simple to elaborate. Some components may possess properties such as parameters, port connections, etc., numbered in the hundreds. When designing and debugging a new component, or verifying the settings of an existing component, it becomes important to be able to view this property data in a convenient format. The Component Properties Viewer provides an intuitive and convenient means of categorizing and displaying component attributes so that they may be examined efficiently.
Component Properties Viewer
The component properties are categorized into tabbed categories, where each section lists the individual attributes in a list format. The categories are described as follows (see Chapter 9 in this manual for details on these topics):
Layers: Provides information on graphical layers and related conditional statements set in the component Graphics section.
Ports: Provides information on external connections (nodes) and related conditional statements set in the component Graphics section.
Parameters: Provides information on parameter variables, such as Symbol name, type, unit, etc., set in the Parameters section.
Computations: Provides information on defined computed variables, such as type and computed value set in the Computations segment of the Script section
Errors: Provides a list of pre-compilation errors, for example, Computations segment errors.
NOTE: All values displayed in this viewer are shown in the same precision as will be used in a substitution. For EMTDC, this is 12 significant figures. All evaluation errors are indicated with a #NaN in the Value column.
Right-click on any component and select View Properties... from the pop-up menu to invoke the Component Properties Viewer.
The properties listed in each tabbed section are organized into columns.
Layers Tab |
Layers:
Layer #: Simply a numbered list.
Expression: The conditional statement defining the graphical layer.
F: An asterisk '*' in this column indicates that the Expression conditional stateCment is currently true (otherwise false).
Ports Tab |
Ports:
Name: The Symbol name of the corresponding port connection.
Expression: This is the conditional statement defining whether or not this port connection is enabled.
M: Mode. The symbols displayed here indicate the port connection type.
o: Electrical node
<: Input data node
>: Output data node
+: Shorted node
Type: The declared type (i.e. REAL, INTEGER, LOGICAL) if the port connection is non-electrical.
Dim: The signal dimension if a vector. This column is left blank if the signal is a scalar (i.e. Dim = 1).
F: An asterisk '*' in this column indicates that the Expression conditional statement is currently true (i.e. enabled).
Parameters Tab |
Parameters:
Name: The Symbol name of the parameter.
Caption: The Description of the parameter.
Type: The type of parameter (i.e. input, text, choice, etc.).
Unit: The Default Unit for the parameter (or Target Unit).
Minimum: The Minimum Value of the corresponding parameter.
Maximum: The Maximum Value of the corresponding parameter.
Data: The actual value as it is entered in the parameters dialog.
Value: The actual value of the parameter following evaluation by PSCAD (considering both entered units and the Target Unit).
F: An asterisk '*' in this column indicates that the parameter is enabled (otherwise disabled).
Computations Tab |
Computations:
Name: The name of the declared constant.
Expression: The script expression in the Computations segment, defining the value of the declared constant.
Type: The declared type of the constant (i.e. REAL, INTEGER, LOGICAL)
Value: The calculated value of the constant following evaluation.
Errors Tab |
Errors:
Error #: The sequential error number (i.e. order in list).
Trace: A description of the actual error. This is normally a message from the internal compiler.
Once the Component Properties Viewer has been opened, the data is open to some simple formatting. Although property attributes cannot be altered, users may adjust the order in which properties appear – this is useful if the data is to be saved to a file for example.
Left-click and hold a listed property in the display window. Drag the mouse pointer to where you want to place it and release the mouse button.
Component data can be saved to a text file at any time. Select the desired tab and press the Save As... button to bring up the Save As dialog window.
Select a folder, enter a filename, and press the Save button.
Specific rows of property data can be saved to the clipboard at any time as follows:
To copy a single row of data, right-click within the row, and select Copy Data.
To copy multiple consecutive rows, left-click on the first row, hold down the Shift button, left-click on the last row, and select Copy Data.
To copy multiple rows that are not consecutive, hold down the Ctrl button, left-click in each row to be selected, and select Copy Data.