Text Labels

 

Text can be displayed on component graphics by using a Text Label object.  Text labels can be one line of text only, and the user may select alignment and size.

Adding Text Labels

To add a text label to your component definition, the most straightforward method is to use the ribbon control bar Shapes tab:

 

 

Simply left-click the Text button, drag it to where you want it placed and left-click again.  

Changing Text Label Properties

Text label properties can be adjusted through the Text Properties dialog:  Either left double-click or right-click over the text label and select Properties....

 

 

Appearance:

 

Data:

Visibility:

Displaying Parameter Data in Text Labels

It is possible to use text labels to display  the contents a specific input parameter field. For example, you can display the MVA rating of a transformer model according to what is entered in its Rated MVA input field.

Substitution Operators

Linking a text label to an input parameter is accomplished by simply entering the Symbol name of an associated input parameter into the text label, preceded by either a percent (%) or a dollar ($) symbol.  If the $ prefix is used, just the value of the linked input field will be displayed.  If the % prefix is used, both the value and the specified unit will be displayed.  The following example illustrates how to link to an input field.  See The Parameters Section and Substitutions for more details.

 

 

 

EXAMPLE 1:

 

A user wants to display the value of an input field with Symbol name timec, which represents the component time constant.  The user adds a text label to the component graphic and adds the following to the Text input field in the Format Text Label dialog:

 

Component Graphic section

Text Label Properties

 

If the timec input field has a value of say 10.0 [s], then the resulting display on the Circuit canvas would be similar to:

 

NOTE:  If the % prefix above is replaced by the $ prefix, the units will not be displayed.