VoltVarCurve#
- class popo.standards.VoltVarCurve(capability, deadband_pu=0.02, limit_pu=0.06, lower_limit_pu=None)#
Bases:
objectA 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;
Nonemakes the curve symmetric, equal tolimit_pu.
- breakpoints()#
The four voltage breakpoints and the reactive power at each, as OpenDSS takes them.
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:
- 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:
- 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:
- 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