Package CIM14 :: Package IEC61968 :: Package WiresExt :: Module DistributionTapChanger' :: Class DistributionTapChanger

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, monitoredPhase='A', ptRatio=0.0, reverseLineDropX=0.0, ctRating=0.0, reverseLineDropR=0.0, lineDropCompensation=False, ctRatio=0.0, targetVoltage=0.0, limitVoltage=0.0, lineDropR=0.0, lineDropX=0.0, bandVoltage=0.0, *args, **kw_args)
Initialises a new 'DistributionTapChanger' instance.

Inherited from IEC61970.Wires.RatioTapChanger'.RatioTapChanger: getRatioVariationCurve, getTransformerWinding, getWinding, setRatioVariationCurve, setTransformerWinding, setWinding

Inherited from IEC61970.Wires.TapChanger'.TapChanger: addTapSchedules, getImpedanceVariationCurve, getRegulatingControl, getSvTapStep, getTapSchedules, removeTapSchedules, setImpedanceVariationCurve, setRegulatingControl, setSvTapStep, setTapSchedules

Inherited from IEC61970.Core.PowerSystemResource'.PowerSystemResource: addAssets, addBlock, addMeasurements, addOperatingShare, addPsrLists, addReportingGroup, getAssets, getBlock, getLocation, getMeasurements, getOperatingShare, getOutageSchedule, getPSRType, getPsrLists, getReportingGroup, removeAssets, removeBlock, removeMeasurements, removeOperatingShare, removePsrLists, removeReportingGroup, setAssets, setBlock, setLocation, setMeasurements, setOperatingShare, setOutageSchedule, setPSRType, setPsrLists, setReportingGroup

Inherited from IEC61970.Core.IdentifiedObject'.IdentifiedObject: getModelingAuthoritySet, setModelingAuthoritySet

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'>, 'ctRating': <typ...

_attrs = ['monitoredPhase', 'ptRatio', 'reverseLineDropX', 'ct...

_defaults = {'bandVoltage': 0.0, 'ctRating': 0.0, 'ctRatio': 0...

_enums = {'monitoredPhase': 'PhaseCode'}

_refs = []

Inherited from IEC61970.Wires.RatioTapChanger'.RatioTapChanger (private): _many_refs

Properties

[hide private]

Inherited from IEC61970.Wires.RatioTapChanger'.RatioTapChanger: RatioVariationCurve, TransformerWinding, Winding

Inherited from IEC61970.Wires.TapChanger'.TapChanger: ImpedanceVariationCurve, RegulatingControl, SvTapStep, TapSchedules

Inherited from IEC61970.Core.PowerSystemResource'.PowerSystemResource: Assets, Block, Location, Measurements, OperatingShare, OutageSchedule, PSRType, PsrLists, ReportingGroup

Inherited from IEC61970.Core.IdentifiedObject'.IdentifiedObject: ModelingAuthoritySet

Inherited from object: __class__

Method Details

[hide private]

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

Initialises a new 'DistributionTapChanger' instance.

Parameters:

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

Overrides: object.__init__

Class Variable Details

[hide private]

_attr_types

Value:

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

_attrs

Value:

['monitoredPhase',
 'ptRatio',
 'reverseLineDropX',
 'ctRating',
 'reverseLineDropR',
 'lineDropCompensation',
 'ctRatio',
 'targetVoltage',
...

_defaults

Value:

{'bandVoltage': 0.0,
 'ctRating': 0.0,
 'ctRatio': 0.0,
 'limitVoltage': 0.0,
 'lineDropCompensation': False,
 'lineDropR': 0.0,
 'lineDropX': 0.0,
 'monitoredPhase': 'A',
...

Class DistributionTapChanger

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

_attr_types

_attrs

_defaults

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