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	Any value
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	Any value
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	Any value
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	Any value
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)	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:

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.

Excitation Systems

The excitation systems data comes from ElmSym section in the XML file. The following tables outline the required fields for each excitation system that is accessible through Native Library.

avr_EXST1

This model is represented by ExciterEXST1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXST1
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterAC7B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	AC7B
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterAC7B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESDC1A
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterEXAC1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXAC1
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterESST4B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESST4B
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterESST4B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESST4B
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterEXDC2 in the built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXDC2
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterIEEEAC4 in the built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXAC4
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterEXPIC1 in the built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXPIC1
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by EXST1 in the built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXST1
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by EXST2 in the built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXST2
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterEXST3 in the built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	EXST3
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterESAC5A in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESAC5A
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterESAC1A in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESAC1A
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterESAC8B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESAC8B
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterESAC6A in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESAC6A
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterESDC2A in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ESDC2A
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterIEEET1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	IEEET1
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterIEEET2 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	IEEET2
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterIEEEX1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	IEEEX1
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterIEEEX2 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	IEEEX2
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterIVOEX in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	IVOEX
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterREXSYS in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	REXSYS
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterSCRX in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	SCRX
outserv	Out-of-service (s)	0: In-service 1: Out-of-service
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 model is represented by ExciterSEXS in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	SCRX
outserv	Out-of-service	0: In-service 1: Out-of-service
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 model is represented by ExciterST5B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ST5B
outserv	Out-of-service	0: In-service 1: Out-of-service
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 model is represented by ExciterST6B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ST6B
outserv	Out-of-service	0: In-service 1: Out-of-service
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 model is represented by ExciterST6B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ST6B
outserv	Out-of-service	0: In-service 1: Out-of-service
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 model is represented by ExciterST7B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	ST7B
outserv	Out-of-service	0: In-service 1: Out-of-service
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 model is represented by ExciterURST5T in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Exciter name in the section	URST5T
outserv	Out-of-service	0: In-service 1: Out-of-service
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]

uel_UEL1

This model is represented by LimiterExciterUEL1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	LimiterExciter name in the section	UEL1
outserv	Out-of-service	0: In-service 1: Out-of-service
Kur	Kur	Any value
Kuc	Kuc
Kuf	Kuf
Kul	Kul
Kui	Kui
Tu2	Tu2
Tu1	Tu1
Tu4	Tu4
Tu3	Tu3
VUImin	VUImin
VULmin	VULmin
VURmax	VURmax
VUCmax	VUCmax
VUImax	VUImax
VULmax	VULmax

uel_UEL2

This model is represented by LimiterExciterUEL2 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	LimiterExciter name in the section	UEL2
outserv	Out-of-service	0: In-service 1: Out-of-service
k	k-exponent (=0,=1 or =2) [0/1/2]	Integer values [0, 1, 2]
Tuv	Tuv	Any value
Tup	Tup
Tuq	Tuq
Kuf	Kuf
Kfb	Kfb
Tul	Tul
Kul	Kul
Kui	Kui
Tu2	Tu2
Tu1	Tu1
Tu4	Tu4
Tu3	Tu3
VUImin	VUImin
VULmin	VULmin
VUImax	VUImax
VULmax	VULmax

oel_MAXEX1

This model is represented by LimiterExciterMAXEX1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	LimiterExciter name in the section	oel_MAXEX1
outserv	Out-of-service	0: In-service 1: Out-of-service
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 model is represented by LimiterExciterMAXEX2 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	LimiterExciter name in the section	oel_MAXEX2
outserv	Out-of-service	0: In-service 1: Out-of-service
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-governor

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

gov_GAST

This model is represented by TurbineGovernorGAST in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	GAST
outserv	Out-of-service	0: In-service 1: Out-of-service
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

This model is represented by TurbineGovernorGAST2A in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	GAST2A
outserv	out of service	0: In-service 1: Out-of-service
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 model is represented by TurbineGovernorGGOV1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	GGOV1
outserv	out of service	0: In-service 1: Out-of-service
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 model is represented by TurbineGovernorHYGOV in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	HYGOV
outserv	out of service	0: In-service 1: Out-of-service
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 model is represented by TurbineGovernorIEEEG1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	IEEEG1
outserv	out of service	0: In-service 1: Out-of-service
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 model is represented by TurbineGovernorIEEEG2 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	IEEEG2
outserv	out of service	0: In-service 1: Out-of-service
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

This model is represented by TurbineGovernorIEEEG3 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	IEEEG3
outserv	out of service	0: In-service 1: Out-of-service
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 model is represented by TurbineGovernorIEESGO in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	IEEEG3
outserv	out of service	0: In-service 1: Out-of-service
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

This model is represented by TurbineGovernorPIDGOV in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	PIDGOV
outserv	out of service	0: In-service 1: Out-of-service
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 model is represented by TurbineGovernorTGOV1 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	TGOV1
outserv	out of service	0: In-service 1: Out-of-service
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

This model is represented by TurbineGovernorTGOV2 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	TGOV2
outserv	out of service	0: In-service 1: Out-of-service
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

This model is represented by TurbineGovernorTGOV2 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	governor name in the section	TGOV5
outserv	out of service	0: In-service 1: Out-of-service
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 of 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 of 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 XML file. The following tables outline the required fields for each power system stabilizer system that is accessible through Native Library.

Pss_IEE2ST

This model is represented by StabilizerIEE2ST in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	IEE2ST
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 value in the range of 1-6
Ic1	1th Input Selector [1-6]	Integer value in the range of 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 model is represented by StabilizerIEEEST in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	IEEEST
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 value in the range of 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 model is represented by PSS1A in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	STAB1
outserv	Out of service (s)	0: In-service 1: Out-of-service
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 model is represented by PSS2A in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	PSS2A
outserv	Out-of-service	0: In-service 1: Out-of-service
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 value in the range of 1-6
Ic2	2nd Input Selector [1-6]	Integer value in the range of 1-6
Kd	Derivator Factor [pu]	Any value
Vstmin	Controller Minimum Output [pu]
Vstmax	Controller Maximum Output [pu]

Pss_PSS2B

This model is represented by PSS2B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	PSS2B
outserv	Out-of-service	0: In-service 1: Out-of-service
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 value in the range of 1-6
Ic2	2nd Input Selector [1-6]	Integer value in the range of 1-6
IPB	PSS base selector (1=gen MVA, 0=gen MW) [-]	Integer 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

This model is represented by StabilizerPSS3B in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	PSS2B
outserv	Out-of-service	0: In-service 1: Out-of-service
Ic1	1st Input Selector [1-6]	Integer value in the range of 1-6
Ic2	2nd Input Selector [1-6]	Integer value in the range of 1-6
IPB	PSS base selector (1=gen MVA, 0=gen MW) [-]	Integer value in the range of 0, 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]	Integer Value (0 or 1)
VSTmax	Controller Maximum Output [pu]	Any value

Pss_STAB3

This model is represented by PowerSensitiveStabilizer3 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	STAB3
outserv	Out-of-service	0: In-service 1: Out-of-service
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) [-]	Integer Value (0 or 1)

Pss_STAB4

This model is represented by PowerSensitiveStabilizer4 in built-in library.

Fields from ElmSym Section

Entry	Description	Acceptable Values
ID	Unique identifier for DGS file	Any value
loc_name	Power system stabilizer name in the section	STAB4
outserv	Out-of-service	0: In-service 1: Out-of-service
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) [-]	Integer Value (0 or 1)

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	Any value
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	Any value
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	Any value
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

Specs for DGS File Format

Bus Data

Fields from ElmTerm Section

Line Data

Fields from ElmLne Section

Fields from TypLne Section

Load Data

Fields from ElmLod Section

Fields from TypLod Section

Static Generator Data

Fields from ElmGenstat Section

Example:

Synchronous Machine Data

Fields from ElmSym Section

Fields from TypSym Section

Machines Controller Data

Excitation Systems

avr_EXST1

avr_AC7B

avr_ESDC1A

avr_EXAC1A

avr_ESST4B

avr_ESST1A

avr_EXDC2

avr_EXAC4

avr_EXPIC1

avr_EXST1

avr_EXST2

avr_EXST3

avr_ESAC5A

avr_ESAC1A

avr_ESAC8B

avr_ESAC6A

avr_ESDC2A

avr_IEEET1

avr_IEEET2

avr_IEEEX1

avr_IEEEX2

avr_IVOEX

avr_REXSYS

avr_SCRX

avr_SEXS

avr_ST5B

avr_ST6B

avr_ST6B

avr_ST7B

avr_URST5T

uel_UEL1

uel_UEL2

oel_MAXEX1

oel_MAXEX2

Turbine-governor

gov_GAST

gov_GAST2A

gov_GGOV1

gov_HYGOV

gov_IEEEG1

gov_IEEEG2

gov_IEEEG3

gov_IEESGO

gov_PIDGOV

gov_TGOV1

gov_TGOV2

gov_TGOV5

Power Systems Stabilizer

Pss_IEE2ST

Pss_IEEEST

Pss_STAB1

Pss_PSS2A

Pss_PSS2B

Pss_PSS3B

Pss_STAB3

Pss_STAB4

Switch Data

Two-Winding Transformer Data

Fields from ElmTr2 Section

Three-Winding Transformer Data

Fields from ElmTr3 Section

Fields from TypTr3 Section