Trees       Indices       Help   
PyCIM
CIM14 :: CPSM :: Equipment :: Wires :: PhaseTapChanger :: PhaseTapChanger :: Class PhaseTapChanger
[hide private]
[frames] | no frames]

Class PhaseTapChanger

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.- The attribute ltcflag specifies whether or not a TapChanger has load tap changing capabilities. If the ltcFlag is true, the attributes “highStep”, “lowStep”, “neutralStep”, “normalStep” and 'stepPhaseShiftIncrement' are all required. - The attributes voltageStepIncrementOutOfPhase, windingConnectionAngle, xStepMax, and xStepMin are not required.

Instance Methods [hide private]
 
__init__(self, nominalVoltageOutOfPhase=0.0, windingConnectionAngle=0.0, phaseTapChangerType="asymmetrical", xStepMin=0.0, xStepMax=0.0, stepPhaseShiftIncrement=0.0, voltageStepIncrementOutOfPhase=0.0, TransformerWinding=None, PhaseVariationCurve=None, *args, **kw_args)
Initialises a new 'PhaseTapChanger' instance.
 
getTransformerWinding(self)
The transformer winding to which the phase tap changer belongs.
 
setTransformerWinding(self, value)
 
getPhaseVariationCurve(self)
A PhaseTapChanger can have an associated PhaseVariationCurve to define phase shift variations with tap step changes.
 
setPhaseVariationCurve(self, value)

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

Class Variables [hide private]
  _attrs = ["nominalVoltageOutOfPhase", "windingConnectionAngle"...
  _attr_types = {"nominalVoltageOutOfPhase": float, "windingConn...
  _defaults = {"nominalVoltageOutOfPhase": 0.0, "windingConnecti...
  _enums = {"phaseTapChangerType": "PhaseTapChangerKind"}
  _refs = ["TransformerWinding", "PhaseVariationCurve"]
  _many_refs = []
  TransformerWinding = property(getTransformerWinding, setTransf...
  PhaseVariationCurve = property(getPhaseVariationCurve, setPhas...

Inherited from TapChanger.TapChanger: ImpedanceVariationCurve, RegulatingControl, TapSchedules

Instance Variables [hide private]
  nominalVoltageOutOfPhase
Similar to TapChanger.nominalVoltage, but this is the nominal voltage in the out of phase winding at the nominal tap step.
  windingConnectionAngle
The phase angle between the in-phase winding and the out-of -phase winding used for creating phase shift.
  phaseTapChangerType
The type of phase shifter construction.
  xStepMin
The reactance at the minimum tap step.
  xStepMax
The reactance at the maximum tap step.
  stepPhaseShiftIncrement
Phase shift per step position.
  voltageStepIncrementOutOfPhase
The voltage step increment on the out of phase winding.

Inherited from TapChanger.TapChanger: highStep, lowStep, ltcFlag, neutralStep, neutralU, normalStep, regulationStatus, stepVoltageIncrement

Method Details [hide private]

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

 

Initialises a new 'PhaseTapChanger' instance.

Parameters:
  • 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.
  • 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.
  • phaseTapChangerType - The type of phase shifter construction. Values are: "asymmetrical", "symmetrical", "unknown"
  • xStepMin - The reactance at the minimum tap step.
  • xStepMax - The reactance at the maximum 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.
  • 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.
  • TransformerWinding - The transformer winding to which the phase tap changer belongs.
  • PhaseVariationCurve - A PhaseTapChanger can have an associated PhaseVariationCurve to define phase shift variations with tap step changes.
Overrides: TapChanger.TapChanger.__init__

Class Variable Details [hide private]

_attrs

Value:
["nominalVoltageOutOfPhase", "windingConnectionAngle", "phaseTapChange\
rType", "xStepMin", "xStepMax", "stepPhaseShiftIncrement", "voltageSte\
pIncrementOutOfPhase"]

_attr_types

Value:
{"nominalVoltageOutOfPhase": float, "windingConnectionAngle": float, "\
phaseTapChangerType": str, "xStepMin": float, "xStepMax": float, "step\
PhaseShiftIncrement": float, "voltageStepIncrementOutOfPhase": float}

_defaults

Value:
{"nominalVoltageOutOfPhase": 0.0, "windingConnectionAngle": 0.0, "phas\
eTapChangerType": "asymmetrical", "xStepMin": 0.0, "xStepMax": 0.0, "s\
tepPhaseShiftIncrement": 0.0, "voltageStepIncrementOutOfPhase": 0.0}

TransformerWinding

Value:
property(getTransformerWinding, setTransformerWinding)

PhaseVariationCurve

Value:
property(getPhaseVariationCurve, setPhaseVariationCurve)

Instance Variable Details [hide private]

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.

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.

phaseTapChangerType

The type of phase shifter construction. Values are: "asymmetrical", "symmetrical", "unknown"

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.

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.


   Trees       Indices       Help   
PyCIM
Generated by Epydoc 3.0.1 on Sat Jul 2 18:27:35 2011 http://epydoc.sourceforge.net