feat: prepare advanced excercises

Author: jaapschoutenalliander

power-grid-model-ds/advanced.ipynb

@@ -2,10 +2,20 @@
  "cells": [
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "59d49e29",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "\u001b[1m[\u001b[0m\u001b[34;49mnotice\u001b[0m\u001b[1;39;49m]\u001b[0m\u001b[39;49m A new release of pip is available: \u001b[0m\u001b[31;49m24.2\u001b[0m\u001b[39;49m -> \u001b[0m\u001b[32;49m25.1.1\u001b[0m\n",
+      "\u001b[1m[\u001b[0m\u001b[34;49mnotice\u001b[0m\u001b[1;39;49m]\u001b[0m\u001b[39;49m To update, run: \u001b[0m\u001b[32;49mpip install --upgrade pip\u001b[0m\n"
+     ]
+    }
+   ],
    "source": [
     "!pip install pandas power-grid-model-ds[visualizer] --quiet"
    ]
@@ -33,7 +43,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 3,
    "id": "cf475775",
    "metadata": {},
    "outputs": [],
@@ -65,7 +75,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 4,
    "id": "37f4bd29",
    "metadata": {},
    "outputs": [],
@@ -118,7 +128,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 5,
    "id": "78d0639e",
    "metadata": {},
    "outputs": [],
@@ -157,7 +167,15 @@
    "execution_count": null,
    "id": "206be67b",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "None\n"
+     ]
+    }
+   ],
    "source": [
     "# Check the grid for capacity issues\n",
     "# 1. Use the PowerGridModelInterface to calculate power flow\n",
@@ -212,6 +230,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "# Check the introduction workshop on adding a substation\n",
+    "\n",
     "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",
@@ -243,12 +263,23 @@
    "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 routes that originate from a given substation node.\"\"\"\n",
     "\n",
     "# %load solutions/advanced_5_1_get_all_congested_routes.py"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "ee84e60c",
+   "metadata": {},
+   "source": [
+    "Next we will use the nodes x and y coordinates to find a suitable node to connect to the new substation. You will create a find_connection_point function that return the Node in a route which is closest to the new_substation."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -260,17 +291,29 @@
     "    \"\"\"Calculate the connection point for the new route.\n",
     "    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",
     "# %load solutions/advanced_5_2_find_connection_point.py"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "a75e9b73",
+   "metadata": {},
+   "source": [
+    "Finally we build a function that creates a new line between the connection point and the new substation. We will first create it with an open connection and optimize the opening in the next step."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
    "id": "263818f6",
    "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",
@@ -325,6 +368,14 @@
     "# %load solutions/advanced_6_optimize_route_transfer.py"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "dbf3243e",
+   "metadata": {},
+   "source": [
+    "Now we combine the functions you created to solve the issues in the network"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -361,6 +412,14 @@
     "transfer_routes(grid=grid, new_substation=new_substation)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "82546c38",
+   "metadata": {},
+   "source": [
+    "Check we resolved all contingencies"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,

power-grid-model-ds/solutions/advanced_5_3_connect_to_route.py

@@ -0,0 +1,13 @@
+def connect_to_route(grid: Grid, connection_point: NodeArray, new_substation: NodeArray) -> None:
+    """Connect the new substation node to the connection point.
+    """
+    # Create a new line that connects the two nodes
+    new_line = MyLineArray(
+        from_node=[new_substation.id],
+        to_node=[connection_point.id],
+        from_status=[0], # status is 0 to make sure the line is not active
+        to_status=[1],
+        i_n=[360.0],
+        r1=[0.05], x1=[0.01], c1=[0.0], tan1=[0.0]
+    )
+    grid.append(new_line)