Trees       Indices       Help   
PyCIM
CIM14 :: CPSM :: Equipment :: Generation :: Production :: GeneratingUnit :: GeneratingUnit :: Class GeneratingUnit
[hide private]
[frames] | no frames]

Class GeneratingUnit

Core.Equipment.Equipment --+
                           |
                          GeneratingUnit

A single or set of synchronous machines for converting mechanical power into alternating-current power. For example, individual machines within a set may be defined for scheduling purposes while a single control signal is derived for the set. In this case there would be a GeneratingUnit for each member of the set and an additional GeneratingUnit corresponding to the set.- To define a GeneratingUnit requires defining the initial real power injection, net real power limits, and the status of the unit. The initial injection is defined using the attribute “initialP”. - The net real power limits can be defined in three ways; 1) with the attributes “maxOperatingP” and “minOperatingP”, or 2) with the attribute “ratedNetMaxP” or 3) with the attributes “ratedGrossMinP” and “ratedGrossMaxP” used in conjunction with an associated GrossToNetActivePowerCurve. - The control status of the unit is defined with the attribute “genControlSource”, but it is not required. The participation factor attributes “longPF”, “normalPF”, and “shortPF” are not required. - The GeneratingUnit class should only be used in cases where the more specific classes, HydroGeneratingUnit and ThermalGeneratingUnit, do not apply. - The attributes governorSCD, maximumAllowableSpinningReserve, nominalP, startupCost, and variableCost are not required.

Instance Methods [hide private]
 
__init__(self, maxOperatingP=0.0, ratedGrossMaxP=0.0, variableCost=0.0, minOperatingP=0.0, ratedGrossMinP=0.0, shortPF=0.0, ratedNetMaxP=0.0, longPF=0.0, startupCost=0.0, genControlSource="onAGC", nominalP=0.0, governorSCD=0.0, maximumAllowableSpinningReserve=0.0, initialP=0.0, normalPF=0.0, SynchronousMachines=None, ControlAreaGeneratingUnit=None, GrossToNetActivePowerCurves=None, *args, **kw_args)
Initialises a new 'GeneratingUnit' instance.
 
getSynchronousMachines(self)
A synchronous machine may operate as a generator and as such becomes a member of a generating unit
 
setSynchronousMachines(self, value)
 
addSynchronousMachines(self, *SynchronousMachines)
 
removeSynchronousMachines(self, *SynchronousMachines)
 
getControlAreaGeneratingUnit(self)
ControlArea specifications for this generating unit.
 
setControlAreaGeneratingUnit(self, value)
 
addControlAreaGeneratingUnit(self, *ControlAreaGeneratingUnit)
 
removeControlAreaGeneratingUnit(self, *ControlAreaGeneratingUnit)
 
getGrossToNetActivePowerCurves(self)
A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit
 
setGrossToNetActivePowerCurves(self, value)
 
addGrossToNetActivePowerCurves(self, *GrossToNetActivePowerCurves)
 
removeGrossToNetActivePowerCurves(self, *GrossToNetActivePowerCurves)
Class Variables [hide private]
  _attrs = ["maxOperatingP", "ratedGrossMaxP", "variableCost", "...
  _attr_types = {"maxOperatingP": float, "ratedGrossMaxP": float...
  _defaults = {"maxOperatingP": 0.0, "ratedGrossMaxP": 0.0, "var...
  _enums = {"genControlSource": "GeneratorControlSource"}
  _refs = ["SynchronousMachines", "ControlAreaGeneratingUnit", "...
  _many_refs = ["SynchronousMachines", "ControlAreaGeneratingUni...
  SynchronousMachines = property(getSynchronousMachines, setSync...
  ControlAreaGeneratingUnit = property(getControlAreaGeneratingU...
  GrossToNetActivePowerCurves = property(getGrossToNetActivePowe...
Instance Variables [hide private]
  maxOperatingP
This is the maximum operating active power limit the dispatcher can enter for this unit
  ratedGrossMaxP
The unit's gross rated maximum capacity (Book Value).
  variableCost
The variable cost component of production per unit of ActivePower.
  minOperatingP
This is the minimum operating active power limit the dispatcher can enter for this unit.
  ratedGrossMinP
The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid
  shortPF
Generating unit economic participation factor
  ratedNetMaxP
The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity
  longPF
Generating unit economic participation factor
  startupCost
The initial startup cost incurred for each start of the GeneratingUnit.
  genControlSource
The source of controls for a generating unit.
  nominalP
The nominal power of the generating unit.
  governorSCD
Governor Speed Changer Droop.
  maximumAllowableSpinningReserve
Maximum allowable spinning reserve.
  initialP
Default Initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration
  normalPF
Generating unit economic participation factor
Method Details [hide private]

__init__(self, maxOperatingP=0.0, ratedGrossMaxP=0.0, variableCost=0.0, minOperatingP=0.0, ratedGrossMinP=0.0, shortPF=0.0, ratedNetMaxP=0.0, longPF=0.0, startupCost=0.0, genControlSource="onAGC", nominalP=0.0, governorSCD=0.0, maximumAllowableSpinningReserve=0.0, initialP=0.0, normalPF=0.0, SynchronousMachines=None, ControlAreaGeneratingUnit=None, GrossToNetActivePowerCurves=None, *args, **kw_args)
(Constructor)

 

Initialises a new 'GeneratingUnit' instance.

Parameters:
  • maxOperatingP - This is the maximum operating active power limit the dispatcher can enter for this unit
  • ratedGrossMaxP - The unit's gross rated maximum capacity (Book Value).
  • variableCost - The variable cost component of production per unit of ActivePower.
  • minOperatingP - This is the minimum operating active power limit the dispatcher can enter for this unit.
  • ratedGrossMinP - The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid
  • shortPF - Generating unit economic participation factor
  • ratedNetMaxP - The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity
  • longPF - Generating unit economic participation factor
  • startupCost - The initial startup cost incurred for each start of the GeneratingUnit.
  • genControlSource - The source of controls for a generating unit. Values are: "onAGC", "unavailable", "plantControl", "offAGC"
  • nominalP - The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the govenor speed change droop (govenorSCD attribute).
  • governorSCD - Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency.
  • maximumAllowableSpinningReserve - Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.
  • initialP - Default Initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration
  • normalPF - Generating unit economic participation factor
  • SynchronousMachines - A synchronous machine may operate as a generator and as such becomes a member of a generating unit
  • ControlAreaGeneratingUnit - ControlArea specifications for this generating unit.
  • GrossToNetActivePowerCurves - A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit

Class Variable Details [hide private]

_attrs

Value:
["maxOperatingP", "ratedGrossMaxP", "variableCost", "minOperatingP", "\
ratedGrossMinP", "shortPF", "ratedNetMaxP", "longPF", "startupCost", "\
genControlSource", "nominalP", "governorSCD", "maximumAllowableSpinnin\
gReserve", "initialP", "normalPF"]

_attr_types

Value:
{"maxOperatingP": float, "ratedGrossMaxP": float, "variableCost": floa\
t, "minOperatingP": float, "ratedGrossMinP": float, "shortPF": float, \
"ratedNetMaxP": float, "longPF": float, "startupCost": float, "genCont\
rolSource": str, "nominalP": float, "governorSCD": float, "maximumAllo\
wableSpinningReserve": float, "initialP": float, "normalPF": float}

_defaults

Value:
{"maxOperatingP": 0.0, "ratedGrossMaxP": 0.0, "variableCost": 0.0, "mi\
nOperatingP": 0.0, "ratedGrossMinP": 0.0, "shortPF": 0.0, "ratedNetMax\
P": 0.0, "longPF": 0.0, "startupCost": 0.0, "genControlSource": "onAGC\
", "nominalP": 0.0, "governorSCD": 0.0, "maximumAllowableSpinningReser\
ve": 0.0, "initialP": 0.0, "normalPF": 0.0}

_refs

Value:
["SynchronousMachines", "ControlAreaGeneratingUnit", "GrossToNetActive\
PowerCurves"]

_many_refs

Value:
["SynchronousMachines", "ControlAreaGeneratingUnit", "GrossToNetActive\
PowerCurves"]

SynchronousMachines

Value:
property(getSynchronousMachines, setSynchronousMachines)

ControlAreaGeneratingUnit

Value:
property(getControlAreaGeneratingUnit, setControlAreaGeneratingUnit)

GrossToNetActivePowerCurves

Value:
property(getGrossToNetActivePowerCurves, setGrossToNetActivePowerCurve\
s)

Instance Variable Details [hide private]

genControlSource

The source of controls for a generating unit. Values are: "onAGC", "unavailable", "plantControl", "offAGC"

nominalP

The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the govenor speed change droop (govenorSCD attribute).

governorSCD

Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency.

maximumAllowableSpinningReserve

Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.


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