Documentation Home Page ◇ ePHASORSIM Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

Create a GenUnit

Owned by Sylvain Ménard
Last updated: Dec 04, 2023
3 min read

Page Content

Required Steps

The following steps are required to create a GenUnit:

  1. Drag and drop required components  (e.g. a generator and/or its controllers) and connect them to construct a GenUnit,

  2. Define all parameters of the GenUnit and pass them to each component, appropriately,

  3. Define partType parameter with value 1 and data type Real,

  4. Add Power Pin to the GenUnit following the naming convention and connect it to the Power Pin of the current injector component. This pin is the point of connection between FMU and the rest of the network, 

  5. Save GenUnit with the following naming rules:

    1. If the data is imported from Excel file, the name length of a GenUnit is limited to 31 characters.

    2. If the data is not imported from Excel file, the name of the GenUnit should include the name of all the components included in the GenUnit, separated by underscores. The order of appearance for these names depends on the type of the component defined in the FMUGlossary.csv file and it is based on the following priority:

      1. Generator

      2. Exciter

      3. Power system stabilizer

      4. Turbine Governor

      5. Maximum excitation limiter

For example in case of importing from PSS/e data files, if a GenUnit is constructed from a GENSAL type machine, an EXST1 type exciter, a HYGOV type turbine-governor and PSS2A type power system stabilizer, then the GenUnit must be named as GENSAL_EXST1_PSS2A_HYGOV.

OpalRT Modelica Library

Following describes each component template in the OpalRT Modelica Library.

Generator

Pins Name

Pin Type

Description

Connects To

Pins Name

Pin Type

Description

Connects To

TRIP

Input

Trip signal

OpalRT Interface Pin

XADIFD

Output

Field current (p.u.)

XADIFD of Exciter

VI

Output

Machine voltage and current in rectangular form (p.u.)

VI of Exciter, Stabilizer and TurbineGovernor

AccPower

Output

Accelerating power (p.u. on MBASE)

PSS_AUX[2] and PSS_AUX2[2]

MBASE

Output

Machine base power (MVA)

MBASE of TurbineGovernor

SLIP

Output

Machine slip (p.u.)

PSS_AUX[1] and PSS_AUX2[1] of Stabilizer,

SLIP of TurbineGovernor

EX_AUX

Output

Exciter auxiliary signals

EX_AUX of Exciter

ETERM0

Output

Initial ETERM value (p.u.)

ETERM0 of Exciter

EFD

Input

Exciter output EFD (p.u.)

EFD of Exciter or EFD0 of itself

EFD0

Output

Initial EFD value (p.u.)

EFD0 of Exciter

PMECH

Input

Turbine output PMECH signal  (p.u.)

PMECH of TurbineGovernor or PMECH0 of itself

PMECH0

Output

Initial value of PMECH (p.u.)

PMECH0 of TurbineGovernor

Exciter

Pins Name

Pin Type

Description

Connects To

Pins Name

Pin Type

Description

Connects To

VI

Input

Machine voltage and current in rectangular form (p.u.)

VI of Generator

ECOMP

Output

Machine terminal voltage (p.u.)

ECOMP of Stabilizer

XADIFD

Input

Field current (p.u.)

XADIFD of Generator

VUEL

Input

Over excitation limiter VUEL output

VUEL or Initial Constant Value

VOEL

Input

Under excitation limiter VOEL output

VOEL or Initial Constant Value

VOTHSG

Input

Stabilizer VOTHSG output (p.u.)

VOTHSG of Stabilizer

dVREF

Input

Change in voltage reference (p.u.)

OpalRT Interface Pin

EX_AUX

Input

Exciter auxiliary signals

EX_AUX of Generator

ETERM0

Input

Initial ETERM value (p.u.)

ETERM0 of Generator

EFD

Output

Exciter output EFD signal (p.u.)

EFD of Generator

EFD0

Input

Initial EFD value (p.u.)

EFD0 of Generator

Turbine Governor

Pins Name

Pin Type

Description

Connects To

Pins Name

Pin Type

Description

Connects To

VI

Input

Machine voltage and current in rectangular form (p.u.)

VI of Generator

MBASE

Input

Machine base power (MVA)

MBASE of Generator

SLIP

Input

Machine slip (p.u.)

SLIP of Generator

PMECH0

Input

Initial value of PMECH (p.u.)

PMECH0 of Generator

PMECH

Output

Turbine Output PMECH signal (p.u.)

PMECH of Generator

dGREF

Input

Change in governor reference (p.u.)

OpalRT Interface Pin

Stabilizer

Pins Name

Pin Type

Description

Connects To

Pins Name

Pin Type

Description

Connects To

ECOMP

Input

Machine terminal voltage (p.u.)

ECOMP of Exciter

VI

Input

1st input for machine voltage and current (p.u.)

VI of Generator

PSS_AUX[1]

Input

1st auxiliary input for generator SLIP (p.u.)

SLIP of Generator

PSS_AUX[2]

Input

1st auxiliary input for generator accelerating power (p.u. on MBASE)

AccPower of Generator

VI2

Input

2nd input for machine voltage and current (p.u.)

VI of Generator

PSS_AUX2[1]

Input

2nd auxiliary input for generator SLIP (p.u.)

SLIP of Generator

PSS_AUX2[2]

Input

2nd auxiliary input for generator accelerating power (p.u. on MBASE)

AccPower of Generator

VOTHSG

Output

Stabilizer VOTHSG output (p.u.)

VOTHSG of Exciter

Note: From RT-LAB v. 2020.2 onward, a parameter named partType with value 1 and data type Real is defined for the GenUnit Modelica code. This parameter is used to extend the application of FMI. Thus, do not use this name for other parameters. 

Note: When the data is imported from PSS/e, CYME or PowerFactory:

  • The components’ name appearing in the GenUnit’s name must be exactly the same as the components’ name which we define in the 'FMUGlossary.csv' file.

  • However, when data is imported from Excel, the name of the Excel Sheet for FMU must match exactly as the FMU file name.

  • The name of the parameters in the GenUnit must be exactly the same as the name of the parameters in the 'FMUGlossary.csv' for the components that appear in that GenUnit.

  • For more information regarding 'FMUGlossary.csv', please refer to Register component in FMUGlossary.



OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323