VoltVarCurve#

class popo.standards.VoltVarCurve(capability, deadband_pu=0.02, limit_pu=0.06, lower_limit_pu=None)#

Bases: object

A piecewise-linear Volt-VAr characteristic.

Reactive power is flat inside a deadband around nominal and ramps linearly to the capability limit at the outer voltage points. Absorbing above nominal and supplying below is the sign convention throughout, which is what makes the response oppose the excursion rather than reinforce it.

Variables:
  • capability – The reactive capability the curve ramps towards, absorbed above nominal and supplied below.

  • deadband_pu – Half-width of the flat region around nominal, in per unit.

  • limit_pu – Voltage displacement above nominal at which full absorption is reached.

  • lower_limit_pu – Displacement below nominal at which full supply is reached; None makes the curve symmetric, equal to limit_pu.

property lower_pu: float#

Displacement below nominal at which full supply is reached.

breakpoints()#

The four voltage breakpoints and the reactive power at each, as OpenDSS takes them.

Return type:

tuple[tuple[float, ...], tuple[float, ...]]

Examples

>>> volts, values = VoltVarCurve.as_nzs_4777().breakpoints()
>>> [round(v * 230) for v in volts], values
([207, 220, 240, 258], (0.44, 0.0, 0.0, -0.6))
classmethod ieee_1547_default()#

The default characteristic of IEEE 1547-2018, category B.

Return type:

VoltVarCurve

classmethod as_nzs_4777()#

The volt-var characteristic of AS/NZS 4777.2:2020, Australia A, on a 230 V base.

Full supply at 207 V, none between 220 and 240 V, and full absorption at 258 V.

Return type:

VoltVarCurve

reactive_power_pu(voltage_pu)#

Reactive power the curve requests at a given terminal voltage.

Parameters:

voltage_pu (ArrayLike) – Terminal voltage in per unit of nominal.

Return type:

ndarray

Returns:

Reactive power per unit of rated apparent power. Negative absorbs, which is the response to a voltage above nominal.

Examples

>>> curve = VoltVarCurve.ieee_1547_default()
>>> float(curve.reactive_power_pu(1.0))
0.0