Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel3
minLevel1
include
outlinefalse
indent
excludePage Content
typelist
classprintablefalse

...

class

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 Version

The versions of MATLAB R2018b, R2020a and above are supported by RT-LAB

MATLAB R2019b (v9.7) and above.

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 OPALRT Linux OS (64bit); however, the new OS is highly recommended.

...

.

OpenModelica

...

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.

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

Enables FMUCReator to use DYMOLA as a tool to build FMUs compatible with ePHASORSIM. This key is required only for FMUCreator and not for running the pre-build FMUs. No license is required for OpenModelica FMU.

...

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.

Please refer to FMI

Dymola