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

Class SynchronousMachine

Core.ConductingEquipment.ConductingEquipment --+    
                                               |    
               RegulatingCondEq.RegulatingCondEq --+
                                                   |
                                                  SynchronousMachine

An electromechanical device that operates synchronously with the network. It is a single machine operating either as a generator or synchronous condenser or pump.- [R7.2] and [R9.3] are satisfied by navigation to ConnectivityNode and Substation. - If a SynchronousMachine is not associated with a ReactiveCapabilityCurve, then the minQ and maxQ attributes will be used. - If a ReactiveCapabilityCurve is supplied, then the minQ and maxQ attributes are not required. - If a synchronous condenser is being modeled so that there is no capability for real power output, the SynchronousMachine is not required to be associated with a GeneratingUnit. In this case, the type and operatingMode attributes must both be set to “condenser”. - Attributes qPercent, r, r0, r2, x, x0, x2, ratedS and referencePriority are not required. SynchronousMachine.GeneratingUnit is required for this profile - need to change UML to reflect this.

Instance Methods [hide private]
 
__init__(self, x0=0.0, qPercent=0.0, x2=0.0, r=0.0, operatingMode="condenser", r0=0.0, type="condenser", r2=0.0, maxQ=0.0, x=0.0, ratedS=0.0, minQ=0.0, InitialReactiveCapabilityCurve=None, HydroPump=None, GeneratingUnit=None, *args, **kw_args)
Initialises a new 'SynchronousMachine' instance.
 
getInitialReactiveCapabilityCurve(self)
The default ReactiveCapabilityCurve for use by a SynchronousMachine
 
setInitialReactiveCapabilityCurve(self, value)
 
getHydroPump(self)
The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation.
 
setHydroPump(self, value)
 
getGeneratingUnit(self)
A synchronous machine may operate as a generator and as such becomes a member of a generating unit
 
setGeneratingUnit(self, value)

Inherited from RegulatingCondEq.RegulatingCondEq: getRegulatingControl, setRegulatingControl

Class Variables [hide private]
  _attrs = ["x0", "qPercent", "x2", "r", "operatingMode", "r0", ...
  _attr_types = {"x0": float, "qPercent": float, "x2": float, "r...
  _defaults = {"x0": 0.0, "qPercent": 0.0, "x2": 0.0, "r": 0.0, ...
  _enums = {"operatingMode": "SynchronousMachineOperatingMode", ...
  _refs = ["InitialReactiveCapabilityCurve", "HydroPump", "Gener...
  _many_refs = []
  InitialReactiveCapabilityCurve = property(getInitialReactiveCa...
  HydroPump = property(getHydroPump, setHydroPump)
  GeneratingUnit = property(getGeneratingUnit, setGeneratingUnit)

Inherited from RegulatingCondEq.RegulatingCondEq: RegulatingControl

Instance Variables [hide private]
  x0
Zero sequence reactance of the synchronous machine.
  qPercent
Percent of the coordinated reactive control that comes from this machine.
  x2
Negative sequence reactance.
  r
Positive sequence resistance of the synchronous machine.
  operatingMode
Current mode of operation.
  r0
Zero sequence resistance of the synchronous machine.
  type
Modes that this synchronous machine can operate in.
  r2
Negative sequence resistance.
  maxQ
Maximum reactive power limit.
  x
Positive sequence reactance of the synchronous machine.
  ratedS
Nameplate apparent power rating for the unit
  minQ
Minimum reactive power limit for the unit.
Method Details [hide private]

__init__(self, x0=0.0, qPercent=0.0, x2=0.0, r=0.0, operatingMode="condenser", r0=0.0, type="condenser", r2=0.0, maxQ=0.0, x=0.0, ratedS=0.0, minQ=0.0, InitialReactiveCapabilityCurve=None, HydroPump=None, GeneratingUnit=None, *args, **kw_args)
(Constructor)

 

Initialises a new 'SynchronousMachine' instance.

Parameters:
  • x0 - Zero sequence reactance of the synchronous machine.
  • qPercent - Percent of the coordinated reactive control that comes from this machine.
  • x2 - Negative sequence reactance.
  • r - Positive sequence resistance of the synchronous machine.
  • operatingMode - Current mode of operation. Values are: "condenser", "generator"
  • r0 - Zero sequence resistance of the synchronous machine.
  • type - Modes that this synchronous machine can operate in. Values are: "condenser", "generator_or_condenser", "generator"
  • r2 - Negative sequence resistance.
  • maxQ - Maximum reactive power limit. This is the maximum (nameplate) limit for the unit.
  • x - Positive sequence reactance of the synchronous machine.
  • ratedS - Nameplate apparent power rating for the unit
  • minQ - Minimum reactive power limit for the unit.
  • InitialReactiveCapabilityCurve - The default ReactiveCapabilityCurve for use by a SynchronousMachine
  • 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
Overrides: RegulatingCondEq.RegulatingCondEq.__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]

_attrs

Value:
["x0", "qPercent", "x2", "r", "operatingMode", "r0", "type", "r2", "ma\
xQ", "x", "ratedS", "minQ"]

_attr_types

Value:
{"x0": float, "qPercent": float, "x2": float, "r": float, "operatingMo\
de": str, "r0": float, "type": str, "r2": float, "maxQ": float, "x": f\
loat, "ratedS": float, "minQ": float}

_defaults

Value:
{"x0": 0.0, "qPercent": 0.0, "x2": 0.0, "r": 0.0, "operatingMode": "co\
ndenser", "r0": 0.0, "type": "condenser", "r2": 0.0, "maxQ": 0.0, "x":\
 0.0, "ratedS": 0.0, "minQ": 0.0}

_enums

Value:
{"operatingMode": "SynchronousMachineOperatingMode", "type": "Synchron\
ousMachineType"}

_refs

Value:
["InitialReactiveCapabilityCurve", "HydroPump", "GeneratingUnit"]

InitialReactiveCapabilityCurve

Value:
property(getInitialReactiveCapabilityCurve, setInitialReactiveCapabili\
tyCurve)

Instance Variable Details [hide private]

operatingMode

Current mode of operation. Values are: "condenser", "generator"

type

Modes that this synchronous machine can operate in. Values are: "condenser", "generator_or_condenser", "generator"

maxQ

Maximum reactive power limit. This is the maximum (nameplate) limit for the unit.


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