Class DistributionTapChanger

                                    object --+                    
                                             |                    
                              Element'.Element --+                
                                                 |                
  IEC61970.Core.IdentifiedObject'.IdentifiedObject --+            
                                                     |            
IEC61970.Core.PowerSystemResource'.PowerSystemResource --+        
                                                         |        
                     IEC61970.Wires.TapChanger'.TapChanger --+    
                                                             |    
               IEC61970.Wires.RatioTapChanger'.RatioTapChanger --+
                                                                 |
                                                                DistributionTapChanger

Additional ratio tap changer parameters common to distribution line regulators. 'tculControlMode' would always be 'volt'. If 'monitoredPhase' is not specified, then if the controlled DistributionTransformerWinding is single-phase, the PT primary is assumed to be connected across that winding, which is the normal case. If the controlled winding is three-phase, then the 'monitoredPhase' is assumed to be 'AN', unless otherwise specified. Whenever 'ctRatio' and 'ptRatio' are specified, it's customary to specify the R and X in 'volts' referred to the PT secondary circuit, otherwise R and X are in feeder primary ohms. If 'ptRatio' is not specified, then 'targetVoltage', 'limitVoltage', and 'bandVoltage' are on the feeder primary base, phase-neutral or phase-phase depending on the 'monitoredPhase'. Otherwise, these attributes are all on the PT secondary base.

Instance Methods

[hide private]

__init__(self, lineDropR=0.0, monitoredPhase='ABC', lineDropCompensation=False, ptRatio=0.0, ctRatio=0.0, reverseLineDropR=0.0, limitVoltage=0.0, reverseLineDropX=0.0, bandVoltage=0.0, targetVoltage=0.0, lineDropX=0.0, *args, **kw_args)
Initialises a new 'DistributionTapChanger' instance.

Inherited from IEC61970.Wires.RatioTapChanger'.RatioTapChanger: getWinding, setWinding

Inherited from IEC61970.Wires.TapChanger'.TapChanger: getSvTapStep, setSvTapStep

Inherited from IEC61970.Core.PowerSystemResource'.PowerSystemResource: getGeoLocation, getPSRType, setGeoLocation, setPSRType

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Class Variables

[hide private]

_attr_types = {'bandVoltage': <type 'float'>, 'ctRatio': <type...

_attrs = ['lineDropR', 'monitoredPhase', 'lineDropCompensation...

_defaults = {'bandVoltage': 0.0, 'ctRatio': 0.0, 'limitVoltage...

_enums = {'monitoredPhase': 'PhaseCode'}

_refs = []

Inherited from Element'.Element (private): _many_refs

Properties

[hide private]

Inherited from IEC61970.Wires.RatioTapChanger'.RatioTapChanger: Winding

Inherited from IEC61970.Wires.TapChanger'.TapChanger: SvTapStep

Inherited from IEC61970.Core.PowerSystemResource'.PowerSystemResource: GeoLocation, PSRType

Inherited from object: __class__

Method Details

[hide private]

init(self, lineDropR=0.0, monitoredPhase=`'ABC'`, lineDropCompensation=False, ptRatio=0.0, ctRatio=0.0, reverseLineDropR=0.0, limitVoltage=0.0, reverseLineDropX=0.0, bandVoltage=0.0, targetVoltage=0.0, lineDropX=0.0, *args, **kw_args)
(Constructor)

Initialises a new 'DistributionTapChanger' instance.

Parameters:

lineDropR - Line drop compensator resistance setting for normal (forward) power flow.
monitoredPhase - Phase voltage controlling this regulator, measured at regulator location. Values are: "ABC", "splitSecondary2N", "ABN", "CN", "ACN", "BC", "AN", "BN", "AB", "splitSecondary1N", "N", "C", "AC", "ABCN", "splitSecondary12N", "A", "B", "BCN"
lineDropCompensation - If true, the line drop compensation is to be applied.
ptRatio - Built-in voltage transducer ratio.
ctRatio - Built-in current transducer ratio.
reverseLineDropR - Line drop compensator resistance setting for reverse power flow.
limitVoltage - Maximum allowed regulated voltage on the PT secondary base, regardless of line drop compensation. Sometimes referred to as first-house protection.
reverseLineDropX - Line drop compensator reactance setting for reverse power flow.
bandVoltage - Voltage range (max - min) on the PT secondary base, centered on 'targetVoltage'.
targetVoltage - Target voltage on the PT secondary base.
lineDropX - Line drop compensator reactance setting for normal (forward) power flow.

Overrides: object.__init__

Class Variable Details

[hide private]

_attr_types

Value:

{'bandVoltage': <type 'float'>,
 'ctRatio': <type 'float'>,
 'limitVoltage': <type 'float'>,
 'lineDropCompensation': <type 'bool'>,
 'lineDropR': <type 'float'>,
 'lineDropX': <type 'float'>,
 'monitoredPhase': <type 'str'>,
 'ptRatio': <type 'float'>,
...

_attrs

Value:

['lineDropR',
 'monitoredPhase',
 'lineDropCompensation',
 'ptRatio',
 'ctRatio',
 'reverseLineDropR',
 'limitVoltage',
 'reverseLineDropX',
...

_defaults

Value:

{'bandVoltage': 0.0,
 'ctRatio': 0.0,
 'limitVoltage': 0.0,
 'lineDropCompensation': False,
 'lineDropR': 0.0,
 'lineDropX': 0.0,
 'monitoredPhase': 'ABC',
 'ptRatio': 0.0,
...

Class DistributionTapChanger

__init__(self, lineDropR=0.0, monitoredPhase='ABC', lineDropCompensation=False, ptRatio=0.0, ctRatio=0.0, reverseLineDropR=0.0, limitVoltage=0.0, reverseLineDropX=0.0, bandVoltage=0.0, targetVoltage=0.0, lineDropX=0.0, *args, **kw_args) (Constructor)

_attr_types

_attrs

_defaults

init(self, lineDropR=0.0, monitoredPhase=`'ABC'`, lineDropCompensation=False, ptRatio=0.0, ctRatio=0.0, reverseLineDropR=0.0, limitVoltage=0.0, reverseLineDropX=0.0, bandVoltage=0.0, targetVoltage=0.0, lineDropX=0.0, *args, **kw_args)
(Constructor)