Four Quadrant Converters

../../../_images/4QC.svg

Discrete Four Quadrant Converter

class gym_electric_motor.physical_systems.converters.FiniteFourQuadrantConverter(**kwargs)[source]
Key:

‘Finite-4QC’

Switching States / Actions:
0: T2, T4 on.
1: T1, T4 on.
2: T2, T3 on.
3: T1, T3 on.
Action Space:

Discrete(4)

Output Voltages and Currents:
Box(-1, 1, shape=(1,))
Box(-1, 1, shape=(1,))
Parameters:
  • tau – Discrete time step of the system in seconds

  • interlocking_time – Interlocking time of the transistors in seconds

action_space = Discrete(4)

gymnasium.Space that defines the set of all possible actions for the converter

convert(i_out, t)[source]

The conversion function that converts the previously set action to an input voltage for the motor. This function has to be called at least at every previously defined switching time, because the input voltage for the motor might change at these times.

Parameters:
  • i_out (list(float)) – All currents that flow out of the converter into the motor.

  • t (float) – Current time of the system.

Returns:

List of all input voltages at the motor.

Return type:

list(float)

currents = Box(-1.0, 1.0, (1,), float64)

gymnasium.Space that defines Minimum, Maximum and Dimension of possible output current of the converter

i_sup(i_out)[source]

Calculate the current, the converter takes from the supply for the given output currents and the current switching state.

Parameters:

i_out (list(float)) – All currents flowing out of the converter and into the motor.

Returns:

The current drawn from the supply.

Return type:

float

reset()[source]

Reset all converter states to a default.

Returns:

A default output voltage after reset(=0V).

Return type:

list(float)

set_action(action, t)[source]

Set the next action of the converter at the beginning of a simulation step in the system.

Parameters:
  • action (element of action_space) – The control action on the converter.

  • t (float) – Time at the beginning of the simulation step in seconds.

Returns:

Times when a switching action occurs and the conversion function must be called by the system.

Return type:

list(float)

property tau

Time of one simulation step in seconds.

Type:

Float

voltages = Box(-1.0, 1.0, (1,), float64)

gymnasium.Space that defines Minimum, Maximum and Dimension of possible output voltage of the converter

Continuous Four Quadrant Converter

class gym_electric_motor.physical_systems.converters.ContFourQuadrantConverter(**kwargs)[source]

The continuous four quadrant converter (4QC) is simulated with two continuous 2QC.

Key:

‘Cont-4QC’

Actions:
Duty Cycle Transistor T1: 0.5 * (Action + 1)
Duty Cycle Transistor T2: 1 - 0.5 * (Action + 1)
Duty Cycle Transistor T3: 1 - 0.5 * (Action + 1)
Duty Cycle Transistor T4: 0.5 * (Action + 1)
Action Space:

Box(-1, 1, shape=(1,))

Output Voltages and Currents:
voltages: Box(-1, 1, shape=(1,))
currents: Box(-1, 1, shape=(1,))
Parameters:
  • tau – Discrete time step of the system in seconds

  • interlocking_time – Interlocking time of the transistors in seconds

action_space = Box(-1.0, 1.0, (1,), float64)

gymnasium.Space that defines the set of all possible actions for the converter

convert(i_out, t)[source]

The conversion function that converts the previously set action to an input voltage for the motor. This function has to be called at least at every previously defined switching time, because the input voltage for the motor might change at these times.

Parameters:
  • i_out (list(float)) – All currents that flow out of the converter into the motor.

  • t (float) – Current time of the system.

Returns:

List of all input voltages at the motor.

Return type:

list(float)

currents = Box(-1.0, 1.0, (1,), float64)

gymnasium.Space that defines Minimum, Maximum and Dimension of possible output current of the converter

i_sup(i_out)[source]

Calculate the current, the converter takes from the supply for the given output currents and the current switching state.

Parameters:

i_out (list(float)) – All currents flowing out of the converter and into the motor.

Returns:

The current drawn from the supply.

Return type:

float

reset()[source]

Reset all converter states to a default.

Returns:

A default output voltage after reset(=0V).

Return type:

list(float)

set_action(action, t)[source]

Set the next action of the converter at the beginning of a simulation step in the system.

Parameters:
  • action (element of action_space) – The control action on the converter.

  • t (float) – Time at the beginning of the simulation step in seconds.

Returns:

Times when a switching action occurs and the conversion function must be called by the system.

Return type:

list(float)

property tau

Time of one simulation step in seconds.

Type:

Float

voltages = Box(-1.0, 1.0, (1,), float64)

gymnasium.Space that defines Minimum, Maximum and Dimension of possible output voltage of the converter