Common Data

The following attributes are common to all imported components:

Parameter	Description	Acceptable Values
`ID` / `FID`	Unique identifier for DGS-XML file	Any Value
`loc_name`	Location Name. A human readable description of the component	Any Value
`outserv`	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.

This PowerFactory component is mapped to the Bus component of the Native Library.

Parameters from ElmTerm Section

Parameter	Description	Acceptable Values
`uknom`	Nominal Voltage: Line-Line in kV	Any value

Line Data

The Line data comes from ElmLne and TypLne sections in the XML file.

This PowerFactory component is mapped to the Line component of the Native Library.

Parameters from ElmLne Section

Parameter	Description	Acceptable Values
`dline`	Length of Line (km)	Positive Value

Parameters from TypLne Section

Parameter	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

Load Data

The load data comes from ElmLod and TypLod sections in the DGS-XML file.

This PowerFactory component is mapped to the Load component of the Native Library.

Parameters from ElmLod Section

Parameter	Description	Acceptable Values
`plini`	Operating Point: Active Power in MW	Any value
`qlini`	Operating Point: Reactive Power in MVAr
`scale0`	Scaling factor of operating point

Parameters from TypLod Section

Parameter	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.

Notes:

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.

Shunt Data

The shunt data comes from the ElmShnt sections in the DGS-XML file.

This PowerFactory component is mapped to the Positive Sequence Shunt component of the Native Library.

Parameters from ElmShnt Section

Parameter	Description	Acceptable Values
`shtype`	Shunt Type	`1` for RL shunt `2` for C shunt
`rrea`
`xrea`	Impedance
`qcapn`	Rated Capacitive Power

Static Generator Data

The static generator data come from ElmGenstat sections in the DGS-XML file.

This PowerFactory component is mapped to the constant Load component of the Native Library.

Parameters from ElmGenstat Section

Parameter	Description	Acceptable Values
`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	Any value
`scale0`	Dispatch: Scaling Factor	Any value
`av_mode`	Local Controller Mode	Const Q
`iSimModel`	Simulation RMS Model	`4` for 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,

Switch Data

The switch data comes from StaSwitch and ElmCoup section in the DGS-XML file.

This PowerFactory component is mapped to the Switch component of the Native Library.

Parameters from StaSwitch Section

Parameter	Description	Acceptable Values
`on_off`	Switch initial status	`1` for close `0` for open

Two-Winding Transformer Data

The two-winding transformer data comes from ElmTr2 and TypTr2 sections in the DGS-XML file.

This PowerFactory component is mapped to the Positive Sequence Transformer component of the Native Library.

Parameters from ElmTr2 Section

Parameter	Description	Acceptable Values
`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.)

Parameters from TypTr2 Section

Parameter	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` `D`
`tr2cn_l`	LV-Side vector group.	`YN` `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

Three-Winding Transformer Data

The three-winding transformer data is obtained from ElmTr3 and TypTr3 sections in the DGS-XML file.

This PowerFactory component is mapped to the Positive Sequence Transformer component of the Native Library.

Parameters from ElmTr3 Section

Parameter	Description	Acceptable Values
`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.)

Parameters from TypTr3 Section

Parameter	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` `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

Synchronous Machine Data

The synchronous machine data comes from ElmSym and TypSym sections in the DGS-XML file.

This PowerFactory component is mapped to the Synchronous Machine component of the Native Library.

Parameters from ElmSym Section

Parameter	Description	Acceptable Values
`ngnum`	Number of parallel Machines	Any value
`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
`i_mot`	Generator/Motor	Must be `0`: Generator
`phiini`	Initial voltage angle in degree	`-180` to `180`

Parameters from TypSym Section

Parameter	Description	Acceptable Values
`sgn`	Nominal apparent power (MVA)	Any value
`ugn`	Nominal voltage (kV)	Any value
`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: 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.

Machine Controls Data

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.

Excitation Systems

The excitation systems data comes from ElmDsl sections in the DGS-XML file. The following tables outline the required parameters for each excitation system that is accessible through Native Library.

avr_EXST1

This PowerFactory component is mapped to EXST1 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement delay (s)	Any value
`Tb`	Filter Delay Time (s)
`Tc`	Filter Derivative Time Constant (s)
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Kc`	Exciter Current Compensation Factor [pu]
`Kf`	Stabilization Path Gain [pu]
`Tf`	Stabilization Path Delay Time [s]
`Vimin`	Controller Minimum Input [pu]
`Vrmin`	Controller Minimum Output [pu]
`Vimax`	Controller Maximum Output [pu]
`Vrmax`	Controller Maximum Output [pu]

avr_AC7B

This PowerFactory component is mapped to AC7B exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`TR`	Voltage transducer time const [s]	Any value
`TE`	Exciter field time constant [s]
`TF3`	Field current stabilizing feedback time constant [pu]
`TDR`	Voltage regulator differential time constant [s]
`KC`	Rectifier loading factor [pu]
`KD`	Demagnetizing factor [pu]
`KDR`	Voltage regulator differential gain
`KE`	Exciter droop [pu]
`KF1`	Exciter stabilizing feedback gain
`KF2`	Exciter field current feedback gain
`KF3`	Exciter field current feedback gain
`KIA`	Field current loop integral gain
`KIR`	Voltage regulator integral gain
`KL`	Current loop limitation factor [pu]
`KP`	Potential circuit gain coefficient
`KPA`	Field current loop proportional gain
`KPR`	Voltage regulator proportional gain
`VAMIN`	Field current loop minimum output [pu]
`VAMAX`	Field current loop maximum output [pu]
`VRMIN`	Voltage regulator minimum output [pu]
`VRMAX`	Voltage regulator maximum output [pu]
`VFEMIN`	Minimum exciter output voltage [pu]
`VFEMAX`	Exciter field current limit reference [pu]
`E1`	Field Voltage for SEI [pu]
`E2`	Field Voltage for SE2 [pu]
`SE1`	Saturation at E1 [pu]
`SE2`	Saturation at E2 [pu]

avr_ESDC1A

This PowerFactory component is mapped to ESDC1A exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`E1`	Saturation Factor 1 [pu]	Any value
`E2`	Saturation Factor 3 [pu]
`Ka`	Controller Gain [pu]
`Ke`	Excitor Constant [pu]
`Kf`	Stabilization Path Gain [pul
`Se1`	Saturation Factor 3 [pu]
`Se2`	Saturation Factor 4 [pu]
`Ta`	Controller Time Constant [s]
`Tb`	Filter Delay Time Constant [s]
`Tc`	Filter Derivative Time Constant [s]
`Te`	Excitor Time Constant [s]
`Tf1`	Stabilization Path Time Constant [s]
`Tr`	Measurement Delay [s]
`Vrmin`	Controller Minimum Output [pu]
`Vrmax`	Controller Maximum Output [pu]

avr_EXAC1A

This PowerFactory component is mapped to EXAC1 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Tb`	Filter Delay Time [s]
`Tc`	Filter Derivative Time Constant [s]
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Te`	Exciter Time Constant [s]
`Kf`	Stabilization Path Gain [pu]
`Tf`	Stabilization Path Delay Time [s]
`Kc`	Rectifier Regulation Constant [s]
`Kd`	Exciter Armature reaction Factor [pu]
`E1`	Saturation Factor 1 [pu]
`Se1`	Saturation Factor 1 [pu]
`E2`	Saturation Factor 3 [pu]
`Se2`	Saturation Factor 4 [pu]
`Ke`	Exciter Constant [pu]
`Vrmin`	Controller Minimum Output [pu]
`Vrmax`	Controller Maximum Output [pu]

avr_ESST4B

This PowerFactory component is mapped to ESST4B exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Time Constant [s]	Any value
`Kp`	Voltage Component (Magnitude) [pu]
`thetaP`	Voltage Component (angle) [deg.]
`Kir`	PI Time Constant [1/s]
`Kpm`	Forward Gain inner loop [pu]
`Kim`	Forward Time Constant inner loop [1/s]
`Ta`	Controller Time Constant [s]
`Kg`	Feedback Gain inner loop [pu]
`Vrmin`	Voltage Regulator Minimum Output [pu]
`Ta`	Controller Time Constant [s]
`Kg`	Feedback Gain inner loop [pu]
`thetaP`	Exciter Maximum Output [pu]
`Vrmin`	Voltage Regulator Minimum Output [pu]
`Vmmin`	Forward Minimum Output [pu]
`Vmmax`	Forward Maximum Output [pu]
`Vbmax`	Exciter voltage limit [pu]
`Vrmax`	Voltage Regulator Maximum Output [pu]

avr_ESST1A

This PowerFactory component is mapped to ESST1A exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Tb`	Filter 1st Delay Time Constant [s]
`Tc`	Filter 1st Derivative Time Constant [s]
`Tb1`	Filter 2nd Delay Time Constant [s]
`Tc1`	Filter 2nd Derivative Time Constant [s]
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Kc`	Current Limiter Factor [pu]
`Kf`	Stabilization Path Gain [pu]
`Tf`	Stabilization Path Time Constant [s]
`Klr`	Current Input Factor [pu]
`Ilr`	Exciter Maximum Output [pu]
`Vos`	PSS Input Selector [pu]
`Vel`	Uel Input Selector [pu]
`Vimin`	Controller Input Minimum [pu]
`Vamin`	Controller Minimum Output [pu]
`Vrmin`	Exciter Minimum Output [pu]
`Vrmax`	Exciter Maximum Output [pu]
`Vimax`	Controller Input Maximum [pu]
`Vamax`	Controller Maximum Output [pu]

avr_EXDC2

This PowerFactory component is mapped to EXDC2 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Tb`	Filter Delay Time [pu]
`Tc`	Filter Derivative Time Constant [s]
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Kc`	Exciter Current Compensation Factor [pu]
`Kf`	Stabilization Path Gain [pu]
`E1`	Saturation Factor 1 [pu]
`Se1`	Saturation Factor 2 [pu]
`E2`	Saturation Factor 3 [pu]
`Se2`	Saturation Factor 4 [pu]
`Te`	Exciter Time Constant [s]
`Kf`	Stabilization Path Gain [pu]
`Tf1`	Stabilization Path Time Constant [s]
`Ke`	Exciter Constant [pu]

avr_EXAC4

This PowerFactory component is mapped to EXAC4 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Tb`	Filter Delay Time [s]
`Tc`	Filter Derivative Time Constant [s]
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Kc`	Exciter Current Compensation Factor [pu]
`Vimin`	Controller Minimum Input [pu]
`Vrmin`	Exciter Minimum Output [pu]
`Vimax`	Controller Maximum Input [pu]
`Vrmax`	Exciter Maximum Output [pu]

avr_EXPIC1

This PowerFactory component is mapped to EXPIC1 exciter of the native library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta1`	Controller Time Constant [s]
`Ta2`	Filter 1th Delay Time [s]
`Ta3`	Filter Derivative Time Constant [s]
`Ta4`	Filter 2th Delay Time [s]
`Kf`	Stabilization Path Gain [pu]
`Tf1`	Stabilization Path 1th Time Constant [s]
`Tf2`	Stabilization Path 2th Time Constant [s]
`E1`	Saturation Factor 1 [pu]
`Se1`	Saturation Factor 2 [pu]
`E2`	Saturation Factor 3 [pu]
`Se2`	Saturation Factor 4 [pu]
`Te`	Exciter Time Constant [s]
`Kp`	Voltage Factor [pu]
`Ki`	Current Factor [pu]
`Kc`	Excitation Current Factor [pu]
`Ke`	Excitation Constant [pu]
`Vr2`	Controller Minimum [pu]
`Vrmin`	Controller Minimum Output [pu]
`Efdmin`	Excitdr Minimum Output [pu]
`Vr1`	Controller Maximum [pu]
`Vrmax`	Controller Maximum Output [pu]
`Efdmax`	Exciter Maximum Output [pu]

avr_EXST1

This PowerFactory component is mapped to EXST1 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta1`	Controller Time Constant [s]
`Ta2`	Filter 1th Delay Time [s]
`Ta3`	Filter Derivative Time Constant [s]
`Ta4`	Filter 2th Delay Time [s]
`Kf`	Stabilization Path Gain [pu]
`Tf1`	Stabilization Path 1th Time Constant [s]
`Tf2`	Stabilization Path 2th Time Constant [s]
`E1`	Saturation Factor 1 [pu]
`Se1`	Saturation Factor 2 [pu]
`E2`	Saturation Factor 3 [pu]
`Se2`	Saturation Factor 4 [pu]
`Te`	Exciter Time Constant [s]
`Kp`	Voltage Factor [pu]
`Ki`	Current Factor [pu]
`Kc`	Excitation Current Factor [pu]
`Ke`	Excitation Constant [pu]
`Vr2`	Controller Minimum [pu]
`Vrmin`	Controller Minimum Output [pu]
`Efdmin`	Exciter Minimum Output [pu]
`Vr1`	Controller Maximum [pu]
`Vrmax`	Controller Maximum Output [pu]
`Efdmax`	Exciter Maximum Output [pu]

avr_EXST2

This PowerFactory component is mapped to EXST2 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Ke`	Exciter Constant [pu]
`Te`	Exciter Time Constant [s]
`Kf`	Saturation Path Gain [pu]
`Tf`	Stabilization Path Time Constant [s]
`Kp`	Voltage Factor [pu]
`Ki`	Current Factor [pu]
`Kc`	Excitation Current Factor [pu]
`Vrmin`	Controller Output Minimum [pu]
`Vrmax`	Controller Output Maximum [pu]
`Efdmax`	Exciter Maximum Output [pu]

avr_EXST3

This PowerFactory component is mapped to EXST3 exciter of the native library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Kj`	Input Filter Factor [pu]
`Tb`	Input Filter Delay Time [s]
`Tc`	Input Filter Derivative Time Constant [s]
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Kg`	Stabilization Path Gain [pu]
`Kc`	Excitation Current Factor [s]
`Kp`	Voltage Component (magnitude) [pu]
`thetaP`	Voltage Component (angle) [pu]
`Ki`	Current Factor [pu]
`Xl`	Voltage Sensing Path Reactance [pu]
`Vimin`	Controller Input Minimum [pu]
`Vrmin`	Controller Output Minimum [pu]
`Vimax`	Controller Input Maximum [pu]
`Vrmax`	Controller Output Maximum [pu]
`EFDmax`	Exciter Maximum Output [pu]
`Vgmax`	Stabilization Path Maximum [pu]

avr_ESAC5A

This PowerFactory component is mapped to ESAC5A exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Ke`	Exciter Constant [pu]
`Te`	Exciter Time Constant [s]
`Kf`	Stabilization Path Gain [pu]
`Tf1`	Stabilization Path 1th Time Constant [s]
`Tf2`	Stabilization Path 2th Time Constant [s]
`Tf3`	Stabilization Path 3th Time Constant [s]
`Tf4`	Stabilization Path 4th Time Constant [s]
`E1`	Saturation Factor 1 [pu]
`Se1`	Saturation Factor 2 [pu]
`E2`	Saturation Factor 3 [pu]
`Se2`	Saturation Factor 4 [pu]
`Vrmin`	Controller Minimum Output [pu]
`Vrmax`	Controller Input Maximum [pu]

avr_ESAC1A

This PowerFactory component is mapped to ESAC1A exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tb`	Filter Delay Time [s]	Any value
`Tc`	Filter Derivative Time Constant [s]
`Tr`	Measurement Delay [s]
`Ka`	Controller Gain [p.u.]
`Ta`	Controller Time Constant [s]
`Kf`	Controller Gain [p.u.]
`Tf`	Stabilization Path Time Constant [s]
`Kf`	Stabilization Path Gain [p.u.]
`Te`	Excitor Time Constant [s]
`Kc`	Rectifier Regulation Constant [p.u.]
`Ke`	Excitor Constant [p.u.]
`Kd`	Armature Reaction Constant [p.u.]
`E1`	Saturation Factor 1 [pu]
`SEI`	Saturation Factor 2 [pu]
`E2`	Saturation Factor 3 [pu]
`SE2`	Saturation Factor 4 [pu]
`Vamin`	Amplifier Minimum Output [p,u.]
`Vrmin`	Controller Minimum Output [p.u.]
`Vamax`	Amplifier Maximum Output [p,u.]
`Vrmax`	Controller Minimum Output [p.u.]

avr_ESAC8B

This PowerFactory component is mapped to ESAC8B exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Time Constant [s]	Any value
`KP`	Proportional Gain [pu]
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Ke`	Exciter Constant [s]
`Te`	Exciter Time Constant [s]
`E1`	Saturation Factor 1 [pu]
`SeI`	Saturation Factor 2 [pu]
`E2`	Saturation Factor 3 [pu]
`Se2`	Saturation Factor 4 [pu]
`KD`	Derivative Gain [pu]
`TD`	Time Const. Derivative Action [s]
`VRMIN`	Controller Minimum Output [pu]
`VRMAX`	Controller Maximum Output [pu]

avr_ESAC6A

This PowerFactory component is mapped to ESAC6A exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Voltage transducer time const [s]	Any value
`Ta`	Amplifier time const [s]
`Ka`	Amplifier gain [pu]
`Te`	Exciter time Const [s]
`E1`	Field Voltage SE1 [pu]
`SE1`	Saturation function 1 [pu]
`E2`	Field Voltage SE2 [pu]
`SE2`	Saturation function 2 [pu]
`Th`	Damping module lag time const [s]
`Tj`	Damping module lead time const [s]
`Kh`	Damping module gain [pu]
`KD`	Armature reaction constant [pu]
`KC`	Rectifier regulation constant [pu]
`Vfelim`	Voltage saturation limits [pu]
`KE`	Exciter droop [pu]
`Tb`	First Lag time const [s]
`Tc`	First Lead time const [s]
`Vrmin`	Voltage regulation minimum [pu]
`Vamin`	Voltage amplifier minimum [pu]
`Vhmax`	Damping module limiter [pu]
`Vrmax`	Voltage regulation maximum [pu]
`Vamax`	Voltage amplifier maximum [pu]

avr_ESDC2A

This PowerFactory component is mapped to ESDC2A exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Tb`	Filter Delay Time [s]
`Tc`	Filter Derivative Time Constant [s]
`Ka`	Controller Gain [p.u.]
`Ta`	Controller Time Constant [s]
`Te`	Exciter Time Constant [s]
`Ke`	Exciter Constant [p.u.]
`E1`	Saturation function 1 [pu]
`SE1`	Saturation function 2 [pu]
`E2`	Saturation function 3 [pu]
`SE2`	Saturation function 4 [pu]
`Kf`	Stabilization Path Gain [p.u.]
`Tf1`	Stabilization Path Time Constant [s]
`Vrmin`	Controller Minimum Output [pu]
`Vrmax`	Controller Maximum Output [pu]

avr_IEEET1

This PowerFactory component is mapped to IEEET1 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Ke`	Exciter Constant [pu]
`Te`	Exciter Time Constant [s]
`Kf`	Stabilization Path Gain [pu]
`Tf`	Stabilization Path Time Constant [s]
`E1`	Saturation function 1 [pu]
`Se1`	Saturation function 2 [pu]
`E2`	Saturation function 3 [pu]
`Se2`	Saturation function 4 [pu]
`Vrmin`	Controller Output Minimum [pu]
`Vrmax`	Controller Output Maximum [pu]

avr_IEEET2

This PowerFactory component is mapped to IEEET2 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Ke`	Exciter Constant [pu]
`Te`	Exciter Time Constant [s]
`Kf`	Stabilization Path Gain [pu]
`Tf`	Stabilization Path Time Constant [s]
`E1`	Saturation function 1 [pu]
`Se1`	Saturation function 2 [pu]
`E2`	Saturation function 3 [pu]
`Se2`	Saturation function 4 [pu]
`Vrmin`	Controller Output Minimum [pu]
`Vrmax`	Controller Output Maximum [pu]

avr_IEEEX1

This PowerFactory component is mapped to IEEEX1 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Tb`	Filter Delay Time [s]
`Tc`	Filter Derivative Time Constant [s]
`Te`	Exciter Time Constant [s]
`Kf`	Stabilization Path Gain [pu]
`Tf1`	Stabilization Path Delay Time [s]
`E1`	Saturation function 1 [pu]
`Se1`	Saturation function 2 [pu]
`E2`	Saturation function 3 [pu]
`Se2`	Saturation function 4 [pu]
`Ke`	Exciter Constant [pu]
`Vrmin`	Controller Output Minimum [pu]
`Vrmax`	Controller Output Maximum [pu]

avr_IEEEX2

This PowerFactory component is mapped to IEEEX2 exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Delay [s]	Any value
`Ka`	Controller Gain [pu]
`Ta`	Controller Time Constant [s]
`Tb`	Filter Delay Time [s]
`Tc`	Filter Derivative Time Constant [s]
`Te`	Exciter Time Constant [s]
`Kf`	Stabilization Path Gain [pu]
`Tf1`	Stabilization Path 1th Delay Time [s]
`Tf2`	Stabilization Path 2th Delay Time [s]
`E1`	Saturation function 1 [pu]
`Se1`	Saturation function 2 [pu]
`E2`	Saturation function 3 [pu]
`Se2`	Saturation function 4 [pu]
`Ke`	Exciter Constant [pu]
`Vrmin`	Controller Minimum Output [pu]
`Vrmax`	Controller Maximum Output [pu]

avr_IVOEX

This PowerFactory component is mapped to IVOEX exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`K1`	First Block Gain [pu]	Any value
`A1`	First Block Factor 1 [pu]
`T1`	First Block Derivative Time Constant [s]
`A2`	First Block Factor 2 [pu]
`T2`	First Block Delay Time Constant [s]
`K3`	Second Block Gain [pu]
`A3`	Second Block Factor 1 [pu]
`T3`	Second Block Derivative Time Constant [s]
`A4`	Second Block Factor 2 [pu]
`T4`	Second Block Delay Time Constant [s]
`K5`	Third Block Gain [pu]
`A5`	Third Block Factor 1 [pu]
`T5`	Third Block Derivative Time Constant [s]
`A6`	Third Block Factor 2 [pu]
`T6`	Third Block Delay Time Constant [s]
`MIN1`	First Block Lower Limit [pu]
`MIN3`	Second Block Lower Limit [pu]
`MIN5`	Third Block Lower Limit [pu]
`MAX1`	First Block Upper Limit [pu]
`MAX3`	Second Block Upper Limit [pu]
`MAX5`	Third Block Upper Limit [pu]

avr_REXSYS

This PowerFactory component is mapped to REXSYS exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Voltage transducer time constant [s]	Any value
`Kd`	Exciter regulation factor [pu]
`Kc`	Rectifier regulation factor [pu]
`E1`	Exciter flux at knee of curve [pu]
`SE1`	Saturation factor at knee [pu]
`E2`	Maximum exciter [pu]
`SE2`	Saturation factor at maximum flux [pu]
`Ke`	Exciter field proportional gain [s]
`Tp`	Field current bridge time constant [s]
`F1imf`	Power Supply limit factor [s]
`Ta`	Voltage regulator time constant [pu]
`Kh`	Field voltage controller feedback gain [pu]
`Kip`	Field current regulator proportional gain [pu]
`Kii`	Field current regulator integral gain [1/s]
`Kvp`	Voltage regulator proportional gain [pu]
`Kvi`	Voltage regulator integral gain [1/s]
`Vimax`	Voltage regulator input Limit [pu]
`Tb2`	Lag-time constant [s]
`Tc2`	Lead-time constant [s]
`Tf2`	Feedback Lag-time constant [s]
`Tf1`	Feedback Lead-time constant [s]
`Tb1`	Lag-time constant [s]
`Tc1`	Lead-time constant [s]
`Kf`	Rate feedback gain [pu]
`Tf`	Rate feedback>o time constant [s]
`Fbf`	0:Vr; 1:Ife; 2:Efd [0, 1, 2]	Integer values [0, 1, 2]
`Te`	Exciter field time constant [s]	Any value
`Vfmin`	Minimum exciter field current [pu]
`Vrmin`	Minimum controller output [pu]
`Vfmax`	Maximum exciter field current [pu]
`Vrmax`	Maximum controller output [pu]

avr_SCRX

This PowerFactory component is mapped to SCRX exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tb`	Filter Delay Time [s]	Any value
`Ta`	Filter Derivative Time Constant [s]
`K`	Controller Gain [pu]
`Te`	Exciter Time Constant [s]
`rc_rfd`	Crowbar resistor factor. [pu]
`Emin`	Controller Minimum Output [pu]
`Emax`	Controller Maximum Output [pu]
`Cswitch`	Cswitch [0, 1]	Integer values [0 , 1]

avr_SEXS

This PowerFactory component is mapped to SEXS exciter of the native library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tb`	Filter Delay Time [s]	Any value
`Ta`	Filter Derivative Time Constant [s]
`K`	Controller Gain [pu]
`Te`	Exciter Time Constant [s]
`Emin`	Controller Minimum Output [pu]
`Emax`	Controller Maximum Output [pu]

avr_ST5B

This PowerFactory component is mapped to ST5B exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Regulator input filter time constant [s]	Any value
`TB1`	Lag time constant of 1st lead-lag block (avr channel) [s]
`TC1`	lead time constant of 1st lead-lag block (avr channel) [s]
`Kr`	Voltage regulator gain [pu]
`TB2`	lag time constant of 2nd lead-lag block (avr channel) [s]
`TC2`	lead time constant of 2nd lead-lag block (avr channel) [s]
`TUB1`	lag time constant of 1st lead-lag block (uel channel) [s]
`TUC1`	lead time constant of 1st lead-lag block (uel channel) [s]
`TUB2`	lag time constant of 2nd lead-lag block (uel channel) [s]
`TUC2`	lead time constant of 2nd lead-lag block (uel channel) [s]
`TOB1`	lag time constant of 1st lead-lag block (oel channel) [s]
`TOC1`	lead time constant of 1st lead-lag block (oel channel) [s]
`Kc`	Current compensation factor [pu]
`T1`	Voltage regulator time constant [s]
`Kterm_fed`	Terminal fed flag [1/0]	integer values [0 , 1]
`Vrmin`	Vrmin	Any value
`VRmin`	Voltage regulator minimum limit [pu]
`VRmax`	Voltage regulator maximum limit [pu]

avr_ST6B

This PowerFactory component is mapped to ST6B exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Input filter time constant [s]	Any value
`Kpa`	Regulator proportional gain [pu]
`Kia`	Regulator integral gain [pu]
`Kda`	Regulator derivative gain [pu]
`Tda`	Regulator derivative time constant [s]
`ILR`	Exciter current limit reference [pu]
`Klr`	Exciter output current limiter gain [pu]
`Kci`	Exciter output current limit adjustment gain [pu]
`Kff`	Field regulator inner loop pre-control gain [pu]
`Km`	Field regulator inner loop forward gain [pu]
`Kg`	Voltage regulator feedback gain [pu]
`Tg`	Voltage regulator feedback time constant [s]
`Term_fed`	Terminal fed flag [1/0]
`OEL_flag`	OEL router selector [1/2	Integer values [1, 2]
`Term_fed`	Terminal fed flag [1/0]	Integer values [0 , 1]
`VAmin`	Regulator output minimum limit [pu]	Any value
`VRmin`	Voltage regulator minimum limit [pu]
`VAmax`	Regulator output maximum limit [pu]
`VRmax`	Voltage regulator maximum limit [pu]

avr_ST6B

This PowerFactory component is mapped to ST6B exciter of the native library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Input filter time constant [s]	Any value
`Kpa`	Regulator proportional gain [pu]
`Kia`	Regulator integral gain [pu]
`Kda`	Regulator derivative gain [pu]
`Tda`	Regulator derivative time constant [s]
`ILR`	Exciter current limit reference [pu]
`Klr`	Exciter output current limiter gain [pu]
`Kci`	Exciter output current limit adjustment gain [pu]
`Kff`	Field regulator inner loop pre-control gain [pu]
`Km`	Field regulator inner loop forward gain [pu]
`Kg`	Voltage regulator feedback gain [pu]
`Tg`	Voltage regulator feedback time constant [s]
`Term_fed`	Terminal fed flag [1/0]
`OEL_flag`	OEL router selector [1/2	Integer values [1, 2]
`Term_fed`	Terminal fed flag [1/0]	Integer values [0 , 1]
`VAmin`	Regulator output minimum limit [pu]	Any value
`VRmin`	Voltage regulator minimum limit [pu]
`VAmax`	Regulator output maximum limit [pu]
`VRmax`	Voltage regulator maximum limit [pu]

avr_ST7B

This PowerFactory component is mapped to ST7B exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`UEL_flag`	UEL router selector [1/3]	Integer values [1/3]
`OEL_flag`	OEL router selector [1/3]	Integer values [1/3]
`Kl`	Feedback gain [pu]	Any value
`Kh`	Feedback gain [pu]
`Kpa`	Voltage regulator gain [pu]
`Tr`	Input filter time constant [s]
`Tb`	Voltage regulator lag time constant [s]
`Tc`	Voltage regulator lead time constant [s]
`Tf`	Voltage input lag time constant [s]
`Tg`	Voltage input lead time constant [s]
`Kia`	First-order feedback gain [pu]
`Tia`	First-order feedback time constant [s]
`Vmin`	Voltage reference minimum limit [pu]
`VRmin`	Voltage regulator minimum limit [pu]
`Vmax`	Voltage reference maximum limit [pu]
`VRmax`	Voltage regulator maximum limitg [pu]
`VAmin`	Regulator output minimum limit [pu]
`VRmin`	Voltage regulator minimum limit [pu]
`VAmax`	Regulator output maximum limit [pu]
`VRmax`	Voltage regulator maximum limit [pu]

avr_URST5T

This PowerFactory component is mapped to URST5T exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tr`	Measurement Time Constant [s]	Any value
`Tb1`	Lag-time constant [s]
`Tc1`	Lead-time constant [s]
`Kr`	Controller Gain [pu]
`Tb2`	Lag-time constantt [s]
`Tc2`	Voltage regulator lead time constant [s]
`T1`	Controller time constant [s]
`Kc`	Rectifier loading factor [pu]
`Vrmin`	Voltage Regulator Minimum Output [pu]
`Vrmax`	Voltage Regulator Maximum Output [pu]

Limiter Exciter

uel_UEL1

This PowerFactory component is mapped to UEL1 limiter exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Kur`		Any value
`Kuc`
`Kuf`
`Kul`
`Kui`
`Tu2`
`Tu1`
`Tu4`
`Tu3`
`VUImin`
`VULmin`
`VURmax`
`VUCmax`
`VUImax`
`VULmax`

uel_UEL2

This PowerFactory component is mapped to UEL2 limiter exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`k`	k-exponent (=0,=1 or =2) [0/1/2]	Integer values [0, 1, 2]
`Tuv`		Any value
`Tup`
`Tuq`
`Kuf`
`Kfb`
`Tul`
`Kul`
`Kui`
`Tu2`
`Tu1`
`Tu4`
`Tu3`
`VUImin`
`VULmin`
`VUImax`
`VULmax`

oel_MAXEX1

This PowerFactory component is mapped to MAXEX1 limiter exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Kmx`	OEL Gain [pu]	Any value
`EFD1`	Over Excitation Relay - Voltage First Value of Curve [p.u.]
`TIME1`	Over Excitation Relay - Time First Value of Curve [s]
`EFD2`	Over Excitation Relay - Voltage Second Value of Curve [p.u.]
`TIME2`	Over Excitation Relay - Time Second Value of Curve [s]
`EFD3`	Over Excitation Relay - Voltage Three Value of Curve [p.u.]
`TIME3`	Over Excitation Relay - Time Three Value of Curve [s]
`EFDdes`	Minimum Exctation to Enable OEL [p.u.]
`EFDres`	EDF Rated [p.u.]
`Vlow`	Maximum OEL signal [p.u.]

oel_MAXEX2

This PowerFactory component is mapped to MAXEX2 limiter exciter of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Kmx`	OEL Gain [pu]	Any value
`L`	0 for EFD limiting, 1 for IFD limiting [0/1]
`TIME1`	Over Excitation Relay - Time First Value of Curve [s]
`XFDdes`	Minimum Exctation to Enable OEL [p.u.]
`XFDres`	XFD Rated [p.u.]
`XFD1`	Over Excitation Relay - Voltage/Current First Value of Curve [p.u.]
`XFD2`	Over Excitation Relay - Voltage/Current Second Value of Curve [p.u.]
`TIME2`	Over Excitation Relay - Time Second Value of Curve [s]
`XFD3`	Over Excitation Relay - Voltage/Current Three Value of Curve [p.u.]
`TIME3`	Over Excitation Relay - Time Three Value of Curve [s]
`Vlow`	Maximum OEL signal [p.u.]

Turbine and Governors

The turbine-governor data comes from ElmSym section in the DGS-XML file. The following tables outline the required parameters for each turbine-governor that is accessible through the Native Library.

gov_GAST

This PowerFactory component is mapped to Turbine and Governor component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`R`	Speed Droop [pu]	Any value
`T1`	Controller Time Constant [s]
`T2`	Actuator Time Constant [s]
`T3`	Compressor Time Constant [s]
`AT`	Ambient Temperature Load Limit [pu]
`Kt`	Turbine Factor [pu]
`Dturb`	frictional losses factor pu [pu]
`PN`	Turbine Rated Power (=0→PN=Pgnn) [MW]
`Vmin`	Controller Minimum Output [pu]
`Vmax`	Controller Maximum Output [pu]

gov_GAST2A

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Ecr`	Fuel System Delay [s]	Any value
`T`	Fuel Control Delay Time [s]
`K3`	Turbine Factor [pu]
`Tf`	Fuel System Delay [s]
`Tcd`	Turbine Time Delay [s]
`K6`	Compressor Factor [pu]
`Kf`	Fuel System Feed Back Factor [pu]
`K4`	Radiation Shield Prop. Factor [pu]
`K5`	Radiation Shield Integr Factor [pu]
`T3`	Radiation Shield Time Constant [s]
`W`	Speed Controller Gain [pu]
`X`	Speed Controller Der. Time Const. [s]
`Z`	Speed Controller Is/Dr (0/1) [s]
`Y`	Speed Controller Time Constant [s]
`Tt`	Temperature Controller Time Constant [s]
`T5`	Temperature Controller Gain [pu]
`T4`	Thermocouple Time Constant [s]
`af2`	Turbine Characteristic. Constant [pu]
`bf2`	Turbine Characteristic. Torque [pu]
`cf2`	Turbine Characteristic, Speed [pu]
`Etd`	Temperature Controller Delay [s]
`Tr`	Rated Exhaust Temperature [grd.F]
`af1`	Turbine 1th Factor [pu]
`bf1`	Turbine 2th Factor [pu]
`a`	Fuel System Prop. Characteristic [pu]
`b`	Fuel System Time Constant [s]
`c`	Fuel System I/L Factor (0/1) [-]
`Tc`	Temperature Control [grd.F]
`Trate`	Turbine Rated Power (=0→ PN=Pgnn) [MW]
`Min`	VCE Lower Limit [pu]
`Max`	VCE Upper Limit [pu]

gov_GGOV1

This PowerFactory component is mapped to Turbine and Governor component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Ldref`	Load Limiter Reference Value [pu]	Any value
`Kturb`	Turbine Gain [pu]
`Wfnl`	No Load Fuel Flow [pu]
`Kpload`	Load Limiter Proportional Gain [pu]
`Tfload`	Load Limiter Time Constant [s]
`Tsa`	Temperature Detection Lead Time Constant [s]
`Tsb`	Temperature Detection Lag Time Constant [s]
`Ka`	Acceleration Limiter Gain [pu/s]
`Ta`	Acceleration Limiter Time Constant [s]
`Kimw`	Power Controller Reset Gain [pu]
`Tpelec`	Electrical Power Transducer time constant [s]
`Rselect`	Governer Droop Feedback Signal Selector [-]
`Aset`	Acceleration Limiter Setpoint [pu/s]
`r`	Permanent Droop [pu]
`db`	Speed Governor Deadband [pu]
`Kpgov`	Governor Proportional Gain [pu]
`Kigov`	Governor Integral Gain [pu]
`Kdgov`	Governor Derivative Gain [pu]
`Tdgov`	Governor Derivative Controller Time Constant [s]
`Tact`	Actuator Time Constant [s]
`Trate`	Turbine Rated Power (=0→PN=Pgnn) [MW]
`Dm`	Mechanical Damping Coefficient [pu]
`Flag`	Switch for Fuel Source Coefficient [-]
`bf1`	Turbine 2th Factor [pu]
`Teng`	Diesel Engine Transport Time Constant [s]
`Tc`	Turbine Lead Time Constant [s]
`Tb`	Turbine Lag Time Constant [s]
`Tc`	Temperature Control [grd.F]
`Kiload`	Load Limiter Integral Gain [pu]
`rdown`	Maximum Rate of Load Limit Decrease [pu/s]
`minerr`	Minimum Speed Error Signal [pu]
`Vmin`	Minimum Valve Position Limit [pu]
`rclose`	Maximum Valve Closing Rate [pu/s]
`rup`	Maximum Rate of Load Limit Increase [pu/s]
`maxerr`	Maximum Speed Error Signal [pu]
`Vmax`	Maximum Valve Position Limit [pu]
`ropen`	Maximum Valve Opening Rate [pu/s]

gov_HYGOV

This PowerFactory component is mapped to the Turbine and Governor component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`r`	Temporary Droop [pu]	Any value
`Tr`	Governor Time Constant [s]
`Tf`	Filter Time Constant [s]
`Tg`	Servo Time Constant [s]
`Tw`	Water Starting Time [s]
`At`	Turbine Gain [pu]
`Dturb`	frictional losses factor pu [pu]
`qnl`	No Load Flow [pu]
`R`	Permanent Droop [pu]
`PN`	Turbine Rated Power (=0->PN=Pgnn) [Mw]
`Gmin`	Minimum Gate Limit [pu]
`Velm`	Gate Velocity Limit [pu]
`Gmax`	Maximum Gate Limit [pu]

gov_IEEEG1

This PowerFactory component is mapped to the Turbine and Governor component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`K`	Controller Gain [pu]	Any value
`T1`	Governor Time Constant [s]
`T2`	Governor Derivative Time Constant [s]
`T3`	Servo Time Constant [s]
`K1`	High-Pressure Turbine Factor [pu]
`K2`	High-Pressure Turbine Factor [pu]
`T5`	Intermediate Pressure Turbine Time Constant [s]
`K3`	Intermediate Pressure Turbine Factor [pu]
`K4`	Intermediate Pressure Turbine Factor [pu]
`T6`	Medium Pressure Turbine Time Constant [s]
`K5`	Medium Pressure Turbine Factor [pu]
`K6`	Medium Pressure Turbine Factor [pu]
`T4`	High-Pressure Turbine Time Constant [s]
`T7`	Low-Pressure Turbine Time Constant [s]
`K7`	Low-Pressure Turbine Factor [pu]
`K8`	Low-Pressure Turbine Factor [pu]
`PNhp`	HP Turbine Rated Power (=0->PNhp=PgnnHp) [MW]
`PNlp`	LP Turbine Rated Power (=0->PNhp=Pgnnlp) [MW]
`Uc`	Valve Closing Time [pu/s]
`Pmin`	Minimum Gate Limit [pu]
`Uo`	Valve Opening Time [pu/s]
`Pmax`	Maximum Gate Limit [pu]

gov_IEEEG2

This PowerFactory component is mapped to IEEEG2 turbine governor of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`K`	Controller Gain [pu]	Any value
`T1`	Governor Time Constant [s]
`T2`	Governor Derivative Time Constant [s]
`T3`	Servo Time Constant [s]
`T4`	Water Starting Time [s]
`PN`	Turbine Rated Power (=0→PN=Pgnn) [MW]
`Pmin`	Minimum Gate Limit [pu]
`Pmax`	Maximum Gate Limit [pu]

gov_IEEEG3

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tg`	Gate Servomotor Time Constant [s]	Any value
`Tp`	Pilot Valve Time Constant [s]
`Sigma`	Permanent Droop [pu]
`Delta`	Temporary Droop [pu]
`Tr`	Governor Time Constant [s]
`a11`	Waterhammer 1th Factor [pu]
`a13`	Waterhammer 2th Factor [pu]
`a21`	Waterhammer 3th Factor [pu]
`a23`	Waterhammer 4th Factor [pu]
`Tw`	Water Starting Time [s]
`PN`	Turbine Rated Power (=0→PN=Pgnn) [MW]
`Uc`	Valve Closing Time [pu/s]
`Pmin`	Minimum Gate Limit [pu]
`Uo`	Valve Opening Time [pu/s]
`Pmax`	Maximum Gate Limit [pu]

gov_IEESGO

This PowerFactory component is mapped to the Turbine and Governor component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`T1`	Governor Time Constant [s]	Any value
`T2`	Governor Derivative Time Constant [s]
`K1`	Controller Gain [pu]
`T3`	Servo Time Constant [pu]
`T4`	Steam Chest & Inlet Piping Time Constant [s]
`K3`	Low-Pressure Turbine Factor [pu]
`T6`	Interm. & Low-Pressure Turbine Time Constant [s]
`K2`	High-Pressure Turbine Factor [pu]
`T5`	Reheater Time Constant [pu]
`PN`	Turbine Rated Power (=0→PN=Pgnn) [MW]
`Pmin`	Minimum Gate Limit [pu]
`Pmax`	Maximum Gate Limit [pu]

gov_PIDGOV

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tw`		Any value
`Atw`
`Gmax`
`Tb`
`G0`
`G1`
`G2`
`P1`
`P2`
`P3`
`Ta`
`Kp`
`Ki`
`Kd`
`Dturb`
`Flag`
`PN`	Turbine Rated Power (=0→PN=Pgnn) [MW]
`Rperm`
`Treg`
`Gmin`
`Velmin`
`Velmax`

gov_TGOV1

This PowerFactory component is mapped the Turbine and Governor component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`T3`	Turbine Delay Time Constant [s]	Any value
`T2`	Turbine Derivative Time Constant [s]
`At`	Turbine power coefficient [pu]
`Dt`	Frictional Losses Factor [pu]
`R`	Controller Droopr [pu]
`T1`	Governor Time Constant [s]
`Vmin`	Minimum Gate Limit [pu]
`Vmax`	Maximum Gate Limit [pu]
`PN`	Turbine Rated Power (=0→PN=Pgnn) [MW]

gov_TGOV2

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`R`	Controller Droop [pu]	Any value
`T1`	Governor Time Constant [s]
`K`	Fraction of the turbine power not involved in the fast valving [pu]
`T3`	Reheater Time Constant [s]
`Tt`	Power fall Time Constant [s]
`Dt`	Frictional Losses Factor [pu]
`dwfv`	Speed deviation to begin fast valving [pu]
`Ta`	Time of full close of intercept valve [s]
`Tb`	Time of remain close of intercept valve [s]
`Tc`	Time of full open of intercept valve [s]
`PN`	Turbine Rated Power(=0→PN=Pgnn) [MW]
`Vmin`	Minimum Gate Limit [pu]
`Vmax`	Maximum Gate Limit [pu]

gov_TGOV5

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`K`	Controller Gain [pu]	Any value
`T1`	Governor Time Constant [s]
`T2`	Governor Derivative Time Constant [s]
`T3`	Servo Time Constant [s]
`K1`	High-Pressure Turbine Factor [pu]
`K2`	High-Pressure Turbine Factor [pu]
`T5`	Intermediate Pressure Turbine Time Constant [s]
`K3`	Intermediate Pressure Turbine Factor [pu]
`K4`	Intermediate Pressure Turbine Factor [pu]
`T6`	Medium Pressure Turbine Time Constant [s]
`K5`	Medium Pressure Turbine Factor [pu]
`K6`	Medium Pressure Turbine Factor [pu]
`T4`	High Pressure Turbine Time Constant [s]
`T7`	Low Pressure Turbine Time Constant [s]
`K7`	Low Pressure Turbine Factor [pu]
`K8`	Low Pressure Turbine Factor [pu]
`PNhp`	HP Turbine Rated Power(=0->PNhp=PgnnHp) [MW]
`PNlp`	LP Turbine Rated Power(=0->PNlp=Pgnnlp) [MW]
`B`	The frequency bias for load reference control [pu]
`K13`	The gain between MW demand and pressure set point. [-]
`K12`	The gain for pressure error bias. [-]
`Kmw`	The gain of the MW transducer (0 or 1). [-]	Integer values [0, 1]
`Tmw`	The MW transducer time constant [s]	Any value
`K14`	Inverse of load reference servomotor time constant (= 0.0 if load reference does not change). [-]	Any value
`Kl`	The feedback gain from the load reference (0 or 1). [-]	Integer values [0, 1]
`Dpe`	The deadband in the pressure error signal for load reference control [pu of Pres]	Any value
`Ki`	The controller integral gain. [pu]
`Ti`	The controller proportional lead time constant [s]
`Tr`	The controller rate lead time constant [s]
`Tri`	The inherent lag associated with lead TR [s]
`K9`	The adjustment to the pressure drop coefficient as a function of drum pressure. [-]
`Cb`	The boiler storage time constant [s]
`Tf`	The fuel and air system time constant [s]
`Tw`	Fuel flow time constant [s]
`Td`	The time delay in the fuel supply system [s]
`K11`	The gain of anticipation signal from load demand. [-]
`K10`	The gain of anticipation signal from main stream flow. [-]
`C1`	The pressure drop coefficient. [-]
`Psp`	The initial throttle pressure set point. [pu]
`C2`	The gain for the pressure error bias. [-]
`C3`	The adjustment to the pressure set point. [-]
`Uc`	Valve Closing Time [p.u./s]
`Vmin`	Minimum Gate Limit [p.u.]
`Rmin`	The load reference negative rate of change limit [pu/s]
`Lmin`	The minimum load reference. [pu]
`Cmin`	The minimum controller output. [pu]
`Uo`	Valve Opening Time [p.u./s]
`Vmax`	Maximum Gate Limit [p.u.]
`Rmax`	The load reference positive rate of change limit [pu/s]
`Lmax`	The maximum load reference. [pu]
`Cmax`	The maximum controller output. [pu]

Power Systems Stabilizer

The power system stabilizer systems data comes from ElmSym section in the DGS-XML file. The following tables outline the required parameters for each power system stabilizer system that is accessible through Native Library.

pss_IEE2ST

This PowerFactory component is mapped to the Power System Stabilizer (PSS) component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`K1`	Signal 1 transducer gain [pu]	Any value
`T1`	Signal 1 transducer time constant [s]
`K2`	Signal 2 transducer gain [pu]
`T2`	Signal 2 transducer time constant [s]
`T3`	First washout derivative time constant [s]
`T4`	First washout integrate time constant [s]
`T6`	First Lead/Lag delay time constant [s]
`T5`	First Lead/Lag derivative time constant [s]
`T8`	Second Lead/Lag delay time constant [s]
`T7`	Second Lead/Lag derivative time constant [s]
`T10`	Three Lead/Lag delay time constant [s]
`T9`	Three Lead/Lag derivative time constant [s]
`Ic2`	2th Input Selector [1-6]	Integer values [1-6]
`Ic1`	1th Input Selector [1-6]	Integer values [1-6]
`IPB`	PSS base selector (1=gen MVA, 0=gen MW) [-]	Boolean value [0 or 1]
`Kd`	Derivator Factor [pu]	Any value
`Lsmin`	Signal pss minimum [pu]
`Vcl`	Lower voltage output limiter [pu]
`Lsmax`	Signal pss maximum [pu]
`Vcu`	Upper Voltage output limiter [pu]

pss_IEEEST

This PowerFactory component is mapped to the Power System Stabilizer (PSS) component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`T2`	Lead/Lag 2th Delay Time Constant [s]	Any value
`T1`	Lead/Lag 1th Derivative Time Constant [s]
`T4`	Lead/Lag 4th Delay Time Constant [s]
`T3`	Lead/Lag 3th Derivative Time Constant [s]
`Ks`	Stabilizer Gain [pu]
`T5`	Stabilizer Derivative Time Constant [s]
`T6`	Stabilizer Time Constant [s]
`A1`	Filter 1th Time Constant [s]
`A2`	Filter 2th Time Constant [s]
`A3`	Filter 3th Time Constant [s]
`A4`	Filter 4th Time Constant [s]
`A5`	Filter 5th Time Constant [s]
`A6`	Filter 6th Time Constant [s]
`Ic`	1th Input Selector [1-6]	Integer values [1-6]
`IPB`	IPB	Boolean value [0 or 1]
`Kd`	Derivator Factor [pu]	Any value
`Lsmin`	Signal pss minimum [pu]
`Vcl`	Lower voltage output limiter [pu]
`Lsmax`	Controller Maximum Output [pu]
`Vcl`	Controller Minimum Limit [pu]

pss_STAB1

This PowerFactory component is mapped to the Power System Stabilizer (PSS) component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`K`	Stabilizer Gain [pu]	Any value
`T`	Washout integrate time constant [s]
`T2`	Second Lead/Lag Derivative Time Constant [s]
`T1`	First Lead/Lag Derivative Time Constant [s]
`T4`	Second Lead/Lag Delay Time Constant [s]
`T3`	First Lead/Lag Delay Time Constant [s]
`HLIM`	Signal PSS Maximum [pu]

pss_PSS2A

This PowerFactory component is mapped to the Power System Stabilizer (PSS) component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tw1`	1st Washout 1th Time Constant [s]	Any value
`Tw2`	1st Washout 2th Time Constant [s]
`T6`	1st Signal Transducer Time Constant [s]
`TW3`	2nd Washout 1th Time Constant [s]
`TW4`	2nd Washout 2th Time Constant [s]
`Ks2`	2nd Signal Transducer Factor [pu]
`T7`	2nd Signal Transducer Time Constant [s]
`Ks3`	Washouts Coupling Factor [pu]
`Ks1`	Pss Gain [pu]
`Ts1`	1st Lead-Lag Derivative Time Constant [s]
`Ts2`	1st Lead-Lag Delay Time Constant [s]
`Ts3`	2nd Lead-Lag Derivative Time Constant [s]
`Ts4`	1st Lead-Lag Delay Time Constant [s]
`T8`	Ramp Tracking Filter Deriv. Time Constant [s]
`T9`	Ramp Tracking Filter Delay Time Constant [s]
`N`	Ramp Tracking Filter [-]
`M`	Ramp Tracking Filter [-]
`Ic1`	1st Input Selector [1-6]	Integer values [1-6]
`Ic2`	2nd Input Selector [1-6]	Integer values [1-6]
`Kd`	Derivator Factor [pu]	Any value
`Vstmin`	Controller Minimum Output [pu]
`Vstmax`	Controller Maximum Output [pu]

pss_PSS2B

This PowerFactory component is mapped to the Power System Stabilizer (PSS) component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tw1`	1st Washout 1th Time Constant [s]	Any value
`Tw2`	1st Washout 2th Time Constant [s]
`T6`	1st Signal Transucer Time Constant [s]
`TW3`	2nd Washout 1th Time Constant [s]
`TW4`	2nd Washout 2th Time Constant [s]
`Ks2`	2nd Signal Transducer Factor [pu]
`T7`	2nd Signal Transducer Time Constant [s]
`Ks3`	Washouts Coupling Factor [pu]
`Ks1`	Pss Gain [pu]
`Ts1`	1st Lead-Lag Derivative Time Constant [s]
`Ts2`	1st Lead-Lag Delay Time Constant [s]
`Ts3`	2nd Lead-Lag Derivative Time Constant [s]
`Ts4`	1st Lead-Lag Delay Time Constant [s]
`T8`	Ramp Tracking Filter Deriv. Time Constant [s]
`T9`	Ramp Tracking Filter Delay Time Constant [s]
`N`	Ramp Tracking Filter [-]
`M`	Ramp Tracking Filter [-]
`Ic1`	1st Input Selector [1-6]	Integer values [1-6]
`Ic2`	2nd Input Selector [1-6]	Integer values [1-6]
`IPB`	PSS base selector (1=gen MVA, 0=gen MW) [-]	Boolean value [0 or 1]
`Kd`	Derivator Factor [pu]	Any value
`Ts10`	3rd Lead-Lag Derivative Time Constant [s]
`Ts11`	3rd Lead-Lag Delay Time Constant [s]
`Vstmin`	Controller Minimum Output [pu]
`VS1min`	Input Signal 1 Minimum Limit [pu]
`VS2min`	Input Signal 2 Minimum Limit [pu]
`Vstmax`	Controller Maximum Output [pu]
`VS1max`	Input Signal 1 Maximum Limit [pu]
`VS2max`	Input Signal 2 Maximum Limit [pu]

pss_PSS3B

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Ic1`	1st Input Selector [1-6]	Integer values [1-6]
`Ic2`	2nd Input Selector [1-6]	Integer values [1-6]
`IPB`	PSS base selector (1=gen MVA, 0=gen MW) [-]	Boolean value [0 or 1]
`Kd`	Kd	Any value
`Ks1`	Input Channel 1 gain [pu]
`T1`	Input 1 Transducer time constant [s]
`Ks2`	Input Channel 2 gain [pu]
`T2`	Input 2 Transducer time constant [s]
`Tw1`	Input 1 Washout Time Constant [s]
`Tw2`	Input 2 Washout Time Constant [s]
`Tw3`	Main Washout Time Constant [s]
`A3`	A3
`A4`	A4
`A1`	A1
`A2`	A2
`A7`	A7
`A8`	A8
`A5`	A5
`A6`	A6
`VSTmin`	Controller Minimum Output [pu]	Boolean value [0 or 1]
`VSTmax`	Controller Maximum Output [pu]	Any value

pss_STAB3

This PowerFactory component is mapped to the Power System Stabilizer (PSS) component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Tt`	Power transducer time constant [s]	Any value
`Tx1`	Filter Time Constant [s]
`Kx`	Washout Factor [pu]
`Tx2`	Washout time constant [s]
`Vlim`	Control output limiter [pu]
`IPB`	PSS base selector (1=gen MVA, 0=gen MW) [-]	Boolean value [0 or 1]

pss_STAB4

This PowerFactory component is mapped to the Power System Stabilizer (PSS) component of the Native Library.

Parameters from ElmDsl Section

Parameter	Description	Acceptable Values
`Kx`	Washout Factor [pu]	Any value
`Tx2`	Washout Time Constant [s]
`Tb`	Lead Time Constant 2 [s]
`Tc`	Lag Time Constant 2 [s]
`Ta`	Lead Time Constant 1 [s]
`Tx1`	Lag Time Constant 1 [s]
`Te`	Output Filter Time Constant 2 [s]
`Td`	Output Filter Time Constant 1 [s]
`Tt`	Signal Transducer Time Constant [s]
`L1`	Controller Minimum Output [pu]
`L2`	Controller Maximum Output [pu]
`IPB`	PSS base selector (1=gen MVA, 0=gen MW) [-]	Boolean value [0 or 1]

Supported Components in DGS-XML File Format

Common Data

Bus Data

Parameters from ElmTerm Section

Line Data

Parameters from ElmLne Section

Parameters from TypLne Section

Load Data

Parameters from ElmLod Section

Parameters from TypLod Section

Shunt Data

Parameters from ElmShnt Section

Static Generator Data

Parameters from ElmGenstat Section

Example

Switch Data

Parameters from StaSwitch Section

Two-Winding Transformer Data

Parameters from ElmTr2 Section

Parameters from TypTr2 Section

Three-Winding Transformer Data

Parameters from ElmTr3 Section

Parameters from TypTr3 Section

Synchronous Machine Data

Parameters from ElmSym Section

Parameters from TypSym Section

Machine Controls Data

Excitation Systems

avr_EXST1

Parameters from ElmDsl Section

avr_AC7B

Parameters from ElmDsl Section

avr_ESDC1A

Parameters from ElmDsl Section

avr_EXAC1A

Parameters from ElmDsl Section

avr_ESST4B

Parameters from ElmDsl Section

avr_ESST1A

Parameters from ElmDsl Section

avr_EXDC2

Parameters from ElmDsl Section

avr_EXAC4

Parameters from ElmDsl Section

avr_EXPIC1

Parameters from ElmDsl Section

avr_EXST1

Parameters from ElmDsl Section

avr_EXST2

Parameters from ElmDsl Section

avr_EXST3

Parameters from ElmDsl Section

avr_ESAC5A

Parameters from ElmDsl Section

avr_ESAC1A

Parameters from ElmDsl Section

avr_ESAC8B

Parameters from ElmDsl Section

avr_ESAC6A

Parameters from ElmDsl Section

avr_ESDC2A

Parameters from ElmDsl Section

avr_IEEET1

Parameters from ElmDsl Section

avr_IEEET2

Parameters from ElmDsl Section

avr_IEEEX1

Parameters from ElmDsl Section

avr_IEEEX2

Parameters from ElmDsl Section

avr_IVOEX

Parameters from ElmDsl Section

avr_REXSYS

Parameters from ElmDsl Section

avr_SCRX

Parameters from ElmDsl Section

avr_SEXS

Parameters from ElmDsl Section

avr_ST5B

Parameters from ElmDsl Section