Modelica is an object-oriented, declarative, multi-domain modeling language for component-oriented modeling of complex systems. For more information please refer to:
The Functional Mock-up Interface (or FMI) is a standardized interface protocol which enables computer simulations tools to integrate different models developed by Modelica language into their own environment. For more information please refer to:
Functional Mock-up Unit (FMU) is a zip file which includes the compiled binary code of the Modelica model as well as an XML file which includes the information about the model (number of parameters/states/inputs/outputs, name of these parameters, ...) required by FMI standard to connect to the model externally. The FMU can also include other files which might be required by a specific external tool.
Various commercial and open-source tools are available as Modelica developments environments that are complied with FMI standard to export FMUs. A comprehensive list of available tools can be found in this webpage:
ePHASORSIM is compatible with two of these tools: OpenModelica and Dymola
OpenModelica is an open-source Modelica-based modeling and simulation environment intended for industrial and academic usage. Its long-term development is supported by a non-profit organization, “Open Source Modelica Consortium (OSMC)”. For more information please refer to:
Dymola is a commercial tool that requires purchasing a licence. For more information please refer to:
FMUCreator is a customized tool developed by OPAL-RT to create FMUs from Models which are compatible with ePHASORSIM solver.
A GenUnit is a combination of only one Current injector component and its required Controller component. A GenUnit must have at least one Power Pin. The figure below illustrates a typical GenUnit which is made in OpenModelica. As can be seen, this GenUnit has a salient pole type synchronous type generator (GENSAL) as the current injector device and three controllers which are HYGOV (Hydro turbine-governor model), EXST1 (IEEE Type ST1 excitation system) and IEEEST (IEEE stabilizing model).
Note: GenUnit can also contain just one Current injector component without a Controller component.
Current Injector Component
A current injector is a component which can be modelled as a current source. These are basically the components which generate (such as synchronous machines), absorb (such as loads) or transfer (such as transmission lines) electrical energy directly to/from the power system. From ePHASORSIM’s perspective, any model with at least one power pin is considered as a current injector.
A controller is a component which controls specific signals of the current injector component. Exciters, turbine-governors and power system stabilizers are typical examples in this category. A GenUnit is combination of controller(s) and current injector devices.
A power pin is a connector type class which includes variables for both voltage and current of a component. If two or more power pins are connected together, Modelica’s translator automatically generates equations for voltage equality as well as Kirchhoff’s Current Law (KCL) for this connection.
Power pins are used to interface with powers system buses in ePHASORSIM simulations. They must follow a strict naming convention: bus0 for the first power pin, bus1 for the second, and so forth.
An Interface Pin is used to set an input value for the FMU model that is expected to be changed during simulations. A common use case is for signals like TRIP for a generator which is specified in the outer scope (GenUnit level) of a model.
A *.csv file which includes the name, type and parameters of the supported Modelica components.
FMU Mapping File
ePHASORSIM uses different mapping files in *.csv format to map parameters of a component in PSS/e, CYME or PowerFactory to the corresponding component define in 'FMUGlossory.csv'.
These files are as follows:
|'PSSEv32_mapping.csv'||maps PSS/e ver.32 components’ parameters to 'FMUGlossary.csv'.|
|'PFv2017_mapping.csv'||maps PowerFactory ver.2017 components’ parameters to 'FMUGlossary.csv'.|
|'CYMEv7x_mapping.csv'||maps CYME ver.7.x components’ parameters to 'FMUGlossary.csv'.|