example alternative shifting algo

Signed-off-by: Sahas Subramanian <[email protected]>

Author: shsms

src/frequenz/sdk/microgrid/__init__.py

@@ -286,6 +286,8 @@
 
 Battery bounds available for use: -100kW to 100kW
 
+##### Shifting or Limiting
+
 | pri | available bounds | req bounds     | req power | s/l    | power in range | cumulative power |
 |-----|------------------|----------------|-----------|--------|----------------|------------------|
 | 7   | -100kW .. 100kW  | None           | 10kW      | shifts | 10kW           | 10kW             |
@@ -298,6 +300,20 @@
 | 0   | -52kW .. 18kW    | -40kW .. -10kW | -10kW     | limits | -10kW          | -28kW            |
 |     |                  |                |           |        | target power   | -28kW            |
 
+##### Shifting and Limiting
+
+| pri | available bounds | req bounds     | req power | power in range | cumulative power |
+|-----|------------------|----------------|-----------|----------------|------------------|
+| 7   | -100kW .. 100kW  | None           | 10kW      | 10kW           | 10kW             |
+| 6   | -110kW .. 90kW   | -110kW .. 80kW | 10kW      | 10kW           | 20kW             |
+| 5   | -120kW .. 70kW   | -100kW .. 80kW | 80kW      | 70kW           | 90kW             |
+| 4   | -190kW .. 0kW    | None           | -120kW    | -120kW         | -30kW            |
+| 3   | -70kW .. 120kW   | None           | 60kW      | 60kW           | 30kW             |
+| 2   | -130kW .. 60kW   | -40kW .. 30kW  | 20kW      | 20kW           | 50kW             |
+| 1   | -60kW .. 10kW    | None           | 12kW      | 10kW           | 60kW             |
+| 0   | -70kW .. 0kW     | -40kW .. -10kW | -10kW     | -10kW          | 50kW             |
+|     |                  |                |           | target power   | 50kW             |
+
 In this example, there are some shifting and some limiting actors, and each of
 them affect the lower priority actors in the same patterns mentioned above.
 """  # noqa: D205, D400