Note: All the supported components that exist in 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 XML file. The following table lists the required fields for each section.
Fields from ElmTerm Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Bus name in the section | |
outserv | Out of service | Must be 0 |
uknom | Nominal Voltage: Line-Line in kV | Any value |
Note: The 'ID' in above table is used to create the component ID described in I/O Pins for PowerFactory Data .
Line Data
The Line data comes from ElmLne and TypLne sections in the XML file. The following tables list the required fields for each section
Fields from ElmLne Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Line name in the section | |
dline | Length of Line (km) | Positive Value |
Fields from TypLne Section
Entry | Description | Acceptable Values |
uline | Rated Voltage | Any value |
sline | Rated Current | |
rline | Series resistance (Ohm/km) | |
xline | Series reactance (Ohm/km) | |
bline | Shunt Susceptance (uS/km) | |
aohl | Line Type | ohl: Overhead Line |
Note: The 'ID’ in above ElmLne Section Table is used to create the component ID described in I/O Pins for PowerFactory Data.
Load Data
The load data comes from ElmLod and TypLod sections in the XML file. The following tables list the required fields for each section.
Fields from ElmLod Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Load name in the section | |
plini | Operating Point: Active Power in MW | |
qlini | Operating Point: Reactive Power in MVAr | |
scale0 | Scaling factor of operating point |
Fields from TypLod Section
Entry | Description | Acceptable Values |
aP | Active power portion of impedance load. | Any value from 0 to 1 |
bP | Active power portion of current load. | |
cP | Active power portion of power load. | |
aQ | Reactive power portion of impedance load. | |
bQ | Reactive power portion of current load. | |
cQ | Reactive power portion of power load. |
Note:
- In order to simulate the ‘ZIP’ load, the e_aP, e_bP and e_cP must be specified as 2, 1, 0 respectively. The e_aQ, e_bQ and e_cQ must also be specified as 2, 1, 0 respectively.
- Make sure that aP+bP+cP=1, aQ+bQ+cQ=1.
- The 'ID’ in above ElmLod Section Table is used to create the component ID described in I/O Pins for PowerFactory Data.
Static Generator Data
The static generator data come from ElmGenstat sections in the XML file and it is mapped to a constant load model. The following tables list the required fields for this section.
Fields from ElmGenstat Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Generator name in the section | |
outserv | Out of service | 0: In-service 1: Out-of-service |
ngum | Number of parallel units | Any integer value |
model_inp | Dispatch: Input model | Must be DEF |
pgini | Dispatch: Active Power in MW | Any value |
qgini | Dispatch: Reactive Power in MVAr | |
scale0 | Dispatch: Scaling Factor | Any value |
av_mode | Local Controller Mode | Const Q |
iSimModel | Simulation RMS Model | 4: Constant Power |
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,
![]() |
Note: The 'ID’ in above table is used to create the component ID described in I/O Pins for PowerFactory Data .
Synchronous Machine Data
The synchronous machine data comes from ElmSym and TypSym sections in the XML file. The following tables list the required fields for each section.
Fields from ElmSym Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Generator name in the section | |
typ_id | Type in TypSym | |
ngnum | Number of parallel Machines | |
pgini | Dispatch: Active Power in MW | |
qgini | Dispatch: Reactive Power in MVAr | |
usetp | Dispatch: Voltage in p.u. | |
q_min | Minimum reactive power operational Limits (p.u.) | |
q_max | Maximum reactive power operational Limits (p.u.) | |
ip_ctrl | Slack bus | 0 for false 1 for true |
outserv | Out of Service | Must be 0 |
i_mot | Generator/Motor | Must be 0: Generator |
phiini | Initial voltage angle in degree | -180 to 180 |
Fields from TypSym Section
Entry | Description | Acceptable Values |
sgn | Nominal apparent power (MVA) | Any value |
ugn | Nominal voltage (kV) | |
iturbo | Rotor type | 0 for salient rotor 1 for round rotor |
rstr | Stator resistance (p.u.) | Any value |
xd | d-axis reactance (p.u.) | |
xq | q-axis reactance (p.u.) | |
xds | d-axis transient reactance xd' (p.u.) | |
xqs | q-axis transient reactance xq' (p.u.) | |
xdss | d-axis sub-transient reactance (p.u.) | |
xqss | q-axis sub-transient reactance (p.u.) | |
h | Inertia constant H (s) | |
dpu | Turbine shaft friction torque coefficient (Damping factor) | |
xl | Leakage reactance (p.u.) | |
tds0 | d-axis transient time constant (s) | |
tqs0 | q-axis transient time constant (s) | |
tdss0 | d-axis sub-transient time constant (s) | |
tqss0 | q-axis sub-transient time constant (s) | |
sg10 | Saturation function value for 1 p.u | |
sg12 | Saturation function value for 1.2 p.u | |
model_inp | Model type | ‘det’ for Standard Model ‘cls’ for Classical Model |
isat | Flux saturation considered or not | 0 for not considered 1 for considered |
Note:
- The 'ID’ in above ElmSym Section table is used to create the component ID described in I/O Pins for PowerFactory Data.
- With built-in models only round rotor standard and the classical models are supported. The classical model is equivalent to the ‘SynGenGENCLS’ model and the standard model with round rotor is equivalent to ‘SynGenGENROU’ model.
Machines Controller Data
The following models are available in the built-in library:
- Excitation system: avr_EXST1. This model is represented by ExciterEXST1 in built-in library.
- Power system stabilizer: pss_STAB1. This model is represented by StabilizerSTAB1 in built-in library.
- Turbine-governor: gov_TGOV1. This model is represented by TurbineGovernorTGOV1 in built-in library.
Note:
- Up to v2020.4, it was possible to use FMU library with PowerFactory input files to cover a wider range of the control models. This feature has been disabled in the current release.
- Please refer to Mapping to PowerFactory parameters for more details about this disabled feature.
- Parameter "PN" for all Turbine Governor models and "At" for TGOV1 are not imported. Their values must be set to PN = 0 and At = 1.
- Parameter "IPB" for all Stabilizer models and "Kd" for the ones with input code are not imported. Thus, their values must be set to 1.
- The remote bus feature is also not supported in stabilizers with PowerFactory input files.
Switch Data
The switch data comes from StaSwitch section in the XML file. The following tables list the required fields for each section.
Fields from StaSwitch Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Switch name in the section | |
on_off | Switch initial status | 1 for close 0 for open |
Note: The 'ID’ in StaSwitch Section table is used to create the component ID described in I/O Pins for PowerFactory Data.
Two-Winding Transformer Data
The two-winding transformer data comes from ElmTr2 and TypTr2 sections in the XML file. The following tables list the required fields for each section.
Fields from ElmTr2 Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Transformer name in the section | |
outserv | Service status | 0 for in-service 1 for out-of-service |
nntap | Position for “Tap Changer 1” | Any value |
rSbasepu | Resistance on netwrok Sbase (p.u.) | |
xSbasepu | Reactance on network Sbase (p.u.) | |
bSbasepu | Susceptance on network Sbase (p.u.) |
Fields from TypTr2 Section
Entry | Description | Acceptable Values |
strn | Rated power (MVA) | Any value |
utrn_h | HV-Side rated voltage (kv) | |
utrn_l | LV-Side rated voltage (kv) | |
tr2cn_h | HV-Side vector group. | ‘YN’ or ‘D’ |
tr2cn_l | LV-Side vector group. | ‘YN’ or ‘D’ |
nt2ag | Phase shift vector group | Any value |
dutap | Additional voltage per tap | |
phitr | Phase change per tap | |
nntap0 | Neutral tap position | |
ntpmn | Minimum tap position | |
ntpmx | Maximum tap position |
Note: The 'ID’ in ElmTr2 Section table is used to create the component ID described in I/O Pins for PowerFactory Data.
Three-Winding Transformer Data
The three-winding transformer data is obtained from ElmTr3 and TypTr3 sections in the XML file. The following tables list the required fields for each section.
Fields from ElmTr3 Section
Entry | Description | Acceptable Values |
ID | Unique identifier for DGS file | Any value |
loc_name | Transformer name in the section | |
outserv | Service status | 0 for in-service 1 for out-of-service |
n3tap_h | Tap HV-Side: Act. Position in | Any value |
n3tap_m | Tap MV-Side: Act. Position in | |
n3tap_l | Tap LV-Side: Act. Position in | |
rSbasepu_hm | Resistance between HV-MV in Network Sbase (p.u.) | |
rSbasepu_ml | Resistance between MV-LV in Network Sbase (p.u.) | |
rSbasepu_lh | Resistance between LV-HV in Network Sbase (p.u.) | |
xSbasepu_hm | Reactance between HV-MV in Network Sbase (p.u.) | |
xSbasepu_ml | Reactance between MV-LV in Network Sbase (p.u.) | |
xSbasepu_lh | Reactance between LV-HV in Network Sbase (p.u.) | |
bSbasepu | Susceptance in network Sbase (p.u.) |
Fields from TypTr3 Section
Entry | Description | Acceptable Values |
strn3_h | Rated Power: HV-Side (MVA) | Any value |
strn3_m | Rated Power: MV-Side (MVA) | |
strn3_l | Rated Power: LV-Side (MVA) | |
utrn3_h | HV-Side rated voltage (kv) | |
utrn3_m | MV-Side rated voltage (kv) | |
utrn3_l | LV-Side rated voltage (kv) | |
tr3cn_h | HV-Side vector group. | ‘YN’ or ‘D’ |
tr3cn_m | MV-Side vector group. | |
tr3cn_l | LV-Side vector group. | |
nt3ag_h | HV-side phase shift vector group | Any value |
nt3ag_m | MV-side phase shift vector group | |
nt3ag_l | LV-side phase shift vector group | |
du3tp_h | Tap HV-Side: Add. Voltage per Tap | |
du3tp_m | Tap MV-Side: Add. Voltage per Tap | |
du3tp_l | Tap LV-Side: Add. Voltage per Tap | |
n3tp0_h | HV-Side: Neutral Position | |
n3tp0_m | MV-Side: Neutral Position | |
n3tp0_l | LV-Side: Neutral Position | |
i3loc | Magnetizing Impedance |