Package CIM14 :: Package IEC61970 :: Package Wires :: Module PhaseTapChanger' :: Class PhaseTapChanger

Class PhaseTapChanger

                           object --+                
                                    |                
                     Element'.Element --+            
                                        |            
  Core.IdentifiedObject'.IdentifiedObject --+        
                                            |        
Core.PowerSystemResource'.PowerSystemResource --+    
                                                |    
                           TapChanger'.TapChanger --+
                                                    |
                                                   PhaseTapChanger

A specialization of a voltage tap changer that has detailed modeling for phase shifting capabilities. A phase shifting tap changer is also in general a voltage magnitude transformer. The symmetrical and asymmetrical transformer tap changer models are defined here.

Instance Methods

[hide private]

__init__(self, phaseTapChangerType='asymmetrical', nominalVoltageOutOfPhase=0.0, xStepMin=0.0, stepPhaseShiftIncrement=0.0, windingConnectionAngle=0.0, xStepMax=0.0, voltageStepIncrementOutOfPhase=0.0, PhaseVariationCurve=None, Winding=None, TransformerWinding=None, *args, **kw_args)
Initialises a new 'PhaseTapChanger' instance.

getPhaseVariationCurve(self)
A PhaseTapChanger can have an associated PhaseVariationCurve to define phase shift variations with tap step changes.

getTransformerWinding(self)
The transformer winding to which the phase tap changer belongs.

getWinding(self)
Transformer winding to which this phase tap changer belongs.

setPhaseVariationCurve(self, value)

setTransformerWinding(self, value)

setWinding(self, value)

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

Inherited from 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 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 = {'nominalVoltageOutOfPhase': <type 'float'>, 'ph...

_attrs = ['phaseTapChangerType', 'nominalVoltageOutOfPhase', '...

_defaults = {'nominalVoltageOutOfPhase': 0.0, 'phaseTapChanger...

_enums = {'phaseTapChangerType': 'PhaseTapChangerKind'}

_many_refs = []

_refs = ['PhaseVariationCurve', 'Winding', 'TransformerWinding']

Properties

[hide private]

PhaseVariationCurve
A PhaseTapChanger can have an associated PhaseVariationCurve to define phase shift variations with tap step changes.

TransformerWinding
The transformer winding to which the phase tap changer belongs.

Winding
Transformer winding to which this phase tap changer belongs.

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

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

Inherited from Core.IdentifiedObject'.IdentifiedObject: ModelingAuthoritySet

Inherited from object: __class__

Method Details

[hide private]

init(self, phaseTapChangerType=`'asymmetrical'`, nominalVoltageOutOfPhase=0.0, xStepMin=0.0, stepPhaseShiftIncrement=0.0, windingConnectionAngle=0.0, xStepMax=0.0, voltageStepIncrementOutOfPhase=0.0, PhaseVariationCurve=None, Winding=None, TransformerWinding=None, *args, **kw_args)
(Constructor)

Initialises a new 'PhaseTapChanger' instance.

Parameters:

phaseTapChangerType - The type of phase shifter construction. Values are: "asymmetrical", "unknown", "symmetrical"
nominalVoltageOutOfPhase - Similar to TapChanger.nominalVoltage, but this is the nominal voltage in the out of phase winding at the nominal tap step. A typical case may have zero voltage at the nominal step, indicating no phase shift at the nominal voltage.
xStepMin - The reactance at the minimum tap step.
stepPhaseShiftIncrement - Phase shift per step position. A positive value indicates a positive phase shift from the winding where the tap is located to the other winding (for a two-winding transformer). The actual phase shift increment might be more accurately computed from the symmetrical or asymmetrical models or a tap step table lookup if those are available.
windingConnectionAngle - The phase angle between the in-phase winding and the out-of -phase winding used for creating phase shift. It is only possible to have a symmemtrical transformer if this angle is 90 degrees.
xStepMax - The reactance at the maximum tap step.
voltageStepIncrementOutOfPhase - The voltage step increment on the out of phase winding. This voltage step on the out of phase winding of the phase shifter. Similar to TapChanger.voltageStepIncrement, but it is applied only to the out of phase winding.
PhaseVariationCurve - A PhaseTapChanger can have an associated PhaseVariationCurve to define phase shift variations with tap step changes.
Winding - Transformer winding to which this phase tap changer belongs.
TransformerWinding - The transformer winding to which the phase tap changer belongs.

Overrides: object.__init__

Class Variable Details

[hide private]

_attr_types

Value:

{'nominalVoltageOutOfPhase': <type 'float'>,
 'phaseTapChangerType': <type 'str'>,
 'stepPhaseShiftIncrement': <type 'float'>,
 'voltageStepIncrementOutOfPhase': <type 'float'>,
 'windingConnectionAngle': <type 'float'>,
 'xStepMax': <type 'float'>,
 'xStepMin': <type 'float'>}

_attrs

Value:

['phaseTapChangerType',
 'nominalVoltageOutOfPhase',
 'xStepMin',
 'stepPhaseShiftIncrement',
 'windingConnectionAngle',
 'xStepMax',
 'voltageStepIncrementOutOfPhase']

_defaults

Value:

{'nominalVoltageOutOfPhase': 0.0,
 'phaseTapChangerType': 'asymmetrical',
 'stepPhaseShiftIncrement': 0.0,
 'voltageStepIncrementOutOfPhase': 0.0,
 'windingConnectionAngle': 0.0,
 'xStepMax': 0.0,
 'xStepMin': 0.0}

Property Details

[hide private]

PhaseVariationCurve

A PhaseTapChanger can have an associated PhaseVariationCurve to define phase shift variations with tap step changes.

Get Method:: getPhaseVariationCurve(self) - A PhaseTapChanger can have an associated PhaseVariationCurve to define phase shift variations with tap step changes.
Set Method:: setPhaseVariationCurve(self, value)

TransformerWinding

The transformer winding to which the phase tap changer belongs.

Get Method:: getTransformerWinding(self) - The transformer winding to which the phase tap changer belongs.
Set Method:: setTransformerWinding(self, value)

Winding

Transformer winding to which this phase tap changer belongs.

Get Method:: getWinding(self) - Transformer winding to which this phase tap changer belongs.
Set Method:: setWinding(self, value)

Class PhaseTapChanger

__init__(self, phaseTapChangerType='asymmetrical', nominalVoltageOutOfPhase=0.0, xStepMin=0.0, stepPhaseShiftIncrement=0.0, windingConnectionAngle=0.0, xStepMax=0.0, voltageStepIncrementOutOfPhase=0.0, PhaseVariationCurve=None, Winding=None, TransformerWinding=None, *args, **kw_args) (Constructor)

_attr_types

_attrs

_defaults

PhaseVariationCurve

TransformerWinding

Winding

init(self, phaseTapChangerType=`'asymmetrical'`, nominalVoltageOutOfPhase=0.0, xStepMin=0.0, stepPhaseShiftIncrement=0.0, windingConnectionAngle=0.0, xStepMax=0.0, voltageStepIncrementOutOfPhase=0.0, PhaseVariationCurve=None, Winding=None, TransformerWinding=None, *args, **kw_args)
(Constructor)