Area
Package: PowerCoreOpenAPIModels · Source: Core/Topology/Area.json
A collection of buses for control purposes. The Area can be specified when defining each ACBus or DCBus in the area.
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. |
peak_active_power | number | — | MW / pu (by power_units) | Peak active power in the area. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
peak_reactive_power | number | — | MVAr / pu (by power_units) | Peak reactive power in the area. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
load_response | number | — | MW/Hz | Load-frequency damping parameter modeling how much the load in the area changes due to changes in frequency. Units: MW/Hz. |
scheduled_net_interchange | number or null | — | MW / pu (by power_units) | Scheduled net active power interchange of the area (PSS/E PDES): the area’s total export minus its total import that area interchange control holds. Positive means the area exports power. null when the area has no scheduled interchange; 0.0 is a valid schedule. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
out_of_area_load_ids | array of integer | — | — | IDs of the loads that belong to this area but connect to a bus in another area (PSS/E off-area loads). When area interchange control includes these loads (PSS/E AREAIN=2), their demand counts in the net interchange of this area, not of the area of their 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. |