ElmBmu attributesPowerFactory Virtual Power Plant

Every attribute of the PowerFactory Virtual Power Plant (ElmBmu): 122 input parameters and 11 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.

What ElmBmu is

A virtual power plant: a group of generators dispatched together towards one active power setpoint.

Class
ElmBmu, element class
PowerFactory name
Virtual Power Plant
Attributes
122 input parameters and 11 result variables, in 2 calculations

Read and write ElmBmu in Python

import powerfactory

app = powerfactory.GetApplication()          # GetApplicationExt() from outside PowerFactory

for obj in app.GetCalcRelevantObjects("*.ElmBmu"):
    print(obj.loc_name, obj.GetAttribute("loc_name")) # Name

obj = app.GetCalcRelevantObjects("*.ElmBmu")[0]
obj.SetAttribute("loc_name", "VPP 1")         # rename it
  • An input parameter is read and written with or without its e: prefix: GetAttribute("outserv") and GetAttribute("e:outserv") give the same value.

ElmBmu input parameters

The element data, as typed in GetAttribute and SetAttribute (the e: prefix is optional). Setting one changes the model.

AttributeUnitDescription
loc_name·Name
chr_name·Characteristic Name
for_name·Foreign Key
dat_src·Data source
appr_modby·Modified by
outserv·Out of Service
appr_status·Status
iAdjustQ·Adjust Reactive Power accordingly
distr_mod·Distribution Mode
priority·Virtual Power Plant, Merit Order
plantUsage·Power plant usage
isCtrlP·Active power
isCtrlQ·Reactive power
isMustRunUC·Must run
ctrlUsageP·Active Power
ctrlUsageQ·Reactive Power
isBmuPlims·Active power operational limits
isLimPmax·Max.
isLimPmin·Min.
isBmuQlims·Reactive power operational limits
isLimQmax·Max.
isLimQmin·Min.
consumMode·Separate consumption mode
isConsCostOp·Operating costs
discMethCostOp·Piecewise linearisation for LP
numBreakpointsCostOp·Number of breakpoints
isConsCostsRedispatch·Additional redispatch costs
isConsStartUpCost·Start-up costs
isConsShutDownCost·Shut-down costs
isConstrRamp·Ramp rate constraints
isConstrUpDown·Start-up/shut-down time constraints
isDiscreteCtrlP·Restriction to discrete active power values
isPcurrAllowed·Allow current active power value
isBmuCurtailCosts·Costs for curtailment
iInterPol·Approximation
polyDegree·Polynomial degree
powerDistrMethod·Power distribution
isRespectLims·Respect individual operational machine limits
PtotMWActive Power Setpoint
PminMWMin.
PmaxMWMax.
QminMvarMin.
QmaxMvarMax.
smoothfac%Smoothing factor
PminConsumMWMin.
PmaxConsumMWMax.
costCurtailmentUSD/MWhCosts for curtailment
penaltyCostsUSD/MWhPenalty costs
fixedCostsUSD/hFixed costs
consumCostsUSD/MWhConsumption costs
costRedispatchUpUSD/MWhUpward active power redispatch costs
costRedispatchDownUSD/MWhDownward active power redispatch costs
costRedispatchQUSD/MvarhRedispatch costs for reactive power change
cost_upUSDWarm-start costs
costColdStartUSDCold-start costs
coldStartTimehCold-start time
costShutDownUSDShut-down costs
limRampUpMW/hRamp-up limit
limRampDownMW/hRamp-down limit
limRampStartUpMWStart-up ramp limit
limRampShutDownMWShut-down ramp limit
minUpTimehMinimum up-time
minDownTimehMinimum down-time
appr_modif·Modified
vecBreakpointsPMWPower
vecStartUpTimes>=hDown-time
vecStartUpCostsUSDStart-up costs
vecDiscreteCtrlPvals%Valid active power values
cpowerMWPower
ccostUSD/hCosts
desc·Description
pOpCostCurve·Generator cost curveObject: IntCostcurvegen
contents·Scripts
cNumDispMachAutoDisp·Number of dispatchable machines
cNumFixedMachAutoDisp·Number of non-dispatchable machines
cNumMachQds·Number of machines for storage model
cNumCtrlsUc·Number of controllable machines
PsumMWMax. Active Power Sum
PsumActMWActual Active Power Sum
machines_disp·Dispatchable Machines
fixed·Must run
merit_order·Merit Order
machines_fix·Non-Dispatchable Machines
available_fix·Available
cStorage·Storage modelObject: ElmStorage
cCurativeLimPSumMWMax. curative active power deviation
cCurativeLimQSumMvarMax. curative reactive power deviation
cWeightedCurativeCostsPUSD/MVAhWeighted costs sum for curative active power deviation
cWeightedCurativeCostsQUSD/MVAhWeighted costs sum for curative reactive power deviation
cPsumMinMWMin.
cPsumMaxMWMax.
cQsumMinMvarMin.
cQsumMaxMvarMax.
cPsumMinConsumMWMin.
cPsumMaxConsumMWMax.
avgCostsUcUSD/MWhAverage costs
cfixedCostsUSD/hFixed costs
cPenaltyCostWeightSumUSD/MWhPenalty costs
cFixedCostSumUSD/hFixed costs
cConsumWeightCostSumUSD/MWhConsumption costs
cSumCostCurtailmentUSD/MWhCosts for curtailment
cSumCostRedispUpUSD/MWhUpward active power redispatch costs
cSumCostRedispDownUSD/MWhDownward active power redispatch costs
cSumCostRedispQUSD/MvarhRedispatch costs for reactive power change
cCostShutDownSumUSDShut-down costs
cLimRampUpSumMW/hRamp-up limit
cLimRampDownSumMW/hRamp-down limit
cLimRampStartUpSumMWStart-up ramp limit
cLimRampShutDownSumMWShut-down ramp limit
cMinUpTimeMachhMinimum up-time
cMinDownTimeMachhMinimum down-time
cDiscMethCostOp·Piecewise linearisation for LP
cPratedSumMWPr(rated)
cPowerDistrMethod·Power distribution
colMachine·Machine
colCtrlP·Active power control
colCtrlQ·Reactive power control
colNomPowerMVARated Power
colPratedMWRated Active Power
colGenShiftKey%Generation shift key
colGenUsageBmu·Generator usage
colCtrlFixedToLdfVal·Fix controls to Load Flow values

ElmBmu load flow results

Read after ComLdf with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:PsumMWTotal Active Power
c:QsumMvarTotal Reactive Power
c:cst_dispUSD/hTotal operating costs
c:PminMWLower limit of active power
c:PmaxMWUpper limit of active power
c:QminMvarLower limit of reactive power
c:QmaxMvarUpper limit of reactive power

ElmBmu dc load flow results

Read after ComLdf (DC) with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:PsumMWTotal Active Power
c:cst_dispUSD/hTotal operating costs
c:PminMWLower limit of active power
c:PmaxMWUpper limit of active power

ElmBmu basic data

b: values are worked out from the input data. Read them; they are not set.

AttributeUnitDescription
b:loc_name·Name

Related

← ElmBbone Backbone · ElmBoundary Boundary →