MonitoredLine

Package: PowerOperationsOpenAPIModels · Source: Operations/Branch/MonitoredLine.json

An AC transmission line with additional power flow constraints specified by the system operator, more restrictive than the line’s thermal limits.

For example, monitored lines can be used to restrict line flow following a contingency elsewhere in the network. See the flow_limits parameter. If monitoring is not needed, see Line.

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.
r	number	yes	ohm / pu (by parameter_units)	Resistance. Units: per parameter_units — NATURAL_UNITS: ohm, COMPONENT_BASE: pu .
x	number	yes	ohm / pu (by parameter_units)	Reactance. Units: per parameter_units — NATURAL_UNITS: ohm, COMPONENT_BASE: pu .
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.
parameter_units	string (ImpedanceUnitBasis)	—	—	Unit basis for this line’s impedance and shunt admittance fields (r, x, b, g).
b	FromTo	yes	S / pu (by parameter_units)	Shunt susceptance, specified both on the from and to ends of the line. These are commonly modeled with the same value. Units: per parameter_units — NATURAL_UNITS: S, COMPONENT_BASE: pu .
flow_limits	FromTo_ToFrom	yes	MW / pu (by power_units)	Minimum and maximum permissable flow on the line, if different from the thermal rating defined in rating. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
rating	number	yes	MVA / pu (by power_units)	Thermal rating. Flow through the transformer must be between -rating and rating. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
rating_b	number	—	MVA / pu (by power_units)	Second current rating. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
rating_c	number	—	MVA / pu (by power_units)	Third current rating. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
angle_limits	MinMax	yes	rad	Minimum and maximum angle limits. Units: rad.
g	FromTo	—	S / pu (by parameter_units)	Shunt conductance, specified both on the from and to ends of the line. These are commonly modeled with the same value. Units: per parameter_units — NATURAL_UNITS: S, COMPONENT_BASE: pu .