Skip to main content

PSCAD™ termy

PSCAD™ termy

Last updated: 12 June 2025

Version: v1

Software required:

PSCAD™

Background​

termy is a PSCAD™ Definition provided with the gridmo software platform which enables gridmo to easily interface with your PSCAD™ Workspace. termy contains the metering components of the smiby block and is typically used for terminal-level metering.

Adding termy into a model​

Step 1: Add termy to your PSCAD™ Workspace​

Add the termy block into your PSCAD™ Workspace by the same process as adding the smiby block:

  • Download the latest version of termy using the DOWNLOAD MODEL button above.
  • Open your PSCAD™ Workspace file from your gridmo Engine's Inputs folder (.pswx) in PSCAD™.
  • Right click on the Definitions folder underneath the PSCAD™ Case in the Workspace view and select Import From File.
  • Navigate to the location of the termy definition file (.psdx) and select it.
  • Right click on the termy definition (it will appear at the bottom of the list of definitions) and select Copy.
  • Right click in the whitespace area in your Workspace, right click and select Paste.
  • Move termy to the location you wish to meter, by inserting termy in between two PSCAD™ nodes.
tip

You can have multiple termy blocks in your PSCAD™ Workspace to meter different locations.

tip

Note that the smiby block has point of connection metering - therefore, typically, you don't need termy at your generating system's connection point.

Step 2: Configure termy parameters​

To configure the termy block, right click on the termy block and navigate to 'Edit Parameters'. Update the 'Project settings' and 'FRT Flags' tabs as below:

Project settings​
  • Name
    • This field can be used to distinguish between multiple termy blocks in a PSCAD™ workspace and when using the OUTPUT, LOCATION= Command. Set the Name field to a unique name such as termy_PV or termy_INV1.

The termy block has several parameters which define the base values of the internal metering. Set the following as per your project's base values:

  • Voltage base (kV)
  • Frequency base (Hz)
  • Project rated active power (MW)
  • Active current id base (MW)
  • Reactive current iq base (MVAr)
tip

If your project's generating system is scaled within your model (i.e. number of inverters), you can scale the termy block's measurement outputs by using the Measurement scale field.

FRT flags​

In the 'FRT flags' tab, link the FRT flags from your generating system with the termy block by configuring the following fields:

  • Single FRT flag or separate LVRT/HVRT flags?
    • If your generating system has a single flag for FRT select 'Single FRT flag', or 'Separate LVRT/HVRT flags' if you have individual flags for LVRT/HVRT.
  • FRT flag
    • If 'Single FRT flag' selected, enter the variable name of your FRT flag in this field.
  • LVRT flag and HVRT flag
    • If 'Separate LVRT/HVRT flags' selected, enter the variables names of your LVRT and HVRT flags here.

Using termy's metering channels​

The following metering channels are available within termy. Replace LOCATION= with the name of the termy block you have set in the previous step.

Connection point voltage, three-phase RMS [p.u.]:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_VOLT, VAL=V, NAME=i_put_name_here

Connection point voltage, single-phase RMS [p.u.]:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_VA, VAL=V, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_VB, VAL=V, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_VC, VAL=V, NAME=i_put_name_here

Connection point current, single-phase RMS [p.u. on base configured in smiby]:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_IA, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_IB, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_IC, VAL=I, NAME=i_put_name_here

Connection point active power [MW] and reactive power [MVAr]:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_P, VAL=PQS, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_Q, VAL=PQS, NAME=i_put_name_here

Connection point power factor [unitless]:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_PF, VAL=PF, NAME=i_put_name_here

Click here for details on how gridmo calculates power factor.

Connection point active current [p.u.] and reactive current [p.u.] on a provided base:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_ID, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_IQ, VAL=I, NAME=i_put_name_here

Same quantities, but exported as sequence components:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_ID_pos_seq, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_IQ_pos_seq, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_ID_neg_seq, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_IQ_neg_seq, VAL=I, NAME=i_put_name_here

Positive, negative and zero sequence voltage:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_V_pos_seq, VAL=V, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_V_neg_seq, VAL=V, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_V_zero_seq, VAL=V, NAME=i_put_name_here

Positive, negative and zero sequence current:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_I_pos_seq, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_I_neg_seq, VAL=I, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_I_zero_seq, VAL=I, NAME=i_put_name_here

Positive and negative sequence ratios (Ipos/Vpos and Ineg/Vneg):

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_pos_seq_ratio, NAME=i_put_name_here
OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_neg_seq_ratio, NAME=i_put_name_here

Frequency [Hz]:

OUTPUT, LOCATION=<enter_termy_name_here>, TITLE=termy_FREQ, VAL=F, NAME=i_put_name_here

Updating termy to a new version​

Update the termy block to the newest version by the same process and updating the smiby block:

  • Download the latest version of termy.
  • In PSCAD, navigate to your project containing the termy block(s) using the left hand sidebar, and expand 'Definitions' using the '+' symbol. Ensure that your current definition of the termy block is named 'termy' and not 'termy_1' or otherwise.
  • Right click on 'Definitions', click 'Import from File' and select the 'termy_pscadv5.psdx' file you just downloaded. The new termy definition should appear as 'termy_1' in the project definitions.
  • Open the scripts tab of PSCAD by navigating to the 'View' tab, select 'Panes' and then 'Scripts'.
  • In the Scripts tab, click 'New' and navigate to the directory where the new termy version was downloaded. Select and open the 'gridmo_update_termy.py' script.
  • Click 'Run' to update the termy block to the new version. Note that the script will automatically transfer all your project settings from the existing termy block.
  • To complete the update, delete the old termy definition and rename the new definition to 'termy'.

caution

Updating termy may overwrite any of your custom modifications to termy. In general, we recommend not making any changes to the termy block or OEM libraries so that newer versions may be accommodated easily.

Revision history​

Version 1 | 12 June 2025​

  • First release.