Source
Package: PowerOperationsOpenAPIModels · Source: Operations/StaticInjection/Source.json
An infinite bus with a constant voltage output.
Commonly used in dynamics simulations to represent a very large machine on a single bus or for the representation of import/exports in operational simulations.
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 | — | MW / pu (by power_units) | Initial active power set point of the unit. For power flow, this is the steady state operating point of the system. For production cost modeling, this may or may not be used as the initial starting point for the solver, depending on the solver used. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
reactive_power | number | — | MVAr / pu (by power_units) | Initial reactive power set point of the unit. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
active_power_limits | MinMax | — | MW / pu (by power_units) | Minimum and maximum stable active power levels. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
reactive_power_limits | MinMax | — | MVAr / pu (by power_units) | Minimum and maximum reactive power limits. Set to null if not applicable. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
parameter_units | string (ImpedanceUnitBasis) | — | — | Unit basis for this source’s impedance fields (R_th, X_th). |
R_th | number | — | ohm / pu (by parameter_units) | Source Thevenin resistance. Units: per parameter_units — NATURAL_UNITS: ohm, COMPONENT_BASE: pu . |
X_th | number | — | ohm / pu (by parameter_units) | Source Thevenin reactance. Units: per parameter_units — NATURAL_UNITS: ohm, COMPONENT_BASE: pu . |
internal_voltage | number | — | pu | Internal voltage. Units: pu. |
internal_angle | number | — | rad | Internal angle. Units: rad. |
base_voltage | number | — | kV | The base voltage. Units: kV. |
base_power | number | — | 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. |
operation_cost | ImportExportCost or MarketBidTimeSeriesCost or ImportExportTimeSeriesCost | yes | — | Cost of importing and exporting power at the source. or MarketBidCost |
dynamic_injector | integer or null | — | — | ID of the corresponding dynamic injection device, if any. |