soft4pes.control.lin.lcl_vc_ctr#

Voltage Controller (VC) for the control of the capacitor voltage in the three-phase voltage-source converter equipped with an LC(L) filter. Provide the converter current reference in dq-frame for Current Controller (CC).

[Ref.]. V. Pirsto, J. Kukkola and M. Hinkkanen, “Multifunctional Cascade Control of Voltage-Source Converters Equipped With an LC Filter,” IEEE Trans. Ind. Electron., vol. 69, no. 3, pp. 2610-2620, March 2022.

Classes#

LCLVcCtr

Voltage Controller for the control of the capacitor voltage.

Module Contents#

class soft4pes.control.lin.lcl_vc_ctr.LCLVcCtr(sys, curr_ctr, I_conv_max=1.2)[source]#

Bases: soft4pes.control.common.controller.Controller

Voltage Controller for the control of the capacitor voltage.

Parameters:

  • sys (object) – The system model containing electrical parameters and base values.

  • curr_ctr (object) – The current controller containing its controller parameters and attributes.

  • I_conv_max (float (optional)) – The maximum converter current in per unit (p.u.).

u_iu_comp[source]#

Integrator state for the converter voltage reference in the dq-frame.

Type:

complex

sys[source]#

System model containing electrical parameters and base values.

Type:

object

I_conv_max[source]#

The maximum converter current in per unit (p.u.).

Type:

float

ctr_pars[source]#

Controller parameters including delta, K_u, k_iu, and K_tu.

Type:

SimpleNamespace

curr_ctr[source]#

The current controller containing its controller parameters and attributes.

Type:

object

set_sampling_interval(Ts)[source]#

Set the sampling interval and compute controller parameters.

[Ref.]. H.-S. Kim, H.-S. Jung, and S.-K. Sul, “Discrete-time voltage controller for voltage source converters with LC filter based on state-space models,” IEEE Trans. Ind. Appl., vol. 55, no. 1, pp. 529-540, Jan./Feb. 2019.

Parameters:

Ts (float) – Sampling interval [s].

execute(sys, kTs)[source]#

Execute the Voltage Controller (VC) and save the controller data.

Parameters:

  • sys (object) – System model.

  • kTs (float) – Current discrete time instant [s].

Returns:

The converter current reference in dq-frame for Current Controller (CC).

Return type:

1 x 2 ndarray of floats