Pour la documentation en FRANÇAIS, utilisez l’outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.



Note: All the supported components that exist in XML file will be imported and considered to be in-service. That means for a component that is out-of-service in PowerFactory, the Solver imports its data and treats it as in-service. Thus, it is recommended to remove the data from the input file for the components that are required to be out-of-service during simulation.


Bus Data

The bus data comes from Elmterm section in the XML file. The following table lists the required fields for each section.

Fields from ElmTerm Section

Entry

Description

Acceptable Values

ID

Unique identifier for DGS file

Any value

loc_name

Bus name in the section

outserv

Out of service

Must be 0

uknom

Nominal Voltage: Line-Line in kV

Any value


Note: The 'ID' in above table is used to create the component ID described in I/O Pins for PowerFactory Data .


Line Data

The Line data comes from ElmLne and TypLne sections in the XML file. The following tables list the required fields for each section

Fields from ElmLne Section

Entry

Description

Acceptable Values

ID

Unique identifier for DGS file

Any value


loc_name

Line name in the section

dline

Length of Line (km)

Positive Value

Fields from TypLne Section

Entry

Description

Acceptable Values

ulineRated Voltage

Any value







slineRated Current

rline

Series resistance (Ohm/km)

xline

Series reactance (Ohm/km)

bline

Shunt Susceptance (uS/km)

aohlLine Typeohl: Overhead Line


Note: The 'ID’ in above ElmLne Section Table is used to create the component ID described in I/O Pins for PowerFactory Data.


Load Data

The load data comes from ElmLod and TypLod sections in the XML file. The following tables list the required fields for each section.

Fields from ElmLod Section

Entry

Description

Acceptable Values

ID

Unique identifier for DGS file

Any value

loc_name

Load name in the section

plini

Operating Point: Active Power in MW

qlini

Operating Point: Reactive Power in MVAr

scale0

Scaling factor of operating point

Fields from TypLod Section

Entry

Description

Acceptable Values

aP

Active power portion of impedance load.

Any value from 0 to 1

bP

Active power portion of current load.

cP

Active power portion of power load.

aQ

Reactive power portion of impedance load.

bQ

Reactive power portion of current load.

cQ

Reactive power portion of power load.


Note:

  • In order to simulate the ‘ZIP’ load, the e_aP, e_bP and e_cP must be specified as 2, 1, 0 respectively. The e_aQ, e_bQ and e_cQ must also be specified as 2, 1, 0 respectively.
  • Make sure that aP+bP+cP=1, aQ+bQ+cQ=1.
  • The 'ID’ in above ElmLod Section Table is used to create the component ID described in I/O Pins for PowerFactory Data.


Static Generator Data

The static generator data come from ElmGenstat sections in the XML file and it is mapped to a constant load model. The following tables list the required fields for this section.

Fields from ElmGenstat Section

Entry

Description

Acceptable Values

ID

Unique identifier for DGS file

Any value

loc_name

Generator name in the section

outserv

Out of service

0: In-service

1: Out-of-service

ngum

Number of parallel units

Any integer value

model_inpDispatch: Input modelMust be DEF
pginiDispatch: Active Power in MWAny value
qginiDispatch: Reactive Power in MVAr
scale0Dispatch: Scaling FactorAny value
av_modeLocal Controller ModeConst Q
iSimModelSimulation 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

ngnumNumber 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

outservOut of ServiceMust be 0
i_motGenerator/Motor

Must be 0: Generator

phiini

Initial voltage angle in degree

-180 to 180

Fields from TypSym Section

Entry

Description

Acceptable Values

sgn

Nominal apparent power (MVA)

Any value

ugn

Nominal voltage (kV)

iturbo

Rotor type

0 for salient rotor

1 for round rotor

rstr

Stator resistance (p.u.)

Any value

xd

d-axis reactance (p.u.)

xq

q-axis reactance (p.u.)

xds

d-axis transient reactance xd' (p.u.)

xqs

q-axis transient reactance xq' (p.u.)

xdss

d-axis sub-transient reactance (p.u.)

xqss

q-axis sub-transient reactance (p.u.)

h

Inertia constant H (s)

dpu

Turbine shaft friction torque coefficient

(Damping factor)

xl

Leakage reactance (p.u.)

tds0

d-axis transient time constant (s)

tqs0

q-axis transient time constant (s)

tdss0

d-axis sub-transient time constant (s)

tqss0

q-axis sub-transient time constant (s)

sg10

Saturation function value for 1 p.u

sg12

Saturation function value for 1.2 p.u

model_inp

Model type

‘det’ for Standard Model

‘cls’ for Classical Model

isat

Flux saturation considered or not

0 for not considered

1 for considered


Note:

  • The 'ID’ in above ElmSym Section table is used to create the component ID described in I/O Pins for PowerFactory Data.
  • With built-in models only round rotor standard and the classical models are supported. The classical model is equivalent to the SynGenGENCLS’ model and the standard model with round rotor is equivalent to ‘SynGenGENROU model.


Machines Controller Data

The following models are available in the built-in library:

  • Excitation system: avr_EXST1. This model is represented by ExciterEXST1 in built-in library.
  • Power system stabilizer: pss_STAB1. This model is represented by StabilizerSTAB1 in built-in library.
  • Turbine-governor: gov_TGOV1. This model is represented by TurbineGovernorTGOV1 in built-in library.



Note:

  • Up to v2020.4, it was possible to use FMU library with PowerFactory input files to cover a wider range of the control models. This feature has been disabled in the current release.
  • Please refer to Mapping to PowerFactory parameters for more details about this disabled feature.
  • Parameter "PN" for all Turbine Governor models and "At" for TGOV1 are not imported. Their values must be set to PN = 0 and At = 1.
  • Parameter "IPB" for all Stabilizer models and "Kd" for the ones with input code are not imported. Thus, their values must be set to 1.
  • The remote bus feature is also not supported in stabilizers with PowerFactory input files.


Switch Data

The switch data comes from StaSwitch section in the XML file. The following tables list the required fields for each section.

Fields from StaSwitch Section

Entry

Description

Acceptable Values

ID

Unique identifier for DGS file

Any value


loc_name

Switch name in the section

on_off

Switch initial status

1 for close

0 for open


Note: The 'ID’ in StaSwitch Section table is used to create the component ID described in I/O Pins for PowerFactory Data.


Two-Winding Transformer Data

The two-winding transformer data comes from ElmTr2 and TypTr2 sections in the XML file. The following tables list the required fields for each section.

Fields from ElmTr2 Section

Entry

Description

Acceptable Values

ID

Unique identifier for DGS file

Any value


loc_name

Transformer name in the section

outserv

Service status

0 for in-service

1 for out-of-service

nntap

Position for “Tap Changer 1”

Any value


rSbasepu

Resistance on netwrok Sbase (p.u.)

xSbasepu

Reactance on network Sbase (p.u.)

bSbasepu

Susceptance on network Sbase (p.u.)


Fields from TypTr2 Section

Entry

Description

Acceptable Values

strn

Rated power (MVA)

Any value


utrn_h

HV-Side rated voltage (kv)

utrn_l

LV-Side rated voltage (kv)

tr2cn_h

HV-Side vector group.

‘YN’ or ‘D’

tr2cn_l

LV-Side vector group.

‘YN’ or ‘D’

nt2ag

Phase shift vector group

Any value


dutap

Additional voltage per tap

phitr

Phase change per tap

nntap0

Neutral tap position

ntpmn

Minimum tap position

ntpmx

Maximum tap position



Note: The 'ID’ in ElmTr2 Section table is used to create the component ID described in I/O Pins for PowerFactory Data.



Three-Winding Transformer Data

The three-winding transformer data is obtained from ElmTr3 and TypTr3 sections in the XML file. The following tables list the required fields for each section.

Fields from ElmTr3 Section

Entry

Description

Acceptable Values

ID

Unique identifier for DGS file

Any value

loc_name

Transformer name in the section

outserv

Service status

0 for in-service

1 for out-of-service

n3tap_h

Tap HV-Side: Act. Position in

Any value


n3tap_m

Tap MV-Side: Act. Position in

n3tap_l

Tap LV-Side: Act. Position in

rSbasepu_hm

Resistance between HV-MV in Net­work Sbase (p.u.)

rSbasepu_ml

Resistance between MV-LV in Net­work Sbase (p.u.)

rSbasepu_lh

Resistance between LV-HV in Net­work Sbase (p.u.)

xSbasepu_hm

Reactance between HV-MV in Net­work Sbase (p.u.)

xSbasepu_ml

Reactance between MV-LV in Net­work 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

  • No labels