VoltWattCurve#

class popo.standards.VoltWattCurve(start_pu=1.06, end_pu=1.1, min_power_pu=0.2, name='Volt-Watt', reference='')#

Bases: object

A piecewise-linear Volt-Watt characteristic.

Active power is unrestricted up to start_pu and is curtailed linearly to min_power_pu of rated output at end_pu, holding that floor above it. Unlike Volt-VAr it costs the customer energy, which is why the curtailment begins close to the upper statutory limit rather than at nominal.

Variables:
  • start_pu – Voltage at which curtailment begins.

  • end_pu – Voltage at which curtailment reaches its floor.

  • min_power_pu – Active power permitted at and above end_pu, per unit of rated output.

  • name – Human-readable identifier.

  • reference – The clause the settings come from.

classmethod ieee_1547_default()#

The default voltage-active power characteristic of IEEE 1547-2018.

Return type:

VoltWattCurve

classmethod as_nzs_4777()#

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

Unrestricted to 253 V, the upper limit of AS 61000.3.100, and curtailed to 20% of rated output at 260 V, so that it acts as a backstop above the limit rather than inside the band.

Return type:

VoltWattCurve

Examples

>>> curve = VoltWattCurve.as_nzs_4777()
>>> round(curve.start_pu * 230), round(curve.end_pu * 230), curve.min_power_pu
(253, 260, 0.2)
active_power_pu(voltage_pu)#

Active power the curve permits at a given terminal voltage.

Parameters:

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

Return type:

ndarray

Returns:

Permitted active power per unit of rated output, 1.0 below start_pu and min_power_pu at or above end_pu.

Examples

>>> curve = VoltWattCurve.ieee_1547_default()
>>> float(curve.active_power_pu(1.08))
0.6