hermess.devices.inverter_voltage

Inverter outer voltage-control strategies (the reactive / voltage side).

The voltage controller is the AVR-analogue of the converter: it turns the reactive-power / voltage setpoints into the voltage-magnitude reference Vcd that the inner control ladder regulates the capacitor voltage to. It owns the reactive-power measurement state Qc_tilde and the Qref / Vref setpoints.

The strategy owns the Qc_tilde state but the host writes its measurement- filter equation d Qc_tilde/dt = omega_f (Qc - Qc_tilde) because Qc comes from the shared Park-transform loop in Inverter.fgcall.

Attributes

VOLTAGE_REGISTRY

Classes

VoltageControl

Abstract base class for inverter outer voltage-control strategies.

QVDroop

Reactive-power / voltage droop: Vcd = Vref + Kq (Qref - Qc_tilde).

Module Contents

class hermess.devices.inverter_voltage.VoltageControl[source]

Bases: abc.ABC

Abstract base class for inverter outer voltage-control strategies.

Must expose the voltage-magnitude reference: fgcall() returns the Vcd vector consumed by the inner control ladder (host-mediated via host.voltage_command). Reads host params/states/setpoints by attribute.

abstract states() → List[str][source]
Return type:

List[str]

algebs() → List[str][source]
Return type:

List[str]

algebs_units() → Dict[str, str][source]
Return type:

Dict[str, str]

algebs_x0() → Dict[str, float][source]
Return type:

Dict[str, float]

abstract units() → List[str][source]
Return type:

List[str]

abstract params() → Dict[str, float][source]
Return type:

Dict[str, float]

abstract x0() → Dict[str, float][source]
Return type:

Dict[str, float]

abstract descriptions() → Dict[str, str][source]
Return type:

Dict[str, str]

abstract setpoints() → Dict[str, float][source]
Return type:

Dict[str, float]

abstract fgcall(host, dae: hermess.system.Dae)[source]

Publish the voltage-magnitude reference on host.Vcd (read by the inner controller via host.voltage_command(dae)). The host writes the Qc_tilde measurement-filter equation (Qc is host-computed).

Parameters:

dae (hermess.system.Dae)

abstract finit_sequential(host, dae: hermess.system.Dae, Qc: numpy.ndarray, Vcd: numpy.ndarray) → Dict[str, numpy.ndarray][source]

Resolve the voltage controller’s states/setpoints from the (frame-invariant) reactive power Qc and the inner controller’s voltage command Vcd. This is where the Q-V gauge lives. The base raises; each voltage law declares its own resolution.

Parameters:
Return type:

Dict[str, numpy.ndarray]

class hermess.devices.inverter_voltage.QVDroop[source]

Bases: VoltageControl

Reactive-power / voltage droop: Vcd = Vref + Kq (Qref - Qc_tilde).

Owns the filtered reactive-power state Qc_tilde, the droop gain Kq and the Qref / Vref setpoints.

states() → List[str][source]
Return type:

List[str]

units() → List[str][source]
Return type:

List[str]

params() → Dict[str, float][source]
Return type:

Dict[str, float]

x0() → Dict[str, float][source]
Return type:

Dict[str, float]

setpoints() → Dict[str, float][source]
Return type:

Dict[str, float]

descriptions() → Dict[str, str][source]
Return type:

Dict[str, str]

fgcall(host, dae: hermess.system.Dae)[source]

Publish the voltage-magnitude reference on host.Vcd (read by the inner controller via host.voltage_command(dae)). The host writes the Qc_tilde measurement-filter equation (Qc is host-computed).

Parameters:

dae (hermess.system.Dae)

finit_sequential(host, dae: hermess.system.Dae, Qc: numpy.ndarray, Vcd: numpy.ndarray) → Dict[str, numpy.ndarray][source]

Resolve the voltage controller’s states/setpoints from the (frame-invariant) reactive power Qc and the inner controller’s voltage command Vcd. This is where the Q-V gauge lives. The base raises; each voltage law declares its own resolution.

Parameters:
Return type:

Dict[str, numpy.ndarray]

hermess.devices.inverter_voltage.VOLTAGE_REGISTRY: Dict[str, type]