VoltageDroopControl

Package: PowerOperationsOpenAPIModels · Source: Operations/SupplementalAttributes/VoltageDroopControl.json

Supplemental attribute for a voltage droop controller (PSS/E voltage droop control): a set of generators jointly regulating the reactive power at one bus along a Q–V characteristic. While the controller is available its regulated bus and characteristic override each member’s own voltage target; while it is unavailable the members fall back to their own targets. Membership and each member’s relative reactive power weight are VoltageControlAssociation rows. The characteristic holds reactive_power_limits.max below voltage_limits.min, ramps to deadband_reactive_power at deadband_voltage_limits.min, holds it through deadband_voltage_limits.max, ramps to reactive_power_limits.min at voltage_limits.max, and holds it above.

Properties

Property	Type	Required	Unit	Description
id	integer	yes	—	Unique integer identifier for this supplemental attribute.
name	string	yes	—	Name of the voltage droop controller.
available	boolean	—	—	Whether the controller is in service (PSS/E STATUS). While false, members regulate their own targets.
regulated_bus_id	integer	yes	—	ID of the bus whose reactive power the controller regulates; overrides every member’s own regulated bus while the controller is available.
reactive_power_limits	MinMax	yes	MVAr	Reactive power held below voltage_limits.min (max, PSS/E QMAX) and above voltage_limits.max (min, PSS/E QMIN). Units: MVAr.
deadband_reactive_power	number	yes	MVAr	Reactive power held while the regulated bus voltage is inside deadband_voltage_limits (PSS/E QDB). Must lie strictly between reactive_power_limits.min and reactive_power_limits.max. Units: MVAr.
voltage_units	string (VoltageUnitBasis)	—	—	Unit basis for the voltage fields. COMPONENT_BASE (per-unit on the regulated bus base voltage) is PSS/E RAW native.
deadband_voltage_limits	MinMax	yes	kV / pu (by voltage_units)	Voltage band inside which the controller holds deadband_reactive_power (PSS/E VDBLOW, VDBHIGH). Must lie inside voltage_limits. Units: per voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu .
voltage_limits	MinMax	yes	kV / pu (by voltage_units)	Voltages at which the characteristic reaches reactive_power_limits.max (min, PSS/E VLOW) and reactive_power_limits.min (max, PSS/E VHIGH). Units: per voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu .