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
Page Content
Required Steps
The following steps are required to create a GenUnit:
Drag and drop required components (e.g. a generator and/or its controllers) and connect them to construct a https://opal-rt.atlassian.net/wiki/spaces/EUD/pages/23200436/Terminologies#GenUnit-FMU ,
Define all parameters of the GenUnit and pass them to each component, appropriately,
Define partType parameter with value 1 and data type Real,
Add https://opal-rt.atlassian.net/wiki/spaces/EUD/pages/23200436/Terminologies#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,
Save GenUnit with the following naming rules:
If the data is imported from Excel file, the name length of a GenUnit is limited to 31 characters.
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:Generator
Exciter
Power system stabilizer
Turbine Governor
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
.
OPAL-RT Modelica Library
Following describes each component template in the OpalRT Modelica Library.
Generator
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 |
---|---|---|---|
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 |
---|---|---|---|
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 |
---|---|---|---|
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 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.
Notes: 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
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter