PowerLoad
Package: PowerOperationsOpenAPIModels · Source: Operations/StaticInjection/PowerLoad.json
A static power load, most commonly used for operational models such as power flow and operational optimizations.
This load consumes a set amount of power (set by active_power for a power flow simulation or a max_active_power time series for an operational simulation). For loads that can be compensated for load interruptions through demand response programs, see InterruptiblePowerLoad. For voltage-dependent loads used in dynamics modeling, see StandardLoad.
Properties
| Property | Type | Required | Unit | Description |
|---|---|---|---|---|
id | integer | yes | — | Unique integer identifier for this component. |
name | string | yes | — | Name of the component. Components of the same type (e.g., PowerLoad) must have unique names, but components of different types (e.g., PowerLoad and ACBus) can have the same name. |
available | boolean | yes | — | Indicator of whether the component is connected and online (true) or disconnected, offline, or down (false). Unavailable components are excluded during simulations. |
bus | integer | yes | — | ID of the bus that this component is connected to. |
active_power | number | yes | MW / pu (by power_units) | Initial steady-state active power demand. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
reactive_power | number | yes | MVAr / pu (by power_units) | Initial steady-state reactive power demand. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
base_power | number | yes | MVA | Base power of the unit for per unitization. Units: MVA. |
power_units | string (UnitSystem) | yes | — | Unit basis for this component’s power-family fields (active/reactive/apparent power, ratings, limits, ramp rates). COMPONENT_BASE: per unit on this component’s own base_power. NATURAL_UNITS: the field’s physical unit. |
max_active_power | number | yes | MW / pu (by power_units) | Maximum active power that this load can demand. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
max_reactive_power | number | yes | MVAr / pu (by power_units) | Maximum reactive power that this load can demand. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
conformity | string (LoadConformity) | — | — | Indicates whether the specified load is conforming or non-conforming. |
dynamic_injector | integer or null | — | — | ID of the corresponding dynamic injection device, if any. |