...
| Table of Contents | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Installation
OPAL-RT Products
Installation of RT-LAB is required to run ePHASORSIM.
From version v2021v2023.3 and later an installation of OPAL-RT's Unified DataBase (UDB) Opal One is required to import data from PowerFactory input file via the Unified Database.
Third-Party Requirements
Software | Description |
|---|---|
MATLAB | The versions of MATLAB R2018b, R2021a and above are supported by RT-LAB 2024.1. |
C/C++ Compiler for MATLAB | MinGW64 for MATLAB 64bit is free compiler recommended by MATLAB that can be used. |
Java version 8.0 or later | Required to import data from CYME |
The FMI feature is compatible with:
...
DYMOLA Version 2019, released 2018-04-11 (MATLAB 32/64bit): Real-time target can be either in RedHat (32bit) or new OPAL-RTLinux OS (64bit); however, the new OS is highly recommended.
...
OpenModelica 1.16.2 (only MATLAB 64bit): Real-time target must be OPAL-RTLinux OS (64bit).
| Note |
|---|
Note: This version of OM 1.16.2 is not compatible with the eXtreme High Performance (XHP) execution mode of RT-LAB. To run ePHASORSIM model with OM 1.16.2 FMUs on OPAL-RTLinux OS, the XHP mode must be disabled. |
To export FMU an installation of DYMOLA or OpenModelica (OM) is required.
To run an ePHASORSIM model with DYMOLA or OM 1.16.2 FMUs, the installation of DYMAOLA or OM1.16.2, respectively, is not required. Whereas, in case of OM 1.9.1 FMUs an installation of OM is required on both linux target and host.
On Linux targets:
...
. |
...
...
For OM 1.9.1 use FMUCreator to install the proper package on RedHat Linux target.
On host: download the required installer file via the following links and install it manually.
OpenModelica |
|---|
...
| Note |
|---|
Note: This version of OM 1.9.1 has memory leak issues which will limit the number of FMUs that can be used in a model. OPAL-RT has partially resolved this memory leak and made a custom build of OM 1.9.1 that is recommended for better performance. The customized OM 1.9.1 has installers for both Windows and Linux. Please contact OPAL-RT Support to receive this custom version gratis. |
The tool FMUCreator, included with RT-LAB, eases installation of OpenModelica on the Linux target. It also simplifies compilation and generation of FMUs from the user’s developed models.
The FMUCreator tool has an external dependency on Visual C++ 2008 Redistributable - x86 9.0.21022. The user must ensure the latter is installed prior to running the tool.
The MinGW binary folder (provided with OpenModelica at %OPENMODELICAHOME%/MinGW/bin) must be added to the system path after installation.
License(s)
To run ePHASORSIM, both host and target computers need to have appropriate licenses installed.
The license key names are:
EPHASOR_RT
Enables ePHASORSIM on a real-time target.
EPHASOR_NRT
Enables ePHASORSIM offline (on Windows host).
EPHASOR_NUM_POWERSYSTEM_NODES
Maximum size of a power system (in number of nodes) that can be simulated by ePHASORSIM.
EPHASOR_INPUTFORMAT_PSSE
Enables ePHASORSIM’s PSS/e data file input feature.
EPHASOR_INPUTFORMAT_CYME
Enables ePHASORSIM’s CYME data file input feature.
EPHASOR_INPUTFORMAT_POWERFACTORY
Enables ePHASORSIM’s PowerFactory data file input feature.
EPHASOR_FEATURE_POWERFLOW
Enables power-flow computation on the host (even though the target uses the results of the power-flow, the target’s license doesn’t contain this key)
EPHASOR_PYTHON_API
Enables ePHASORSIM’s Python API feature.
Parallel Processing
EPHASOR_NUM_CORES
Maximum number of cores that can be used for simulation on a Linux target. [If this key is set to a number strictly higher than 1, EPHASOR_PARALLELIZE_GENUNITS is enabled.]
EPHASOR_PARALLELIZE_GENUNITS
Enables parallel computation for generator units in the embedded library and FMUs (machines and their controllers). [If this key is set, EPHASOR_NUM_CORES is set to a number strictly higher than 1]
EPHASOR_PARTITION_POWERSYSTEM
Enables partitioning of the power system: when the power system is partitioned, the network’s nodal equations are computed in parallel. [If this key is enabled, EPHASOR_PARALLELIZE_GENUNITS is enabled too]
FMU Creation
EPHASOR_DYMOLA_FMU
...
OpenModelica-1.9.1-revision-22929.exe: https://build.openmodelica.org/omc/builds/windows/releases/1.9/1
Please refer to FMI |
Dymola |
|---|