Improve guidance

Author: lucas-vivier

pre-analysis/hydro_analysis.ipynb

@@ -8,7 +8,51 @@
     "# GRDC Hydro Data Processing and Analysis\n",
     "\n",
     "## Overview\n",
-    "This notebook processes and analyzes streamflow data from the Global Runoff Data Centre (GRDC) to create a comprehensive dataset of river discharge and runoff. The analysis is particularly useful for hydropower assessment, water resource management, and climate impact studies in Central African regions.\n",
+    "This notebook processes and analyzes streamflow data from the Global Runoff Data Centre (GRDC) to create a comprehensive dataset of river discharge and runoff. The analysis is particularly useful for hydropower assessment, water resource management, and climate impact studies.\n",
+    "\n",
+    "## Setting Up Your Environment\n",
+    "\n",
+    "### Installation Instructions\n",
+    "To run this notebook, you need to set up a Python environment with the required packages. Follow these steps:\n",
+    "\n",
+    "1. **Create a virtual environment** (recommended):\n",
+    "   ```bash\n",
+    "   # Using conda\n",
+    "   conda create -n hydro-env python=3.8\n",
+    "   conda activate hydro-env\n",
+    "   ```\n",
+    "\n",
+    "2. **Install required packages**:\n",
+    "   ```bash\n",
+    "   # Navigate to the pre-analysis directory\n",
+    "   cd epm/pre-analysis\n",
+    "\n",
+    "   # Install requirements\n",
+    "   pip install -r requirements_hydro.txt\n",
+    "   ```\n",
+    "\n",
+    "3. **Create a Jupyter kernel**:\n",
+    "   ```bash\n",
+    "   python -m ipykernel install --user --name hydro-env --display-name \"Hydro Analysis\"\n",
+    "   ```\n",
+    "\n",
+    "4. **Launch Jupyter and select the kernel**:\n",
+    "   ```bash\n",
+    "   jupyter notebook\n",
+    "   ```\n",
+    "   When opening this notebook, select the \"Hydro Analysis\" kernel from the kernel menu.\n",
+    "\n",
+    "### Required Packages\n",
+    "The following packages are required and will be installed from the requirements.txt file:\n",
+    "- pandas\n",
+    "- numpy\n",
+    "- matplotlib\n",
+    "- geopandas\n",
+    "- folium\n",
+    "- xarray\n",
+    "- branca\n",
+    "- shapely\n",
+    "- rapidfuzz\n",
     "\n",
     "## Required Input Data\n",
     "This analysis requires three types of input data, all available from open-source repositories. You must download these datasets separately before running this notebook:\n",
@@ -52,7 +96,12 @@
   {
    "cell_type": "code",
    "id": "3a43cbf66c979286",
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-06-24T06:30:08.274627Z",
+     "start_time": "2025-06-24T06:30:08.260249Z"
+    }
+   },
    "source": [
     "import os\n",
     "import geopandas as gpd\n",
@@ -77,7 +126,7 @@
     "from utils import map_grdc_stationbasins_and_subregions\n"
    ],
    "outputs": [],
-   "execution_count": null
+   "execution_count": 45
   },
   {
    "cell_type": "markdown",