DiscreteControlledACBranch
Package: PowerOperationsOpenAPIModels · Source: Operations/Branch/DiscreteControlledACBranch.json
Used to represent switches and breakers connecting AC Buses.
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. |
active_power_flow | number | yes | MW / pu (by power_units) | Initial condition of active power flow on the line. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
reactive_power_flow | number | yes | MVAr / pu (by power_units) | Initial condition of reactive power flow on the line. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
arc | integer | yes | — | An Arc defining this line from a bus to another bus. |
base_power | number | yes | MVA | System base power for per-unitization of this component’s per-unit fields, recorded per component in lieu of a system-level table. 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. |
r | number | yes | pu | Resistance. Per-unit on base_power, which records the system base. Units: pu. |
x | number | yes | pu | Reactance. Per-unit on base_power, which records the system base. Units: pu. |
rating | number | yes | MVA / pu (by power_units) | Thermal rating. Flow on the branch must be between -rating and rating. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu . |
discrete_branch_type | string | — | — | Type of discrete control. |
branch_status | string | — | — | Open or Close status. |
normal_branch_status | string | — | — | Normal (as-designed) open or close status of the device. |