Ctrl+K

XfmrCode#

( General )

EPRI’s OpenDSS Documentation for this component: https://opendss.epri.com/XfmrCode.html

#

Name

Type

Default

Units

Description

1

Phases

integer

3

Number of phases this transformer.

2

Windings

integer

Number of windings, this transformers. (Also is the number of terminals) Default is 2. This property triggers memory allocation for the Transformer and will cause other properties to revert to default values.

3

Wdg

integer

Set this = to the number of the winding you wish to define. Then set the values for this winding. Repeat for each winding. Alternatively, use the array collections (buses, kvas, etc.) to define the windings. Note: reactances are BETWEEN pairs of windings; they are not the property of a single winding.

4

Conn

string
(from enum. Connection, on array)

Connection of this winding. Default is “wye” with the neutral solidly grounded.

5

kV

real
(on array)

kV

For 2-or 3-phase, enter phase-phase kV rating. Otherwise, kV rating of the actual winding

6

kVA

real
(on array)

Base kVA rating of the winding. Side effect: forces change of max normal and emerg kva ratings.If 2-winding transformer, forces other winding to same value. When winding 1 is defined, all other windings are defaulted to the same rating and the first two winding resistances are defaulted to the %loadloss value.

7

Tap

real
(on array)

Per unit tap that this winding is normally on.

8

%R

real
(on array)

Percent resistance this winding. (half of total for a 2-winding).

9

RNeut

real
(on array)

Ω

Neutral resistance of wye (star)-connected winding in actual ohms. If entered as a negative value, the neutral is assumed to be open, or floating.

10

XNeut

real
(on array)

Ω

Neutral reactance of wye(star)-connected winding in actual ohms. May be positive or negative.

11

Conns

array of strings
(from enum. Connection)

Use this to specify all the Winding connections at once using an array. Example:

New Transformer.T1 buses=“Hibus, lowbus”
~ conns=(delta, wye)
Redundant with Conn

12

kVs

array of reals

Use this to specify the kV ratings of all windings at once using an array. Example:

New Transformer.T1 buses=“Hibus, lowbus”
~ conns=(delta, wye)
~ kvs=(115, 12.47)

See kV= property for voltage rules.
Redundant with kV

13

kVAs

array of reals

Use this to specify the kVA ratings of all windings at once using an array.
Redundant with kVA

14

Taps

array of reals

Use this to specify the normal p.u. tap of all windings at once using an array.
Redundant with Tap

15

XHL

real

Use this to specify the percent reactance, H-L (winding 1 to winding 2). Use for 2- or 3-winding transformers. On the kva base of winding 1.
Redundant with X12

16

XHT

real

Use this to specify the percent reactance, H-T (winding 1 to winding 3). Use for 3-winding transformers only. On the kVA base of winding 1.
Redundant with X13

17

XLT

real

Use this to specify the percent reactance, L-T (winding 2 to winding 3). Use for 3-winding transformers only. On the kVA base of winding 1.
Redundant with X23

18

XSCArray

array of reals

Use this to specify the percent reactance between all pairs of windings as an array. All values are on the kVA base of winding 1. The order of the values is as follows:

(x12 13 14… 23 24.. 34 ..)

There will be n(n-1)/2 values, where n=number of windings.

19

Thermal

real

2.0

hour

Thermal time constant of the transformer. Typically about 2.
Not used

20

n

real

0.8

n Exponent for thermal properties in IEEE C57. Typically 0.8.
Not used

21

m

real

0.8

m Exponent for thermal properties in IEEE C57. Typically 0.9 - 1.0
Not used

22

FLRise

real

65.0

°C

Temperature rise for full load.
Not used

23

HSRise

real

15.0

°C

Hot spot temperature rise.
Not used

24

%LoadLoss

real

Percent load loss at full load. The %R of the High and Low windings (1 and 2) are adjusted to agree at rated kVA loading.

25

%NoLoadLoss

real

Percent no load losses at rated excitation voltage. Default is 0. Converts to a resistance in parallel with the magnetizing impedance in each winding.

26

NormHkVA

real

kVA

Normal maximum kVA rating of H winding (winding 1). Usually 100% - 110% of maximum nameplate rating, depending on load shape. Defaults to 110% of kVA rating of Winding 1.

27

EmergHkVA

real

kVA

Emergency (contingency) kVA rating of H winding (winding 1). Usually 140% - 150% of maximum nameplate rating, depending on load shape. Defaults to 150% of kVA rating of Winding 1.

28

MaxTap

real
(on array)

Max per unit tap for the active winding.

29

MinTap

real
(on array)

Min per unit tap for the active winding.

30

NumTaps

integer

(on array)

Total number of taps between min and max tap. Default is 32.

31

%IMag

real

Percent magnetizing current. Magnetizing branch is in parallel with windings in each phase. Also, see “ppm_antifloat”.

32

ppm_Antifloat

real

1.0

Default=1 ppm. Parts per million of transformer winding VA rating connected to ground to protect against accidentally floating a winding without a reference. If positive then the effect is adding a very large reactance to ground. If negative, then a capacitor.

33

%Rs

array of reals

Use this property to specify all the winding %resistances using an array. Example:

New Transformer.T1 buses=“Hibus, lowbus” ~ %Rs=(0.2 0.3)
Redundant with %R

34

X12

real

Alternative to XHL for specifying the percent reactance from winding 1 to winding 2. Use for 2- or 3-winding transformers. Percent on the kVA base of winding 1.

35

X13

real

Alternative to XHT for specifying the percent reactance from winding 1 to winding 3. Use for 3-winding transformers only. Percent on the kVA base of winding 1.

36

X23

real

Alternative to XLT for specifying the percent reactance from winding 2 to winding 3.Use for 3-winding transformers only. Percent on the kVA base of winding 1.

37

RDCOhms

real
(on array)

Winding dc resistance in OHMS. Useful for GIC analysis. From transformer test report. Defaults to 85% of %R property

38

Seasons

integer

Defines the number of ratings to be defined for the transformer, to be used only when defining seasonal ratings using the “Ratings” property.

39

Ratings

array of reals

[600.0]

An array of ratings to be used when the seasonal ratings flag is True. It can be used to insert
multiple ratings to change during a QSTS simulation to evaluate different ratings in transformers.

40

Like

string
(XfmrCode name)
deprecated

Make like another object, e.g.:

New Capacitor.C2 like=c1 …