Merge pull request #700 from BDonnot/bd_dev

Fix the protections in case of soft_overflow_threshold

Author: BDonnot

.github/workflows/main.yml

@@ -68,7 +68,6 @@ jobs:
       - name: Build wheel
         run: |
           python setup.py bdist_wheel
-          # auditwheel repair dist/*.whl  # only for compiled code !
 
       - name: Install wheel
         run: |
@@ -80,7 +79,23 @@ jobs:
           python -c "import grid2op"
           python -c "from grid2op import *"
           python -c "from grid2op.Action._backendAction import _BackendAction"
+          
+      # - name: Run full tests + code coverage
+      #   if: matrix.python.name == 'cp312'
+      #   run: |
+      #     python -m pip install --upgrade coverage
+      #     python -m pip install --find-links=dist/ grid2op[test]
+      #     cd grid2op/tests
+      #     coverage run -m unittest discover
+      #     coverage xml -i 
 
+      # - name: Upload coverage
+      #   if: matrix.python.name == 'cp312'
+      #   uses: actions/upload-artifact@v4
+      #   with: 
+      #     name: coverage.xml
+      #     path: grid2op/tests/*.xml
+
       - name: List wheel
         run: 
           ls ./dist/*.whl

CHANGELOG.rst

@@ -158,6 +158,13 @@ Native multi agents support:
 - [FIXED] an issue in the AAA tests: when backend does not support storages, some tests were skipped not correctly
 - [FIXED] an issue when computing the cascading failure routine, in case multiple iterations were performed, 
   the cooldowns were not updated correctly.
+- [FIXED] cascading failure could be started at the first observation (t=0, just after a reset).
+- [FIXED] a bug when "SOFT_OVERFLOW_THRESHOLD" was not 1.: it also impacted "instantaneous overcurrent protections" 
+  (it was triggered when `flow > SOFT_OVERFLOW_THRESHOLD * HARD_OVERFLOW_THRESHOLD * th_lim`)
+- [FIXED] a bug when "SOFT_OVERFLOW_THRESHOLD" was not 1.: the backend routine to compute the protections 
+  disconnected the lines with a counter based on `flow > th_lim` and not `flow > th_lim * SOFT_OVERFLOW_THRESHOLD`
+- [ADDED] Possibility to disconnect loads, generators and storage units (if proper flag set in the environment).
+  See documentation.
 - [ADDED] possibility to set the "thermal limits" when calling `env.reset(..., options={"thermal limit": xxx})`
 - [ADDED] possibility to retrieve some structural information about elements with
   with `gridobj.get_line_info(...)`, `gridobj.get_load_info(...)`, `gridobj.get_gen_info(...)` 
@@ -173,6 +180,10 @@ Native multi agents support:
 - [ADDED] possibility to set the initial time stamp of the observation in the `env.reset`
   kwargs by using `env.reset(..., options={"init datetime": XXX})`
 - [ADDED] the `ChangeNothing` time series class now supports forecast
+- [ADDED] test coverage on the CI
+- [ADDED] the `obs.timestep_protection_triggered` counter which counts whether or not the 
+  "time overcurrent protection" (soft overflow) will be triggered: lines will be disconnected
+  if `time overcurrent protection > parameters.NB_TIMESTEP_POWERFLOW_ALLOWED`
 - [IMPROVED] possibility to set the injections values with names
   to be consistent with other way to set the actions (*eg* set_bus)
 - [IMPROVED] error messages when creating an action which changes the injections
@@ -203,11 +214,9 @@ Native multi agents support:
   it... unless you know what you are doing)
 - [IMPROVED] `ForecastEnv` is now part of the public API.
 - [IMPROVED] no need to call `self._compute_pos_big_top()` at the end of the implementation of `backend.load_grid()`
-
-[1.10.5] - 2025-03-07
-------------------------
-- [FIXED] force pandapower < 3 otherwise pandapower backend does not work and 
-  lots of tests are failing.
+- [IMPROVED] type hints in various files.
+- [IMPROVED] documentation of the backend
+- [IMRPOVED] `SOFT_OVERFLOW_THRESHOLD` can now be lower than 1
 
 [1.10.5] - 2025-03-07
 ------------------------