Class: Autotrans¶
A Autotrans object in OpenDSS representing an auto-transformer where the series and common windings share a magnetic core. Winding 1 is the series (high-side) winding; winding 2 is the common winding.
URI: dss:Autotrans
classDiagram
class Autotrans
click Autotrans href "../Autotrans/"
Autotrans : bank
Autotrans : basefreq
Autotrans : bus
Autotrans : buses
Autotrans : conn
Autotrans : conns
Autotrans : Core
Autotrans : emergamps
Autotrans : emerghkVA
Autotrans : enabled
Autotrans : faultrate
Autotrans : flrise
Autotrans : hsrise
Autotrans : kV
Autotrans : kVA
Autotrans : kVAs
Autotrans : kVs
Autotrans : LeadLag
Autotrans : like
Autotrans : m
Autotrans : MaxTap
Autotrans : MinTap
Autotrans : n
Autotrans : name
Autotrans : normamps
Autotrans : normhkVA
Autotrans : NumTaps
Autotrans : pct_imag
Autotrans : pct_loadloss
Autotrans : pct_noloadloss
Autotrans : pct_R
Autotrans : pct_Rs
Autotrans : pctperm
Autotrans : phases
Autotrans : ppm_antifloat
Autotrans : Rdcohms
Autotrans : repair
Autotrans : sub
Autotrans : subname
Autotrans : tap
Autotrans : taps
Autotrans : thermal
Autotrans : wdg
Autotrans : WdgCurrents
Autotrans : windings
Autotrans : XfmrCode
Autotrans : XHT
Autotrans : XHX
Autotrans : XRConst
Autotrans : XSCarray
Autotrans : XXT
Class Properties¶
| Property | Value |
|---|---|
| Class URI | dss:Autotrans |
Slots¶
| Name | Cardinality and Range | Description | Inheritance |
|---|---|---|---|
| name | 1 String |
Object name | direct |
| phases | 0..1 Integer |
Number of phases this AutoTrans | direct |
| windings | 0..1 Integer |
Number of windings, this AutoTrans | direct |
| wdg | 0..1 Integer |
Set this = to the number of the winding you wish to define | direct |
| bus | 0..1 String |
Bus connection spec for the active winding (set by wdg property) | direct |
| conn | 0..1 String |
Connection of this winding | direct |
| kV | 0..1 Float |
For 2-or 3-phase, enter phase-phase kV rating | direct |
| kVA | 0..1 Float |
Base kVA rating of the winding | direct |
| tap | 0..1 String |
Per unit tap that this winding is on | direct |
| pct_R | 0..1 Float |
Percent ac resistance this winding | direct |
| Rdcohms | 0..1 Integer |
Winding dc resistance in OHMS | direct |
| Core | 0..1 String |
{Shell* | 5-leg |
| buses | 0..1 String |
Use this to specify all the bus connections at once using an array | direct |
| conns | 0..1 String |
Use this to specify all the Winding connections at once using an array | direct |
| kVs | 0..1 Float |
Use this to specify the kV ratings of all windings at once using an array | direct |
| kVAs | 0..1 Float |
Use this to specify the kVA ratings of all windings at once using an array | direct |
| taps | 0..1 String |
Use this to specify the per-unit tap positions of all windings at once | direct |
| XHX | 0..1 Float |
Use this to specify the percent reactance, H-L (winding 1 to winding 2) | direct |
| XHT | 0..1 Float |
Use this to specify the percent reactance, H-T (winding 1 to winding 3) | direct |
| XXT | 0..1 Float |
Use this to specify the percent reactance, L-T (winding 2 to winding 3) | direct |
| XSCarray | 0..1 Integer |
Use this to specify the percent reactance between all pairs of windings as an... | direct |
| thermal | 0..1 String |
Thermal time constant of the AutoTrans in hours | direct |
| n | 0..1 String |
n Exponent for thermal properties in IEEE C57 | direct |
| m | 0..1 String |
m Exponent for thermal properties in IEEE C57 | direct |
| flrise | 0..1 String |
Temperature rise, deg C, for full load | direct |
| hsrise | 0..1 String |
Hot spot temperature rise, deg C | direct |
| pct_loadloss | 0..1 Float |
Percent load loss at full load | direct |
| pct_noloadloss | 0..1 Float |
Percent no load losses at rated excitation voltage | direct |
| normhkVA | 0..1 Float |
Normal maximum kVA rating of H winding (winding 1+2) | direct |
| emerghkVA | 0..1 Float |
Emergency (contingency) kVA rating of H winding (winding 1+2) | direct |
| sub | 0..1 Boolean |
={Yes | No} Designates whether this AutoTrans is to be considered a substation |
| MaxTap | 0..1 String |
Max per unit tap for the active winding | direct |
| MinTap | 0..1 String |
Min per unit tap for the active winding | direct |
| NumTaps | 0..1 Integer |
Total number of taps between min and max tap | direct |
| subname | 0..1 String |
Substation Name | direct |
| pct_imag | 0..1 Float |
Percent magnetizing current | direct |
| ppm_antifloat | 0..1 Float |
ppm (parts per million) anti-float factor | direct |
| pct_Rs | 0..1 Float |
Use this property to specify all the winding ac %resistances using an array | direct |
| bank | 0..1 String |
Name of the bank this transformer is part of, for CIM, MultiSpeak, and other ... | direct |
| XfmrCode | 0..1 String |
Name of a library entry for transformer properties | direct |
| XRConst | 0..1 Boolean |
={Yes | No} Default is NO |
| LeadLag | 0..1 String |
{Lead | Lag (default) |
| WdgCurrents | 0..1 Float |
(Read only) Makes winding currents available via return on query | direct |
| normamps | 0..1 Float |
Normal rated current | direct |
| emergamps | 0..1 Float |
Maximum or emerg current | direct |
| faultrate | 0..1 String |
Failure rate per year | direct |
| pctperm | 0..1 Float |
Percent of failures that become permanent | direct |
| repair | 0..1 String |
Hours to repair | direct |
| basefreq | 0..1 Float |
Base Frequency for ratings | direct |
| enabled | 0..1 Boolean |
{Yes | No or True |
| like | 0..1 String |
Make like another object, e | direct |
Comments¶
- OpenDSS Autotrans maps to CIM PowerTransformer + PowerTransformerEnd (one per winding), TransformerMeshImpedance (for short-circuit reactances XHX/XHT/XXT), and TransformerCoreAdmittance (no-load losses, winding 1 only). Key difference from regular Transformer: uses XHX/XHT/XXT naming instead of XHL/XHT/XLT; every winding is imported as connectionKind Y, grounded, with zero ground impedance (CIM has no explicit auto-transformer WindingConnection type). There is no dedicated Autotrans exporter; export of a converted PowerTransformer is handled by the same code path as a regular Transformer.
Identifier and Mapping Information¶
Schema Source¶
- from schema: https://gridappsd.github.io/dss-graph/opendss
Mappings¶
| Mapping Type | Mapped Value |
|---|---|
| self | dss:Autotrans |
| native | dss:Autotrans |
| exact | cim:PowerTransformer |
LinkML Source¶
Direct¶
name: Autotrans
description: A Autotrans object in OpenDSS representing an auto-transformer where
the series and common windings share a magnetic core. Winding 1 is the series (high-side)
winding; winding 2 is the common winding.
comments:
- 'OpenDSS Autotrans maps to CIM PowerTransformer + PowerTransformerEnd (one per winding),
TransformerMeshImpedance (for short-circuit reactances XHX/XHT/XXT), and TransformerCoreAdmittance
(no-load losses, winding 1 only). Key difference from regular Transformer: uses
XHX/XHT/XXT naming instead of XHL/XHT/XLT; every winding is imported as connectionKind
Y, grounded, with zero ground impedance (CIM has no explicit auto-transformer WindingConnection
type). There is no dedicated Autotrans exporter; export of a converted PowerTransformer
is handled by the same code path as a regular Transformer.'
from_schema: https://gridappsd.github.io/dss-graph/opendss
exact_mappings:
- cim:PowerTransformer
attributes:
name:
name: name
description: Object name. Must be unique per object type.
comments:
- Direct name mapping; no conversion needed.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:IdentifiedObject.name
identifier: true
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Cndata
- Dynamicexp
- Growthshape
- Linecode
- Linegeometry
- Linespacing
- Loadshape
- Priceshape
- Spectrum
- TccCurve
- Tsdata
- Tshape
- Wiredata
- Xfmrcode
- Xycurve
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: string
required: true
phases:
name: phases
annotations:
order:
tag: order
value: 1
description: Number of phases this AutoTrans.
comments:
- 'Import: inferred from bus connection specs. Not stored directly on CIM PowerTransformer
(phase count is implicit in Terminal/End configuration).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Xfmrcode
- Fault
- Gicsource
- Isource
- Vsource
range: integer
required: false
windings:
name: windings
annotations:
order:
tag: order
value: 2
description: Number of windings, this AutoTrans. Typically 2 for a 2-winding auto-transformer.
comments:
- 'Import: creates one PowerTransformerEnd per winding. Export: len(PowerTransformer.PowerTransformerEnd).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:PowerTransformerEnd
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: integer
required: false
wdg:
name: wdg
annotations:
order:
tag: order
value: 3
description: Set this = to the number of the winding you wish to define. Used
as index selector for subsequent winding properties.
comments:
- 'OpenDSS-only (N/A): index selector consumed at parse time; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: integer
required: false
bus:
name: bus
annotations:
order:
tag: order
value: 4
description: Bus connection spec for the active winding (set by wdg property).
comments:
- Each winding bus maps to a Terminal → ConnectivityNode. buses[] is the array
form of the same property.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:Terminal.ConnectivityNode
rank: 1000
domain_of:
- Autotrans
- Transformer
- Regcontrol
range: string
required: false
conn:
name: conn
annotations:
order:
tag: order
value: 5
description: Connection of this winding {Series, wye*, Delta, LN, LL}.
comments:
- 'Import: ''wye''/''wye-g'' → WindingConnection.Y; ''delta'' → WindingConnection.D.
Export: reverse enum lookup. Auto-transformer windings are typically Y-connected
in CIM.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.connectionKind
domain_of:
- Load
- Generator
- Generic5
- Indmach012
- Pvsystem
- Storage
- Windgen
- Autotrans
- Capacitor
- Reactor
- Transformer
- Xfmrcode
- Sensor
range: string
required: false
kV:
name: kV
annotations:
order:
tag: order
value: 6
description: For 2-or 3-phase, enter phase-phase kV rating. Otherwise, enter actual
winding voltage rating.
comments:
- 'Import: PowerTransformerEnd.ratedU = Voltage(kV, ''kV''). Export: kV = ratedU.to(''kV'').
CIM stores in V (SI base). kVs[] is the array form.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedU
domain_of:
- Load
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
kVA:
name: kVA
annotations:
order:
tag: order
value: 7
description: Base kVA rating of the winding.
comments:
- 'Import: PowerTransformerEnd.ratedS = ApparentPower(kVA, ''kVA''). Export: kVA
= ratedS.to(''kVA''). CIM stores in VA (SI base). kVAs[] is the array form.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedS
domain_of:
- Load
- Generator
- Generic5
- Indmach012
- Pvsystem
- Storage
- Windgen
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
tap:
name: tap
annotations:
order:
tag: order
value: 8
description: Per unit tap that this winding is on. Default is 1.0.
todos:
- tap/taps[] is parsed but not converted. If implemented, it should create a RatioTapChanger
on the winding's PowerTransformerEnd with step derived from the per-unit tap
value.
comments:
- 'OpenDSS-only (N/A) for now: the current converter reads tap into an internal
per-winding parameter but never uses it to create a RatioTapChanger; no CIM
field is set from this property. taps[] is the array form.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
pct_R:
name: pct_R
annotations:
order:
tag: order
value: 9
dss_name:
tag: dss_name
value: '%R'
description: Percent ac resistance this winding. Default is 0.2%.
comments:
- 'Import: for each winding, the percent resistance is taken from %Rs[winding]
if given, else from %R (applied to every winding), else a default of 0.5 percent;
PowerTransformerEnd.r = Resistance(Zbase × pct_R / 100, ''ohm''), where Zbase
= kV² × 1000 / kVA using that winding''s own kV and kVA. Export: there is no
dedicated Autotrans exporter, so the converted PowerTransformer is written back
out by the generic Transformer exporter, which emits %r=<value> on every winding''s
continuation line using the same Zbase formula in reverse. The exported DSS
text always uses the Transformer object type and XHL/XHT/XLT reactance naming,
not Autotrans/XHX/XHT/XXT (see class-level comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:PowerTransformerEnd.r
domain_of:
- Pvsystem
- Storage
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
Rdcohms:
name: Rdcohms
annotations:
order:
tag: order
value: 10
description: Winding dc resistance in OHMS. Default is 0.
comments:
- 'OpenDSS-only (N/A): DC winding resistance for loss calculation; no separate
CIM field on PowerTransformerEnd (CIM r is AC resistance).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
range: integer
required: false
Core:
name: Core
annotations:
order:
tag: order
value: 11
description: '{Shell*|5-leg|3-Leg|1-phase|core-1-phase|4-leg} Core Type.'
comments:
- 'OpenDSS-only (N/A): core construction type; no CIM equivalent in the standard
profile.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
range: string
required: false
buses:
name: buses
annotations:
order:
tag: order
value: 12
description: Use this to specify all the bus connections at once using an array.
Array form of the winding bus property.
comments:
- Array form of bus property; each element maps to a Terminal → ConnectivityNode
for the corresponding winding.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:Terminal.ConnectivityNode
rank: 1000
domain_of:
- Autotrans
- Transformer
range: string
required: false
conns:
name: conns
annotations:
order:
tag: order
value: 13
description: Use this to specify all the Winding connections at once using an
array.
comments:
- Array form of conn property. Each element maps to PowerTransformerEnd.connectionKind
via the same enum lookup.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.connectionKind
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
kVs:
name: kVs
annotations:
order:
tag: order
value: 14
description: Use this to specify the kV ratings of all windings at once using
an array.
comments:
- Array form of kV property. Each element maps to the corresponding PowerTransformerEnd.ratedU.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedU
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
- Sensor
range: float
required: false
kVAs:
name: kVAs
annotations:
order:
tag: order
value: 15
description: Use this to specify the kVA ratings of all windings at once using
an array.
comments:
- Array form of kVA property. Each element maps to the corresponding PowerTransformerEnd.ratedS.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedS
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
taps:
name: taps
annotations:
order:
tag: order
value: 16
description: Use this to specify the per-unit tap positions of all windings at
once.
todos:
- Not implemented; see tap todos.
comments:
- 'OpenDSS-only (N/A) for now: array form of tap; not converted by the current
importer (see tap comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
XHX:
name: XHX
annotations:
order:
tag: order
value: 17
description: Use this to specify the percent reactance, H-L (winding 1 to winding
2). Default is 7.
comments:
- 'Import: creates a TransformerMeshImpedance between windings 1 and 2, with x
= x0 = Zbase × XHX / 100, where Zbase uses winding 1''s own kV together with
the primary winding''s kVA. The paired TransformerMeshImpedance.r/r0 is set
from the sum of the two windings'' %R (see %R comments), not from XHX itself.
No separate zero-sequence reactance is derived; x0 always equals x. Export:
recovered as the generic Transformer exporter''s XHL field, using the same Zbase
convention in reverse; the exported DSS text uses Transformer/XHL naming, not
Autotrans/XHX (see class-level comments). Name equivalent to XHL in regular
Transformer.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
domain_of:
- Autotrans
range: float
required: false
XHT:
name: XHT
annotations:
order:
tag: order
value: 18
description: Use this to specify the percent reactance, H-T (winding 1 to winding
3). Default is 35.
comments:
- 'Import: same TransformerMeshImpedance formula as XHX (see XHX comments), applied
to the winding 1-to-3 pair; only used when 3 or more windings are present. Export:
recovered as the generic Transformer exporter''s XHT field (see XHX comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
domain_of:
- Autotrans
- Transformer
range: float
required: false
XXT:
name: XXT
annotations:
order:
tag: order
value: 19
description: Use this to specify the percent reactance, L-T (winding 2 to winding
3). Default is 30.
comments:
- 'Import: same TransformerMeshImpedance formula as XHX (see XHX comments), applied
to the winding 2-to-3 pair; only used when 3 or more windings are present. Export:
recovered as the generic Transformer exporter''s XLT field (see XHX comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
domain_of:
- Autotrans
range: float
required: false
XSCarray:
name: XSCarray
annotations:
order:
tag: order
value: 20
description: Use this to specify the percent reactance between all pairs of windings
as an array. Replaces XHX, XHT, XXT for transformers with more than 3 windings.
comments:
- 'Import: array form giving one %Xsc entry per winding pair, in the order produced
by iterating pairs (i, k) with i < k over winding indices; each entry uses the
same TransformerMeshImpedance formula as XHX (see XHX comments). Used in place
of XHX/XHT/XXT for transformers with more than 3 windings. If fewer entries
are given than there are winding pairs, the remaining pairs default to 10.0
percent (higher than the default used for a regular Transformer). Export: for
more than 3 windings, the generic Transformer exporter recovers the full pairwise
list as Xscarray using the same convention in reverse (see XHX comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
domain_of:
- Autotrans
range: integer
required: false
thermal:
name: thermal
annotations:
order:
tag: order
value: 21
description: Thermal time constant of the AutoTrans in hours.
comments:
- 'OpenDSS-only (N/A): thermal model parameter; no CIM equivalent in the standard
profile.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
n:
name: n
annotations:
order:
tag: order
value: 22
description: n Exponent for thermal properties in IEEE C57.
comments:
- 'OpenDSS-only (N/A): IEEE C57 thermal exponent; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
m:
name: m
annotations:
order:
tag: order
value: 23
description: m Exponent for thermal properties in IEEE C57.
comments:
- 'OpenDSS-only (N/A): IEEE C57 thermal exponent; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
flrise:
name: flrise
annotations:
order:
tag: order
value: 24
description: Temperature rise, deg C, for full load.
comments:
- 'OpenDSS-only (N/A): thermal rating parameter; no CIM equivalent in the standard
profile.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
hsrise:
name: hsrise
annotations:
order:
tag: order
value: 25
description: Hot spot temperature rise, deg C.
comments:
- 'OpenDSS-only (N/A): hot spot thermal rating; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
pct_loadloss:
name: pct_loadloss
annotations:
order:
tag: order
value: 26
dss_name:
tag: dss_name
value: '%loadloss'
description: Percent load loss at full load. Winding resistance losses.
todos:
- '%loadloss not read by the importer. If implemented, it should follow the same
fallback used for regular Transformer: when neither %R nor %Rs is given, split
%loadloss evenly across windings to derive each winding''s %R.'
comments:
- 'OpenDSS-only (N/A) for now: the current converter never reads %loadloss; no
CIM field is set from this property. (%R/%Rs, not %loadloss, is what drives
PowerTransformerEnd.r for auto-transformers — see %R comments.)'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
pct_noloadloss:
name: pct_noloadloss
annotations:
order:
tag: order
value: 27
dss_name:
tag: dss_name
value: '%noloadloss'
description: Percent no load losses at rated excitation voltage. Core losses.
comments:
- 'Import: a TransformerCoreAdmittance is created on winding 1 only when %noloadloss
or %imag is nonzero, with g = g0 = %noloadloss / 100 / Zbase, where Zbase uses
winding 1''s own kV and kVA. Export: the generic Transformer exporter recovers
%noloadloss = g × Zbase × 100 using the same Zbase convention; if no TransformerCoreAdmittance
is present, it falls back to a catalog-based (NoLoadTest) recovery path instead.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerCoreAdmittance.g
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
normhkVA:
name: normhkVA
annotations:
order:
tag: order
value: 28
description: Normal maximum kVA rating of H winding (winding 1+2).
todos:
- Operational limit converter not yet implemented for transformers. Should map
to a CurrentLimit or ApparentPowerLimit on the H winding terminal.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:OperationalLimit
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
emerghkVA:
name: emerghkVA
annotations:
order:
tag: order
value: 29
description: Emergency (contingency) kVA rating of H winding (winding 1+2).
todos:
- Emergency operational limit converter not yet implemented.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:OperationalLimit
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
sub:
name: sub
annotations:
order:
tag: order
value: 30
description: ={Yes|No} Designates whether this AutoTrans is to be considered
a substation.
todos:
- sub is not converted. If implemented, it should place the PowerTransformer in
a Substation EquipmentContainer, using subname for the container's name.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer; no CIM field
is set from this property.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
range: boolean
required: false
MaxTap:
name: MaxTap
annotations:
order:
tag: order
value: 31
description: Max per unit tap for the active winding. Default is 1.10.
todos:
- No RatioTapChanger is created by the importer. MaxTap/MinTap/NumTaps should
together populate RatioTapChanger.highStep/lowStep/stepVoltageIncrement on the
tapped winding's PowerTransformerEnd.
comments:
- 'OpenDSS-only (N/A) for now: the current importer never creates a RatioTapChanger
for an auto-transformer winding (see tap comments), so MaxTap is not read into
any CIM field.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
MinTap:
name: MinTap
annotations:
order:
tag: order
value: 32
description: Min per unit tap for the active winding. Default is 0.90.
todos:
- Not implemented; see MaxTap todos.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer (see MaxTap comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
NumTaps:
name: NumTaps
annotations:
order:
tag: order
value: 33
description: Total number of taps between min and max tap. Default is 32.
todos:
- Not implemented; see MaxTap todos.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer; if implemented,
would combine with MaxTap/MinTap to derive RatioTapChanger.stepVoltageIncrement
= (MaxTap - MinTap) / NumTaps (see MaxTap comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: integer
required: false
subname:
name: subname
annotations:
order:
tag: order
value: 34
description: Substation Name. Used when sub=Yes.
todos:
- Not implemented; see sub todos.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer (see sub comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
range: string
required: false
pct_imag:
name: pct_imag
annotations:
order:
tag: order
value: 35
dss_name:
tag: dss_name
value: '%imag'
description: Percent magnetizing current.
comments:
- 'Import: same TransformerCoreAdmittance created as for %noloadloss (see %noloadloss
comments), with b = b0 = %imag / 100 / Zbase. Export: the generic Transformer
exporter recovers %imag = b × Zbase × 100 using the same Zbase convention (or
the catalog-based fallback if no TransformerCoreAdmittance is present).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerCoreAdmittance.b
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
ppm_antifloat:
name: ppm_antifloat
annotations:
order:
tag: order
value: 36
description: ppm (parts per million) anti-float factor. Default=1 ppm. Prevents
floating buses.
comments:
- 'OpenDSS-only (N/A): numerical stability parameter; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
pct_Rs:
name: pct_Rs
annotations:
order:
tag: order
value: 37
dss_name:
tag: dss_name
value: '%Rs'
description: Use this property to specify all the winding ac %resistances using
an array.
comments:
- Array form of %R property. Each element maps to the corresponding PowerTransformerEnd.r
via the same percent-to-ohm conversion.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:PowerTransformerEnd.r
rank: 1000
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
bank:
name: bank
annotations:
order:
tag: order
value: 38
description: Name of the bank this transformer is part of, for CIM, MultiSpeak,
and other interfaces.
todos:
- bank is not converted. If implemented, it should group single-phase auto-transformer
units sharing the same bank name into a TransformerTank.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer; no TransformerTank
grouping is created for an Autotrans.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
range: string
required: false
XfmrCode:
name: XfmrCode
annotations:
order:
tag: order
value: 39
description: Name of a library entry for transformer properties. References an
XfmrCode object.
todos:
- XfmrCode is not read on import. If implemented, it should resolve to a catalog
object by name and set PowerTransformer.AssetDatasheet.
comments:
- 'Import: not read by the current importer; PowerTransformer.AssetDatasheet is
never set for an Autotrans. Export: if AssetDatasheet happens to be set (e.g.
by another tool), the generic Transformer exporter writes XfmrCode=AssetDatasheet.name.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:PowerTransformer.AssetDatasheet
rank: 1000
domain_of:
- Autotrans
- Transformer
range: string
required: false
XRConst:
name: XRConst
annotations:
order:
tag: order
value: 40
description: ={Yes|No} Default is NO. If Yes, X/R ratio is constant with frequency.
comments:
- 'OpenDSS-only (N/A): frequency dependence flag; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
range: boolean
required: false
LeadLag:
name: LeadLag
annotations:
order:
tag: order
value: 41
description: '{Lead | Lag (default) | ANSI (default) | Euro } Designation in mixed
Delta-wye connections of the relationship between HV to LV winding.'
comments:
- 'OpenDSS-only (N/A): phase displacement designation; no standard CIM field on
PowerTransformerEnd for this.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Transformer
range: string
required: false
WdgCurrents:
name: WdgCurrents
annotations:
order:
tag: order
value: 42
description: (Read only) Makes winding currents available via return on query.
comments:
- 'OpenDSS-only (N/A): read-only operational output; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
range: float
required: false
normamps:
name: normamps
annotations:
order:
tag: order
value: 43
description: Normal rated current.
todos:
- Operational limit converter not yet implemented for auto-transformers.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:CurrentLimit
rank: 1000
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Cndata
- Linecode
- Linegeometry
- Tsdata
- Wiredata
- Fault
range: float
required: false
emergamps:
name: emergamps
annotations:
order:
tag: order
value: 44
description: Maximum or emerg current.
todos:
- Emergency operational limit converter not yet implemented.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:CurrentLimit
rank: 1000
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Cndata
- Linecode
- Linegeometry
- Tsdata
- Wiredata
- Fault
range: float
required: false
faultrate:
name: faultrate
annotations:
order:
tag: order
value: 45
description: Failure rate per year.
todos:
- Requires CIM extension to roundtrip.
comments:
- Reliability parameter; no CIM equivalent in the standard profile.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Linecode
- Fault
range: string
required: false
pctperm:
name: pctperm
annotations:
order:
tag: order
value: 46
description: Percent of failures that become permanent.
todos:
- Requires CIM extension to roundtrip.
comments:
- Reliability parameter; no CIM equivalent in the standard profile.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Reactor
- Linecode
- Fault
range: float
required: false
repair:
name: repair
annotations:
order:
tag: order
value: 47
description: Hours to repair.
todos:
- Requires CIM extension to roundtrip.
comments:
- Reliability parameter; no CIM equivalent in the standard profile.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Linecode
- Fault
range: string
required: false
basefreq:
name: basefreq
annotations:
order:
tag: order
value: 48
description: Base Frequency for ratings.
comments:
- Not stored on CIM PowerTransformer; base frequency is a circuit-level property
in CIM.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: float
required: false
enabled:
name: enabled
annotations:
order:
tag: order
value: 49
description: '{Yes|No or True|False} Indicates whether this element is enabled.'
comments:
- 'OpenDSS-only (N/A): if False, converter returns None and no CIM object is created.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: boolean
required: false
like:
name: like
annotations:
order:
tag: order
value: 50
description: 'Make like another object, e.g.: New Autotrans.AT2 like=AT1 ...'
comments:
- 'OpenDSS-only (N/A): DSS template/copy directive resolved at parse time; no
CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Cndata
- Dynamicexp
- Growthshape
- Linecode
- Linegeometry
- Linespacing
- Loadshape
- Priceshape
- Spectrum
- TccCurve
- Tsdata
- Tshape
- Wiredata
- Xfmrcode
- Xycurve
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: string
required: false
class_uri: dss:Autotrans
Induced¶
name: Autotrans
description: A Autotrans object in OpenDSS representing an auto-transformer where
the series and common windings share a magnetic core. Winding 1 is the series (high-side)
winding; winding 2 is the common winding.
comments:
- 'OpenDSS Autotrans maps to CIM PowerTransformer + PowerTransformerEnd (one per winding),
TransformerMeshImpedance (for short-circuit reactances XHX/XHT/XXT), and TransformerCoreAdmittance
(no-load losses, winding 1 only). Key difference from regular Transformer: uses
XHX/XHT/XXT naming instead of XHL/XHT/XLT; every winding is imported as connectionKind
Y, grounded, with zero ground impedance (CIM has no explicit auto-transformer WindingConnection
type). There is no dedicated Autotrans exporter; export of a converted PowerTransformer
is handled by the same code path as a regular Transformer.'
from_schema: https://gridappsd.github.io/dss-graph/opendss
exact_mappings:
- cim:PowerTransformer
attributes:
name:
name: name
description: Object name. Must be unique per object type.
comments:
- Direct name mapping; no conversion needed.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:IdentifiedObject.name
identifier: true
owner: Autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Cndata
- Dynamicexp
- Growthshape
- Linecode
- Linegeometry
- Linespacing
- Loadshape
- Priceshape
- Spectrum
- TccCurve
- Tsdata
- Tshape
- Wiredata
- Xfmrcode
- Xycurve
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: string
required: true
phases:
name: phases
annotations:
order:
tag: order
value: 1
description: Number of phases this AutoTrans.
comments:
- 'Import: inferred from bus connection specs. Not stored directly on CIM PowerTransformer
(phase count is implicit in Terminal/End configuration).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
owner: Autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Xfmrcode
- Fault
- Gicsource
- Isource
- Vsource
range: integer
required: false
windings:
name: windings
annotations:
order:
tag: order
value: 2
description: Number of windings, this AutoTrans. Typically 2 for a 2-winding auto-transformer.
comments:
- 'Import: creates one PowerTransformerEnd per winding. Export: len(PowerTransformer.PowerTransformerEnd).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:PowerTransformerEnd
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: integer
required: false
wdg:
name: wdg
annotations:
order:
tag: order
value: 3
description: Set this = to the number of the winding you wish to define. Used
as index selector for subsequent winding properties.
comments:
- 'OpenDSS-only (N/A): index selector consumed at parse time; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: integer
required: false
bus:
name: bus
annotations:
order:
tag: order
value: 4
description: Bus connection spec for the active winding (set by wdg property).
comments:
- Each winding bus maps to a Terminal → ConnectivityNode. buses[] is the array
form of the same property.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:Terminal.ConnectivityNode
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Regcontrol
range: string
required: false
conn:
name: conn
annotations:
order:
tag: order
value: 5
description: Connection of this winding {Series, wye*, Delta, LN, LL}.
comments:
- 'Import: ''wye''/''wye-g'' → WindingConnection.Y; ''delta'' → WindingConnection.D.
Export: reverse enum lookup. Auto-transformer windings are typically Y-connected
in CIM.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.connectionKind
owner: Autotrans
domain_of:
- Load
- Generator
- Generic5
- Indmach012
- Pvsystem
- Storage
- Windgen
- Autotrans
- Capacitor
- Reactor
- Transformer
- Xfmrcode
- Sensor
range: string
required: false
kV:
name: kV
annotations:
order:
tag: order
value: 6
description: For 2-or 3-phase, enter phase-phase kV rating. Otherwise, enter actual
winding voltage rating.
comments:
- 'Import: PowerTransformerEnd.ratedU = Voltage(kV, ''kV''). Export: kV = ratedU.to(''kV'').
CIM stores in V (SI base). kVs[] is the array form.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedU
owner: Autotrans
domain_of:
- Load
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
kVA:
name: kVA
annotations:
order:
tag: order
value: 7
description: Base kVA rating of the winding.
comments:
- 'Import: PowerTransformerEnd.ratedS = ApparentPower(kVA, ''kVA''). Export: kVA
= ratedS.to(''kVA''). CIM stores in VA (SI base). kVAs[] is the array form.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedS
owner: Autotrans
domain_of:
- Load
- Generator
- Generic5
- Indmach012
- Pvsystem
- Storage
- Windgen
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
tap:
name: tap
annotations:
order:
tag: order
value: 8
description: Per unit tap that this winding is on. Default is 1.0.
todos:
- tap/taps[] is parsed but not converted. If implemented, it should create a RatioTapChanger
on the winding's PowerTransformerEnd with step derived from the per-unit tap
value.
comments:
- 'OpenDSS-only (N/A) for now: the current converter reads tap into an internal
per-winding parameter but never uses it to create a RatioTapChanger; no CIM
field is set from this property. taps[] is the array form.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
pct_R:
name: pct_R
annotations:
order:
tag: order
value: 9
dss_name:
tag: dss_name
value: '%R'
description: Percent ac resistance this winding. Default is 0.2%.
comments:
- 'Import: for each winding, the percent resistance is taken from %Rs[winding]
if given, else from %R (applied to every winding), else a default of 0.5 percent;
PowerTransformerEnd.r = Resistance(Zbase × pct_R / 100, ''ohm''), where Zbase
= kV² × 1000 / kVA using that winding''s own kV and kVA. Export: there is no
dedicated Autotrans exporter, so the converted PowerTransformer is written back
out by the generic Transformer exporter, which emits %r=<value> on every winding''s
continuation line using the same Zbase formula in reverse. The exported DSS
text always uses the Transformer object type and XHL/XHT/XLT reactance naming,
not Autotrans/XHX/XHT/XXT (see class-level comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:PowerTransformerEnd.r
owner: Autotrans
domain_of:
- Pvsystem
- Storage
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
Rdcohms:
name: Rdcohms
annotations:
order:
tag: order
value: 10
description: Winding dc resistance in OHMS. Default is 0.
comments:
- 'OpenDSS-only (N/A): DC winding resistance for loss calculation; no separate
CIM field on PowerTransformerEnd (CIM r is AC resistance).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
range: integer
required: false
Core:
name: Core
annotations:
order:
tag: order
value: 11
description: '{Shell*|5-leg|3-Leg|1-phase|core-1-phase|4-leg} Core Type.'
comments:
- 'OpenDSS-only (N/A): core construction type; no CIM equivalent in the standard
profile.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: string
required: false
buses:
name: buses
annotations:
order:
tag: order
value: 12
description: Use this to specify all the bus connections at once using an array.
Array form of the winding bus property.
comments:
- Array form of bus property; each element maps to a Terminal → ConnectivityNode
for the corresponding winding.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:Terminal.ConnectivityNode
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: string
required: false
conns:
name: conns
annotations:
order:
tag: order
value: 13
description: Use this to specify all the Winding connections at once using an
array.
comments:
- Array form of conn property. Each element maps to PowerTransformerEnd.connectionKind
via the same enum lookup.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.connectionKind
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
kVs:
name: kVs
annotations:
order:
tag: order
value: 14
description: Use this to specify the kV ratings of all windings at once using
an array.
comments:
- Array form of kV property. Each element maps to the corresponding PowerTransformerEnd.ratedU.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedU
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
- Sensor
range: float
required: false
kVAs:
name: kVAs
annotations:
order:
tag: order
value: 15
description: Use this to specify the kVA ratings of all windings at once using
an array.
comments:
- Array form of kVA property. Each element maps to the corresponding PowerTransformerEnd.ratedS.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
exact_mappings:
- cim:PowerTransformerEnd.ratedS
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
taps:
name: taps
annotations:
order:
tag: order
value: 16
description: Use this to specify the per-unit tap positions of all windings at
once.
todos:
- Not implemented; see tap todos.
comments:
- 'OpenDSS-only (N/A) for now: array form of tap; not converted by the current
importer (see tap comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
XHX:
name: XHX
annotations:
order:
tag: order
value: 17
description: Use this to specify the percent reactance, H-L (winding 1 to winding
2). Default is 7.
comments:
- 'Import: creates a TransformerMeshImpedance between windings 1 and 2, with x
= x0 = Zbase × XHX / 100, where Zbase uses winding 1''s own kV together with
the primary winding''s kVA. The paired TransformerMeshImpedance.r/r0 is set
from the sum of the two windings'' %R (see %R comments), not from XHX itself.
No separate zero-sequence reactance is derived; x0 always equals x. Export:
recovered as the generic Transformer exporter''s XHL field, using the same Zbase
convention in reverse; the exported DSS text uses Transformer/XHL naming, not
Autotrans/XHX (see class-level comments). Name equivalent to XHL in regular
Transformer.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
range: float
required: false
XHT:
name: XHT
annotations:
order:
tag: order
value: 18
description: Use this to specify the percent reactance, H-T (winding 1 to winding
3). Default is 35.
comments:
- 'Import: same TransformerMeshImpedance formula as XHX (see XHX comments), applied
to the winding 1-to-3 pair; only used when 3 or more windings are present. Export:
recovered as the generic Transformer exporter''s XHT field (see XHX comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: float
required: false
XXT:
name: XXT
annotations:
order:
tag: order
value: 19
description: Use this to specify the percent reactance, L-T (winding 2 to winding
3). Default is 30.
comments:
- 'Import: same TransformerMeshImpedance formula as XHX (see XHX comments), applied
to the winding 2-to-3 pair; only used when 3 or more windings are present. Export:
recovered as the generic Transformer exporter''s XLT field (see XHX comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
range: float
required: false
XSCarray:
name: XSCarray
annotations:
order:
tag: order
value: 20
description: Use this to specify the percent reactance between all pairs of windings
as an array. Replaces XHX, XHT, XXT for transformers with more than 3 windings.
comments:
- 'Import: array form giving one %Xsc entry per winding pair, in the order produced
by iterating pairs (i, k) with i < k over winding indices; each entry uses the
same TransformerMeshImpedance formula as XHX (see XHX comments). Used in place
of XHX/XHT/XXT for transformers with more than 3 windings. If fewer entries
are given than there are winding pairs, the remaining pairs default to 10.0
percent (higher than the default used for a regular Transformer). Export: for
more than 3 windings, the generic Transformer exporter recovers the full pairwise
list as Xscarray using the same convention in reverse (see XHX comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerMeshImpedance.x
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
range: integer
required: false
thermal:
name: thermal
annotations:
order:
tag: order
value: 21
description: Thermal time constant of the AutoTrans in hours.
comments:
- 'OpenDSS-only (N/A): thermal model parameter; no CIM equivalent in the standard
profile.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
n:
name: n
annotations:
order:
tag: order
value: 22
description: n Exponent for thermal properties in IEEE C57.
comments:
- 'OpenDSS-only (N/A): IEEE C57 thermal exponent; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
m:
name: m
annotations:
order:
tag: order
value: 23
description: m Exponent for thermal properties in IEEE C57.
comments:
- 'OpenDSS-only (N/A): IEEE C57 thermal exponent; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
flrise:
name: flrise
annotations:
order:
tag: order
value: 24
description: Temperature rise, deg C, for full load.
comments:
- 'OpenDSS-only (N/A): thermal rating parameter; no CIM equivalent in the standard
profile.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
hsrise:
name: hsrise
annotations:
order:
tag: order
value: 25
description: Hot spot temperature rise, deg C.
comments:
- 'OpenDSS-only (N/A): hot spot thermal rating; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
pct_loadloss:
name: pct_loadloss
annotations:
order:
tag: order
value: 26
dss_name:
tag: dss_name
value: '%loadloss'
description: Percent load loss at full load. Winding resistance losses.
todos:
- '%loadloss not read by the importer. If implemented, it should follow the same
fallback used for regular Transformer: when neither %R nor %Rs is given, split
%loadloss evenly across windings to derive each winding''s %R.'
comments:
- 'OpenDSS-only (N/A) for now: the current converter never reads %loadloss; no
CIM field is set from this property. (%R/%Rs, not %loadloss, is what drives
PowerTransformerEnd.r for auto-transformers — see %R comments.)'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
pct_noloadloss:
name: pct_noloadloss
annotations:
order:
tag: order
value: 27
dss_name:
tag: dss_name
value: '%noloadloss'
description: Percent no load losses at rated excitation voltage. Core losses.
comments:
- 'Import: a TransformerCoreAdmittance is created on winding 1 only when %noloadloss
or %imag is nonzero, with g = g0 = %noloadloss / 100 / Zbase, where Zbase uses
winding 1''s own kV and kVA. Export: the generic Transformer exporter recovers
%noloadloss = g × Zbase × 100 using the same Zbase convention; if no TransformerCoreAdmittance
is present, it falls back to a catalog-based (NoLoadTest) recovery path instead.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerCoreAdmittance.g
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
normhkVA:
name: normhkVA
annotations:
order:
tag: order
value: 28
description: Normal maximum kVA rating of H winding (winding 1+2).
todos:
- Operational limit converter not yet implemented for transformers. Should map
to a CurrentLimit or ApparentPowerLimit on the H winding terminal.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:OperationalLimit
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
emerghkVA:
name: emerghkVA
annotations:
order:
tag: order
value: 29
description: Emergency (contingency) kVA rating of H winding (winding 1+2).
todos:
- Emergency operational limit converter not yet implemented.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:OperationalLimit
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
sub:
name: sub
annotations:
order:
tag: order
value: 30
description: ={Yes|No} Designates whether this AutoTrans is to be considered
a substation.
todos:
- sub is not converted. If implemented, it should place the PowerTransformer in
a Substation EquipmentContainer, using subname for the container's name.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer; no CIM field
is set from this property.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: boolean
required: false
MaxTap:
name: MaxTap
annotations:
order:
tag: order
value: 31
description: Max per unit tap for the active winding. Default is 1.10.
todos:
- No RatioTapChanger is created by the importer. MaxTap/MinTap/NumTaps should
together populate RatioTapChanger.highStep/lowStep/stepVoltageIncrement on the
tapped winding's PowerTransformerEnd.
comments:
- 'OpenDSS-only (N/A) for now: the current importer never creates a RatioTapChanger
for an auto-transformer winding (see tap comments), so MaxTap is not read into
any CIM field.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
MinTap:
name: MinTap
annotations:
order:
tag: order
value: 32
description: Min per unit tap for the active winding. Default is 0.90.
todos:
- Not implemented; see MaxTap todos.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer (see MaxTap comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: string
required: false
NumTaps:
name: NumTaps
annotations:
order:
tag: order
value: 33
description: Total number of taps between min and max tap. Default is 32.
todos:
- Not implemented; see MaxTap todos.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer; if implemented,
would combine with MaxTap/MinTap to derive RatioTapChanger.stepVoltageIncrement
= (MaxTap - MinTap) / NumTaps (see MaxTap comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: integer
required: false
subname:
name: subname
annotations:
order:
tag: order
value: 34
description: Substation Name. Used when sub=Yes.
todos:
- Not implemented; see sub todos.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer (see sub comments).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: string
required: false
pct_imag:
name: pct_imag
annotations:
order:
tag: order
value: 35
dss_name:
tag: dss_name
value: '%imag'
description: Percent magnetizing current.
comments:
- 'Import: same TransformerCoreAdmittance created as for %noloadloss (see %noloadloss
comments), with b = b0 = %imag / 100 / Zbase. Export: the generic Transformer
exporter recovers %imag = b × Zbase × 100 using the same Zbase convention (or
the catalog-based fallback if no TransformerCoreAdmittance is present).'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:TransformerCoreAdmittance.b
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
ppm_antifloat:
name: ppm_antifloat
annotations:
order:
tag: order
value: 36
description: ppm (parts per million) anti-float factor. Default=1 ppm. Prevents
floating buses.
comments:
- 'OpenDSS-only (N/A): numerical stability parameter; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
pct_Rs:
name: pct_Rs
annotations:
order:
tag: order
value: 37
dss_name:
tag: dss_name
value: '%Rs'
description: Use this property to specify all the winding ac %resistances using
an array.
comments:
- Array form of %R property. Each element maps to the corresponding PowerTransformerEnd.r
via the same percent-to-ohm conversion.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
close_mappings:
- cim:PowerTransformerEnd.r
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
- Xfmrcode
range: float
required: false
bank:
name: bank
annotations:
order:
tag: order
value: 38
description: Name of the bank this transformer is part of, for CIM, MultiSpeak,
and other interfaces.
todos:
- bank is not converted. If implemented, it should group single-phase auto-transformer
units sharing the same bank name into a TransformerTank.
comments:
- 'OpenDSS-only (N/A) for now: not read by the current importer; no TransformerTank
grouping is created for an Autotrans.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: string
required: false
XfmrCode:
name: XfmrCode
annotations:
order:
tag: order
value: 39
description: Name of a library entry for transformer properties. References an
XfmrCode object.
todos:
- XfmrCode is not read on import. If implemented, it should resolve to a catalog
object by name and set PowerTransformer.AssetDatasheet.
comments:
- 'Import: not read by the current importer; PowerTransformer.AssetDatasheet is
never set for an Autotrans. Export: if AssetDatasheet happens to be set (e.g.
by another tool), the generic Transformer exporter writes XfmrCode=AssetDatasheet.name.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:PowerTransformer.AssetDatasheet
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: string
required: false
XRConst:
name: XRConst
annotations:
order:
tag: order
value: 40
description: ={Yes|No} Default is NO. If Yes, X/R ratio is constant with frequency.
comments:
- 'OpenDSS-only (N/A): frequency dependence flag; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: boolean
required: false
LeadLag:
name: LeadLag
annotations:
order:
tag: order
value: 41
description: '{Lead | Lag (default) | ANSI (default) | Euro } Designation in mixed
Delta-wye connections of the relationship between HV to LV winding.'
comments:
- 'OpenDSS-only (N/A): phase displacement designation; no standard CIM field on
PowerTransformerEnd for this.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Transformer
range: string
required: false
WdgCurrents:
name: WdgCurrents
annotations:
order:
tag: order
value: 42
description: (Read only) Makes winding currents available via return on query.
comments:
- 'OpenDSS-only (N/A): read-only operational output; no CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
range: float
required: false
normamps:
name: normamps
annotations:
order:
tag: order
value: 43
description: Normal rated current.
todos:
- Operational limit converter not yet implemented for auto-transformers.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:CurrentLimit
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Cndata
- Linecode
- Linegeometry
- Tsdata
- Wiredata
- Fault
range: float
required: false
emergamps:
name: emergamps
annotations:
order:
tag: order
value: 44
description: Maximum or emerg current.
todos:
- Emergency operational limit converter not yet implemented.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
related_mappings:
- cim:CurrentLimit
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Cndata
- Linecode
- Linegeometry
- Tsdata
- Wiredata
- Fault
range: float
required: false
faultrate:
name: faultrate
annotations:
order:
tag: order
value: 45
description: Failure rate per year.
todos:
- Requires CIM extension to roundtrip.
comments:
- Reliability parameter; no CIM equivalent in the standard profile.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Linecode
- Fault
range: string
required: false
pctperm:
name: pctperm
annotations:
order:
tag: order
value: 46
description: Percent of failures that become permanent.
todos:
- Requires CIM extension to roundtrip.
comments:
- Reliability parameter; no CIM equivalent in the standard profile.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Reactor
- Linecode
- Fault
range: float
required: false
repair:
name: repair
annotations:
order:
tag: order
value: 47
description: Hours to repair.
todos:
- Requires CIM extension to roundtrip.
comments:
- Reliability parameter; no CIM equivalent in the standard profile.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
rank: 1000
owner: Autotrans
domain_of:
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Linecode
- Fault
range: string
required: false
basefreq:
name: basefreq
annotations:
order:
tag: order
value: 48
description: Base Frequency for ratings.
comments:
- Not stored on CIM PowerTransformer; base frequency is a circuit-level property
in CIM.
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
owner: Autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: float
required: false
enabled:
name: enabled
annotations:
order:
tag: order
value: 49
description: '{Yes|No or True|False} Indicates whether this element is enabled.'
comments:
- 'OpenDSS-only (N/A): if False, converter returns None and no CIM object is created.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
owner: Autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: boolean
required: false
like:
name: like
annotations:
order:
tag: order
value: 50
description: 'Make like another object, e.g.: New Autotrans.AT2 like=AT1 ...'
comments:
- 'OpenDSS-only (N/A): DSS template/copy directive resolved at parse time; no
CIM equivalent.'
from_schema: https://gridappsd.github.io/dss-graph/pde/autotrans
owner: Autotrans
domain_of:
- Load
- Generator
- Generic5
- Gicline
- Indmach012
- Pvsystem
- Storage
- Upfc
- Vccs
- Vsconverter
- Windgen
- Autotrans
- Capacitor
- Gictransformer
- Line
- Reactor
- Transformer
- Capcontrol
- Espvlcontrol
- Expcontrol
- Fuse
- Gendispatcher
- Invcontrol
- Pycontrol
- Recloser
- Regcontrol
- Relay
- Storagecontroller
- Swtcontrol
- Upfccontrol
- Cndata
- Dynamicexp
- Growthshape
- Linecode
- Linegeometry
- Linespacing
- Loadshape
- Priceshape
- Spectrum
- TccCurve
- Tsdata
- Tshape
- Wiredata
- Xfmrcode
- Xycurve
- Energymeter
- Fmonitor
- Monitor
- Sensor
- Fault
- Gicsource
- Isource
- Vsource
range: string
required: false
class_uri: dss:Autotrans