Voltage Controler

class grid2op.VoltageControler.BaseVoltageController(gridobj, controler_backend)[source]

This class is the most basic controler for the voltages. Basically, what it does is read the voltages from the chronics.

If the voltages are not on the chronics (missing files), it will not change the voltage setpoints at all.

abstractmethod fix_voltage(observation, agent_action, env_action, prod_v_chronics)[source]

This method must be overloaded to change the behaviour of the generator setpoint for time t+1.

This simple class will:

  • do nothing if the vector prod_v_chronics is None

  • set the generator setpoint to the value in prod_v_chronics

Basically, this class is pretty fast, but does nothing interesting, beside looking at the data in files.

More general class can use, to adapt the voltage setpoint:

  • observation the observation (receive by the agent) at time t

  • agent_action the action of the agent at time t

  • env_action the modification of the environment at time t, that will be observed by the agent at time t+1

  • prod_v_chronics the new setpoint of the generators present in the data (if any, this can be None)

To help this class, a grid2op.Backend.Backend is available and can be used to perform simulation of potential impact of voltages setpoints.

Parameters
  • observation (grid2op.Observation.Observation) – The last observation (at time t)

  • agent_action (grid2op.Action.Action) – The action that the agent took

  • env_action (grid2op.Action.Action) – The modification that the environment will take.

  • prod_v_chronics (numpy.ndarray) – The next voltage setpoint present in the data (if any) or None if not.

Returns

res – The new setpoint, in this case depending only on the prod_v_chronics.

Return type

grid2op.Action.Action

class grid2op.VoltageControler.ControlVoltageFromFile(gridobj, controler_backend)[source]

This class is the most basic controler for the voltages. Basically, what it does is read the voltages from the chronics.

If the voltages are not on the chronics (missing files), it will not change the voltage setpoints at all.

fix_voltage(observation, agent_action, env_action, prod_v_chronics)[source]

This method must be overloaded to change the behaviour of the generator setpoint for time t+1.

This simple class will:

  • do nothing if the vector prod_v_chronics is None

  • set the generator setpoint to the value in prod_v_chronics

Basically, this class is pretty fast, but does nothing interesting, beside looking at the data in files.

More general class can use, to adapt the voltage setpoint:

  • observation the observation (receive by the agent) at time t

  • agent_action the action of the agent at time t

  • env_action the modification of the environment at time t, that will be observed by the agent at time t+1

  • prod_v_chronics the new setpoint of the generators present in the data (if any, this can be None)

To help this class, a grid2op.Backend.Backend is available and can be used to perform simulation of potential impact of voltages setpoints.

Parameters
  • observation (grid2op.Observation.Observation) – The last observation (at time t)

  • agent_action (grid2op.Action.Action) – The action that the agent took

  • env_action (grid2op.Action.Action) – The modification that the environment will take.

  • prod_v_chronics (numpy.ndarray) – The next voltage setpoint present in the data (if any) or None if not.

Returns

res – The new setpoint, in this case depending only on the prod_v_chronics.

Return type

grid2op.Action.Action

If you still can’t find what you’re looking for, try in one of the following pages: