Class: Transformer

A Transformer object in OpenDSS representing a multi-winding transformer connecting two or more buses in the distribution system.

URI: dss:Transformer

 classDiagram
    class Transformer
    click Transformer href "../Transformer/"
      Transformer : bank

      Transformer : basefreq

      Transformer : bus

      Transformer : buses

      Transformer : conn





        Transformer --> "0..1" ConnectionType : conn
        click ConnectionType href "../ConnectionType/"



      Transformer : conns





        Transformer --> "*" ConnectionType : conns
        click ConnectionType href "../ConnectionType/"



      Transformer : Core





        Transformer --> "0..1" CoreType : Core
        click CoreType href "../CoreType/"



      Transformer : emergamps

      Transformer : emerghkVA

      Transformer : enabled

      Transformer : faultrate

      Transformer : flrise

      Transformer : hsrise

      Transformer : kV

      Transformer : kVA

      Transformer : kVAs

      Transformer : kVs

      Transformer : LeadLag





        Transformer --> "0..1" LeadLagType : LeadLag
        click LeadLagType href "../LeadLagType/"



      Transformer : like

      Transformer : m

      Transformer : MaxTap

      Transformer : MinTap

      Transformer : n

      Transformer : name

      Transformer : normamps

      Transformer : normhkVA

      Transformer : NumTaps

      Transformer : pct_imag

      Transformer : pct_loadloss

      Transformer : pct_noloadloss

      Transformer : pct_perm

      Transformer : pct_R

      Transformer : pct_Rs

      Transformer : phases

      Transformer : ppm_antifloat

      Transformer : Ratings

      Transformer : RdcOhms

      Transformer : repair

      Transformer : Rneut

      Transformer : Seasons

      Transformer : sub

      Transformer : subname

      Transformer : tap

      Transformer : taps

      Transformer : thermal

      Transformer : wdg

      Transformer : windings

      Transformer : X12

      Transformer : X13

      Transformer : X23

      Transformer : XfmrCode

      Transformer : XHL

      Transformer : XHT

      Transformer : XLT

      Transformer : Xneut

      Transformer : XRConst

      Transformer : Xscarray

Class Properties

Property	Value
Class URI	dss:Transformer

Slots

Name	Cardinality and Range	Description	Inheritance
name	1 String	Object name	direct
phases	0..1 Integer	Number of phases this transformer	direct
windings	0..1 Integer	Number of windings, this transformers	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 this winding	direct
conn	0..1 ConnectionType	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 Float	Per unit tap that this winding is on	direct
pct_R	0..1 Float	Percent resistance this winding	direct
Rneut	0..1 Float	Neutral resistance of wye (star)-connected winding in actual ohms	direct
Xneut	0..1 Float	Neutral reactance of wye(star)-connected winding in actual ohms	direct
buses	* String	Use this to specify all the bus connections at once using an array	direct
conns	* ConnectionType	Use this to specify all the Winding connections at once using an array	direct
kVs	* Float	Use this to specify the kV ratings of all windings at once using an array	direct
kVAs	* Float	Use this to specify the kVA ratings of all windings at once using an array	direct
taps	* Float	Use this to specify the p	direct
XHL	0..1 Float	Percent reactance, H-L (winding 1 to winding 2)	direct
XHT	0..1 Float	Percent reactance, H-T (winding 1 to winding 3)	direct
XLT	0..1 Float	Percent reactance, L-T (winding 2 to winding 3)	direct
Xscarray	* Float	Percent reactance between all pairs of windings as an array	direct
thermal	0..1 Float	Thermal time constant of the transformer in hours	direct
n	0..1 Float	n Exponent for thermal properties in IEEE C57	direct
m	0..1 Float	m Exponent for thermal properties in IEEE C57	direct
flrise	0..1 Float	Temperature rise, deg C, for full load	direct
hsrise	0..1 Float	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 excitatation voltage	direct
normhkVA	0..1 Float	Normal maximum kVA rating of H winding (winding 1)	direct
emerghkVA	0..1 Float	Emergency (contingency) kVA rating of H winding (winding 1)	direct
sub	0..1 Boolean	Designates whether this transformer is to be considered a substation	direct
MaxTap	0..1 Float	Max per unit tap for the active winding	direct
MinTap	0..1 Float	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	Default=1 ppm	direct
pct_Rs	* Float	Use this property to specify all the winding %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	Default is NO	direct
X12	0..1 Float	Alternative to XHL for specifying the percent reactance from winding 1 to win...	direct
X13	0..1 Float	Alternative to XHT for specifying the percent reactance from winding 1 to win...	direct
X23	0..1 Float	Alternative to XLT for specifying the percent reactance from winding 2 to win...	direct
LeadLag	0..1 LeadLagType	Designation in mixed Delta-wye connections the relationship between HV to LV ...	direct
Core	0..1 CoreType	Core Type	direct
RdcOhms	* Float	Winding dc resistance in OHMS	direct
Seasons	0..1 Integer	Defines the number of ratings to be defined for the transfomer, to be used on...	direct
Ratings	* Float	An array of ratings to be used when the seasonal ratings flag is True	direct
normamps	0..1 Float	Normal rated current	direct
emergamps	0..1 Float	Maximum or emerg current	direct
faultrate	0..1 Float	Failure rate per year	direct
pct_perm	0..1 Float	Percent of failures that become permanent	direct
repair	0..1 Float	Hours to repair	direct
basefreq	0..1 Float	Base Frequency for ratings	direct
enabled	0..1 Boolean	Indicates whether this element is enabled	direct
like	0..1 String	Make like another object, e	direct

Comments

• 3-phase (or phases > 1): mapped to CIM PowerTransformer with one PowerTransformerEnd per winding. Single-phase with bank set: mapped to a TransformerTank (one TransformerTankEnd per winding) attached to a shared PowerTransformer named after the bank, so all single-phase units of a bank share one CIM transformer container. Impedances are stored as TransformerMeshImpedance objects between winding pairs, and no-load losses/magnetizing current as a single TransformerCoreAdmittance on the primary winding — unless an XfmrCode catalog entry is referenced, in which case impedance and loss data are instead read from the catalog's ShortCircuitTest and NoLoadTest objects.

Identifier and Mapping Information

Schema Source

• from schema: https://gridappsd.github.io/dss-graph/opendss

Mappings

Mapping Type	Mapped Value
self	dss:Transformer
native	dss:Transformer
exact	cim:PowerTransformer

LinkML Source

Direct

name: Transformer
description: A Transformer object in OpenDSS representing a multi-winding transformer
  connecting two or more buses in the distribution system.
comments:
- '3-phase (or phases > 1): mapped to CIM PowerTransformer with one PowerTransformerEnd
  per winding. Single-phase with bank set: mapped to a TransformerTank (one TransformerTankEnd
  per winding) attached to a shared PowerTransformer named after the bank, so all
  single-phase units of a bank share one CIM transformer container. Impedances are
  stored as TransformerMeshImpedance objects between winding pairs, and no-load losses/magnetizing
  current as a single TransformerCoreAdmittance on the primary winding — unless an
  XfmrCode catalog entry is referenced, in which case impedance and loss data are
  instead read from the catalog''s ShortCircuitTest and NoLoadTest objects.'
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.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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
      dss_default:
        tag: dss_default
        value: int(3)
    description: Number of phases this transformer. Default is 3.
    comments:
    - 1-phase transformers with bank set are routed to the TransformerTank path rather
      than a standalone PowerTransformer.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformerEnd
    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
    minimum_value: 1
    maximum_value: 3
  windings:
    name: windings
    annotations:
      order:
        tag: order
        value: 2
      dss_default:
        tag: dss_default
        value: int(2)
    description: 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.
    comments:
    - Count of PowerTransformerEnd objects attached to the PowerTransformer.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformerEnd
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: integer
    required: false
    minimum_value: 2
  wdg:
    name: wdg
    annotations:
      order:
        tag: order
        value: 3
    description: Set this to the number of the winding you wish to define. Then set
      the values for this winding. Repeat for each winding.
    comments:
    - 'N/A: OpenDSS winding selector resolved at parse time; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: integer
    required: false
  bus:
    name: bus
    annotations:
      order:
        tag: order
        value: 4
    description: Bus connection spec for this winding.
    comments:
    - 'Per-winding terminal traversal: each winding maps to a CIM Terminal whose ConnectivityNode
      carries the bus name.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:Terminal.ConnectivityNode
    domain_of:
    - Autotrans
    - Transformer
    - Regcontrol
    range: string
    required: false
  conn:
    name: conn
    annotations:
      order:
        tag: order
        value: 5
    description: Connection of this winding. Default is wye with the neutral solidly
      grounded.
    comments:
    - 'WindingConnection enum: Y→wye, D→delta. Import/export: direct enum translation.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.connectionKind
    domain_of:
    - Load
    - Generator
    - Generic5
    - Indmach012
    - Pvsystem
    - Storage
    - Windgen
    - Autotrans
    - Capacitor
    - Reactor
    - Transformer
    - Xfmrcode
    - Sensor
    range: ConnectionType
    required: false
  kV:
    name: kV
    annotations:
      order:
        tag: order
        value: 6
    description: For 2-or 3-phase, enter phase-phase kV rating. Otherwise, kV rating
      of the actual winding.
    comments:
    - 'Unit conversion: import ratedU = kV(V) * 1000; export kV = ratedU / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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. Side effect: forces change of max
      normal and emerg kVA ratings.'
    comments:
    - 'Unit conversion: import ratedS = kVA * 1000; export kVA = ratedS / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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.
    comments:
    - 'Per-unit tap position. A RatioTapChanger is attached to the PowerTransformerEnd
      when tap != 1.0. Import/export: direct per-unit value.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:RatioTapChanger.step
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  pct_R:
    name: pct_R
    annotations:
      order:
        tag: order
        value: 9
      dss_name:
        tag: dss_name
        value: '%R'
    description: Percent resistance this winding. Half of total for a 2-winding.
    comments:
    - 'Import: r_ohm = (pct_R / 100) * zbase, where zbase = kV^2 * 1e6 / kVA_VA. Export:
      pct_R = (r / zbase) * 100.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:PowerTransformerEnd.r
    domain_of:
    - Pvsystem
    - Storage
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    minimum_value: 0.0
  Rneut:
    name: Rneut
    annotations:
      order:
        tag: order
        value: 10
      dss_default:
        tag: dss_default
        value: float(-1.0)
    description: Neutral resistance of wye (star)-connected winding in actual ohms.
      Default is -1. If entered as negative, the neutral is assumed to be open or
      floating.
    comments:
    - 'Unit: ohm (no conversion). Negative value indicates open/floating neutral.
      Import/export: direct ohm value.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.rground
    domain_of:
    - Load
    - Transformer
    - Xfmrcode
    range: float
    required: false
  Xneut:
    name: Xneut
    annotations:
      order:
        tag: order
        value: 11
    description: Neutral reactance of wye(star)-connected winding in actual ohms.
      May be positive or negative.
    comments:
    - 'Unit: ohm (no conversion). Import/export: direct ohm value.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.xground
    domain_of:
    - Load
    - Transformer
    - Xfmrcode
    range: float
    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.
    comments:
    - Array form of bus (one entry per winding). Each element maps to the ConnectivityNode
      of the corresponding winding Terminal.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:Terminal.ConnectivityNode
    domain_of:
    - Autotrans
    - Transformer
    range: string
    required: false
    multivalued: true
  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 (one WindingConnection per winding). Import/export: direct
      enum translation per element.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.connectionKind
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: ConnectionType
    required: false
    multivalued: true
  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 (one per winding, kV). Unit conversion per element: import
      ratedU = kVs[i] * 1000; export kVs[i] = ratedU / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.ratedU
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    - Sensor
    range: float
    required: false
    multivalued: true
    minimum_value: 0.0
  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 (one per winding, kVA). Unit conversion per element: import
      ratedS = kVAs[i] * 1000; export kVAs[i] = ratedS / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.ratedS
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
    minimum_value: 0.0
  taps:
    name: taps
    annotations:
      order:
        tag: order
        value: 16
    description: Use this to specify the p.u. tap of all windings at once using an
      array.
    comments:
    - Array form of tap (one per winding, per-unit). A RatioTapChanger is created
      per winding where taps[i] != 1.0.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:RatioTapChanger.step
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  XHL:
    name: XHL
    annotations:
      order:
        tag: order
        value: 17
    description: Percent reactance, H-L (winding 1 to winding 2). Use for 2- or 3-winding
      transformers. On the kVA base of winding 1.
    comments:
    - 'Winding 1-to-2 leakage reactance, in percent on the kVA base of winding 1.
      Import: x_ohm = (XHL / 100) * zbase, where zbase = kV_wdg1^2 * 1000 / kVA_wdg1
      (both taken from the lower- numbered winding of the pair — here winding 1).
      Export: the same zbase formula recovers XHL = (x / zbase) * 100.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    domain_of:
    - Transformer
    range: float
    required: false
  XHT:
    name: XHT
    annotations:
      order:
        tag: order
        value: 18
    description: Percent reactance, H-T (winding 1 to winding 3). Use for 3-winding
      transformers only. On the kVA base of winding 1.
    comments:
    - Winding 1-to-3 leakage reactance, in percent on the kVA base of winding 1. Same
      conversion as XHL, with zbase computed from winding 1's own kV and kVA (winding
      1 is the lower-numbered winding of the 1-3 pair).
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    domain_of:
    - Autotrans
    - Transformer
    range: float
    required: false
  XLT:
    name: XLT
    annotations:
      order:
        tag: order
        value: 19
    description: Percent reactance, L-T (winding 2 to winding 3). Use for 3-winding
      transformers only. On the kVA base of winding 1.
    comments:
    - 'Winding 2-to-3 leakage reactance, in percent, using the kVA base of winding
      1 but the kV base of winding 2 (the lower- numbered winding of the 2-3 pair):
      zbase = kV_wdg2^2 * 1000 / kVA_wdg1. Import/export conversion is otherwise the
      same formula as XHL.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    domain_of:
    - Transformer
    range: float
    required: false
  Xscarray:
    name: Xscarray
    annotations:
      order:
        tag: order
        value: 20
    description: Percent reactance between all pairs of windings as an array. All
      values are on the kVA base of winding 1.
    comments:
    - Array form giving one percent leakage-reactance entry per winding pair, ordered
      (1-2, 1-3, ..., 2-3, 2-4, ...) — i.e. by increasing "from" winding, then increasing
      "to" winding. Each entry maps to a separate TransformerMeshImpedance.x, with
      zbase = kV_from^2 * 1000 / kVA_wdg1 (the "from" winding's own kV, always winding
      1's kVA), matching the XHL/XHT/XLT convention.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  thermal:
    name: thermal
    annotations:
      order:
        tag: order
        value: 21
      dss_default:
        tag: dss_default
        value: float(2.0)
    description: Thermal time constant of the transformer in hours. Typically about
      2.
    todos:
    - No CIM equivalent in standard profile. Consider CIM extension for IEEE C57 thermal
      model parameters.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  n:
    name: n
    annotations:
      order:
        tag: order
        value: 22
      dss_default:
        tag: dss_default
        value: float(0.8)
    description: n Exponent for thermal properties in IEEE C57. Typically 0.8.
    todos:
    - No CIM equivalent. IEEE C57 exponent n for thermal model; requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  m:
    name: m
    annotations:
      order:
        tag: order
        value: 23
      dss_default:
        tag: dss_default
        value: float(0.9)
    description: m Exponent for thermal properties in IEEE C57. Typically 0.9 - 1.0.
    todos:
    - No CIM equivalent. IEEE C57 exponent m for thermal model; requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  flrise:
    name: flrise
    annotations:
      order:
        tag: order
        value: 24
      dss_default:
        tag: dss_default
        value: float(65.0)
    description: Temperature rise, deg C, for full load. Default is 65.
    todos:
    - No CIM equivalent. Full-load temperature rise (deg C); requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  hsrise:
    name: hsrise
    annotations:
      order:
        tag: order
        value: 25
      dss_default:
        tag: dss_default
        value: float(15.0)
    description: Hot spot temperature rise, deg C. Default is 15.
    todos:
    - No CIM equivalent. Hot-spot temperature rise (deg C); requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    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. The %R of the High and Low windings
      (1 and 2) are adjusted to agree at rated kVA loading.
    comments:
    - 'Import fallback only, used when neither %R nor %Rs[] is given: each winding''s
      own resistance percentage is set to %loadloss / num_windings (evenly split),
      then converted to ohms on PowerTransformerEnd.r using the same zbase formula
      as %R. Export never recovers %loadloss — it always recomputes %r per winding
      from PowerTransformerEnd.r, so a model that originally set only %loadloss will
      round-trip as %Rs[] instead.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformerEnd.r
    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'
      dss_default:
        tag: dss_default
        value: float(0.0)
    description: Percent no load losses at rated excitatation voltage. Default is
      0. Converts to a resistance in parallel with the magnetizing impedance in each
      winding.
    comments:
    - 'Import: a single TransformerCoreAdmittance is created on the primary winding
      (whenever %noloadloss or %imag is nonzero), with g = (pct_noloadloss / 100)
      / zbase, using the primary winding''s own zbase = kV^2 * 1000 / kVA. Export
      reverses the same formula. When an XfmrCode catalog entry is used instead, the
      equivalent value is read from a NoLoadTest attached to the catalog''s primary
      TransformerEndInfo.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerCoreAdmittance.g
    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). Usually 100%-110%
      of maximum nameplate rating. Defaults to 110% of kVA rating of Winding 1.
    todos:
    - No CIM equivalent. Normal H-winding kVA rating; consider OperationalLimitSet
      mapping.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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). Usually
      140%-150% of maximum nameplate rating. Defaults to 150% of kVA rating of Winding
      1.
    todos:
    - No CIM equivalent. Emergency H-winding kVA rating; consider OperationalLimitSet
      mapping.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  sub:
    name: sub
    annotations:
      order:
        tag: order
        value: 30
      dss_default:
        tag: dss_default
        value: 'false'
    description: Designates whether this transformer is to be considered a substation.
      Default is No.
    todos:
    - Not read by the current importer or written by the exporter — the transformer's
      EquipmentContainer is always the feeder container, never a Substation. If implemented,
      sub=Yes should place the PowerTransformer in a CIM Substation container.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    range: boolean
    required: false
  MaxTap:
    name: MaxTap
    annotations:
      order:
        tag: order
        value: 31
      dss_default:
        tag: dss_default
        value: float(1.10)
    description: Max per unit tap for the active winding. Default is 1.10.
    todos:
    - 'Not exported: the exporter reads back RatioTapChanger.step for tap= but never
      reconstructs MaxTap/MinTap/NumTaps from highStep/lowStep/stepVoltageIncrement.'
    comments:
    - 'Import: only applies to windings whose tap differs from 1.0 (a RatioTapChanger
      is created for that winding); highStep is set to NumTaps / 2 (defaulting to
      16 if NumTaps is absent), and stepVoltageIncrement = (MaxTap - MinTap) / (highStep
      - lowStep) * 100. MaxTap itself is not stored on any CIM field — only its derived
      effect on highStep and stepVoltageIncrement is.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:RatioTapChanger.highStep
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  MinTap:
    name: MinTap
    annotations:
      order:
        tag: order
        value: 32
      dss_default:
        tag: dss_default
        value: float(0.90)
    description: Min per unit tap for the active winding. Default is 0.90.
    todos:
    - Not exported; see MaxTap todos.
    comments:
    - 'Import: lowStep = -highStep (see MaxTap comments), and combines with MaxTap
      to set stepVoltageIncrement. MinTap itself is not stored on any CIM field directly.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:RatioTapChanger.lowStep
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  NumTaps:
    name: NumTaps
    annotations:
      order:
        tag: order
        value: 33
      dss_default:
        tag: dss_default
        value: int(32)
    description: Total number of taps between min and max tap. Default is 32 (16 raise
      and 16 lower taps about the neutral position). The neutral position is not counted.
    todos:
    - Not exported; see MaxTap todos.
    comments:
    - 'Import: highStep = NumTaps / 2, lowStep = -highStep (see MaxTap comments);
      no single CIM field stores NumTaps directly.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:RatioTapChanger.highStep
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: integer
    required: false
  subname:
    name: subname
    annotations:
      order:
        tag: order
        value: 34
    description: Substation Name. Optional. Default is null. If specified, printed
      on plots.
    todos:
    - Not read by the current importer or written by the exporter; see sub todos.
      If implemented, would name the CIM Substation container created for sub=Yes
      transformers.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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'
      dss_default:
        tag: dss_default
        value: float(0.0)
    description: Percent magnetizing current. Default=0.0. Magnetizing branch is in
      parallel with windings in each phase.
    comments:
    - 'Import: stored on the same primary-winding TransformerCoreAdmittance as %noloadloss,
      with b = (pct_imag / 100) / zbase using the primary winding''s own zbase = kV^2
      * 1000 / kVA. Export reverses the same formula. When an XfmrCode catalog entry
      is used instead, the equivalent value is reconstructed from the catalog NoLoadTest''s
      excitingCurrent field via pct_imag = sqrt(excitingCurrent^2 - pct_noloadloss^2).'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerCoreAdmittance.b
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  ppm_antifloat:
    name: ppm_antifloat
    annotations:
      order:
        tag: order
        value: 36
      dss_default:
        tag: dss_default
        value: float(1.0)
    description: Default=1 ppm. Parts per million of transformer winding VA rating
      connected to ground to protect against accidentally floating a winding without
      a reference.
    todos:
    - No CIM equivalent. Anti-float grounding resistance in ppm; requires CIM extension
      or drop on export.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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 %resistances using an
      array.
    comments:
    - 'Array form of pct_R (one per winding). Same per-unit to ohm conversion as pct_R:
      r_ohm = (pct_Rs[i] / 100) * zbase_i.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:PowerTransformerEnd.r
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  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.
    comments:
    - Bank name groups single-phase TransformerTank objects under one shared PowerTransformer.
      When bank is set, this Transformer becomes a TransformerTank; multiple tanks
      with the same bank name share one PowerTransformer parent.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformer
    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. The named XfmrCode
      must already be defined.
    comments:
    - 'Import (3-phase path): looked up by name against previously converted PowerTransformerInfo
      catalog objects; if found, it is set as PowerTransformer.AssetDatasheet and
      impedance/loss data come from the catalog''s TransformerEndInfo/ShortCircuitTest/
      NoLoadTest objects instead of being computed inline. Export: writes XfmrCode=AssetDatasheet.name
      whenever AssetDatasheet is set. Single-phase bank members instead look up a
      TransformerTankInfo directly (see general/xfmrcode.yaml).'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformer.AssetDatasheet
    domain_of:
    - Autotrans
    - Transformer
    range: string
    required: false
  XRConst:
    name: XRConst
    annotations:
      order:
        tag: order
        value: 40
      dss_default:
        tag: dss_default
        value: 'false'
    description: Default is NO. Signifies whether or not the X/R is assumed contant
      for harmonic studies.
    todos:
    - No CIM equivalent. X/R constancy flag for harmonic studies; drop on export or
      store as extension attribute.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    range: boolean
    required: false
  X12:
    name: X12
    annotations:
      order:
        tag: order
        value: 41
    description: 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.
    comments:
    - 'Import-only fallback for XHL: used when XHL is not specified (2-winding case)
      or when XHL/XHT/XLT are not all three given together (3-winding case). Same
      zbase conversion as XHL. Export always writes XHL, never X12.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
  X13:
    name: X13
    annotations:
      order:
        tag: order
        value: 42
    description: 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.
    comments:
    - Import-only fallback for XHT, used only when XHL/XHT/XLT are not all three given
      together for a 3-winding transformer (must appear alongside X12 and X23). Same
      zbase conversion as XHT. Export always writes XHT, never X13.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
  X23:
    name: X23
    annotations:
      order:
        tag: order
        value: 43
    description: 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.
    comments:
    - Import-only fallback for XLT, used only when XHL/XHT/XLT are not all three given
      together for a 3-winding transformer (must appear alongside X12 and X13). Same
      zbase conversion as XLT. Export always writes XLT, never X23.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
  LeadLag:
    name: LeadLag
    annotations:
      order:
        tag: order
        value: 44
    description: Designation in mixed Delta-wye connections the relationship between
      HV to LV winding. Default is ANSI 30 deg lag.
    todos:
    - No CIM equivalent in standard profile. Phase shift convention for mixed Delta-wye;
      requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    range: LeadLagType
    required: false
  Core:
    name: Core
    annotations:
      order:
        tag: order
        value: 46
    description: Core Type. Used for GIC analysis. Default is Shell.
    todos:
    - No CIM equivalent in standard profile. Core type for GIC analysis (Shell/5-leg/3-leg);
      requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Transformer
    range: CoreType
    required: false
  RdcOhms:
    name: RdcOhms
    annotations:
      order:
        tag: order
        value: 47
    description: Winding dc resistance in OHMS. Useful for GIC analysis. From transformer
      test report. Defaults to 85% of %R property.
    todos:
    - No CIM equivalent in standard profile. DC winding resistance for GIC analysis;
      requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    rank: 1000
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  Seasons:
    name: Seasons
    annotations:
      order:
        tag: order
        value: 48
    description: Defines the number of ratings to be defined for the transfomer, to
      be used only when defining seasonal ratings using the Ratings property.
    todos:
    - No CIM equivalent. Seasonal ratings count; see Ratings property.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Line
    - Transformer
    - Storagecontroller
    - Cndata
    - Linecode
    - Linegeometry
    - Tsdata
    - Wiredata
    - Xfmrcode
    range: integer
    required: false
  Ratings:
    name: Ratings
    annotations:
      order:
        tag: order
        value: 49
    description: An array of ratings to be used when the seasonal ratings flag is
      True. Given in kVA.
    todos:
    - Seasonal kVA ratings array. Map to CIM OperationalLimitSet with one ActivePowerLimit
      or ApparentPowerLimit per season; converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:OperationalLimitSet
    domain_of:
    - Line
    - Transformer
    - Cndata
    - Linecode
    - Linegeometry
    - Tsdata
    - Wiredata
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  normamps:
    name: normamps
    annotations:
      order:
        tag: order
        value: 50
    description: Normal rated current.
    todos:
    - Map to CIM OperationalLimitSet/CurrentLimit for normal rating; converter not
      yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:OperationalLimit
    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: 51
    description: Maximum or emerg current.
    todos:
    - Map to CIM OperationalLimitSet/CurrentLimit for emergency rating; converter
      not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:OperationalLimit
    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: 52
    description: Failure rate per year.
    todos:
    - No CIM equivalent in standard profile. Requires CIM extension for reliability
      data.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Linecode
    - Fault
    range: float
    required: false
  pct_perm:
    name: pct_perm
    annotations:
      order:
        tag: order
        value: 53
      dss_name:
        tag: dss_name
        value: pctperm
    description: Percent of failures that become permanent.
    todos:
    - No CIM equivalent in standard profile. Requires CIM extension for reliability
      data.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Line
    - Transformer
    range: float
    required: false
  repair:
    name: repair
    annotations:
      order:
        tag: order
        value: 54
    description: Hours to repair.
    todos:
    - No CIM equivalent in standard profile. Requires CIM extension for reliability
      data.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    domain_of:
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Linecode
    - Fault
    range: float
    required: false
  basefreq:
    name: basefreq
    annotations:
      order:
        tag: order
        value: 55
    description: Base Frequency for ratings.
    todos:
    - Not stored on CIM PowerTransformer. Extract from circuit-level BaseVoltage or
      NetworkModelProject frequency attribute on export.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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: 56
      dss_default:
        tag: dss_default
        value: 'true'
    description: Indicates whether this element is enabled.
    comments:
    - 'N/A: CIM transformers are always present/enabled; disabled elements are omitted
      from the CIM export.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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: 57
    description: 'Make like another object, e.g.: New Capacitor.C2 like=c1 ...'
    comments:
    - 'N/A: OpenDSS template mechanism; resolved at parse time, not stored in CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    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:Transformer

Induced

name: Transformer
description: A Transformer object in OpenDSS representing a multi-winding transformer
  connecting two or more buses in the distribution system.
comments:
- '3-phase (or phases > 1): mapped to CIM PowerTransformer with one PowerTransformerEnd
  per winding. Single-phase with bank set: mapped to a TransformerTank (one TransformerTankEnd
  per winding) attached to a shared PowerTransformer named after the bank, so all
  single-phase units of a bank share one CIM transformer container. Impedances are
  stored as TransformerMeshImpedance objects between winding pairs, and no-load losses/magnetizing
  current as a single TransformerCoreAdmittance on the primary winding — unless an
  XfmrCode catalog entry is referenced, in which case impedance and loss data are
  instead read from the catalog''s ShortCircuitTest and NoLoadTest objects.'
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.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:IdentifiedObject.name
    identifier: true
    owner: Transformer
    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
      dss_default:
        tag: dss_default
        value: int(3)
    description: Number of phases this transformer. Default is 3.
    comments:
    - 1-phase transformers with bank set are routed to the TransformerTank path rather
      than a standalone PowerTransformer.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformerEnd
    owner: Transformer
    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
    minimum_value: 1
    maximum_value: 3
  windings:
    name: windings
    annotations:
      order:
        tag: order
        value: 2
      dss_default:
        tag: dss_default
        value: int(2)
    description: 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.
    comments:
    - Count of PowerTransformerEnd objects attached to the PowerTransformer.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformerEnd
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: integer
    required: false
    minimum_value: 2
  wdg:
    name: wdg
    annotations:
      order:
        tag: order
        value: 3
    description: Set this to the number of the winding you wish to define. Then set
      the values for this winding. Repeat for each winding.
    comments:
    - 'N/A: OpenDSS winding selector resolved at parse time; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: integer
    required: false
  bus:
    name: bus
    annotations:
      order:
        tag: order
        value: 4
    description: Bus connection spec for this winding.
    comments:
    - 'Per-winding terminal traversal: each winding maps to a CIM Terminal whose ConnectivityNode
      carries the bus name.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:Terminal.ConnectivityNode
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Regcontrol
    range: string
    required: false
  conn:
    name: conn
    annotations:
      order:
        tag: order
        value: 5
    description: Connection of this winding. Default is wye with the neutral solidly
      grounded.
    comments:
    - 'WindingConnection enum: Y→wye, D→delta. Import/export: direct enum translation.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.connectionKind
    owner: Transformer
    domain_of:
    - Load
    - Generator
    - Generic5
    - Indmach012
    - Pvsystem
    - Storage
    - Windgen
    - Autotrans
    - Capacitor
    - Reactor
    - Transformer
    - Xfmrcode
    - Sensor
    range: ConnectionType
    required: false
  kV:
    name: kV
    annotations:
      order:
        tag: order
        value: 6
    description: For 2-or 3-phase, enter phase-phase kV rating. Otherwise, kV rating
      of the actual winding.
    comments:
    - 'Unit conversion: import ratedU = kV(V) * 1000; export kV = ratedU / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.ratedU
    owner: Transformer
    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. Side effect: forces change of max
      normal and emerg kVA ratings.'
    comments:
    - 'Unit conversion: import ratedS = kVA * 1000; export kVA = ratedS / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.ratedS
    owner: Transformer
    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.
    comments:
    - 'Per-unit tap position. A RatioTapChanger is attached to the PowerTransformerEnd
      when tap != 1.0. Import/export: direct per-unit value.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:RatioTapChanger.step
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  pct_R:
    name: pct_R
    annotations:
      order:
        tag: order
        value: 9
      dss_name:
        tag: dss_name
        value: '%R'
    description: Percent resistance this winding. Half of total for a 2-winding.
    comments:
    - 'Import: r_ohm = (pct_R / 100) * zbase, where zbase = kV^2 * 1e6 / kVA_VA. Export:
      pct_R = (r / zbase) * 100.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:PowerTransformerEnd.r
    owner: Transformer
    domain_of:
    - Pvsystem
    - Storage
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    minimum_value: 0.0
  Rneut:
    name: Rneut
    annotations:
      order:
        tag: order
        value: 10
      dss_default:
        tag: dss_default
        value: float(-1.0)
    description: Neutral resistance of wye (star)-connected winding in actual ohms.
      Default is -1. If entered as negative, the neutral is assumed to be open or
      floating.
    comments:
    - 'Unit: ohm (no conversion). Negative value indicates open/floating neutral.
      Import/export: direct ohm value.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.rground
    owner: Transformer
    domain_of:
    - Load
    - Transformer
    - Xfmrcode
    range: float
    required: false
  Xneut:
    name: Xneut
    annotations:
      order:
        tag: order
        value: 11
    description: Neutral reactance of wye(star)-connected winding in actual ohms.
      May be positive or negative.
    comments:
    - 'Unit: ohm (no conversion). Import/export: direct ohm value.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.xground
    owner: Transformer
    domain_of:
    - Load
    - Transformer
    - Xfmrcode
    range: float
    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.
    comments:
    - Array form of bus (one entry per winding). Each element maps to the ConnectivityNode
      of the corresponding winding Terminal.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:Terminal.ConnectivityNode
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    range: string
    required: false
    multivalued: true
  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 (one WindingConnection per winding). Import/export: direct
      enum translation per element.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.connectionKind
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: ConnectionType
    required: false
    multivalued: true
  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 (one per winding, kV). Unit conversion per element: import
      ratedU = kVs[i] * 1000; export kVs[i] = ratedU / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.ratedU
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    - Sensor
    range: float
    required: false
    multivalued: true
    minimum_value: 0.0
  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 (one per winding, kVA). Unit conversion per element: import
      ratedS = kVAs[i] * 1000; export kVAs[i] = ratedS / 1000.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:PowerTransformerEnd.ratedS
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
    minimum_value: 0.0
  taps:
    name: taps
    annotations:
      order:
        tag: order
        value: 16
    description: Use this to specify the p.u. tap of all windings at once using an
      array.
    comments:
    - Array form of tap (one per winding, per-unit). A RatioTapChanger is created
      per winding where taps[i] != 1.0.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    exact_mappings:
    - cim:RatioTapChanger.step
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  XHL:
    name: XHL
    annotations:
      order:
        tag: order
        value: 17
    description: Percent reactance, H-L (winding 1 to winding 2). Use for 2- or 3-winding
      transformers. On the kVA base of winding 1.
    comments:
    - 'Winding 1-to-2 leakage reactance, in percent on the kVA base of winding 1.
      Import: x_ohm = (XHL / 100) * zbase, where zbase = kV_wdg1^2 * 1000 / kVA_wdg1
      (both taken from the lower- numbered winding of the pair — here winding 1).
      Export: the same zbase formula recovers XHL = (x / zbase) * 100.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    owner: Transformer
    domain_of:
    - Transformer
    range: float
    required: false
  XHT:
    name: XHT
    annotations:
      order:
        tag: order
        value: 18
    description: Percent reactance, H-T (winding 1 to winding 3). Use for 3-winding
      transformers only. On the kVA base of winding 1.
    comments:
    - Winding 1-to-3 leakage reactance, in percent on the kVA base of winding 1. Same
      conversion as XHL, with zbase computed from winding 1's own kV and kVA (winding
      1 is the lower-numbered winding of the 1-3 pair).
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    range: float
    required: false
  XLT:
    name: XLT
    annotations:
      order:
        tag: order
        value: 19
    description: Percent reactance, L-T (winding 2 to winding 3). Use for 3-winding
      transformers only. On the kVA base of winding 1.
    comments:
    - 'Winding 2-to-3 leakage reactance, in percent, using the kVA base of winding
      1 but the kV base of winding 2 (the lower- numbered winding of the 2-3 pair):
      zbase = kV_wdg2^2 * 1000 / kVA_wdg1. Import/export conversion is otherwise the
      same formula as XHL.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    owner: Transformer
    domain_of:
    - Transformer
    range: float
    required: false
  Xscarray:
    name: Xscarray
    annotations:
      order:
        tag: order
        value: 20
    description: Percent reactance between all pairs of windings as an array. All
      values are on the kVA base of winding 1.
    comments:
    - Array form giving one percent leakage-reactance entry per winding pair, ordered
      (1-2, 1-3, ..., 2-3, 2-4, ...) — i.e. by increasing "from" winding, then increasing
      "to" winding. Each entry maps to a separate TransformerMeshImpedance.x, with
      zbase = kV_from^2 * 1000 / kVA_wdg1 (the "from" winding's own kV, always winding
      1's kVA), matching the XHL/XHT/XLT convention.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    owner: Transformer
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  thermal:
    name: thermal
    annotations:
      order:
        tag: order
        value: 21
      dss_default:
        tag: dss_default
        value: float(2.0)
    description: Thermal time constant of the transformer in hours. Typically about
      2.
    todos:
    - No CIM equivalent in standard profile. Consider CIM extension for IEEE C57 thermal
      model parameters.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  n:
    name: n
    annotations:
      order:
        tag: order
        value: 22
      dss_default:
        tag: dss_default
        value: float(0.8)
    description: n Exponent for thermal properties in IEEE C57. Typically 0.8.
    todos:
    - No CIM equivalent. IEEE C57 exponent n for thermal model; requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  m:
    name: m
    annotations:
      order:
        tag: order
        value: 23
      dss_default:
        tag: dss_default
        value: float(0.9)
    description: m Exponent for thermal properties in IEEE C57. Typically 0.9 - 1.0.
    todos:
    - No CIM equivalent. IEEE C57 exponent m for thermal model; requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  flrise:
    name: flrise
    annotations:
      order:
        tag: order
        value: 24
      dss_default:
        tag: dss_default
        value: float(65.0)
    description: Temperature rise, deg C, for full load. Default is 65.
    todos:
    - No CIM equivalent. Full-load temperature rise (deg C); requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  hsrise:
    name: hsrise
    annotations:
      order:
        tag: order
        value: 25
      dss_default:
        tag: dss_default
        value: float(15.0)
    description: Hot spot temperature rise, deg C. Default is 15.
    todos:
    - No CIM equivalent. Hot-spot temperature rise (deg C); requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    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. The %R of the High and Low windings
      (1 and 2) are adjusted to agree at rated kVA loading.
    comments:
    - 'Import fallback only, used when neither %R nor %Rs[] is given: each winding''s
      own resistance percentage is set to %loadloss / num_windings (evenly split),
      then converted to ohms on PowerTransformerEnd.r using the same zbase formula
      as %R. Export never recovers %loadloss — it always recomputes %r per winding
      from PowerTransformerEnd.r, so a model that originally set only %loadloss will
      round-trip as %Rs[] instead.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformerEnd.r
    owner: Transformer
    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'
      dss_default:
        tag: dss_default
        value: float(0.0)
    description: Percent no load losses at rated excitatation voltage. Default is
      0. Converts to a resistance in parallel with the magnetizing impedance in each
      winding.
    comments:
    - 'Import: a single TransformerCoreAdmittance is created on the primary winding
      (whenever %noloadloss or %imag is nonzero), with g = (pct_noloadloss / 100)
      / zbase, using the primary winding''s own zbase = kV^2 * 1000 / kVA. Export
      reverses the same formula. When an XfmrCode catalog entry is used instead, the
      equivalent value is read from a NoLoadTest attached to the catalog''s primary
      TransformerEndInfo.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerCoreAdmittance.g
    owner: Transformer
    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). Usually 100%-110%
      of maximum nameplate rating. Defaults to 110% of kVA rating of Winding 1.
    todos:
    - No CIM equivalent. Normal H-winding kVA rating; consider OperationalLimitSet
      mapping.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    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). Usually
      140%-150% of maximum nameplate rating. Defaults to 150% of kVA rating of Winding
      1.
    todos:
    - No CIM equivalent. Emergency H-winding kVA rating; consider OperationalLimitSet
      mapping.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  sub:
    name: sub
    annotations:
      order:
        tag: order
        value: 30
      dss_default:
        tag: dss_default
        value: 'false'
    description: Designates whether this transformer is to be considered a substation.
      Default is No.
    todos:
    - Not read by the current importer or written by the exporter — the transformer's
      EquipmentContainer is always the feeder container, never a Substation. If implemented,
      sub=Yes should place the PowerTransformer in a CIM Substation container.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    range: boolean
    required: false
  MaxTap:
    name: MaxTap
    annotations:
      order:
        tag: order
        value: 31
      dss_default:
        tag: dss_default
        value: float(1.10)
    description: Max per unit tap for the active winding. Default is 1.10.
    todos:
    - 'Not exported: the exporter reads back RatioTapChanger.step for tap= but never
      reconstructs MaxTap/MinTap/NumTaps from highStep/lowStep/stepVoltageIncrement.'
    comments:
    - 'Import: only applies to windings whose tap differs from 1.0 (a RatioTapChanger
      is created for that winding); highStep is set to NumTaps / 2 (defaulting to
      16 if NumTaps is absent), and stepVoltageIncrement = (MaxTap - MinTap) / (highStep
      - lowStep) * 100. MaxTap itself is not stored on any CIM field — only its derived
      effect on highStep and stepVoltageIncrement is.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:RatioTapChanger.highStep
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  MinTap:
    name: MinTap
    annotations:
      order:
        tag: order
        value: 32
      dss_default:
        tag: dss_default
        value: float(0.90)
    description: Min per unit tap for the active winding. Default is 0.90.
    todos:
    - Not exported; see MaxTap todos.
    comments:
    - 'Import: lowStep = -highStep (see MaxTap comments), and combines with MaxTap
      to set stepVoltageIncrement. MinTap itself is not stored on any CIM field directly.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:RatioTapChanger.lowStep
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  NumTaps:
    name: NumTaps
    annotations:
      order:
        tag: order
        value: 33
      dss_default:
        tag: dss_default
        value: int(32)
    description: Total number of taps between min and max tap. Default is 32 (16 raise
      and 16 lower taps about the neutral position). The neutral position is not counted.
    todos:
    - Not exported; see MaxTap todos.
    comments:
    - 'Import: highStep = NumTaps / 2, lowStep = -highStep (see MaxTap comments);
      no single CIM field stores NumTaps directly.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:RatioTapChanger.highStep
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: integer
    required: false
  subname:
    name: subname
    annotations:
      order:
        tag: order
        value: 34
    description: Substation Name. Optional. Default is null. If specified, printed
      on plots.
    todos:
    - Not read by the current importer or written by the exporter; see sub todos.
      If implemented, would name the CIM Substation container created for sub=Yes
      transformers.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    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'
      dss_default:
        tag: dss_default
        value: float(0.0)
    description: Percent magnetizing current. Default=0.0. Magnetizing branch is in
      parallel with windings in each phase.
    comments:
    - 'Import: stored on the same primary-winding TransformerCoreAdmittance as %noloadloss,
      with b = (pct_imag / 100) / zbase using the primary winding''s own zbase = kV^2
      * 1000 / kVA. Export reverses the same formula. When an XfmrCode catalog entry
      is used instead, the equivalent value is reconstructed from the catalog NoLoadTest''s
      excitingCurrent field via pct_imag = sqrt(excitingCurrent^2 - pct_noloadloss^2).'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerCoreAdmittance.b
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
  ppm_antifloat:
    name: ppm_antifloat
    annotations:
      order:
        tag: order
        value: 36
      dss_default:
        tag: dss_default
        value: float(1.0)
    description: Default=1 ppm. Parts per million of transformer winding VA rating
      connected to ground to protect against accidentally floating a winding without
      a reference.
    todos:
    - No CIM equivalent. Anti-float grounding resistance in ppm; requires CIM extension
      or drop on export.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    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 %resistances using an
      array.
    comments:
    - 'Array form of pct_R (one per winding). Same per-unit to ohm conversion as pct_R:
      r_ohm = (pct_Rs[i] / 100) * zbase_i.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:PowerTransformerEnd.r
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  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.
    comments:
    - Bank name groups single-phase TransformerTank objects under one shared PowerTransformer.
      When bank is set, this Transformer becomes a TransformerTank; multiple tanks
      with the same bank name share one PowerTransformer parent.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformer
    owner: Transformer
    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. The named XfmrCode
      must already be defined.
    comments:
    - 'Import (3-phase path): looked up by name against previously converted PowerTransformerInfo
      catalog objects; if found, it is set as PowerTransformer.AssetDatasheet and
      impedance/loss data come from the catalog''s TransformerEndInfo/ShortCircuitTest/
      NoLoadTest objects instead of being computed inline. Export: writes XfmrCode=AssetDatasheet.name
      whenever AssetDatasheet is set. Single-phase bank members instead look up a
      TransformerTankInfo directly (see general/xfmrcode.yaml).'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:PowerTransformer.AssetDatasheet
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    range: string
    required: false
  XRConst:
    name: XRConst
    annotations:
      order:
        tag: order
        value: 40
      dss_default:
        tag: dss_default
        value: 'false'
    description: Default is NO. Signifies whether or not the X/R is assumed contant
      for harmonic studies.
    todos:
    - No CIM equivalent. X/R constancy flag for harmonic studies; drop on export or
      store as extension attribute.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    range: boolean
    required: false
  X12:
    name: X12
    annotations:
      order:
        tag: order
        value: 41
    description: 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.
    comments:
    - 'Import-only fallback for XHL: used when XHL is not specified (2-winding case)
      or when XHL/XHT/XLT are not all three given together (3-winding case). Same
      zbase conversion as XHL. Export always writes XHL, never X12.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    owner: Transformer
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
  X13:
    name: X13
    annotations:
      order:
        tag: order
        value: 42
    description: 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.
    comments:
    - Import-only fallback for XHT, used only when XHL/XHT/XLT are not all three given
      together for a 3-winding transformer (must appear alongside X12 and X23). Same
      zbase conversion as XHT. Export always writes XHT, never X13.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    owner: Transformer
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
  X23:
    name: X23
    annotations:
      order:
        tag: order
        value: 43
    description: 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.
    comments:
    - Import-only fallback for XLT, used only when XHL/XHT/XLT are not all three given
      together for a 3-winding transformer (must appear alongside X12 and X13). Same
      zbase conversion as XLT. Export always writes XLT, never X23.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    close_mappings:
    - cim:TransformerMeshImpedance.x
    rank: 1000
    owner: Transformer
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
  LeadLag:
    name: LeadLag
    annotations:
      order:
        tag: order
        value: 44
    description: Designation in mixed Delta-wye connections the relationship between
      HV to LV winding. Default is ANSI 30 deg lag.
    todos:
    - No CIM equivalent in standard profile. Phase shift convention for mixed Delta-wye;
      requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    range: LeadLagType
    required: false
  Core:
    name: Core
    annotations:
      order:
        tag: order
        value: 46
    description: Core Type. Used for GIC analysis. Default is Shell.
    todos:
    - No CIM equivalent in standard profile. Core type for GIC analysis (Shell/5-leg/3-leg);
      requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Transformer
    range: CoreType
    required: false
  RdcOhms:
    name: RdcOhms
    annotations:
      order:
        tag: order
        value: 47
    description: Winding dc resistance in OHMS. Useful for GIC analysis. From transformer
      test report. Defaults to 85% of %R property.
    todos:
    - No CIM equivalent in standard profile. DC winding resistance for GIC analysis;
      requires CIM extension.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    rank: 1000
    owner: Transformer
    domain_of:
    - Transformer
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  Seasons:
    name: Seasons
    annotations:
      order:
        tag: order
        value: 48
    description: Defines the number of ratings to be defined for the transfomer, to
      be used only when defining seasonal ratings using the Ratings property.
    todos:
    - No CIM equivalent. Seasonal ratings count; see Ratings property.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Line
    - Transformer
    - Storagecontroller
    - Cndata
    - Linecode
    - Linegeometry
    - Tsdata
    - Wiredata
    - Xfmrcode
    range: integer
    required: false
  Ratings:
    name: Ratings
    annotations:
      order:
        tag: order
        value: 49
    description: An array of ratings to be used when the seasonal ratings flag is
      True. Given in kVA.
    todos:
    - Seasonal kVA ratings array. Map to CIM OperationalLimitSet with one ActivePowerLimit
      or ApparentPowerLimit per season; converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:OperationalLimitSet
    owner: Transformer
    domain_of:
    - Line
    - Transformer
    - Cndata
    - Linecode
    - Linegeometry
    - Tsdata
    - Wiredata
    - Xfmrcode
    range: float
    required: false
    multivalued: true
  normamps:
    name: normamps
    annotations:
      order:
        tag: order
        value: 50
    description: Normal rated current.
    todos:
    - Map to CIM OperationalLimitSet/CurrentLimit for normal rating; converter not
      yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:OperationalLimit
    owner: Transformer
    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: 51
    description: Maximum or emerg current.
    todos:
    - Map to CIM OperationalLimitSet/CurrentLimit for emergency rating; converter
      not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    related_mappings:
    - cim:OperationalLimit
    owner: Transformer
    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: 52
    description: Failure rate per year.
    todos:
    - No CIM equivalent in standard profile. Requires CIM extension for reliability
      data.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Linecode
    - Fault
    range: float
    required: false
  pct_perm:
    name: pct_perm
    annotations:
      order:
        tag: order
        value: 53
      dss_name:
        tag: dss_name
        value: pctperm
    description: Percent of failures that become permanent.
    todos:
    - No CIM equivalent in standard profile. Requires CIM extension for reliability
      data.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Line
    - Transformer
    range: float
    required: false
  repair:
    name: repair
    annotations:
      order:
        tag: order
        value: 54
    description: Hours to repair.
    todos:
    - No CIM equivalent in standard profile. Requires CIM extension for reliability
      data.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    domain_of:
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Linecode
    - Fault
    range: float
    required: false
  basefreq:
    name: basefreq
    annotations:
      order:
        tag: order
        value: 55
    description: Base Frequency for ratings.
    todos:
    - Not stored on CIM PowerTransformer. Extract from circuit-level BaseVoltage or
      NetworkModelProject frequency attribute on export.
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    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: 56
      dss_default:
        tag: dss_default
        value: 'true'
    description: Indicates whether this element is enabled.
    comments:
    - 'N/A: CIM transformers are always present/enabled; disabled elements are omitted
      from the CIM export.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    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: 57
    description: 'Make like another object, e.g.: New Capacitor.C2 like=c1 ...'
    comments:
    - 'N/A: OpenDSS template mechanism; resolved at parse time, not stored in CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/pde/transformer
    owner: Transformer
    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:Transformer