Apply changes from feedback

Author: Thijss

power-grid-model-ds/advanced.ipynb

@@ -147,7 +147,11 @@
     "\n",
     "1. Use the PowerGridModelInterface to calculate power flow\n",
     "2. Update the Grid object with the calculated values\n",
-    "3. Return the lines (LineArray) that are overloaded"
+    "3. Return the lines (LineArray) that are overloaded\n",
+    "\n",
+    "**💡 Hint**: You can use the `is_overloaded` property of the `MyLineArray` class to check for overloaded lines.\n",
+    "\n",
+    "**💡 Hint**: https://power-grid-model-ds.readthedocs.io/en/stable/quick_start.html#performing-power-flow-calculations"
    ]
   },
   {
@@ -157,16 +161,21 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Hint: You can use the `is_overloaded` property of the `MyLineArray` class to check for overloaded lines.\n",
-    "# Hint: https://power-grid-model-ds.readthedocs.io/en/stable/quick_start.html#performing-power-flow-calculations\n",
-    "\n",
     "def check_for_capacity_issues(grid: Grid) -> LineArray:\n",
     "    \"\"\"Check for capacity issues on the grid.\n",
     "    Return the lines that with capacity issues.\n",
     "    \"\"\"\n",
     "\n",
-    "print(check_for_capacity_issues(grid))\n",
-    "\n",
+    "print(check_for_capacity_issues(grid))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "18973302-105f-42c3-9ffd-1408b90aeb10",
+   "metadata": {},
+   "outputs": [],
+   "source": [
     "# %load solutions/advanced_3_check_for_capacity_issues.py"
    ]
   },
@@ -199,7 +208,7 @@
     "\n",
     "![input_network_with_overload.png](input_network_with_overload.png)\n",
     "\n",
-    "We found out the north west part of the area is overloaded.\n",
+    "We found out the north-east part of the area is overloaded.\n",
     "Goal: Place a second substation near the overloaded path. In the next steps we will use this substation to relieve overloaded cables.\n",
     "\n",
     "You’ll:\n",
@@ -220,8 +229,16 @@
     "def build_new_substation(grid: Grid, location: tuple[float, float]) -> NodeArray:\n",
     "    \"\"\"Build a new substation at the given location.\n",
     "    Return the new substation.\n",
-    "    \"\"\"\n",
-    "\n",
+    "    \"\"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bff1e30f-5dd3-4774-977b-5707322a8f59",
+   "metadata": {},
+   "outputs": [],
+   "source": [
     "# %load solutions/advanced_4_build_new_substation.py"
    ]
   },
@@ -234,9 +251,13 @@
     "Goal: Identify the best way to connect the new substation to the overloaded routes.\n",
     "\n",
     "You’ll:\n",
-    "- Compute which routes (/feeders) are overloaded to see where we need to invervene.\n",
+    "- Compute which routes (/feeders) are overloaded to see where we need to intervene.\n",
     "- Find which node on an overloaded route is geographically closed to the new substation.\n",
-    "- Create a new cable to connect the closest node to the new substation."
+    "- Create a new cable to connect the closest node to the new substation.\n",
+    "\n",
+    "**💡 Hint**: The lines have been extended with extra properties in Step 1\n",
+    "\n",
+    "**💡 Hint**: The arrays in the grid have a filter option, https://power-grid-model-ds.readthedocs.io/en/stable/examples/model/array_examples.html#using-filters"
    ]
   },
   {
@@ -246,12 +267,17 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Hint: The lines have been extended with extra properties in Step 1\n",
-    "# Hint: The arrays in the grid have a filter option, https://power-grid-model-ds.readthedocs.io/en/stable/examples/model/array_examples.html#using-filters\n",
-    "\n",
     "def get_all_congested_routes(grid: Grid) -> list[NodeArray]:\n",
-    "    \"\"\"Get all nodes on routes that contain an overloaded line.\"\"\"\n",
-    "\n",
+    "    \"\"\"Get all nodes on routes that contain an overloaded line.\"\"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "dc494d36-5ee7-401c-8a3b-59e701777f8d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
     "# %load solutions/advanced_5_1_get_all_congested_routes.py"
    ]
   },
@@ -275,8 +301,16 @@
     "    This should be the geographically closest node to the new substation.\n",
     "    \"\"\"\n",
     "    # Calculate the distance of each node in the route to the new_substation\n",
-    "    # Return the closest one\n",
-    "\n",
+    "    # Return the closest one"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "8ce16108-4580-4c32-9e18-60239144ae4f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
     "# %load solutions/advanced_5_2_find_connection_point.py"
    ]
   },
@@ -287,7 +321,9 @@
    "source": [
     "Finally we build a function that creates a new line between the connection point and the new substation.\n",
     "\n",
-    "❗ IMPORTANT ❗ The new line should first be created with an open connection; we will optimize the location of the line opening in the next step."
+    "❗ **IMPORTANT** ❗ The new line should first be created with an open connection; we will optimize the location of the line opening in the next step.\n",
+    "\n",
+    "**💡 Hint**: In the introduction you learned how to add a LineArray to the grid."
    ]
   },
   {
@@ -297,12 +333,18 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Hint: in the introduction you learned how to add a LineArray to the grid\n",
-    "\n",
     "def connect_to_route(grid: Grid, connection_point: NodeArray, new_substation: NodeArray) -> None:\n",
     "    \"\"\"Connect the new substation node to the connection point.\n",
-    "    \"\"\"\n",
-    "\n",
+    "    \"\"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e711bc3c-a09c-4454-b3a5-be4bf15fa077",
+   "metadata": {},
+   "outputs": [],
+   "source": [
     "# %load solutions/advanced_5_3_connect_to_route.py"
    ]
   },
@@ -349,8 +391,16 @@
     "        # Move the Open Point (NOP) upstream\n",
     "        ...\n",
     "    \n",
-    "    grid.set_feeder_ids()\n",
-    "\n",
+    "    grid.set_feeder_ids()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "471b9ff0-43ca-432c-9ce9-71fc06d95b86",
+   "metadata": {},
+   "outputs": [],
+   "source": [
     "# %load solutions/advanced_6_optimize_route_transfer.py"
    ]
   },
@@ -423,7 +473,15 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "visualize(grid)"
+    "visualize(grid)  "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2532f9d-60a9-4fcb-ac23-af6bd3ba47a2",
+   "metadata": {},
+   "source": [
+    "*Note: Jupyter notebook only supports one visualizer instance at a time. You might need to restart the kernel and re-run some cells for this final visualizer to work properly. If you do, make sure to not run earlier cells that contain `visualize(grid)`*"
    ]
   },
   {
@@ -444,7 +502,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": ".venv",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -458,7 +516,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.6"
+   "version": "3.13.2"
   }
  },
  "nbformat": 4,

power-grid-model-ds/introduction.ipynb

@@ -97,9 +97,9 @@
     "\n",
     "**⚙️ Assignment**: Create a new grid class that uses the extended arrays.\n",
     "\n",
-    "**💡 Hint 1**: https://power-grid-model-ds.readthedocs.io/en/stable/examples/model/grid_extensions_examples.html#adding-the-new-arrays-to-the-grid\n",
+    "**💡 Hint**: https://power-grid-model-ds.readthedocs.io/en/stable/examples/model/grid_extensions_examples.html#adding-the-new-arrays-to-the-grid\n",
     "\n",
-    "**💡 Hint 2**: Make sure to add the `@dataclass` decorator to your grid."
+    "**💡 Hint**: Make sure to add the `@dataclass` decorator to your grid."
    ]
   },
   {