Integrate tutorial into doc toctree

Author: peanutfun

doc/user-guide/climada_engine_Forecast.ipynb

@@ -5,6 +5,13 @@
    "metadata": {},
    "source": [
     "# Forecast class\n",
+    "\n",
+    "```{warning}\n",
+    "\n",
+    "The standalone `Forecast` class has been superseded by the implementations of {py:class}`~climada.hazard.forecast.HazardForecast` and {py:class}`~climada.engine.impact_forecast.ImpactForecast`.\n",
+    "Their usage is explained in [another tutorial](climada_engine_ImpactForecast.ipynb).\n",
+    "```\n",
+    "\n",
     "This class deals with weather forecasts and uses CLIMADA ImpactCalc.impact() to forecast impacts of weather events on society. It mainly does one thing:\n",
     "- it contains all plotting and other functionality that are specific for weather forecasts, impact forecasts and warnings\n",
     "\n",

doc/user-guide/climada_engine_ImpactForecast.ipynb

@@ -7,7 +7,8 @@
    "source": [
     "# Hazard forecasts and impacts forecasts\n",
     "\n",
-    "In this tutorial, we showcase CLIMADA functionality to handle forecast data using the classes `HazardForecast` and `ImpactForecast`.\n"
+    "In this tutorial, we showcase CLIMADA functionality to handle forecast data using the classes {py:class}`~climada.hazard.forecast.HazardForecast` and {py:class}`~climada.engine.impact_forecast.ImpactForecast`.\n",
+    "Exemplary forecast data will be downloaded from the Open Government Data (OGD) portal of MeteoSwiss."
    ]
   },
   {
@@ -92,6 +93,16 @@
     "\n"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0678c808",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install meteodata-lab"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 4,

doc/user-guide/index.rst

@@ -21,8 +21,9 @@ You can then go on to more specific tutorial about `Hazard <hazard>`_,
    Impact <impact>
    Local exceedance intensities <climada_util_local_exceedance_values>
    Uncertainty Quantification <unsequa>
-   climada_engine_Forecast
+   Forecasts <climada_engine_ImpactForecast>
    climada_util_calibrate
    Google Earth Engine <climada_util_earth_engine>
    climada_util_api_client
+   Forecast class (outdated) <climada_engine_Forecast>
    How to cite CLIMADA <../misc/citation>