Pour la documentation en FRANÇAIS, utilisez l’outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

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 NamePin TypeDescriptionConnects To
TRIPInputTrip signalOpalRT Interface Pin
XADIFDOutputField current (p.u.)XADIFD of Exciter
VIOutput

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

VI of Exciter, Stabilizer and TurbineGovernor
AccPowerOutputAccelerating power (p.u. on MBASE)PSS_AUX[2] and PSS_AUX2[2]
MBASEOutputMachine base power (MVA)MBASE of TurbineGovernor
SLIPOutputMachine slip (p.u.)

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

SLIP of TurbineGovernor

EX_AUXOutputExciter auxiliary signalsEX_AUX of Exciter
ETERM0OutputInitial ETERM value (p.u.)ETERM0 of Exciter
EFDInputExciter output EFD (p.u.)EFD of Exciter or EFD0 of itself
EFD0OutputInitial EFD value (p.u.)EFD0 of Exciter
PMECHInputTurbine output PMECH signal  (p.u.)PMECH of TurbineGovernor or PMECH0 of itself
PMECH0OutputInitial value of PMECH (p.u.)PMECH0 of TurbineGovernor

Exciter

Pins NamePin TypeDescriptionConnects To
VIInputMachine voltage and current in rectangular form (p.u.)VI of Generator
ECOMPOutputMachine terminal voltage (p.u.)ECOMP of Stabilizer
XADIFDInputField current (p.u.)XADIFD of Generator
VUELInputOver excitation limiter VUEL outputVUEL or Initial Constant Value
VOELInputUnder excitation limiter VOEL outputVOEL or Initial Constant Value
VOTHSGInputStabilizer VOTHSG output (p.u.)VOTHSG of Stabilizer
dVREFInputChange in voltage reference (p.u.)OpalRT Interface Pin
EX_AUXInputExciter auxiliary signalsEX_AUX of Generator
ETERM0InputInitial ETERM value (p.u.)ETERM0 of Generator
EFDOutputExciter output EFD signal (p.u.)EFD of Generator
EFD0InputInitial EFD value (p.u.)EFD0 of Generator

Turbine Governor

Pins NamePin TypeDescriptionConnects To
VIInputMachine voltage and current in rectangular form (p.u.)VI of Generator
MBASEInputMachine base power (MVA)MBASE of Generator
SLIPInputMachine slip (p.u.)SLIP of Generator
PMECH0InputInitial value of PMECH (p.u.)PMECH0 of Generator
PMECHOutputTurbine Output PMECH signal (p.u.)PMECH of Generator
dGREFInputChange in governor reference (p.u.)OpalRT Interface Pin

Stabilizer

Pins NamePin TypeDescriptionConnects To
ECOMPInputMachine terminal voltage (p.u.)ECOMP of Exciter
VIInput1st input for machine voltage and current (p.u.)VI of Generator
PSS_AUX[1]Input1st auxiliary input for generator SLIP (p.u.)SLIP of Generator
PSS_AUX[2]Input1st auxiliary input for generator accelerating power (p.u. on MBASE)AccPower of Generator
VI2Input2nd input for machine voltage and current (p.u.)VI of Generator
PSS_AUX2[1]Input2nd auxiliary input for generator SLIP (p.u.)SLIP of Generator
PSS_AUX2[2]Input2nd auxiliary input for generator accelerating power (p.u. on MBASE)AccPower of Generator
VOTHSGOutputStabilizer 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.


  • No labels