Skip to content

Commit a46bc5d

Browse files
committed
fixing the url to point to Grid2op/grid2op instead of rte-france/grid2op [skip ci]
Signed-off-by: DONNOT Benjamin <[email protected]>
1 parent 9bb03c8 commit a46bc5d

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

59 files changed

+299
-270
lines changed

CHANGELOG.rst

Lines changed: 189 additions & 168 deletions
Large diffs are not rendered by default.

CONTRIBUTING.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,19 @@ Contribution can take different forms:
1616
- adding a new functionality to grid2op (or increase its speed)
1717
- extend grid2op
1818

19-
# What to do ?
19+
# On which topic to contribute ?
20+
21+
If you want to contribute but are not sure were to start you can, for example:
22+
23+
- tackle an opened issue tagged as `good first issue`
24+
- try to solve an opened issue marked with `helps wanted`
25+
- there are also some contribution ideas written in the `[TODO]` and `Next few releases` of the `CHANGELOG.rst`
26+
at the top level of the github repo.
27+
28+
In any case, if you are not sure about what is written here, feel free to ask in the grid2op [github discussion](https://github.com/orgs/Grid2op/discussions),
29+
in the [grid2op discord](https://discord.gg/cYsYrPT) or by contacting by mail the person in charge of the [pypi package](https://pypi.org/project/Grid2Op/).
30+
31+
# What to do concretely ?
2032

2133
For smaller changes (including, but not limited to the reporting of a bug or a contribution to the explanotory notebooks or the documentations)
2234
a simple "pull request" with your modifications by detailing what you had in mind and the goal of your changes.

README.md

Lines changed: 24 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@
55
[![PyPi_Compat](https://img.shields.io/pypi/pyversions/grid2op.svg)](https://pypi.org/project/Grid2Op/)
66
[![LICENSE](https://img.shields.io/pypi/l/grid2op.svg)](https://www.mozilla.org/en-US/MPL/2.0/)
77
[![Documentation Status](https://readthedocs.org/projects/grid2op/badge/?version=latest)](https://grid2op.readthedocs.io/en/latest/?badge=latest)
8-
[![circleci](https://circleci.com/gh/rte-france/Grid2Op.svg?style=shield)](https://circleci.com/gh/rte-france/Grid2Op)
9-
[![discord](https://discord.com/api/guilds/698080905209577513/embed.png)]( https://discord.gg/cYsYrPT)
10-
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/rte-france/Grid2Op/master)
8+
[![CircleCI](https://dl.circleci.com/status-badge/img/gh/Grid2op/grid2op/tree/master.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/Grid2op/grid2op/tree/master)
9+
[![discord](https://discord.com/api/guilds/698080905209577513/embed.png)](https://discord.gg/cYsYrPT)
10+
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/grid2op/grid2op.git/master)
1111

1212
Grid2Op is a platform, built with modularity in mind, that allows to perform powergrid operation.
1313
And that's what it stands for: Grid To Operate.
14-
Grid2Op acts as a replacement of [pypownet](https://github.com/MarvinLer/pypownet)
15-
as a library used for the Learning To Run Power Network [L2RPN](https://l2rpn.chalearn.org/).
14+
It is used as a library used for the Learning To Run Power Network [L2RPN](https://l2rpn.chalearn.org/),
15+
but also for research purpose (especially by the Reinforcement Learning community applied to power system)
1616

1717
This framework allows to perform most kind of powergrid operations, from modifying the setpoint of generators,
1818
to load shedding, performing maintenance operations or modifying the *topology* of a powergrid
@@ -71,7 +71,7 @@ pip3 install grid2op
7171
### Install from source
7272

7373
```commandline
74-
git clone https://github.com/rte-france/Grid2Op.git
74+
git clone https://github.com/grid2op/Grid2Op.git
7575
cd Grid2Op
7676
pip3 install -U .
7777
cd ..
@@ -80,7 +80,7 @@ cd ..
8080
### Install for contributors
8181

8282
```commandline
83-
git clone https://github.com/rte-france/Grid2Op.git
83+
git clone https://github.com/grid2op/Grid2Op.git
8484
cd Grid2Op
8585
pip3 install -e .
8686
pip3 install -e .[optional]
@@ -136,74 +136,74 @@ These notebooks will help you in understanding how this framework is used and co
136136
interesting part of this framework:
137137

138138
* [00_Introduction](getting_started/00_Introduction.ipynb)
139-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/00_Introduction.ipynb)
139+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/00_Introduction.ipynb)
140140
and [00_SmallExample](getting_started/00_SmallExample.ipynb)
141-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/00_SmallExample.ipynb)
141+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/00_SmallExample.ipynb)
142142
describe what is
143143
adressed by the grid2op framework (with a tiny introductions to both power systems and reinforcement learning)
144144
and give and introductory example to a small powergrid manipulation.
145145
* [01_Grid2opFramework](getting_started/01_Grid2opFramework.ipynb)
146-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/01_Grid2opFramework.ipynb)
146+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/01_Grid2opFramework.ipynb)
147147
covers the basics
148148
of the
149149
Grid2Op framework. It also covers how to create a valid environment and how to use the
150150
`Runner` class to assess how well an agent is performing rapidly.
151151
* [02_Observation](getting_started/02_Observation.ipynb)
152-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/02_Observation.ipynb)
152+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/02_Observation.ipynb)
153153
details how to create
154154
an "expert agent" that will take pre defined actions based on the observation it gets from
155155
the environment. This Notebook also covers the functioning of the BaseObservation class.
156156
* [03_Action](getting_started/03_Action.ipynb)
157-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/03_Action.ipynb)
157+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/03_Action.ipynb)
158158
demonstrates
159159
how to use the BaseAction class and how to manipulate the powergrid.
160160
* [04_TrainingAnAgent](getting_started/04_TrainingAnAgent.ipynb)
161-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/04_TrainingAnAgent.ipynb)
161+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/04_TrainingAnAgent.ipynb)
162162
shows how to get started with
163163
reinforcement learning with the grid2op environment. It shows the basic on how to train a "PPO" model operating the grid relying on "stable baselines 3" PPO implementation.
164164
* [05_StudyYourAgent](getting_started/05_StudyYourAgent.ipynb)
165-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/05_StudyYourAgent.ipynb)
165+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/05_StudyYourAgent.ipynb)
166166
shows how to study an BaseAgent, for example
167167
the methods to reload a saved experiment, or to plot the powergrid given an observation for
168168
example. This is an introductory notebook. More user friendly graphical interface should
169169
come soon.
170170
* [06_Redispatching_Curtailment](getting_started/06_Redispatching_Curtailment.ipynb)
171-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/06_Redispatching_Curtailment.ipynb)
171+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/06_Redispatching_Curtailment.ipynb)
172172
explains what is the
173173
"redispatching" and curtailment from the point
174174
of view of a company who's in charge of keeping the powergrid safe (aka a Transmission System Operator) and how to
175175
manipulate this concept in grid2op. Redispatching (and curtailment) allows you to perform **continuous**
176176
actions on the powergrid
177177
problem.
178178
* [07_MultiEnv](getting_started/07_MultiEnv.ipynb)
179-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/07_MultiEnv.ipynb)
179+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/07_MultiEnv.ipynb)
180180
details how grid2op natively support a single agent interacting
181181
with multiple environments at the same time. This is particularly handy to train "asynchronous" agent in the
182182
Reinforcement Learning community for example.
183183
* [08_PlottingCapabilities](getting_started/08_PlottingCapabilities.ipynb)
184-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/08_PlottingCapabilities.ipynb)
184+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/08_PlottingCapabilities.ipynb)
185185
shows you the different ways with which you
186186
can represent (visually) the grid your agent interact with. A renderer is available like in many open AI gym
187187
environment. But you also have the possibility to post process an agent and make some movies out of it, and we also
188188
developed a Graphical User Interface (GUI) called "[grid2viz](https://github.com/mjothy/grid2viz)" that allows
189189
to perform in depth study of your agent's behaviour on different scenarios and even to compare it with baselines.
190190
* [09_EnvironmentModifications](getting_started/09_EnvironmentModifications.ipynb)
191-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/09_EnvironmentModifications.ipynb)
191+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/09_EnvironmentModifications.ipynb)
192192
elaborates on the maintenance,
193193
hazards
194194
and attacks. All three of these represents external events that can disconnect some powerlines. This notebook
195195
covers how to spot when such things happened and what can be done when the maintenance or the attack is over.
196196
* [10_StorageUnits](getting_started/10_StorageUnits.ipynb)
197-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/10_StorageUnits.ipynb)
197+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/10_StorageUnits.ipynb)
198198
details the usage and behaviour of the storage units
199199
in grid2op.
200200
* [11_IntegrationWithExistingRLFrameworks](getting_started/11_IntegrationWithExistingRLFrameworks.ipynb)
201-
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/rte-france/Grid2Op/blob/master/getting_started/11_IntegrationWithExistingRLFrameworks.ipynb)
201+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Grid2Op/grid2op/blob/master/getting_started/11_IntegrationWithExistingRLFrameworks.ipynb)
202202
explains how to use grid2op with other reinforcement learning framework. TODO: this needs to be redone
203203

204204
Try them out in your own browser without installing
205205
anything with the help of mybinder:
206-
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/rte-france/Grid2Op/master)
206+
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Grid2Op/grid2op/master)
207207

208208
Or thanks to google colab (all links are provided near the notebook description)
209209

@@ -212,13 +212,12 @@ Or thanks to google colab (all links are provided near the notebook description)
212212
If you use this package in one of your work, please cite:
213213

214214
```text
215-
@misc{grid2op,
215+
@software{grid2op,
216216
author = {B. Donnot},
217217
title = {{Grid2op- A testbed platform to model sequential decision making in power systems. }},
218+
url = {\url{https://GitHub.com/Grid2Op/grid2op}},
218219
year = {2020},
219220
publisher = {GitHub},
220-
journal = {GitHub repository},
221-
howpublished = {\url{https://GitHub.com/rte-france/grid2op}},
222221
}
223222
```
224223

@@ -273,7 +272,7 @@ to discuss what you would like to change.
273272

274273
To contribute to this code, you need to:
275274

276-
1. fork the repository located at <https://github.com/rte-france/Grid2Op>
275+
1. fork the repository located at <https://github.com/Grid2Op/grid2op>
277276
2. synch your fork with the "latest developement branch of grid2op". For example, if the latest grid2op release
278277
on pypi is `1.6.5` you need to synch your repo with the branch named `dev_1.6.6` or `dev_1.7.0` (if
279278
the branch `dev_1.6.6` does not exist). It will be the highest number in the branches `dev_*` on

binder/environment.yml

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,10 @@ dependencies:
77
- keras
88
- pip
99
- pip:
10-
- grid2op[challenge]
11-
- l2rpn-baselines
10+
- grid2op
1211
- jyquickhelper
1312
- numpy
1413
- numba
15-
- keras
1614
- seaborn
1715
- plotly
18-
- imageio
19-
- ray[rllib, default]
16+
- imageio

docs/developer/create_an_environment.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ Anyway, assuming you created your environment in `EXAMPLE_FOLDER` (remember, in
228228

229229
We tried our best to display useful error messages if the environment is not loading properly. If you experience
230230
any trouble at this stage, feel free to post a github issue on the official grid2op repository
231-
https://github.com/rte-france/grid2op/issues (you might need to log in on a github account for such purpose)
231+
https://github.com/Grid2Op/grid2op/issues (you might need to log in on a github account for such purpose)
232232

233233

234234
.. _calibrate_th_lim_ex:

docs/developer/createbackend.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -841,7 +841,7 @@ virtual environment is a good idea and is not covered here):
841841

842842
.. code-block::
843843
844-
git clone https://github.com/rte-france/grid2op.git grid2op_dev
844+
git clone https://github.com/Grid2Op/grid2op.git grid2op_dev
845845
cd grid2op_dev
846846
pip install -e .
847847

docs/final.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@ If you still can't find what you're looking for, try in one of the following pag
55
* :ref:`search`
66

77
Still trouble finding the information ? Do not hesitate to send a github issue about the documentation at this
8-
link: `Documentation issue template <https://github.com/rte-france/Grid2Op/issues/new?assignees=&labels=documentation&template=documentation.md&title=>`_
8+
link: `Documentation issue template <https://github.com/Grid2Op/grid2op/issues/new?assignees=&labels=documentation&template=documentation.md&title=>`_

docs/grid2op.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Today, the main usage of this platform is to serve as a computation engine for t
2424
competitions.
2525

2626
This platform is still under development. If you notice a bug, let us know with a github issue at
27-
`Grid2Op <https://github.com/rte-france/Grid2Op>`_
27+
`Grid2Op <https://github.com/Grid2Op/grid2op>`_
2828

2929
.. note::
3030
Grid2op do not model any object on the powergrid. It has no internal modeling of the equations of the
@@ -460,7 +460,7 @@ Going further
460460
--------------
461461
To get started into the grid2op ecosystem, we made a set of notebooks
462462
that are available, without any installation thanks to
463-
`Binder <https://mybinder.org/v2/gh/rte-france/Grid2Op/master>`_ . Feel free to visit the "getting_started" page for
463+
`Binder <https://mybinder.org/v2/gh/Grid2Op/grid2op/master>`_ . Feel free to visit the "getting_started" page for
464464
more information and a detailed tour about the issue that grid2op tries to address.
465465

466466
.. note::

docs/grid_graph.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -230,7 +230,7 @@ substation `k` (with `j` different `k`) will never have a "bus" in common.
230230

231231
Changing this would not be too difficult on grid2op side, but would make the action space even bigger. If you
232232
really need to use more than 2 buses at the same substation, do not hesitate to fill a feature request:
233-
https://github.com/rte-france/Grid2Op/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
233+
https://github.com/Grid2Op/grid2op/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
234234

235235

236236
The graph is dynamic
@@ -256,7 +256,7 @@ on the step, nor the same number of edges, for example if powerlines are disconn
256256

257257
If you want to model these, it is perfectly possible without too much trouble. You can fill a feature request
258258
for this if that is interesting to you :
259-
https://github.com/rte-france/Grid2Op/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
259+
https://github.com/Grid2Op/grid2op/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
260260

261261
.. warning::
262262

docs/makeenv.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ You can consult the different notebooks in the `getting_stared` directory of thi
2626
how to use it.
2727

2828
Created Environment should behave exactly like a gymnasium environment. If you notice any unwanted behavior, please address
29-
an issue in the official grid2op repository: `Grid2Op <https://github.com/rte-france/Grid2Op>`_
29+
an issue in the official grid2op repository: `Grid2Op <https://github.com/Grid2Op/grid2op>`_
3030

3131
The environment created with this method should be fully compatible with the gymnasium framework: if you are developing
3232
a new algorithm of "Reinforcement Learning" and you used the openai gymnasium framework to do so, you can port your code

0 commit comments

Comments
 (0)