def __init__(self, nb_env, env):
GridObjects.__init__(self)
# self.init_grid(env)
self.imported_env = env
self.nb_env = nb_env
self._remotes, self._work_remotes = zip(
*[Pipe() for _ in range(self.nb_env)])
env_params = [env.get_kwargs() for _ in range(self.nb_env)]
for el in env_params:
el["backendClass"] = type(env.backend)
self._ps = [
RemoteEnv(env_params=env_,
remote=work_remote,
parent_remote=remote,
name="env: {}".format(i),
seed=np.random.randint(np.iinfo(np.uint32).max))
for i, (work_remote, remote, env_) in enumerate(
zip(self._work_remotes, self._remotes, env_params))
]
for p in self._ps:
p.daemon = True # if the main process crashes, we should not cause things to hang
p.start()
for remote in self._work_remotes:
remote.close()
self._waiting = True
def __init__(self, detailed_infos_for_cascading_failures=False):
"""
Initialize an instance of Backend. This does nothing per se. Only the call to :func:`Backend.load_grid`
should guarantee the backend is properly configured.
:param detailed_infos_for_cascading_failures: Whether to be detailed (but slow) when computing cascading failures
:type detailed_infos_for_cascading_failures: :class:`bool`
"""
GridObjects.__init__(self)
# the following parameter is used to control the amount of verbosity when computing a cascading failure
# if it's set to true, it returns all intermediate _grid states. This can slow down the computation!
self.detailed_infos_for_cascading_failures = detailed_infos_for_cascading_failures
# the power _grid manipulated. One powergrid per backend.
self._grid = None
# thermal limit setting, in ampere, at the same "side" of the powerline than self.get_line_overflow
self.thermal_limit_a = None
def __init__(self,
substation_layout,
observation_space,
radius_sub=20.,
load_prod_dist=70.,
bus_radius=6.):
if substation_layout is None:
raise PlotError(
"Impossible to use plotting abilities without specifying a layout (coordinates) "
"of the substations.")
if len(substation_layout) != observation_space.n_sub:
raise PlotError(
"You provided a layout with {} elements while there are {} substations on the powergrid. "
"Your layout is invalid".format(len(substation_layout),
observation_space.n_sub))
GridObjects.__init__(self)
self.init_grid(observation_space)
self.observation_space = observation_space
self._layout = {}
self._layout["substations"] = self._get_sub_layout(substation_layout)
self.radius_sub = radius_sub
self.load_prod_dist = load_prod_dist # distance between load and generator to the center of the substation
self.bus_radius = bus_radius
self.subs_elements = [None for _ in self.observation_space.sub_info]
# get the element in each substation
for sub_id in range(self.observation_space.sub_info.shape[0]):
this_sub = {}
objs = self.observation_space.get_obj_connect_to(
substation_id=sub_id)
for c_id in objs["loads_id"]:
c_nm = self._get_load_name(sub_id, c_id)
this_load = {}
this_load["type"] = "load"
this_load["sub_pos"] = self.observation_space.load_to_sub_pos[
c_id]
this_sub[c_nm] = this_load
for g_id in objs["generators_id"]:
g_nm = self._get_gen_name(sub_id, g_id)
this_gen = {}
this_gen["type"] = "gen"
this_gen["sub_pos"] = self.observation_space.gen_to_sub_pos[
g_id]
this_sub[g_nm] = this_gen
for lor_id in objs["lines_or_id"]:
ext_id = self.observation_space.line_ex_to_subid[lor_id]
l_nm = self._get_line_name(sub_id, ext_id, lor_id)
this_line = {}
this_line["type"] = "line"
this_line[
"sub_pos"] = self.observation_space.line_or_to_sub_pos[
lor_id]
this_sub[l_nm] = this_line
for lex_id in objs["lines_ex_id"]:
or_id = self.observation_space.line_or_to_subid[lex_id]
l_nm = self._get_line_name(or_id, sub_id, lex_id)
this_line = {}
this_line["type"] = "line"
this_line[
"sub_pos"] = self.observation_space.line_ex_to_sub_pos[
lex_id]
this_sub[l_nm] = this_line
self.subs_elements[sub_id] = this_sub
self._compute_layout()
def __init__(
self,
parameters,
thermal_limit_a=None,
epsilon_poly=1e-2,
tol_poly=1e-6,
):
GridObjects.__init__(self)
# specific to power system
if not isinstance(parameters, Parameters):
raise Grid2OpException(
"Parameter \"parameters\" used to build the Environment should derived form the "
"grid2op.Parameters class, type provided is \"{}\"".format(
type(parameters)))
self.parameters = parameters
# some timers
self._time_apply_act = 0
self._time_powerflow = 0
self._time_extract_obs = 0
# data relative to interpolation
self._epsilon_poly = epsilon_poly
self._tol_poly = tol_poly
# define logger
self.logger = None
# and calendar data
self.time_stamp = None
self.nb_time_step = 0
# observation
self.current_obs = None
# type of power flow to play
# if True, then it will not disconnect lines above their thermal limits
self.no_overflow_disconnection = self.parameters.NO_OVERFLOW_DISCONNECTION
self.timestep_overflow = None
self.nb_timestep_overflow_allowed = None
# store actions "cooldown"
self.times_before_line_status_actionable = None
self.max_timestep_line_status_deactivated = self.parameters.NB_TIMESTEP_LINE_STATUS_REMODIF
self.times_before_topology_actionable = None
self.max_timestep_topology_deactivated = self.parameters.NB_TIMESTEP_TOPOLOGY_REMODIF
# for maintenance operation
self.time_next_maintenance = None
self.duration_next_maintenance = None
# hazard (not used outside of this class, information is given in `time_remaining_before_line_reconnection`
self._hazard_duration = None
# hard overflow part
self.hard_overflow_threshold = self.parameters.HARD_OVERFLOW_THRESHOLD
self.time_remaining_before_line_reconnection = None
self.env_dc = self.parameters.ENV_DC
# redispatching data
self.target_dispatch = None
self.actual_dispatch = None
self.gen_uptime = None
self.gen_downtime = None
self.gen_activeprod_t = None
self._thermal_limit_a = thermal_limit_a
# maintenance / hazards
self.time_next_maintenance = None
self.duration_next_maintenance = None
self.time_remaining_before_reconnection = None
# store environment modifications
self._injection = None
self._maintenance = None
self._hazards = None
self.env_modification = None
# to use the data
self.done = False
self.current_reward = None
self.helper_action_env = None
self.chronics_handler = None
self.game_rules = None
self.helper_action_player = None
self.rewardClass = None
self.actionClass = None
self.observationClass = None
self.legalActClass = None
self.helper_observation = None
self.names_chronics_to_backend = None
self.reward_helper = None
self.reward_range = None, None
# backend
self.init_grid_path = None
# specific to Basic Env, do not change
self.backend = None
self.__is_init = False
