Package CIM14 :: Package IEC61970 :: Package Wires :: Module SynchronousMachine' :: Class SynchronousMachine
[hide private]
[frames] | no frames]

Class SynchronousMachine

                           object --+                            
                                    |                            
                     Element'.Element --+                        
                                        |                        
  Core.IdentifiedObject'.IdentifiedObject --+                    
                                            |                    
Core.PowerSystemResource'.PowerSystemResource --+                
                                                |                
                        Core.Equipment'.Equipment --+            
                                                    |            
        Core.ConductingEquipment'.ConductingEquipment --+        
                                                        |        
                       RegulatingCondEq'.RegulatingCondEq --+    
                                                            |    
                    Dynamics.RotatingMachine'.RotatingMachine --+
                                                                |
                                                               SynchronousMachine
Known Subclasses:

An electromechanical device that operates synchronously with the network. It is a single machine operating either as a generator or synchronous condenser or pump.

Instance Methods [hide private]
 
__init__(self, operatingMode='condenser', type='generator_or_condenser', coolantType='air', xQuadTrans=0.0, condenserP=0.0, referencePriority=0, damping=0.0, x0=0.0, r2=0.0, minQ=0.0, xDirectSync=0.0, maxQ=0.0, r0=0.0, aVRToManualLead=0.0, x=0.0, inertia=0.0, coolantCondition=0.0, manualToAVR=0.0, r=0.0, maxU=0.0, xQuadSync=0.0, qPercent=0.0, xQuadSubtrans=0.0, minU=0.0, aVRToManualLag=0.0, baseQ=0.0, xDirectTrans=0.0, x2=0.0, xDirectSubtrans=0.0, genLoad0=None, HydroPump=None, GeneratingUnit=None, govHydro10=None, PrimeMovers=None, InitialReactiveCapabilityCurve=None, genEquiv0=None, ReactiveCapabilityCurves=None, *args, **kw_args)
Initialises a new 'SynchronousMachine' instance.
 
addPrimeMovers(self, *PrimeMovers)
 
addReactiveCapabilityCurves(self, *ReactiveCapabilityCurves)
 
addgenEquiv0(self, *genEquiv0)
 
addgenLoad0(self, *genLoad0)
 
addgovHydro10(self, *govHydro10)
 
getGeneratingUnit(self)
A synchronous machine may operate as a generator and as such becomes a member of a generating unit
 
getHydroPump(self)
The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation.
 
getInitialReactiveCapabilityCurve(self)
The default ReactiveCapabilityCurve for use by a SynchronousMachine
 
getPrimeMovers(self)
Prime movers that drive this SynchronousMachine.
 
getReactiveCapabilityCurves(self)
All available Reactive capability curves for this SynchronousMachine.
 
getgenEquiv0(self)
 
getgenLoad0(self)
 
getgovHydro10(self)
 
removePrimeMovers(self, *PrimeMovers)
 
removeReactiveCapabilityCurves(self, *ReactiveCapabilityCurves)
 
removegenEquiv0(self, *genEquiv0)
 
removegenLoad0(self, *genLoad0)
 
removegovHydro10(self, *govHydro10)
 
setGeneratingUnit(self, value)
 
setHydroPump(self, value)
 
setInitialReactiveCapabilityCurve(self, value)
 
setPrimeMovers(self, value)
 
setReactiveCapabilityCurves(self, value)
 
setgenEquiv0(self, value)
 
setgenLoad0(self, value)
 
setgovHydro10(self, value)

Inherited from Dynamics.RotatingMachine'.RotatingMachine: addmechanicalLoad0, getmechanicalLoad0, removemechanicalLoad0, setmechanicalLoad0

Inherited from RegulatingCondEq'.RegulatingCondEq: addControls, getControls, getRegulatingControl, removeControls, setControls, setRegulatingControl

Inherited from Core.ConductingEquipment'.ConductingEquipment: addClearanceTags, addProtectionEquipments, addTerminals, getBaseVoltage, getClearanceTags, getProtectionEquipments, getSvStatus, getTerminals, removeClearanceTags, removeProtectionEquipments, removeTerminals, setBaseVoltage, setClearanceTags, setProtectionEquipments, setSvStatus, setTerminals

Inherited from Core.Equipment'.Equipment: addContingencyEquipment, addCustomerAgreements, addOperationalLimitSet, getContingencyEquipment, getCustomerAgreements, getEquipmentContainer, getOperationalLimitSet, removeContingencyEquipment, removeCustomerAgreements, removeOperationalLimitSet, setContingencyEquipment, setCustomerAgreements, setEquipmentContainer, setOperationalLimitSet

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 = {'aVRToManualLag': <type 'float'>, 'aVRToManualL...
  _attrs = ['operatingMode', 'type', 'coolantType', 'xQuadTrans'...
  _defaults = {'aVRToManualLag': 0.0, 'aVRToManualLead': 0.0, 'b...
  _enums = {'coolantType': 'CoolantType', 'operatingMode': 'Sync...
  _many_refs = ['genLoad0', 'govHydro10', 'PrimeMovers', 'genEqu...
  _refs = ['genLoad0', 'HydroPump', 'GeneratingUnit', 'govHydro1...
Properties [hide private]
  GeneratingUnit
A synchronous machine may operate as a generator and as such becomes a member of a generating unit
  HydroPump
The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation.
  InitialReactiveCapabilityCurve
The default ReactiveCapabilityCurve for use by a SynchronousMachine
  PrimeMovers
Prime movers that drive this SynchronousMachine.
  ReactiveCapabilityCurves
All available Reactive capability curves for this SynchronousMachine.
  genEquiv0
  genLoad0
  govHydro10

Inherited from Dynamics.RotatingMachine'.RotatingMachine: mechanicalLoad0

Inherited from RegulatingCondEq'.RegulatingCondEq: Controls, RegulatingControl

Inherited from Core.ConductingEquipment'.ConductingEquipment: BaseVoltage, ClearanceTags, ProtectionEquipments, SvStatus, Terminals

Inherited from Core.Equipment'.Equipment: ContingencyEquipment, CustomerAgreements, EquipmentContainer, OperationalLimitSet

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, operatingMode='condenser', type='generator_or_condenser', coolantType='air', xQuadTrans=0.0, condenserP=0.0, referencePriority=0, damping=0.0, x0=0.0, r2=0.0, minQ=0.0, xDirectSync=0.0, maxQ=0.0, r0=0.0, aVRToManualLead=0.0, x=0.0, inertia=0.0, coolantCondition=0.0, manualToAVR=0.0, r=0.0, maxU=0.0, xQuadSync=0.0, qPercent=0.0, xQuadSubtrans=0.0, minU=0.0, aVRToManualLag=0.0, baseQ=0.0, xDirectTrans=0.0, x2=0.0, xDirectSubtrans=0.0, genLoad0=None, HydroPump=None, GeneratingUnit=None, govHydro10=None, PrimeMovers=None, InitialReactiveCapabilityCurve=None, genEquiv0=None, ReactiveCapabilityCurves=None, *args, **kw_args)
(Constructor)

 

Initialises a new 'SynchronousMachine' instance.

Parameters:
  • operatingMode - Current mode of operation. Values are: "condenser", "generator"
  • type - Modes that this synchronous machine can operate in. Values are: "generator_or_condenser", "generator", "condenser"
  • coolantType - Method of cooling the machine. Values are: "air", "hydrogenGas", "water"
  • xQuadTrans - Quadrature-axis transient reactance, also known as X'q.
  • condenserP - Active power consumed when in condenser mode operation.
  • referencePriority - Priority of unit for reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on.
  • damping - Damping torque coefficient, a proportionality constant that, when multiplied by the angular velocity of the rotor poles with respect to the magnetic field (frequency), results in the damping torque.
  • x0 - Zero sequence reactance of the synchronous machine.
  • r2 - Negative sequence resistance.
  • minQ - Minimum reactive power limit for the unit.
  • xDirectSync - Direct-axis synchronous reactance. The quotient of a sustained value of that AC component of armature voltage that is produced by the total direct-axis flux due to direct-axis armature current and the value of the AC component of this current, the machine running at rated speed. (Xd)
  • maxQ - Maximum reactive power limit. This is the maximum (nameplate) limit for the unit.
  • r0 - Zero sequence resistance of the synchronous machine.
  • aVRToManualLead - Time delay required when switching from Automatic Voltage Regulation (AVR) to Manual for a leading MVAr violation.
  • x - Positive sequence reactance of the synchronous machine.
  • inertia - The energy stored in the rotor when operating at rated speed. This value is used in the accelerating power reference frame for operator training simulator solutions.
  • coolantCondition - Temperature or pressure of coolant medium
  • manualToAVR - Time delay required when switching from Manual to Automatic Voltage Regulation. This value is used in the accelerating power reference frame for powerflow solutions
  • r - Positive sequence resistance of the synchronous machine.
  • maxU - Maximum voltage limit for the unit.
  • xQuadSync - Quadrature-axis synchronous reactance (Xq) , the ratio of the component of reactive armature voltage, due to the quadrature-axis component of armature current, to this component of current, under steady state conditions and at rated frequency.
  • qPercent - Percent of the coordinated reactive control that comes from this machine.
  • xQuadSubtrans - Quadrature-axis subtransient reactance, also known as X'q.
  • minU - Minimum voltage limit for the unit.
  • aVRToManualLag - Time delay required when switching from Automatic Voltage Regulation (AVR) to Manual for a lagging MVAr violation.
  • baseQ - Default base reactive power value. This value represents the initial reactive power that can be used by any application function.
  • xDirectTrans - Direct-axis transient reactance, also known as X'd.
  • x2 - Negative sequence reactance.
  • xDirectSubtrans - Direct-axis subtransient reactance, also known as X'd.
  • genLoad0
  • HydroPump - The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating.
  • GeneratingUnit - A synchronous machine may operate as a generator and as such becomes a member of a generating unit
  • govHydro10
  • PrimeMovers - Prime movers that drive this SynchronousMachine.
  • InitialReactiveCapabilityCurve - The default ReactiveCapabilityCurve for use by a SynchronousMachine
  • genEquiv0
  • ReactiveCapabilityCurves - All available Reactive capability curves for this SynchronousMachine.
Overrides: object.__init__

getHydroPump(self)

 

The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating.


Class Variable Details [hide private]

_attr_types

Value:
{'aVRToManualLag': <type 'float'>,
 'aVRToManualLead': <type 'float'>,
 'baseQ': <type 'float'>,
 'condenserP': <type 'float'>,
 'coolantCondition': <type 'float'>,
 'coolantType': <type 'str'>,
 'damping': <type 'float'>,
 'inertia': <type 'float'>,
...

_attrs

Value:
['operatingMode',
 'type',
 'coolantType',
 'xQuadTrans',
 'condenserP',
 'referencePriority',
 'damping',
 'x0',
...

_defaults

Value:
{'aVRToManualLag': 0.0,
 'aVRToManualLead': 0.0,
 'baseQ': 0.0,
 'condenserP': 0.0,
 'coolantCondition': 0.0,
 'coolantType': 'air',
 'damping': 0.0,
 'inertia': 0.0,
...

_enums

Value:
{'coolantType': 'CoolantType',
 'operatingMode': 'SynchronousMachineOperatingMode',
 'type': 'SynchronousMachineType'}

_many_refs

Value:
['genLoad0',
 'govHydro10',
 'PrimeMovers',
 'genEquiv0',
 'ReactiveCapabilityCurves']

_refs

Value:
['genLoad0',
 'HydroPump',
 'GeneratingUnit',
 'govHydro10',
 'PrimeMovers',
 'InitialReactiveCapabilityCurve',
 'genEquiv0',
 'ReactiveCapabilityCurves']

Property Details [hide private]

GeneratingUnit

A synchronous machine may operate as a generator and as such becomes a member of a generating unit

Get Method:
getGeneratingUnit(self) - A synchronous machine may operate as a generator and as such becomes a member of a generating unit
Set Method:
setGeneratingUnit(self, value)

HydroPump

The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating.

Get Method:
getHydroPump(self) - The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation.
Set Method:
setHydroPump(self, value)

InitialReactiveCapabilityCurve

The default ReactiveCapabilityCurve for use by a SynchronousMachine

Get Method:
getInitialReactiveCapabilityCurve(self) - The default ReactiveCapabilityCurve for use by a SynchronousMachine
Set Method:
setInitialReactiveCapabilityCurve(self, value)

PrimeMovers

Prime movers that drive this SynchronousMachine.

Get Method:
getPrimeMovers(self) - Prime movers that drive this SynchronousMachine.
Set Method:
setPrimeMovers(self, value)

ReactiveCapabilityCurves

All available Reactive capability curves for this SynchronousMachine.

Get Method:
getReactiveCapabilityCurves(self) - All available Reactive capability curves for this SynchronousMachine.
Set Method:
setReactiveCapabilityCurves(self, value)

genEquiv0

Get Method:
getgenEquiv0(self)
Set Method:
setgenEquiv0(self, value)

genLoad0

Get Method:
getgenLoad0(self)
Set Method:
setgenLoad0(self, value)

govHydro10

Get Method:
getgovHydro10(self)
Set Method:
setgovHydro10(self, value)