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.
General Elm Components
- Sylvain Ménard
On this page:
Note: The following is the list of components that are only supported through ePHASORSIM native library. If you are missing support for your components, you can check out the ePHASORSIM Modelica User Defined Library, there you can find out how to use the existing Modelica models or create your own Modelica model.
Common Data
The following attributes are common to all imported components:
Parameter | Description | Acceptable Values |
|---|---|---|
| Unique identifier for DGS-XML file | Any Value |
| Location Name. A human readable description of the component | Any Value |
| Out of service |
|
Note: The loc_name, ID and FID attributes are used to create the components unique name.
This name must be used when referencing IO pins as described in I/O Pins for PowerFactory Data.
Note: All components that exist in the DGS-XML file will be imported and considered to be in-service.
That means for a component that is out-of-service in PowerFactory, the Solver imports its data and treats it as in-service. Thus, it is recommended to remove the data from the input file for the components that are required to be out-of-service during simulation.
Bus Data
The bus data comes from ElmTerm section in the DGS-XML file.
These PowerFactory components are mapped to the Bus
component of the Native Library
Parameters from ElmTerm Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Nominal Voltage: Line-Line in kV | Any value |
Line Data
The Line data comes from ElmLne and TypLne sections in the XML file.
These PowerFactory components are mapped to the Line
component of the Native Library.
Parameters from ElmLne Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Length of Line (km) | Positive Value |
Parameters from TypLne Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Rated Voltage | Any value |
| Rated Current | |
| Series resistance (Ohm/km) | |
| Series reactance (Ohm/km) | |
| Shunt Susceptance (uS/km) | |
| Line Type |
|
Load Data
The load data comes from ElmLod and TypLod sections in the DGS-XML file.
These PowerFactory components are mapped to the Load
component of the Native Library.
Parameters from ElmLod Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Operating Point: Active Power in MW | Any value |
| Operating Point: Reactive Power in MVAr | |
| Scaling factor of operating point |
Parameters from TypLod Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Active power portion of impedance load. | Any value from 0 to 1 |
| Active power portion of current load. | |
| Active power portion of power load. | |
| Reactive power portion of impedance load. | |
| Reactive power portion of current load. | |
| Reactive power portion of power load. |
Shunt Data
The shunt data comes from the ElmShnt sections in the DGS-XML file.
These PowerFactory components are mapped to the Positive Sequence Shunt
component of the Native Library.
Parameters from ElmShnt Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Shunt Type |
|
|
|
|
| Impedance |
|
| Rated Capacitive Power |
|
Switch Data
The switch data comes from StaSwitch and ElmCoup section in the DGS-XML file.
These PowerFactory components are mapped to the Switch
component of the Native Library.
Parameters from StaSwitch Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Switch initial status |
|
Transformers
Two-Winding Transformer Data
The two-winding transformer data comes from ElmTr2 and TypTr2 sections in the DGS-XML file.
These PowerFactory components are mapped to the Positive Sequence Transformer | PositiveSequenceTransformer PositiveSequence2WTransformer
component of the Native Library.
Parameters from ElmTr2 Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Position for “Tap Changer 1” | Any value |
| Resistance on network Sbase (p.u.) | |
| Reactance on network Sbase (p.u.) | |
| Susceptance on network Sbase (p.u.) |
Parameters from TypTr2 Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Rated power (MVA) | Any value |
| HV-Side rated voltage (kv) | |
| LV-Side rated voltage (kv) | |
| HV-Side vector group. |
|
| LV-Side vector group. |
|
| Phase shift vector group | Any value |
| Additional voltage per tap | |
| Phase change per tap | |
| Neutral tap position | |
| Minimum tap position | |
| Maximum tap position |
Three-Winding Transformer Data
The three-winding transformer data is obtained from ElmTr3 and TypTr3 sections in the DGS-XML file.
These PowerFactory components are mapped to the Positive Sequence Transformer | PositiveSequenceTransformer PositiveSequence3WTransformer
component of the Native Library.
Parameters from ElmTr3 Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Tap HV-Side: Act. Position in | Any value |
| Tap MV-Side: Act. Position in | |
| Tap LV-Side: Act. Position in | |
| Resistance between HV-MV in Network Sbase (p.u.) | |
| Resistance between MV-LV in Network Sbase (p.u.) | |
| Resistance between LV-HV in Network Sbase (p.u.) | |
| Reactance between HV-MV in Network Sbase (p.u.) | |
| Reactance between MV-LV in Network Sbase (p.u.) | |
| Reactance between LV-HV in Network Sbase (p.u.) | |
| Susceptance in network Sbase (p.u.) |
Parameters from TypTr3 Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Rated Power: HV-Side (MVA) | Any value |
| Rated Power: MV-Side (MVA) | |
| Rated Power: LV-Side (MVA) | |
| HV-Side rated voltage (kv) | |
| MV-Side rated voltage (kv) | |
| LV-Side rated voltage (kv) | |
| HV-Side vector group. |
|
| MV-Side vector group. | |
| LV-Side vector group. | |
| HV-side phase shift vector group | Any value |
| MV-side phase shift vector group | |
| LV-side phase shift vector group | |
| Tap HV-Side: Add. Voltage per Tap | |
| Tap MV-Side: Add. Voltage per Tap | |
| Tap LV-Side: Add. Voltage per Tap | |
| HV-Side: Neutral Position | |
| MV-Side: Neutral Position | |
| LV-Side: Neutral Position | |
| Magnetizing Impedance |
Machines
Synchronous Machine Data
The synchronous machine data comes from ElmSym and TypSym sections in the DGS-XML file.
These PowerFactory components are mapped to the Synchronous Machine
component of the Native Library.
Parameters from ElmSym Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Number of parallel Machines | Any value |
| Dispatch: Active Power in MW | |
| Dispatch: Reactive Power in MVAr | |
| Dispatch: Voltage in p.u. | |
| Minimum reactive power operational Limits (p.u.) | |
| Maximum reactive power operational Limits (p.u.) | |
| Slack bus |
|
| Generator/Motor | Must be |
| Initial voltage angle in degree |
|
Parameters from TypSym Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Nominal apparent power (MVA) | Any value |
| Nominal voltage (kV) | |
| Rotor type |
|
| Stator resistance (p.u.) | Any value |
| d-axis reactance (p.u.) | |
| q-axis reactance (p.u.) | |
| d-axis transient reactance xd' (p.u.) | |
| q-axis transient reactance xq' (p.u.) | |
| d-axis sub-transient reactance (p.u.) | |
| q-axis sub-transient reactance (p.u.) | |
| Inertia constant H (s) | |
| Turbine shaft friction torque coefficient (Damping factor) | |
| Leakage reactance (p.u.) | |
| d-axis transient time constant (s) | |
| q-axis transient time constant (s) | |
| d-axis sub-transient time constant (s) | |
| q-axis sub-transient time constant (s) | |
| Saturation function value for 1 p.u | |
| Saturation function value for 1.2 p.u | |
| Model type |
|
| Flux saturation considered or not |
|
Static Generator Data
The static generator data come from ElmGenstat sections in the DGS-XML file.
These PowerFactory components are mapped to the constant Load
component of the Native Library.
Parameters from ElmGenstat Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Number of parallel units | Any integer value |
| Dispatch: Input model | Must be DEF |
| Dispatch: Active Power in MW | Any value |
| Dispatch: Reactive Power in MVAr | |
| Dispatch: Scaling Factor | Any value |
| Local Controller Mode | constant Q |
| Simulation RMS Model |
|
Example
For parameter values as, ngum = 2, scale0 = 1, pgini = 15 and qgini = 5, ePHASORSIM models a negative constant power load whose apparent power is given by,
 |
|
Voltage Source Data
Voltage source data come from ElmVac sections in the DGS-XML file.
These PowerFactory components are mapped to the Positive Sequence Voltage Source component of the Native Library.
Parameters from ElmVac Section
Parameter | Description | Acceptable Values |
|---|---|---|
| Voltage angle offset (deg) | Any value |
| Voltage magnitude (pu) | |
| Internal inductance (Ohm) | |
| Internal resistance (Ohm) |
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