From 481db5a7b9a71108e29e0217cb398b10a710ae64 Mon Sep 17 00:00:00 2001
From: Joe Moorhouse <5102656+joemoorhouse@users.noreply.github.com>
Date: Sun, 29 Sep 2024 20:43:04 +0100
Subject: [PATCH] Restructure docs and change theme to ReadTheDocs

Signed-off-by: Joe Moorhouse <5102656+joemoorhouse@users.noreply.github.com>
---
 docs/conf.py                                  |  14 +-
 docs/conf.py.backup                           |  95 ----
 docs/getting-started.rst                      |   8 -
 .../asset_level_impacts.ipynb                 |  72 +--
 docs/getting_started/getting_started.rst      |  11 +
 .../hazard_indicators.ipynb                   | 377 ++--------------
 docs/getting_started/hazard_inventory.ipynb   | 411 ++++++++++++++++++
 docs/images/Logo.png                          | Bin 18549 -> 0 bytes
 docs/index.rst                                |  28 +-
 docs/methodology.rst                          |   2 +-
 docs/references.bib                           |   0
 .../hazard_indicators/hazard_indicators.rst   |   9 +
 .../hazard_indicators/indicators.ipynb        |  24 +
 docs/user_guide/hosting/hosting.rst           |   8 +
 docs/user_guide/hosting/overview.ipynb        |  22 +
 .../introduction.ipynb                        |   2 +-
 .../user_guide.rst}                           |  10 +-
 .../vulnerability/vulnerability.rst           |  11 +
 .../vulnerability}/vulnerability_config.ipynb |  37 +-
 .../inundation_jrc/onboard.ipynb              |   0
 .../inundation_jrc/raw.csv                    |   0
 ...hysical climate vulnerability factors.json |   0
 .../onboard.ipynb                             |   0
 .../raw.csv                                   |   0
 .../Table_A2_Impact_Function_Slope.csv        |   0
 ...S2_V_half_individual_fitting_per_event.csv |   0
 .../wind_eberenz/onboard.ipynb                |   0
 .../vulnerability_uncertainty.ipynb           |   6 +-
 pdm.lock                                      |  28 +-
 pyproject.toml                                |   1 +
 30 files changed, 646 insertions(+), 530 deletions(-)
 delete mode 100644 docs/conf.py.backup
 delete mode 100644 docs/getting-started.rst
 rename docs/{examples => getting_started}/asset_level_impacts.ipynb (99%)
 create mode 100644 docs/getting_started/getting_started.rst
 rename docs/{examples => getting_started}/hazard_indicators.ipynb (98%)
 create mode 100644 docs/getting_started/hazard_inventory.ipynb
 delete mode 100644 docs/images/Logo.png
 create mode 100644 docs/references.bib
 create mode 100644 docs/user_guide/hazard_indicators/hazard_indicators.rst
 create mode 100644 docs/user_guide/hazard_indicators/indicators.ipynb
 create mode 100644 docs/user_guide/hosting/hosting.rst
 create mode 100644 docs/user_guide/hosting/overview.ipynb
 rename docs/{user-guide => user_guide}/introduction.ipynb (99%)
 rename docs/{user-guide.rst => user_guide/user_guide.rst} (83%)
 create mode 100644 docs/user_guide/vulnerability/vulnerability.rst
 rename docs/{user-guide => user_guide/vulnerability}/vulnerability_config.ipynb (99%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/inundation_jrc/onboard.ipynb (100%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/inundation_jrc/raw.csv (100%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/multi_hazard_wri_power_generating_assets/WRI thermal power plant physical climate vulnerability factors.json (100%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/multi_hazard_wri_power_generating_assets/onboard.ipynb (100%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/multi_hazard_wri_power_generating_assets/raw.csv (100%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/wind_eberenz/Table_A2_Impact_Function_Slope.csv (100%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/wind_eberenz/Table_S2_V_half_individual_fitting_per_event.csv (100%)
 rename docs/{ => user_guide/vulnerability}/vulnerability_functions/wind_eberenz/onboard.ipynb (100%)
 rename docs/{user-guide => user_guide/vulnerability}/vulnerability_uncertainty.ipynb (99%)

diff --git a/docs/conf.py b/docs/conf.py
index f3c65a48..f92130b2 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -13,9 +13,9 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = "PhysicalRisk"
-copyright = "2024, DCV"
-author = "DCV"
+project = "physrisk"
+copyright = "2024, OS-Climate"
+author = "OS-Climate"
 
 # The full version, including alpha/beta/rc tags
 # release = "1.1.0"
@@ -70,19 +70,23 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_logo = "images/OS-Climate-Logo.png"
-html_theme = "pydata_sphinx_theme"
+html_theme = "sphinx_rtd_theme"
+#html_theme = "pydata_sphinx_theme"
 html_static_path = ["_static"]
 
 # Don't show the code
 html_show_sourcelink = True
 
 html_theme_options = {
-    # 'logo_only': False,
+    "logo_only": False,
     # 'display_version': False,
     # Table of contents options
     "collapse_navigation": False,
+    "style_nav_header_background": "#d2d2d2"
+    # "#e3e3e3",
 }
 
+
 html_sidebars = {
     "**": [
         "globaltoc.html",  # Índice general
diff --git a/docs/conf.py.backup b/docs/conf.py.backup
deleted file mode 100644
index 2bcd5e4f..00000000
--- a/docs/conf.py.backup
+++ /dev/null
@@ -1,95 +0,0 @@
-# Configuration file for the Sphinx documentation builder.
-#
-# For the full list of built-in configuration values, see the documentation:
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
-
-import os
-import sys
-
-# sys.path.insert(0, os.path.abspath('.'))
-sys.path.insert(0, os.path.abspath(".."))
-sys.path.insert(0, os.path.abspath("../src/"))
-
-# -- Project information -----------------------------------------------------
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
-
-#project = "PhysicalRisk"
-#copyright = "2024, DCV"
-#author = "DCV"
-
-# The full version, including alpha/beta/rc tags
-#release = "1.1.0"
-
-# -- General configuration ---------------------------------------------------
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
-
-# The master toctree document.
-master_doc = "index"
-
-extensions = [
-    "sphinx.ext.autodoc",
-    "sphinx.ext.napoleon",
-    "sphinx_toolbox.installation",
-    "sphinx_toolbox.latex",
-    "sphinx.ext.autosummary",
-    "sphinx.ext.graphviz",
-    "sphinx.ext.inheritance_diagram",
-    "sphinx.ext.autosectionlabel",
-    "sphinx_design",
-    "sphinx.ext.intersphinx",
-    # 'myst_nb',
-    # "myst_parser",
-    "nbsphinx",
-    # "sphinxcontrib.details"
-    "sphinxcontrib.bibtex",
-    "sphinx.ext.mathjax",
-    "sphinx_simplepdf",
-]
-
-bibtex_bibfiles = ["references.bib"]
-bibtex_default_style = "alpha"
-bibtex_encoding = "latin"
-
-templates_path = ["_templates"]
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
-
-# Not show module
-python_module_index = False
-
-# Summary
-autosummary_generate = True
-
-# Docstrings of private methods
-autodoc_default_options = {"members": True, "undoc-members": True, "private-members": False}
-
-# -- Options for HTML output -------------------------------------------------
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
-
-html_logo = "images/OS-Climate-Logo.png"
-html_theme = "pydata_sphinx_theme"
-html_static_path = ["_static"]
-
-# Don't show the code
-html_show_sourcelink = True
-
-html_theme_options = {
-    # 'logo_only': False,
-    # 'display_version': False,
-    # Table of contents options
-    "collapse_navigation": False,
-}
-
-html_sidebars = {
-    "**": [
-        "globaltoc.html",  # Índice general
-        # 'localtoc.html',   # Índice local para cada archivo
-        "searchbox.html",  # Cuadro de búsqueda
-    ]
-}
-
-# This setting ensures that each section in your documentation is automatically assigned
-# a unique label based on the document it belongs to.
-autosectionlabel_prefix_document = True
-
-# show the members in the order they appear in the source code, you can use the autodoc_member_order option.
-autodoc_member_order = "bysource"
diff --git a/docs/getting-started.rst b/docs/getting-started.rst
deleted file mode 100644
index 13d6306d..00000000
--- a/docs/getting-started.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-Getting started
-===============
-
-.. toctree::
-   :maxdepth: 1
-
-   examples/hazard_indicators
-   examples/asset_level_impacts
diff --git a/docs/examples/asset_level_impacts.ipynb b/docs/getting_started/asset_level_impacts.ipynb
similarity index 99%
rename from docs/examples/asset_level_impacts.ipynb
rename to docs/getting_started/asset_level_impacts.ipynb
index 54ce0c4a..b29e3b02 100644
--- a/docs/examples/asset_level_impacts.ipynb
+++ b/docs/getting_started/asset_level_impacts.ipynb
@@ -20,25 +20,32 @@
    },
    "outputs": [],
    "source": [
-    "# UNCOMMENT TO RUN THIS NOTEBOOK\n",
-    "# pip install nbformat pandas plotly requests\n",
-    "\n",
-    "import plotly.graph_objs as go\n",
+    "# pip install nbformat pandas plotly requests"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {
+    "vscode": {
+     "languageId": "shellscript"
+    }
+   },
+   "outputs": [],
+   "source": [
     "import pprint as pp\n",
+    "from typing import NamedTuple\n",
     "import requests\n",
     "\n",
-    "from dotenv import load_dotenv\n",
-    "from physrisk.container import Container\n",
-    "from plotly.subplots import make_subplots\n",
-    "from typing import NamedTuple\n",
+    "import plotly.graph_objs as go\n",
     "import plotly.io\n",
-    "\n",
+    "from plotly.subplots import make_subplots\n",
     "plotly.io.renderers.default = \"notebook\""
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 3,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -77,7 +84,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 4,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -102,7 +109,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 5,
    "metadata": {},
    "outputs": [
     {
@@ -137,9 +144,9 @@
     {
      "data": {
       "text/html": [
-       "<div>                            <div id=\"fe610e54-5e33-4844-ba0e-f02f9b710d5a\" class=\"plotly-graph-div\" style=\"height:525px; width:100%;\"></div>            <script type=\"text/javascript\">                require([\"plotly\"], function(Plotly) {                    window.PLOTLYENV=window.PLOTLYENV || {};                                    if (document.getElementById(\"fe610e54-5e33-4844-ba0e-f02f9b710d5a\")) {                    Plotly.newPlot(                        \"fe610e54-5e33-4844-ba0e-f02f9b710d5a\",                        [{\"name\":\"baseline wind\",\"x\":[0.04900000000000001,0.03233333333333334,0.024000000000000004,0.019000000000000003,0.01566666666666667,0.013285714285714286,0.011500000000000002,0.010111111111111112,0.009000000000000001,0.004,0.0023333333333333335,0.0015,0.001,0.0006666666666666668,0.00042857142857142855,0.00025,0.00011111111111111109,0.0],\"y\":[0.0004863306300282079,0.0032202045740822743,0.010735442202008984,0.016996661463623993,0.02155590325614915,0.028485761901396834,0.041850456280047466,0.05007404596694858,0.059701685162724984,0.11332636752166708,0.16591577789151649,0.20183716992148243,0.23152412925689597,0.26220139356582195,0.279007730852783,0.29570799814905474,0.307745842586294,0.3217969471882758],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"wind SSP585\",\"x\":[0.099,0.04900000000000001,0.03233333333333334,0.024000000000000004,0.019000000000000003,0.01566666666666667,0.013285714285714286,0.011500000000000002,0.010111111111111112,0.009000000000000001,0.004,0.0023333333333333335,0.0015,0.001,0.0006666666666666668,0.00042857142857142855,0.00025,0.00011111111111111109,0.0],\"y\":[7.682019883172996e-05,0.0005583812056975454,0.008825685603841983,0.017046757981196484,0.023436186553044146,0.0396124241720199,0.0560279993842828,0.07006830117541162,0.08194450719972869,0.09264894302678975,0.1933473153228637,0.25481157725696824,0.3041005921318781,0.3238739140242556,0.34008684145476864,0.3628907252701525,0.3693335717289997,0.3823038619319513,0.39510456950344713],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"}],                        {\"template\":{\"data\":{\"histogram2dcontour\":[{\"type\":\"histogram2dcontour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"choropleth\":[{\"type\":\"choropleth\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"histogram2d\":[{\"type\":\"histogram2d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmap\":[{\"type\":\"heatmap\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmapgl\":[{\"type\":\"heatmapgl\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"contourcarpet\":[{\"type\":\"contourcarpet\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"contour\":[{\"type\":\"contour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"surface\":[{\"type\":\"surface\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"mesh3d\":[{\"type\":\"mesh3d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"scatter\":[{\"fillpattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2},\"type\":\"scatter\"}],\"parcoords\":[{\"type\":\"parcoords\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolargl\":[{\"type\":\"scatterpolargl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"bar\":[{\"error_x\":{\"color\":\"#2a3f5f\"},\"error_y\":{\"color\":\"#2a3f5f\"},\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"bar\"}],\"scattergeo\":[{\"type\":\"scattergeo\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolar\":[{\"type\":\"scatterpolar\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"histogram\":[{\"marker\":{\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"histogram\"}],\"scattergl\":[{\"type\":\"scattergl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatter3d\":[{\"type\":\"scatter3d\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattermapbox\":[{\"type\":\"scattermapbox\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterternary\":[{\"type\":\"scatterternary\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattercarpet\":[{\"type\":\"scattercarpet\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"carpet\":[{\"aaxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"baxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"type\":\"carpet\"}],\"table\":[{\"cells\":{\"fill\":{\"color\":\"#EBF0F8\"},\"line\":{\"color\":\"white\"}},\"header\":{\"fill\":{\"color\":\"#C8D4E3\"},\"line\":{\"color\":\"white\"}},\"type\":\"table\"}],\"barpolar\":[{\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"barpolar\"}],\"pie\":[{\"automargin\":true,\"type\":\"pie\"}]},\"layout\":{\"autotypenumbers\":\"strict\",\"colorway\":[\"#636efa\",\"#EF553B\",\"#00cc96\",\"#ab63fa\",\"#FFA15A\",\"#19d3f3\",\"#FF6692\",\"#B6E880\",\"#FF97FF\",\"#FECB52\"],\"font\":{\"color\":\"#2a3f5f\"},\"hovermode\":\"closest\",\"hoverlabel\":{\"align\":\"left\"},\"paper_bgcolor\":\"white\",\"plot_bgcolor\":\"#E5ECF6\",\"polar\":{\"bgcolor\":\"#E5ECF6\",\"angularaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"radialaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"ternary\":{\"bgcolor\":\"#E5ECF6\",\"aaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"baxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"caxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"coloraxis\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"colorscale\":{\"sequential\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"sequentialminus\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"diverging\":[[0,\"#8e0152\"],[0.1,\"#c51b7d\"],[0.2,\"#de77ae\"],[0.3,\"#f1b6da\"],[0.4,\"#fde0ef\"],[0.5,\"#f7f7f7\"],[0.6,\"#e6f5d0\"],[0.7,\"#b8e186\"],[0.8,\"#7fbc41\"],[0.9,\"#4d9221\"],[1,\"#276419\"]]},\"xaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"yaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"scene\":{\"xaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"yaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"zaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2}},\"shapedefaults\":{\"line\":{\"color\":\"#2a3f5f\"}},\"annotationdefaults\":{\"arrowcolor\":\"#2a3f5f\",\"arrowhead\":0,\"arrowwidth\":1},\"geo\":{\"bgcolor\":\"white\",\"landcolor\":\"#E5ECF6\",\"subunitcolor\":\"white\",\"showland\":true,\"showlakes\":true,\"lakecolor\":\"white\"},\"title\":{\"x\":0.05},\"mapbox\":{\"style\":\"light\"}}},\"xaxis\":{\"anchor\":\"y\",\"domain\":[0.0,0.45],\"title\":{\"text\":\"Annual exceedance probability\",\"font\":{\"size\":14}},\"type\":\"log\",\"autorange\":\"reversed\"},\"yaxis\":{\"anchor\":\"x\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Damage as fraction of insurable value\",\"font\":{\"size\":14}}},\"xaxis2\":{\"anchor\":\"y2\",\"domain\":[0.55,1.0]},\"yaxis2\":{\"anchor\":\"x2\",\"domain\":[0.0,1.0]}},                        {\"responsive\": true}                    ).then(function(){\n",
+       "<div>                            <div id=\"d39d4d9f-cc30-4bc1-b18c-a533f2f34337\" class=\"plotly-graph-div\" style=\"height:525px; width:100%;\"></div>            <script type=\"text/javascript\">                require([\"plotly\"], function(Plotly) {                    window.PLOTLYENV=window.PLOTLYENV || {};                                    if (document.getElementById(\"d39d4d9f-cc30-4bc1-b18c-a533f2f34337\")) {                    Plotly.newPlot(                        \"d39d4d9f-cc30-4bc1-b18c-a533f2f34337\",                        [{\"name\":\"baseline wind\",\"x\":[0.04900000000000001,0.03233333333333334,0.024000000000000004,0.019000000000000003,0.01566666666666667,0.013285714285714286,0.011500000000000002,0.010111111111111112,0.009000000000000001,0.004,0.0023333333333333335,0.0015,0.001,0.0006666666666666668,0.00042857142857142855,0.00025,0.00011111111111111109,0.0],\"y\":[0.0004863306300282079,0.0032202045740822743,0.010735442202008984,0.016996661463623993,0.02155590325614915,0.028485761901396834,0.041850456280047466,0.05007404596694858,0.059701685162724984,0.11332636752166708,0.16591577789151649,0.20183716992148243,0.23152412925689597,0.26220139356582195,0.279007730852783,0.29570799814905474,0.307745842586294,0.3217969471882758],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"wind SSP585\",\"x\":[0.099,0.04900000000000001,0.03233333333333334,0.024000000000000004,0.019000000000000003,0.01566666666666667,0.013285714285714286,0.011500000000000002,0.010111111111111112,0.009000000000000001,0.004,0.0023333333333333335,0.0015,0.001,0.0006666666666666668,0.00042857142857142855,0.00025,0.00011111111111111109,0.0],\"y\":[7.682019883172996e-05,0.0005583812056975454,0.008825685603841983,0.017046757981196484,0.023436186553044146,0.0396124241720199,0.0560279993842828,0.07006830117541162,0.08194450719972869,0.09264894302678975,0.1933473153228637,0.25481157725696824,0.3041005921318781,0.3238739140242556,0.34008684145476864,0.3628907252701525,0.3693335717289997,0.3823038619319513,0.39510456950344713],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"}],                        {\"template\":{\"data\":{\"histogram2dcontour\":[{\"type\":\"histogram2dcontour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"choropleth\":[{\"type\":\"choropleth\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"histogram2d\":[{\"type\":\"histogram2d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmap\":[{\"type\":\"heatmap\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmapgl\":[{\"type\":\"heatmapgl\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"contourcarpet\":[{\"type\":\"contourcarpet\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"contour\":[{\"type\":\"contour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"surface\":[{\"type\":\"surface\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"mesh3d\":[{\"type\":\"mesh3d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"scatter\":[{\"fillpattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2},\"type\":\"scatter\"}],\"parcoords\":[{\"type\":\"parcoords\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolargl\":[{\"type\":\"scatterpolargl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"bar\":[{\"error_x\":{\"color\":\"#2a3f5f\"},\"error_y\":{\"color\":\"#2a3f5f\"},\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"bar\"}],\"scattergeo\":[{\"type\":\"scattergeo\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolar\":[{\"type\":\"scatterpolar\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"histogram\":[{\"marker\":{\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"histogram\"}],\"scattergl\":[{\"type\":\"scattergl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatter3d\":[{\"type\":\"scatter3d\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattermapbox\":[{\"type\":\"scattermapbox\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterternary\":[{\"type\":\"scatterternary\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattercarpet\":[{\"type\":\"scattercarpet\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"carpet\":[{\"aaxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"baxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"type\":\"carpet\"}],\"table\":[{\"cells\":{\"fill\":{\"color\":\"#EBF0F8\"},\"line\":{\"color\":\"white\"}},\"header\":{\"fill\":{\"color\":\"#C8D4E3\"},\"line\":{\"color\":\"white\"}},\"type\":\"table\"}],\"barpolar\":[{\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"barpolar\"}],\"pie\":[{\"automargin\":true,\"type\":\"pie\"}]},\"layout\":{\"autotypenumbers\":\"strict\",\"colorway\":[\"#636efa\",\"#EF553B\",\"#00cc96\",\"#ab63fa\",\"#FFA15A\",\"#19d3f3\",\"#FF6692\",\"#B6E880\",\"#FF97FF\",\"#FECB52\"],\"font\":{\"color\":\"#2a3f5f\"},\"hovermode\":\"closest\",\"hoverlabel\":{\"align\":\"left\"},\"paper_bgcolor\":\"white\",\"plot_bgcolor\":\"#E5ECF6\",\"polar\":{\"bgcolor\":\"#E5ECF6\",\"angularaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"radialaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"ternary\":{\"bgcolor\":\"#E5ECF6\",\"aaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"baxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"caxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"coloraxis\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"colorscale\":{\"sequential\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"sequentialminus\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"diverging\":[[0,\"#8e0152\"],[0.1,\"#c51b7d\"],[0.2,\"#de77ae\"],[0.3,\"#f1b6da\"],[0.4,\"#fde0ef\"],[0.5,\"#f7f7f7\"],[0.6,\"#e6f5d0\"],[0.7,\"#b8e186\"],[0.8,\"#7fbc41\"],[0.9,\"#4d9221\"],[1,\"#276419\"]]},\"xaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"yaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"scene\":{\"xaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"yaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"zaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2}},\"shapedefaults\":{\"line\":{\"color\":\"#2a3f5f\"}},\"annotationdefaults\":{\"arrowcolor\":\"#2a3f5f\",\"arrowhead\":0,\"arrowwidth\":1},\"geo\":{\"bgcolor\":\"white\",\"landcolor\":\"#E5ECF6\",\"subunitcolor\":\"white\",\"showland\":true,\"showlakes\":true,\"lakecolor\":\"white\"},\"title\":{\"x\":0.05},\"mapbox\":{\"style\":\"light\"}}},\"xaxis\":{\"anchor\":\"y\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Annual exceedance probability\",\"font\":{\"size\":14}},\"type\":\"log\",\"autorange\":\"reversed\"},\"yaxis\":{\"anchor\":\"x\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Damage as fraction of insurable value\",\"font\":{\"size\":14}}}},                        {\"responsive\": true}                    ).then(function(){\n",
        "                            \n",
-       "var gd = document.getElementById('fe610e54-5e33-4844-ba0e-f02f9b710d5a');\n",
+       "var gd = document.getElementById('d39d4d9f-cc30-4bc1-b18c-a533f2f34337');\n",
        "var x = new MutationObserver(function (mutations, observer) {{\n",
        "        var display = window.getComputedStyle(gd).display;\n",
        "        if (!display || display === 'none') {{\n",
@@ -172,21 +179,12 @@
     "exceedance_histo = wind_impact_histo[\"impact_exceedance\"]\n",
     "exceedance_ssp585 = wind_impact_ssp585[\"impact_exceedance\"]\n",
     "\n",
-    "fig1 = make_subplots(rows=1, cols=2)\n",
-    "fig1.add_trace(\n",
-    "    go.Scatter(x=exceedance_histo[\"exceed_probabilities\"], y=exceedance_histo[\"values\"], name=\"baseline wind\"),\n",
-    "    row=1,\n",
-    "    col=1,\n",
-    ")\n",
-    "fig1.add_trace(\n",
-    "    go.Scatter(x=exceedance_ssp585[\"exceed_probabilities\"], y=exceedance_ssp585[\"values\"], name=\"wind SSP585\"),\n",
-    "    row=1,\n",
-    "    col=1,\n",
-    ")\n",
-    "fig1.update_xaxes(\n",
-    "    title=\"Annual exceedance probability\", title_font={\"size\": 14}, row=1, col=1, type=\"log\", autorange=\"reversed\"\n",
-    ")\n",
-    "fig1.update_yaxes(title=\"Damage as fraction of insurable value\", title_font={\"size\": 14}, row=1, col=1)"
+    "fig1 = make_subplots(rows=1, cols=1)\n",
+    "\n",
+    "fig1.add_scatter(x=exceedance_histo[\"exceed_probabilities\"], y=exceedance_histo[\"values\"], name=\"baseline wind\", row=1, col=1)\n",
+    "fig1.add_scatter(x=exceedance_ssp585[\"exceed_probabilities\"], y=exceedance_ssp585[\"values\"], name=\"wind SSP585\", row=1, col=1)\n",
+    "fig1.update_xaxes(title=\"Annual exceedance probability\", title_font={\"size\": 14}, row=1, col=1, type=\"log\", autorange=\"reversed\")\n",
+    "fig1.update_yaxes(title=\"Damage as fraction of insurable value\", title_font={\"size\": 14}, row=1, col=1)\n"
    ]
   },
   {
@@ -205,7 +203,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 6,
    "metadata": {},
    "outputs": [
     {
@@ -242,7 +240,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 7,
    "metadata": {},
    "outputs": [
     {
@@ -298,7 +296,17 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dotenv import load_dotenv\n",
+    "from physrisk.container import Container"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
    "metadata": {},
    "outputs": [],
    "source": [
diff --git a/docs/getting_started/getting_started.rst b/docs/getting_started/getting_started.rst
new file mode 100644
index 00000000..bf179238
--- /dev/null
+++ b/docs/getting_started/getting_started.rst
@@ -0,0 +1,11 @@
+Getting started
+===============
+
+The following examples provide a walk-through of phyrisk's functionality, starting with access to hazard indicator data and presenting the hazard inventory then moving onto the running of asset level calculations.
+
+.. toctree::
+   :maxdepth: 2
+
+   hazard_indicators
+   hazard_inventory
+   asset_level_impacts
diff --git a/docs/examples/hazard_indicators.ipynb b/docs/getting_started/hazard_indicators.ipynb
similarity index 98%
rename from docs/examples/hazard_indicators.ipynb
rename to docs/getting_started/hazard_indicators.ipynb
index 761f61a6..0a3bc3f1 100644
--- a/docs/examples/hazard_indicators.ipynb
+++ b/docs/getting_started/hazard_indicators.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Hazard indicators\n",
+    "# Hazard indicators\n",
     "Physrisk is primarily designed to run 'bottom-up' calculations that model the impact of climate hazards on large numbers of individual assets (including natural) and operations. These calculations can be used to assess financial risks or socio-economic impacts. To do this physrisk collects:\n",
     "\n",
     "- hazard indicators and\n",
@@ -19,7 +19,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "#### Requesting hazard indicators via the physrisk API\n",
+    "## Requesting hazard indicators via the physrisk API\n",
     "\n",
     "Using physrisk, hazard indicators can be obtained directly from source, as long as the user has the necessary API keys. Alternatively, the API – which is simply a hosted instance of physrisk – can be used, albeit the number of requests will be restricted to 30,000 latitudes and longitudes.\n",
     "\n",
@@ -36,29 +36,32 @@
    },
    "outputs": [],
    "source": [
-    "# UNCOMMENT TO RUN THIS NOTEBOOK\n",
-    "# pip install nbformat pandas plotly requests\n",
-    "\n",
-    "# UNCOMMENT TO RUN THE SECOND PART OF THIS NOTEBOOK:\n",
-    "# pip install physrisk-lib\n",
-    "\n",
-    "import pandas as pd\n",
-    "import plotly.graph_objs as go\n",
+    "# pip install nbformat pandas plotly requests"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {
+    "vscode": {
+     "languageId": "shellscript"
+    }
+   },
+   "outputs": [],
+   "source": [
     "import pprint as pp\n",
-    "import requests\n",
-    "\n",
-    "from dotenv import load_dotenv\n",
     "from IPython.display import Markdown, display\n",
-    "from physrisk.container import Container\n",
+    "import pandas as pd\n",
+    "import plotly.graph_objs as go\n",
     "from plotly.subplots import make_subplots\n",
     "import plotly.io\n",
-    "\n",
+    "import requests\n",
     "plotly.io.renderers.default = \"notebook\""
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 3,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -133,7 +136,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 4,
    "metadata": {},
    "outputs": [
     {
@@ -168,9 +171,9 @@
     {
      "data": {
       "text/html": [
-       "<div>                            <div id=\"fd7c0c65-9459-4e3b-a719-22b378fae05b\" class=\"plotly-graph-div\" style=\"height:525px; width:100%;\"></div>            <script type=\"text/javascript\">                require([\"plotly\"], function(Plotly) {                    window.PLOTLYENV=window.PLOTLYENV || {};                                    if (document.getElementById(\"fd7c0c65-9459-4e3b-a719-22b378fae05b\")) {                    Plotly.newPlot(                        \"fd7c0c65-9459-4e3b-a719-22b378fae05b\",                        [{\"name\":\"baseline flood\",\"x\":[2.0,5.0,10.0,25.0,50.0,100.0,250.0,500.0,1000.0],\"y\":[0.018713276833295822,0.2934648394584656,0.4726479649543762,0.6914869546890259,0.846922755241394,1.0003900527954102,1.2022767066955566,1.352674961090088,1.5003795623779297],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"flood RCP 8.5 2050\",\"x\":[2.0,5.0,10.0,25.0,50.0,100.0,250.0,500.0,1000.0],\"y\":[0.03016260266304016,0.3154944181442261,0.5021084547042847,0.7294760942459106,0.8911455869674683,1.0516209602355957,1.2618706226348877,1.4183039665222168,1.571667194366455],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"baseline wind\",\"x\":[10.0,20.0,30.0,40.0,50.0,60.0,70.0,80.0,90.0,100.0,200.0,300.0,400.0,500.0,600.0,700.0,800.0,900.0,1000.0],\"y\":[34.16875076293945,40.48125076293945,44.493751525878906,46.98125076293945,48.53125,49.849998474121094,51.20000076293945,52.243751525878906,52.79999923706055,53.51874923706055,57.400001525878906,59.875,60.95624923706055,61.79999923706055,62.431251525878906,62.8125,62.9375,63.58124923706055,64.4625015258789],\"type\":\"scatter\",\"xaxis\":\"x2\",\"yaxis\":\"y2\"},{\"name\":\"wind SSP585 2050\",\"x\":[10.0,20.0,30.0,40.0,50.0,60.0,70.0,80.0,90.0,100.0,200.0,300.0,400.0,500.0,600.0,700.0,800.0,900.0,1000.0],\"y\":[37.224998474121094,44.76874923706055,48.63750076293945,51.66875076293945,53.5,55.23749923706055,56.20000076293945,57.23125076293945,58.368751525878906,59.17499923706055,63.11249923706055,65.3125,66.2125015258789,67.1624984741211,67.7125015258789,67.9749984741211,68.23750305175781,69.07499694824219,71.19999694824219],\"type\":\"scatter\",\"xaxis\":\"x2\",\"yaxis\":\"y2\"}],                        {\"template\":{\"data\":{\"histogram2dcontour\":[{\"type\":\"histogram2dcontour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"choropleth\":[{\"type\":\"choropleth\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"histogram2d\":[{\"type\":\"histogram2d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmap\":[{\"type\":\"heatmap\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmapgl\":[{\"type\":\"heatmapgl\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"contourcarpet\":[{\"type\":\"contourcarpet\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"contour\":[{\"type\":\"contour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"surface\":[{\"type\":\"surface\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"mesh3d\":[{\"type\":\"mesh3d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"scatter\":[{\"fillpattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2},\"type\":\"scatter\"}],\"parcoords\":[{\"type\":\"parcoords\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolargl\":[{\"type\":\"scatterpolargl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"bar\":[{\"error_x\":{\"color\":\"#2a3f5f\"},\"error_y\":{\"color\":\"#2a3f5f\"},\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"bar\"}],\"scattergeo\":[{\"type\":\"scattergeo\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolar\":[{\"type\":\"scatterpolar\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"histogram\":[{\"marker\":{\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"histogram\"}],\"scattergl\":[{\"type\":\"scattergl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatter3d\":[{\"type\":\"scatter3d\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattermapbox\":[{\"type\":\"scattermapbox\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterternary\":[{\"type\":\"scatterternary\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattercarpet\":[{\"type\":\"scattercarpet\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"carpet\":[{\"aaxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"baxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"type\":\"carpet\"}],\"table\":[{\"cells\":{\"fill\":{\"color\":\"#EBF0F8\"},\"line\":{\"color\":\"white\"}},\"header\":{\"fill\":{\"color\":\"#C8D4E3\"},\"line\":{\"color\":\"white\"}},\"type\":\"table\"}],\"barpolar\":[{\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"barpolar\"}],\"pie\":[{\"automargin\":true,\"type\":\"pie\"}]},\"layout\":{\"autotypenumbers\":\"strict\",\"colorway\":[\"#636efa\",\"#EF553B\",\"#00cc96\",\"#ab63fa\",\"#FFA15A\",\"#19d3f3\",\"#FF6692\",\"#B6E880\",\"#FF97FF\",\"#FECB52\"],\"font\":{\"color\":\"#2a3f5f\"},\"hovermode\":\"closest\",\"hoverlabel\":{\"align\":\"left\"},\"paper_bgcolor\":\"white\",\"plot_bgcolor\":\"#E5ECF6\",\"polar\":{\"bgcolor\":\"#E5ECF6\",\"angularaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"radialaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"ternary\":{\"bgcolor\":\"#E5ECF6\",\"aaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"baxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"caxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"coloraxis\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"colorscale\":{\"sequential\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"sequentialminus\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"diverging\":[[0,\"#8e0152\"],[0.1,\"#c51b7d\"],[0.2,\"#de77ae\"],[0.3,\"#f1b6da\"],[0.4,\"#fde0ef\"],[0.5,\"#f7f7f7\"],[0.6,\"#e6f5d0\"],[0.7,\"#b8e186\"],[0.8,\"#7fbc41\"],[0.9,\"#4d9221\"],[1,\"#276419\"]]},\"xaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"yaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"scene\":{\"xaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"yaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"zaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2}},\"shapedefaults\":{\"line\":{\"color\":\"#2a3f5f\"}},\"annotationdefaults\":{\"arrowcolor\":\"#2a3f5f\",\"arrowhead\":0,\"arrowwidth\":1},\"geo\":{\"bgcolor\":\"white\",\"landcolor\":\"#E5ECF6\",\"subunitcolor\":\"white\",\"showland\":true,\"showlakes\":true,\"lakecolor\":\"white\"},\"title\":{\"x\":0.05},\"mapbox\":{\"style\":\"light\"}}},\"xaxis\":{\"anchor\":\"y\",\"domain\":[0.0,0.45],\"title\":{\"text\":\"Return period (years)\",\"font\":{\"size\":14}},\"type\":\"log\"},\"yaxis\":{\"anchor\":\"x\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Flood depth (m)\",\"font\":{\"size\":14}}},\"xaxis2\":{\"anchor\":\"y2\",\"domain\":[0.55,1.0],\"title\":{\"text\":\"Return period (years)\",\"font\":{\"size\":14}},\"type\":\"log\"},\"yaxis2\":{\"anchor\":\"x2\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Max (1 minute) wind speed (m\\u002fs)\",\"font\":{\"size\":14}}}},                        {\"responsive\": true}                    ).then(function(){\n",
+       "<div>                            <div id=\"e25f4071-9948-4ccd-bdc6-7c37462ae7f5\" class=\"plotly-graph-div\" style=\"height:525px; width:100%;\"></div>            <script type=\"text/javascript\">                require([\"plotly\"], function(Plotly) {                    window.PLOTLYENV=window.PLOTLYENV || {};                                    if (document.getElementById(\"e25f4071-9948-4ccd-bdc6-7c37462ae7f5\")) {                    Plotly.newPlot(                        \"e25f4071-9948-4ccd-bdc6-7c37462ae7f5\",                        [{\"name\":\"baseline flood\",\"x\":[2.0,5.0,10.0,25.0,50.0,100.0,250.0,500.0,1000.0],\"y\":[0.018713276833295822,0.2934648394584656,0.4726479649543762,0.6914869546890259,0.846922755241394,1.0003900527954102,1.2022767066955566,1.352674961090088,1.5003795623779297],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"flood RCP 8.5 2050\",\"x\":[2.0,5.0,10.0,25.0,50.0,100.0,250.0,500.0,1000.0],\"y\":[0.03016260266304016,0.3154944181442261,0.5021084547042847,0.7294760942459106,0.8911455869674683,1.0516209602355957,1.2618706226348877,1.4183039665222168,1.571667194366455],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"baseline wind\",\"x\":[10.0,20.0,30.0,40.0,50.0,60.0,70.0,80.0,90.0,100.0,200.0,300.0,400.0,500.0,600.0,700.0,800.0,900.0,1000.0],\"y\":[34.16875076293945,40.48125076293945,44.493751525878906,46.98125076293945,48.53125,49.849998474121094,51.20000076293945,52.243751525878906,52.79999923706055,53.51874923706055,57.400001525878906,59.875,60.95624923706055,61.79999923706055,62.431251525878906,62.8125,62.9375,63.58124923706055,64.4625015258789],\"type\":\"scatter\",\"xaxis\":\"x2\",\"yaxis\":\"y2\"},{\"name\":\"wind SSP585 2050\",\"x\":[10.0,20.0,30.0,40.0,50.0,60.0,70.0,80.0,90.0,100.0,200.0,300.0,400.0,500.0,600.0,700.0,800.0,900.0,1000.0],\"y\":[37.224998474121094,44.76874923706055,48.63750076293945,51.66875076293945,53.5,55.23749923706055,56.20000076293945,57.23125076293945,58.368751525878906,59.17499923706055,63.11249923706055,65.3125,66.2125015258789,67.1624984741211,67.7125015258789,67.9749984741211,68.23750305175781,69.07499694824219,71.19999694824219],\"type\":\"scatter\",\"xaxis\":\"x2\",\"yaxis\":\"y2\"}],                        {\"template\":{\"data\":{\"histogram2dcontour\":[{\"type\":\"histogram2dcontour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"choropleth\":[{\"type\":\"choropleth\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"histogram2d\":[{\"type\":\"histogram2d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmap\":[{\"type\":\"heatmap\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmapgl\":[{\"type\":\"heatmapgl\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"contourcarpet\":[{\"type\":\"contourcarpet\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"contour\":[{\"type\":\"contour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"surface\":[{\"type\":\"surface\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"mesh3d\":[{\"type\":\"mesh3d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"scatter\":[{\"fillpattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2},\"type\":\"scatter\"}],\"parcoords\":[{\"type\":\"parcoords\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolargl\":[{\"type\":\"scatterpolargl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"bar\":[{\"error_x\":{\"color\":\"#2a3f5f\"},\"error_y\":{\"color\":\"#2a3f5f\"},\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"bar\"}],\"scattergeo\":[{\"type\":\"scattergeo\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolar\":[{\"type\":\"scatterpolar\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"histogram\":[{\"marker\":{\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"histogram\"}],\"scattergl\":[{\"type\":\"scattergl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatter3d\":[{\"type\":\"scatter3d\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattermapbox\":[{\"type\":\"scattermapbox\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterternary\":[{\"type\":\"scatterternary\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattercarpet\":[{\"type\":\"scattercarpet\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"carpet\":[{\"aaxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"baxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"type\":\"carpet\"}],\"table\":[{\"cells\":{\"fill\":{\"color\":\"#EBF0F8\"},\"line\":{\"color\":\"white\"}},\"header\":{\"fill\":{\"color\":\"#C8D4E3\"},\"line\":{\"color\":\"white\"}},\"type\":\"table\"}],\"barpolar\":[{\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"barpolar\"}],\"pie\":[{\"automargin\":true,\"type\":\"pie\"}]},\"layout\":{\"autotypenumbers\":\"strict\",\"colorway\":[\"#636efa\",\"#EF553B\",\"#00cc96\",\"#ab63fa\",\"#FFA15A\",\"#19d3f3\",\"#FF6692\",\"#B6E880\",\"#FF97FF\",\"#FECB52\"],\"font\":{\"color\":\"#2a3f5f\"},\"hovermode\":\"closest\",\"hoverlabel\":{\"align\":\"left\"},\"paper_bgcolor\":\"white\",\"plot_bgcolor\":\"#E5ECF6\",\"polar\":{\"bgcolor\":\"#E5ECF6\",\"angularaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"radialaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"ternary\":{\"bgcolor\":\"#E5ECF6\",\"aaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"baxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"caxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"coloraxis\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"colorscale\":{\"sequential\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"sequentialminus\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"diverging\":[[0,\"#8e0152\"],[0.1,\"#c51b7d\"],[0.2,\"#de77ae\"],[0.3,\"#f1b6da\"],[0.4,\"#fde0ef\"],[0.5,\"#f7f7f7\"],[0.6,\"#e6f5d0\"],[0.7,\"#b8e186\"],[0.8,\"#7fbc41\"],[0.9,\"#4d9221\"],[1,\"#276419\"]]},\"xaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"yaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"scene\":{\"xaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"yaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"zaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2}},\"shapedefaults\":{\"line\":{\"color\":\"#2a3f5f\"}},\"annotationdefaults\":{\"arrowcolor\":\"#2a3f5f\",\"arrowhead\":0,\"arrowwidth\":1},\"geo\":{\"bgcolor\":\"white\",\"landcolor\":\"#E5ECF6\",\"subunitcolor\":\"white\",\"showland\":true,\"showlakes\":true,\"lakecolor\":\"white\"},\"title\":{\"x\":0.05},\"mapbox\":{\"style\":\"light\"}}},\"xaxis\":{\"anchor\":\"y\",\"domain\":[0.0,0.45],\"title\":{\"text\":\"Return period (years)\",\"font\":{\"size\":14}},\"type\":\"log\"},\"yaxis\":{\"anchor\":\"x\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Flood depth (m)\",\"font\":{\"size\":14}}},\"xaxis2\":{\"anchor\":\"y2\",\"domain\":[0.55,1.0],\"title\":{\"text\":\"Return period (years)\",\"font\":{\"size\":14}},\"type\":\"log\"},\"yaxis2\":{\"anchor\":\"x2\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Max (1 minute) wind speed (m\\u002fs)\",\"font\":{\"size\":14}}},\"legend\":{\"orientation\":\"h\"}},                        {\"responsive\": true}                    ).then(function(){\n",
        "                            \n",
-       "var gd = document.getElementById('fd7c0c65-9459-4e3b-a719-22b378fae05b');\n",
+       "var gd = document.getElementById('e25f4071-9948-4ccd-bdc6-7c37462ae7f5');\n",
        "var x = new MutationObserver(function (mutations, observer) {{\n",
        "        var display = window.getComputedStyle(gd).display;\n",
        "        if (!display || display === 'none') {{\n",
@@ -208,355 +211,39 @@
     "fig1.add_scatter(x=wind_results_baseline[0][\"index_values\"], y=wind_results_baseline[0][\"intensities\"], name=\"baseline wind\", row=1, col=2)\n",
     "fig1.add_scatter(x=wind_results_ssp585[0][\"index_values\"], y=wind_results_ssp585[0][\"intensities\"], name=\"wind SSP585 2050\", row=1, col=2)\n",
     "fig1.update_xaxes(title=\"Return period (years)\", title_font={\"size\": 14}, row=1, col=2, type=\"log\")\n",
-    "fig1.update_yaxes(title=\"Max (1 minute) wind speed (m/s)\", title_font={\"size\": 14}, row=1, col=2)"
+    "fig1.update_yaxes(title=\"Max (1 minute) wind speed (m/s)\", title_font={\"size\": 14}, row=1, col=2)\n",
+    "fig1.update_layout(legend=dict(orientation=\"h\"))"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Accessing the inventory of hazard indicators\n",
-    "\n",
-    "Hazard indicator data are 3 dimensional arrays, the dimensions being ('index', 'spatial y', 'spatial x'). In the case of a EPSG:4326 co-ordinate reference system (CRS), for example, this would be ('index', 'latitude', 'longitude'). The data can be in any (CRS); generally the CRS of the original CRS is retained. API requests specify location via latitude and longitude and physrisk performs the necessary conversion.\n",
-    "\n",
-    "The 'index' depends on the nature of the hazards. For acute hazards – potential occurrence of events such as flood or tropical cyclone – 'index' will be the return period of the event. For chronic hazards its definition can vary. Chronic hazard indicators may be threshold-based, for example 'mean degree days per year above threshold' or 'mean days per year above temperature threshold'; in these cases 'index' gives the thresholds. Chronic hazards may comprise just a single value (e.g. annual probability of fire) in which case there is just a single element in 'index'.    \n",
+    "#### Requesting hazard indicators through physrisk directly\n",
     "\n",
-    "The inventory is a list of 'hazard resources' and each resource corresponds to a single array. This means that there are separate entries for the same hazard indicators inferred from different (e.g. CMIP6 or CORDEX) climate models.\n",
+    "As mentioned above, the API is simply using a hosted version of physrisk and it is possible to run the same calculations using physrisk directly, as long as the necessary API keys are present in a credentials.env file.\n",
     "\n",
-    "For the requests above, the 'path' of the array can be specified explicitly. This is the unique identifier for the hazard resource. But path can also be omitted in which can physrisk applies a set of rules to select a particular array. "
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 4,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "url = base_url + \"get_hazard_data_availability\"\n",
-    "hazard_resources = requests.post(url, json=request).json()[\"models\"]"
+    "The requests above can be run in physrisk using a Requester object."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 5,
    "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Hazards: {'Hail', 'Precipitation', 'Fire', 'Subsidence', 'Drought', 'ChronicHeat', 'CombinedInundation', 'RiverineInundation', 'Wind', 'CoastalInundation', 'WaterRisk'}\n",
-      "122 hazard resources in the inventory, of which 2 are Wind resources.\n",
-      "The resource 'path' is a unique identifier. For the IRIS Wind resource, for example, this is: 'wind/iris/v1/max_speed_{scenario}_{year}'.\n",
-      "Where resources are multi-dimensional arrays (as opposed to an external API), this is also the path of the array.\n",
-      "The available climate scenarios and years for the IRIS resource are:\n",
-      "[{'id': 'historical', 'years': [2010]},\n",
-      " {'id': 'ssp119', 'years': [2050]},\n",
-      " {'id': 'ssp245', 'years': [2050]},\n",
-      " {'id': 'ssp585', 'years': [2050]}]\n",
-      "A description is provided in markdown:\n"
-     ]
-    },
-    {
-     "data": {
-      "text/markdown": [
-       "Sparks, N., Toumi, R. The Imperial College Storm Model (IRIS) Dataset. *Sci Data* **11**, 424 (2024). <https://doi.org/10.1038/s41597-024-03250-y>\n",
-       "## The Imperial College Storm Model (IRIS) Dataset - Scientific Data\n",
-       "Assessing tropical cyclone risk on a global scale given the infrequency of landfalling tropical cyclones and the short period of reliable observations remains a challenge. Synthetic tropical cyclone datasets can help overcome these problems. Here we present a new global dataset created by IRIS, the ImpeRIal college Storm Model. IRIS is novel because, unlike other synthetic TC models, it only simulates the decay from the point of lifetime maximum intensity. This minimises the bias in the dataset. It takes input from 42 years of observed tropical cyclones and creates a 10,000 year synthetic dataset which is then validated against the observations. IRIS captures important statistical characteristics of the observed data. The return periods of the landfall maximum wind speed (1 minute sustained in m/s) are realistic globally. Climate model projections are used to adjust the life-time maximum intensity.\n",
-       "\n",
-       "***Disclaimer***: There have been many improvements on the dataset. Contact Professor Toumi from the Imperial College London for improved data."
-      ],
-      "text/plain": [
-       "<IPython.core.display.Markdown object>"
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
-    },
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "The whole resource:\n",
-      "{'description': 'Sparks, N., Toumi, R. The Imperial College Storm Model (IRIS) '\n",
-      "                'Dataset. *Sci Data* **11**, 424 (2024). '\n",
-      "                '<https://doi.org/10.1038/s41597-024-03250-y>\\n'\n",
-      "                '## The Imperial College Storm Model (IRIS) Dataset - '\n",
-      "                'Scientific Data\\n'\n",
-      "                'Assessing tropical cyclone risk on a global scale given the '\n",
-      "                'infrequency of landfalling tropical cyclones and the short '\n",
-      "                'period of reliable observations remains a challenge. '\n",
-      "                'Synthetic tropical cyclone datasets can help overcome these '\n",
-      "                'problems. Here we present a new global dataset created by '\n",
-      "                'IRIS, the ImpeRIal college Storm Model. IRIS is novel '\n",
-      "                'because, unlike other synthetic TC models, it only simulates '\n",
-      "                'the decay from the point of lifetime maximum intensity. This '\n",
-      "                'minimises the bias in the dataset. It takes input from 42 '\n",
-      "                'years of observed tropical cyclones and creates a 10,000 year '\n",
-      "                'synthetic dataset which is then validated against the '\n",
-      "                'observations. IRIS captures important statistical '\n",
-      "                'characteristics of the observed data. The return periods of '\n",
-      "                'the landfall maximum wind speed (1 minute sustained in m/s) '\n",
-      "                'are realistic globally. Climate model projections are used to '\n",
-      "                'adjust the life-time maximum intensity.\\n'\n",
-      "                '\\n'\n",
-      "                '***Disclaimer***: There have been many improvements on the '\n",
-      "                'dataset. Contact Professor Toumi from the Imperial College '\n",
-      "                'London for improved data.',\n",
-      " 'display_groups': [],\n",
-      " 'display_name': 'Max wind speed (IRIS)',\n",
-      " 'group_id': 'iris_osc',\n",
-      " 'hazard_type': 'Wind',\n",
-      " 'indicator_id': 'max_speed',\n",
-      " 'indicator_model_gcm': 'combined',\n",
-      " 'indicator_model_id': None,\n",
-      " 'map': {'bounds': [[-180.0, 60.0],\n",
-      "                    [180.0, 60.0],\n",
-      "                    [180.0, -60.0],\n",
-      "                    [-180.0, -60.0]],\n",
-      "         'colormap': {'max_index': 255,\n",
-      "                      'max_value': 120.0,\n",
-      "                      'min_index': 1,\n",
-      "                      'min_value': 0.0,\n",
-      "                      'name': 'heating',\n",
-      "                      'nodata_index': 0,\n",
-      "                      'units': 'm/s'},\n",
-      "         'path': 'wind/iris/v1/max_speed_{scenario}_{year}_map',\n",
-      "         'source': 'map_array_pyramid'},\n",
-      " 'params': {},\n",
-      " 'path': 'wind/iris/v1/max_speed_{scenario}_{year}',\n",
-      " 'scenarios': [{'id': 'historical', 'years': [2010]},\n",
-      "               {'id': 'ssp119', 'years': [2050]},\n",
-      "               {'id': 'ssp245', 'years': [2050]},\n",
-      "               {'id': 'ssp585', 'years': [2050]}],\n",
-      " 'units': 'm/s'}\n"
-     ]
-    }
-   ],
-   "source": [
-    "def printmd(string):\n",
-    "    display(Markdown(string))\n",
-    "\n",
-    "\n",
-    "hazard_types = set(r[\"hazard_type\"] for r in hazard_resources)\n",
-    "print(f\"Hazards: {hazard_types}\")\n",
-    "wind_resources = [r for r in hazard_resources if r[\"hazard_type\"] == \"Wind\"]\n",
-    "print(f\"{len(hazard_resources)} hazard resources in the inventory, of which {len(wind_resources)} are Wind resources.\")\n",
-    "iris_model_resource = next(r for r in wind_resources if \"iris\" in r[\"path\"])\n",
-    "# pp.pprint(iris_model_resource[0])\n",
-    "path = iris_model_resource[\"path\"]\n",
-    "print(f\"The resource 'path' is a unique identifier. For the IRIS Wind resource, for example, this is: '{path}'.\")\n",
-    "print(\n",
-    "    \"Where resources are multi-dimensional arrays (as opposed to an external API), this is also the path of the array.\"\n",
-    ")\n",
-    "print(\"The available climate scenarios and years for the IRIS resource are:\")\n",
-    "pp.pprint(iris_model_resource[\"scenarios\"])\n",
-    "print(\"A description is provided in markdown:\")\n",
-    "printmd(iris_model_resource[\"description\"])\n",
-    "print(\"The whole resource:\")\n",
-    "pp.pprint(iris_model_resource)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
+   "outputs": [],
    "source": [
-    "## Writing hazard resources to a summary table\n",
-    "\n",
-    "The code below creates a summary table for all hazard resources."
+    "# pip install physrisk-lib"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 6,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/markdown": [
-       "| Hazard type        | Indicator ID                 | Display name                                                             | Path (ID)                                                                         | Scenarios                                                                                                                                                                                                                                                 |\n",
-       "|:-------------------|:-----------------------------|:-------------------------------------------------------------------------|:----------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n",
-       "| ChronicHeat        | days/above/35c               | Days per year above 35°C (Jupiter)                                       | chronic_heat/jupiter/v1/days_above_35c_{scenario}_{year}                          | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
-       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_25c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_25c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_25c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_25c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_25c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_25c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_30c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_30c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_30c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_30c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_30c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_30c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_35c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_35c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_35c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_35c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_35c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_35c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_40c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_40c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_40c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_40c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_40c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_40c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_45c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_45c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_45c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_45c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_45c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_45c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_50c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_50c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_50c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_50c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_50c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_50c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_55c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_55c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_55c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_55c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_55c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_55c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/ACCESS-CM2    | chronic_heat/osc/v2/days_wbgt_above_ACCESS-CM2_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
-       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/CMCC-ESM2     | chronic_heat/osc/v2/days_wbgt_above_CMCC-ESM2_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
-       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/CNRM-CM6-1    | chronic_heat/osc/v2/days_wbgt_above_CNRM-CM6-1_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
-       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/MIROC6        | chronic_heat/osc/v2/days_wbgt_above_MIROC6_{scenario}_{year}                      | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
-       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/MPI-ESM1-2-LR | chronic_heat/osc/v2/days_wbgt_above_MPI-ESM1-2-LR_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
-       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/NorESM2-MM    | chronic_heat/osc/v2/days_wbgt_above_NorESM2-MM_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
-       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/ACCESS-CM2                                   | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_ACCESS-CM2_{scenario}_{year}    | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/CMCC-ESM2                                    | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_CMCC-ESM2_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/CNRM-CM6-1                                   | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_CNRM-CM6-1_{scenario}_{year}    | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/MIROC6                                       | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_MIROC6_{scenario}_{year}        | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/MPI-ESM1-2-LR                                | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_MPI-ESM1-2-LR_{scenario}_{year} | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/NorESM2-MM                                   | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_NorESM2-MM_{scenario}_{year}    | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/ACCESS-CM2                            | chronic_heat/osc/v2/mean_degree_days_above_index_ACCESS-CM2_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/CMCC-ESM2                             | chronic_heat/osc/v2/mean_degree_days_above_index_CMCC-ESM2_{scenario}_{year}      | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/CNRM-CM6-1                            | chronic_heat/osc/v2/mean_degree_days_above_index_CNRM-CM6-1_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/MIROC6                                | chronic_heat/osc/v2/mean_degree_days_above_index_MIROC6_{scenario}_{year}         | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/MPI-ESM1-2-LR                         | chronic_heat/osc/v2/mean_degree_days_above_index_MPI-ESM1-2-LR_{scenario}_{year}  | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/NorESM2-MM                            | chronic_heat/osc/v2/mean_degree_days_above_index_NorESM2-MM_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/ACCESS-CM2                            | chronic_heat/osc/v2/mean_degree_days_below_index_ACCESS-CM2_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/CMCC-ESM2                             | chronic_heat/osc/v2/mean_degree_days_below_index_CMCC-ESM2_{scenario}_{year}      | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/CNRM-CM6-1                            | chronic_heat/osc/v2/mean_degree_days_below_index_CNRM-CM6-1_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/MIROC6                                | chronic_heat/osc/v2/mean_degree_days_below_index_MIROC6_{scenario}_{year}         | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/MPI-ESM1-2-LR                         | chronic_heat/osc/v2/mean_degree_days_below_index_MPI-ESM1-2-LR_{scenario}_{year}  | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/NorESM2-MM                            | chronic_heat/osc/v2/mean_degree_days_below_index_NorESM2-MM_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/ACCESS-CM2                                | chronic_heat/osc/v2/mean_work_loss_high_ACCESS-CM2_{scenario}_{year}              | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/CMCC-ESM2                                 | chronic_heat/osc/v2/mean_work_loss_high_CMCC-ESM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/CNRM-CM6-1                                | chronic_heat/osc/v2/mean_work_loss_high_CNRM-CM6-1_{scenario}_{year}              | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/MIROC6                                    | chronic_heat/osc/v2/mean_work_loss_high_MIROC6_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/MPI-ESM1-2-LR                             | chronic_heat/osc/v2/mean_work_loss_high_MPI-ESM1-2-LR_{scenario}_{year}           | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/NorESM2-MM                                | chronic_heat/osc/v2/mean_work_loss_high_NorESM2-MM_{scenario}_{year}              | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/ACCESS-CM2                                 | chronic_heat/osc/v2/mean_work_loss_low_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/CMCC-ESM2                                  | chronic_heat/osc/v2/mean_work_loss_low_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/CNRM-CM6-1                                 | chronic_heat/osc/v2/mean_work_loss_low_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/MIROC6                                     | chronic_heat/osc/v2/mean_work_loss_low_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/MPI-ESM1-2-LR                              | chronic_heat/osc/v2/mean_work_loss_low_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/NorESM2-MM                                 | chronic_heat/osc/v2/mean_work_loss_low_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/ACCESS-CM2                              | chronic_heat/osc/v2/mean_work_loss_medium_ACCESS-CM2_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/CMCC-ESM2                               | chronic_heat/osc/v2/mean_work_loss_medium_CMCC-ESM2_{scenario}_{year}             | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/CNRM-CM6-1                              | chronic_heat/osc/v2/mean_work_loss_medium_CNRM-CM6-1_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/MIROC6                                  | chronic_heat/osc/v2/mean_work_loss_medium_MIROC6_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/MPI-ESM1-2-LR                           | chronic_heat/osc/v2/mean_work_loss_medium_MPI-ESM1-2-LR_{scenario}_{year}         | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/NorESM2-MM                              | chronic_heat/osc/v2/mean_work_loss_medium_NorESM2-MM_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
-       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/E2O           | chronic_heat/nluu/v2/weeks_water_temp_above_E2O_{scenario}_{year}                 | historical (1991)                                                                                                                                                                                                                                         |\n",
-       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/GFDL          | chronic_heat/nluu/v2/weeks_water_temp_above_GFDL_{scenario}_{year}                | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
-       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/HadGEM        | chronic_heat/nluu/v2/weeks_water_temp_above_HadGEM_{scenario}_{year}              | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
-       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/IPSL          | chronic_heat/nluu/v2/weeks_water_temp_above_IPSL_{scenario}_{year}                | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
-       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/MIROC         | chronic_heat/nluu/v2/weeks_water_temp_above_MIROC_{scenario}_{year}               | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
-       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/NorESM        | chronic_heat/nluu/v2/weeks_water_temp_above_NorESM_{scenario}_{year}              | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
-       "| CoastalInundation  | flood_depth                  | Flood depth/5%, with subsidence (WRI)                                    | inundation/wri/v2/inuncoast_{scenario}_wtsub_{year}_0_perc_05                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| CoastalInundation  | flood_depth                  | Flood depth/50%, no subsidence (WRI)                                     | inundation/wri/v2/inuncoast_{scenario}_nosub_{year}_0_perc_50                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| CoastalInundation  | flood_depth                  | Flood depth/50%, with subsidence (WRI)                                   | inundation/wri/v2/inuncoast_{scenario}_wtsub_{year}_0_perc_50                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| CoastalInundation  | flood_depth                  | Flood depth/95%, no subsidence (WRI)                                     | inundation/wri/v2/inuncoast_{scenario}_nosub_{year}_0                             | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| CoastalInundation  | flood_depth                  | Flood depth/95%, with subsidence (WRI)                                   | inundation/wri/v2/inuncoast_{scenario}_wtsub_{year}_0                             | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| CoastalInundation  | flood_depth                  | Flood depth/baseline, no subsidence (WRI)                                | inundation/wri/v2/inuncoast_historical_nosub_hist_0                               | historical (1980)                                                                                                                                                                                                                                         |\n",
-       "| CoastalInundation  | flood_depth                  | Flood depth/baseline, with subsidence (WRI)                              | inundation/wri/v2/inuncoast_historical_wtsub_hist_0                               | historical (1980)                                                                                                                                                                                                                                         |\n",
-       "| CoastalInundation  | flood_depth/nosub/5          | Flood depth/5%, no subsidence (WRI)                                      | inundation/wri/v2/inuncoast_{scenario}_nosub_{year}_0_perc_05                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| CombinedInundation | flooded_fraction             | Flooded fraction (Jupiter)                                               | combined_flood/jupiter/v1/fraction_{scenario}_{year}                              | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
-       "| Drought            | months/spei12m/below/index   | Drought SPEI index                                                       | drought/osc/v1/months_spei12m_below_index_MIROC6_{scenario}_{year}                | SSP585 (2005, 2030, 2040, 2050, 2080)                                                                                                                                                                                                                     |\n",
-       "| Drought            | months/spei3m/below/-2       | Drought (Jupiter)                                                        | drought/jupiter/v1/months_spei3m_below_-2_{scenario}_{year}                       | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
-       "| Fire               | fire_probability             | Fire probability (Jupiter)                                               | fire/jupiter/v1/fire_probability_{scenario}_{year}                                | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
-       "| Hail               | days/above/5cm               | Large hail days per year (Jupiter)                                       | hail/jupiter/v1/days_above_5cm_{scenario}_{year}                                  | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
-       "| Precipitation      | max/daily/water_equivalent   | Precipitation (Jupiter)                                                  | precipitation/jupiter/v1/max_daily_water_equivalent_{scenario}_{year}             | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
-       "| RiverineInundation | flood_depth                  | Flood depth (TUDelft)                                                    | inundation/river_tudelft/v2/flood_depth_unprot_{scenario}_{year}                  | historical (1985), RCP 4.5 (2035, 2085), RCP 8.5 (2035, 2085)                                                                                                                                                                                             |\n",
-       "| RiverineInundation | flood_depth                  | Flood depth/GFDL-ESM2M (WRI)                                             | inundation/wri/v2/inunriver_{scenario}_0000GFDL-ESM2M_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| RiverineInundation | flood_depth                  | Flood depth/HadGEM2-ES (WRI)                                             | inundation/wri/v2/inunriver_{scenario}_0000HadGEM2-ES_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| RiverineInundation | flood_depth                  | Flood depth/IPSL-CM5A-LR (WRI)                                           | inundation/wri/v2/inunriver_{scenario}_00IPSL-CM5A-LR_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| RiverineInundation | flood_depth                  | Flood depth/MIROC-ESM-CHEM (WRI)                                         | inundation/wri/v2/inunriver_{scenario}_MIROC-ESM-CHEM_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| RiverineInundation | flood_depth                  | Flood depth/NorESM1-M (WRI)                                              | inundation/wri/v2/inunriver_{scenario}_00000NorESM1-M_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
-       "| RiverineInundation | flood_depth                  | Flood depth/baseline (WRI)                                               | inundation/wri/v2/inunriver_{scenario}_000000000WATCH_{year}                      | historical (1980)                                                                                                                                                                                                                                         |\n",
-       "| RiverineInundation | flood_sop                    | Standard of protection (TUDelft)                                         | inundation/river_tudelft/v2/flood_sop_{scenario}_{year}                           | historical (1985), RCP 4.5 (2035, 2085), RCP 8.5 (2035, 2085)                                                                                                                                                                                             |\n",
-       "| Subsidence         | land_subsidence_rate         | Land subsidence rate (Davydzenka et Al (2024))                           | subsidence/csm/v1/land_subsidence_rate_{scenario}_{year}                          | historical (2021)                                                                                                                                                                                                                                         |\n",
-       "| WaterRisk          | water_demand                 | Water demand in centimeters/year (Aqueduct 4.0)                          | water_risk/wri/v2/water_demand_{scenario}_{year}                                  | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
-       "| WaterRisk          | water_depletion              | Water depletion (Aqueduct 4.0)                                           | water_risk/wri/v2/water_depletion_{scenario}_{year}                               | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
-       "| WaterRisk          | water_depletion_category     | Water depletion category (Aqueduct 4.0)                                  | water_risk/wri/v2/water_depletion_category_{scenario}_{year}                      | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
-       "| WaterRisk          | water_stress                 | Water stress (Aqueduct 4.0)                                              | water_risk/wri/v2/water_stress_{scenario}_{year}                                  | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
-       "| WaterRisk          | water_stress_category        | Water stress category (Aqueduct 4.0)                                     | water_risk/wri/v2/water_stress_category_{scenario}_{year}                         | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
-       "| WaterRisk          | water_supply                 | Water supply in centimeters/year (Aqueduct 4.0)                          | water_risk/wri/v2/water_supply_{scenario}_{year}                                  | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
-       "| Wind               | max_speed                    | Max 1 minute sustained wind speed (Jupiter)                              | wind/jupiter/v1/max_1min_{scenario}_{year}                                        | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
-       "| Wind               | max_speed                    | Max wind speed (IRIS)                                                    | wind/iris/v1/max_speed_{scenario}_{year}                                          | historical (2010), SSP119 (2050), SSP245 (2050), SSP585 (2050)                                                                                                                                                                                            |"
-      ],
-      "text/plain": [
-       "<IPython.core.display.Markdown object>"
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
-    }
-   ],
-   "source": [
-    "#from typing import List\n",
-    "import pandas as pd\n",
-    "import json\n",
-    "\n",
-    "rcp_display_names = {\"rcp2p6\": \"RCP 2.6\", \"rcp4p5\": \"RCP 4.5\" ,\"rcp6p0\": \"RCP 6.0\", \"rcp8p5\": \"RCP 8.5\", }\n",
-    "\n",
-    "def scenario_code(id: str):\n",
-    "    if id.startswith(\"ssp\"):\n",
-    "        return id.upper()\n",
-    "    elif id.startswith(\"rcp\"):\n",
-    "        return id.replace(\"rcp\", \"RCP \").replace(\"p\", \".\")\n",
-    "    else:\n",
-    "        return id\n",
-    "\n",
-    "def format_scenario(scenarios):\n",
-    "    return \", \".join(f\"{scenario_code(scen['id'])} ({', '.join(str(y) for y in scen['years'])})\" for scen in scenarios)\n",
-    "\n",
-    "resource_df = pd.json_normalize(hazard_resources)\n",
-    "resource_df = resource_df.filter([\"hazard_type\", \"indicator_id\", \"display_name\", \"path\", \"scenarios\"])\n",
-    "resource_df = resource_df.sort_values(by=[\"hazard_type\", \"indicator_id\", \"display_name\"])\n",
-    "resource_df.scenarios = resource_df.scenarios.apply(lambda s: format_scenario(s))\n",
-    "resource_df = resource_df.rename(columns={\"hazard_type\": \"Hazard type\",\n",
-    "                                          \"indicator_id\": \"Indicator ID\",\n",
-    "                                          \"display_name\": \"Display name\",\n",
-    "                                          \"path\": \"Path (ID)\",\n",
-    "                                          \"scenarios\": \"Scenarios\",\n",
-    "                                          })\n",
-    "\n",
-    "md = resource_df.to_markdown(index=False)\n",
-    "display(Markdown(md))"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Requesting hazard indicators through physrisk directly\n",
-    "\n",
-    "As mentioned above, the API is simply using a hosted version of physrisk and it is possible to run the same calculations using physrisk directly, as long as the necessary API keys are present in a credentials.env file.\n",
-    "\n",
-    "The requests above can be run in physrisk using a Requester object."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 7,
-   "metadata": {},
    "outputs": [],
    "source": [
+    "from dotenv import load_dotenv\n",
+    "from physrisk.container import Container\n",
+    "\n",
     "load_dotenv(\"../../credentials.env\")\n",
     "# the container is a dependency injection container,\n",
     "# which allows the calculation to be configured to a particular use-case\n",
diff --git a/docs/getting_started/hazard_inventory.ipynb b/docs/getting_started/hazard_inventory.ipynb
new file mode 100644
index 00000000..6bfdca00
--- /dev/null
+++ b/docs/getting_started/hazard_inventory.ipynb
@@ -0,0 +1,411 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Accessing the inventory of hazard indicators\n",
+    "\n",
+    "Hazard indicator data are 3 dimensional arrays, the dimensions being ('index', 'spatial y', 'spatial x'). In the case of a EPSG:4326 co-ordinate reference system (CRS), for example, this would be ('index', 'latitude', 'longitude'). The data can be in any CRS; generally the CRS of the original CRS is retained. API requests specify location via latitude and longitude and physrisk performs the necessary conversion.\n",
+    "\n",
+    "The 'index' depends on the nature of the hazards. For acute hazards – potential occurrence of events such as flood or tropical cyclone – 'index' will be the return period of the event. For chronic hazards its definition can vary. Chronic hazard indicators may be threshold-based, for example 'mean degree days per year above threshold' or 'mean days per year above temperature threshold'; in these cases 'index' gives the thresholds. Chronic hazards may comprise just a single value (e.g. annual probability of fire) in which case there is just a single element in 'index'.    \n",
+    "\n",
+    "The inventory is a list of 'hazard resources' and each resource corresponds to a single array. This means that there are separate entries for the same hazard indicators inferred from different (e.g. CMIP6 or CORDEX) climate models.\n",
+    "\n",
+    "For the requests above, the 'path' of the array can be specified explicitly. This is the unique identifier for the hazard resource. But path can also be omitted in which can physrisk applies a set of rules to select a particular array. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import pprint as pp\n",
+    "import pandas as pd\n",
+    "import requests\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "base_url = \"https://physrisk-api-sandbox.apps.odh-cl1.apps.os-climate.org/api/\"\n",
+    "url = base_url + \"get_hazard_data_availability\"\n",
+    "hazard_resources = requests.post(url, json={}).json()[\"models\"]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can then read the inventory items, for example:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Hazards: {'Wind', 'CoastalInundation', 'Fire', 'WaterRisk', 'RiverineInundation', 'CombinedInundation', 'Drought', 'Precipitation', 'Subsidence', 'Hail', 'ChronicHeat'}\n",
+      "122 hazard resources in the inventory, of which 2 are Wind resources.\n",
+      "The resource 'path' is a unique identifier. For the IRIS Wind resource, for example, this is: 'wind/iris/v1/max_speed_{scenario}_{year}'.\n",
+      "Where resources are multi-dimensional arrays (as opposed to an external API), this is also the path of the array.\n",
+      "The available climate scenarios and years for the IRIS resource are:\n",
+      "[{'id': 'historical', 'years': [2010]},\n",
+      " {'id': 'ssp119', 'years': [2050]},\n",
+      " {'id': 'ssp245', 'years': [2050]},\n",
+      " {'id': 'ssp585', 'years': [2050]}]\n",
+      "The whole IRIS data resource, as an example:\n",
+      "{'description': 'Sparks, N., Toumi, R. The Imperial College Storm Model (IRIS) '\n",
+      "                'Dataset. *Sci Data* **11**, 424 (2024). '\n",
+      "                '<https://doi.org/10.1038/s41597-024-03250-y>\\n'\n",
+      "                '## The Imperial College Storm Model (IRIS) Dataset - '\n",
+      "                'Scientific Data\\n'\n",
+      "                'Assessing tropical cyclone risk on a global scale given the '\n",
+      "                'infrequency of landfalling tropical cyclones and the short '\n",
+      "                'period of reliable observations remains a challenge. '\n",
+      "                'Synthetic tropical cyclone datasets can help overcome these '\n",
+      "                'problems. Here we present a new global dataset created by '\n",
+      "                'IRIS, the ImpeRIal college Storm Model. IRIS is novel '\n",
+      "                'because, unlike other synthetic TC models, it only simulates '\n",
+      "                'the decay from the point of lifetime maximum intensity. This '\n",
+      "                'minimises the bias in the dataset. It takes input from 42 '\n",
+      "                'years of observed tropical cyclones and creates a 10,000 year '\n",
+      "                'synthetic dataset which is then validated against the '\n",
+      "                'observations. IRIS captures important statistical '\n",
+      "                'characteristics of the observed data. The return periods of '\n",
+      "                'the landfall maximum wind speed (1 minute sustained in m/s) '\n",
+      "                'are realistic globally. Climate model projections are used to '\n",
+      "                'adjust the life-time maximum intensity.\\n'\n",
+      "                '\\n'\n",
+      "                '***Disclaimer***: There have been many improvements on the '\n",
+      "                'dataset. Contact Professor Toumi from the Imperial College '\n",
+      "                'London for improved data.',\n",
+      " 'display_groups': [],\n",
+      " 'display_name': 'Max wind speed (IRIS)',\n",
+      " 'group_id': 'iris_osc',\n",
+      " 'hazard_type': 'Wind',\n",
+      " 'indicator_id': 'max_speed',\n",
+      " 'indicator_model_gcm': 'combined',\n",
+      " 'indicator_model_id': None,\n",
+      " 'map': {'bounds': [[-180.0, 60.0],\n",
+      "                    [180.0, 60.0],\n",
+      "                    [180.0, -60.0],\n",
+      "                    [-180.0, -60.0]],\n",
+      "         'colormap': {'max_index': 255,\n",
+      "                      'max_value': 120.0,\n",
+      "                      'min_index': 1,\n",
+      "                      'min_value': 0.0,\n",
+      "                      'name': 'heating',\n",
+      "                      'nodata_index': 0,\n",
+      "                      'units': 'm/s'},\n",
+      "         'path': 'wind/iris/v1/max_speed_{scenario}_{year}_map',\n",
+      "         'source': 'map_array_pyramid'},\n",
+      " 'params': {},\n",
+      " 'path': 'wind/iris/v1/max_speed_{scenario}_{year}',\n",
+      " 'scenarios': [{'id': 'historical', 'years': [2010]},\n",
+      "               {'id': 'ssp119', 'years': [2050]},\n",
+      "               {'id': 'ssp245', 'years': [2050]},\n",
+      "               {'id': 'ssp585', 'years': [2050]}],\n",
+      " 'units': 'm/s'}\n"
+     ]
+    }
+   ],
+   "source": [
+    "hazard_types = set(r[\"hazard_type\"] for r in hazard_resources)\n",
+    "print(f\"Hazards: {hazard_types}\")\n",
+    "wind_resources = [r for r in hazard_resources if r[\"hazard_type\"] == \"Wind\"]\n",
+    "print(f\"{len(hazard_resources)} hazard resources in the inventory, of which {len(wind_resources)} are Wind resources.\")\n",
+    "iris_model_resource = next(r for r in wind_resources if \"iris\" in r[\"path\"])\n",
+    "# pp.pprint(iris_model_resource[0])\n",
+    "path = iris_model_resource[\"path\"]\n",
+    "print(f\"The resource 'path' is a unique identifier. For the IRIS Wind resource, for example, this is: '{path}'.\")\n",
+    "print(\n",
+    "    \"Where resources are multi-dimensional arrays (as opposed to an external API), this is also the path of the array.\"\n",
+    ")\n",
+    "print(\"The available climate scenarios and years for the IRIS resource are:\")\n",
+    "pp.pprint(iris_model_resource[\"scenarios\"])\n",
+    "print(\"The whole IRIS data resource, as an example:\")\n",
+    "pp.pprint(iris_model_resource)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The descriptions are in markdown, which can also be displayed, for example for the IRIS data set:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "A description is provided in markdown, e.g.:\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "Sparks, N., Toumi, R. The Imperial College Storm Model (IRIS) Dataset. *Sci Data* **11**, 424 (2024). <https://doi.org/10.1038/s41597-024-03250-y>\n",
+       "## The Imperial College Storm Model (IRIS) Dataset - Scientific Data\n",
+       "Assessing tropical cyclone risk on a global scale given the infrequency of landfalling tropical cyclones and the short period of reliable observations remains a challenge. Synthetic tropical cyclone datasets can help overcome these problems. Here we present a new global dataset created by IRIS, the ImpeRIal college Storm Model. IRIS is novel because, unlike other synthetic TC models, it only simulates the decay from the point of lifetime maximum intensity. This minimises the bias in the dataset. It takes input from 42 years of observed tropical cyclones and creates a 10,000 year synthetic dataset which is then validated against the observations. IRIS captures important statistical characteristics of the observed data. The return periods of the landfall maximum wind speed (1 minute sustained in m/s) are realistic globally. Climate model projections are used to adjust the life-time maximum intensity.\n",
+       "\n",
+       "***Disclaimer***: There have been many improvements on the dataset. Contact Professor Toumi from the Imperial College London for improved data."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "print(\"A description is provided in markdown, e.g.:\")\n",
+    "display(Markdown(iris_model_resource[\"description\"]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Writing hazard resources to a summary table\n",
+    "\n",
+    "The code below creates a summary table for all hazard resources."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "rcp_display_names = {\"rcp2p6\": \"RCP 2.6\", \"rcp4p5\": \"RCP 4.5\" ,\"rcp6p0\": \"RCP 6.0\", \"rcp8p5\": \"RCP 8.5\", }\n",
+    "\n",
+    "def scenario_code(id: str):\n",
+    "    if id.startswith(\"ssp\"):\n",
+    "        return id.upper()\n",
+    "    elif id.startswith(\"rcp\"):\n",
+    "        return id.replace(\"rcp\", \"RCP \").replace(\"p\", \".\")\n",
+    "    else:\n",
+    "        return id\n",
+    "\n",
+    "def format_scenario(scenarios):\n",
+    "    return \", \".join(f\"{scenario_code(scen['id'])} ({', '.join(str(y) for y in scen['years'])})\" for scen in scenarios)\n",
+    "\n",
+    "resource_df = pd.json_normalize(hazard_resources)\n",
+    "resource_df = resource_df.filter([\"hazard_type\", \"indicator_id\", \"display_name\", \"path\", \"scenarios\"])\n",
+    "resource_df = resource_df.sort_values(by=[\"hazard_type\", \"indicator_id\", \"display_name\"])\n",
+    "resource_df.scenarios = resource_df.scenarios.apply(lambda s: format_scenario(s))\n",
+    "resource_df = resource_df.rename(columns={\"hazard_type\": \"Hazard type\",\n",
+    "                                          \"indicator_id\": \"Indicator ID\",\n",
+    "                                          \"display_name\": \"Display name\",\n",
+    "                                          \"path\": \"Path (ID)\",\n",
+    "                                          \"scenarios\": \"Scenarios\",\n",
+    "                                          })\n",
+    "\n",
+    "style = \"\"\"\n",
+    "<style scoped>\n",
+    "table {\n",
+    "  font-size: 8px;\n",
+    "}\n",
+    "</style>\n",
+    "\"\"\"\n",
+    "\n",
+    "md = resource_df.to_markdown(index=False)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "\n",
+       "<style scoped>\n",
+       "table {\n",
+       "  font-size: 8px;\n",
+       "}\n",
+       "</style>\n",
+       "| Hazard type        | Indicator ID                 | Display name                                                             | Path (ID)                                                                         | Scenarios                                                                                                                                                                                                                                                 |\n",
+       "|:-------------------|:-----------------------------|:-------------------------------------------------------------------------|:----------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n",
+       "| ChronicHeat        | days/above/35c               | Days per year above 35°C (Jupiter)                                       | chronic_heat/jupiter/v1/days_above_35c_{scenario}_{year}                          | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
+       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_25c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_25c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_25c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_25c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_25c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/25c           | Days with average temperature above 25°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_25c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_30c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_30c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_30c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_30c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_30c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/30c           | Days with average temperature above 30°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_30c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_35c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_35c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_35c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_35c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_35c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/35c           | Days with average temperature above 35°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_35c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_40c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_40c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_40c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_40c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_40c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/40c           | Days with average temperature above 40°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_40c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_45c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_45c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_45c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_45c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_45c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/45c           | Days with average temperature above 45°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_45c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_50c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_50c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_50c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_50c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_50c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/50c           | Days with average temperature above 50°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_50c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/ACCESS-CM2                      | chronic_heat/osc/v2/days_tas_above_55c_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/CMCC-ESM2                       | chronic_heat/osc/v2/days_tas_above_55c_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/CNRM-CM6-1                      | chronic_heat/osc/v2/days_tas_above_55c_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/MIROC6                          | chronic_heat/osc/v2/days_tas_above_55c_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/MPI-ESM1-2-LR                   | chronic_heat/osc/v2/days_tas_above_55c_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_tas/above/55c           | Days with average temperature above 55°C/NorESM2-MM                      | chronic_heat/osc/v2/days_tas_above_55c_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/ACCESS-CM2    | chronic_heat/osc/v2/days_wbgt_above_ACCESS-CM2_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
+       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/CMCC-ESM2     | chronic_heat/osc/v2/days_wbgt_above_CMCC-ESM2_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
+       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/CNRM-CM6-1    | chronic_heat/osc/v2/days_wbgt_above_CNRM-CM6-1_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
+       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/MIROC6        | chronic_heat/osc/v2/days_wbgt_above_MIROC6_{scenario}_{year}                      | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
+       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/MPI-ESM1-2-LR | chronic_heat/osc/v2/days_wbgt_above_MPI-ESM1-2-LR_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
+       "| ChronicHeat        | days_wbgt_above              | Days with wet-bulb globe temperature above threshold in °C/NorESM2-MM    | chronic_heat/osc/v2/days_wbgt_above_NorESM2-MM_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP245 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP370 (2030, 2040, 2050, 2060, 2070, 2080, 2090), SSP585 (2030, 2040, 2050, 2060, 2070, 2080, 2090)                             |\n",
+       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/ACCESS-CM2                                   | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_ACCESS-CM2_{scenario}_{year}    | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/CMCC-ESM2                                    | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_CMCC-ESM2_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/CNRM-CM6-1                                   | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_CNRM-CM6-1_{scenario}_{year}    | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/MIROC6                                       | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_MIROC6_{scenario}_{year}        | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/MPI-ESM1-2-LR                                | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_MPI-ESM1-2-LR_{scenario}_{year} | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/32c   | Mean degree days above 32°C/NorESM2-MM                                   | chronic_heat/osc/v2/mean_degree_days_v2_above_32c_NorESM2-MM_{scenario}_{year}    | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/ACCESS-CM2                            | chronic_heat/osc/v2/mean_degree_days_above_index_ACCESS-CM2_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/CMCC-ESM2                             | chronic_heat/osc/v2/mean_degree_days_above_index_CMCC-ESM2_{scenario}_{year}      | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/CNRM-CM6-1                            | chronic_heat/osc/v2/mean_degree_days_above_index_CNRM-CM6-1_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/MIROC6                                | chronic_heat/osc/v2/mean_degree_days_above_index_MIROC6_{scenario}_{year}         | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/MPI-ESM1-2-LR                         | chronic_heat/osc/v2/mean_degree_days_above_index_MPI-ESM1-2-LR_{scenario}_{year}  | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/above/index | Mean degree days above index value/NorESM2-MM                            | chronic_heat/osc/v2/mean_degree_days_above_index_NorESM2-MM_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/ACCESS-CM2                            | chronic_heat/osc/v2/mean_degree_days_below_index_ACCESS-CM2_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/CMCC-ESM2                             | chronic_heat/osc/v2/mean_degree_days_below_index_CMCC-ESM2_{scenario}_{year}      | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/CNRM-CM6-1                            | chronic_heat/osc/v2/mean_degree_days_below_index_CNRM-CM6-1_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/MIROC6                                | chronic_heat/osc/v2/mean_degree_days_below_index_MIROC6_{scenario}_{year}         | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/MPI-ESM1-2-LR                         | chronic_heat/osc/v2/mean_degree_days_below_index_MPI-ESM1-2-LR_{scenario}_{year}  | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_degree_days/below/index | Mean degree days below index value/NorESM2-MM                            | chronic_heat/osc/v2/mean_degree_days_below_index_NorESM2-MM_{scenario}_{year}     | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/ACCESS-CM2                                | chronic_heat/osc/v2/mean_work_loss_high_ACCESS-CM2_{scenario}_{year}              | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/CMCC-ESM2                                 | chronic_heat/osc/v2/mean_work_loss_high_CMCC-ESM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/CNRM-CM6-1                                | chronic_heat/osc/v2/mean_work_loss_high_CNRM-CM6-1_{scenario}_{year}              | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/MIROC6                                    | chronic_heat/osc/v2/mean_work_loss_high_MIROC6_{scenario}_{year}                  | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/MPI-ESM1-2-LR                             | chronic_heat/osc/v2/mean_work_loss_high_MPI-ESM1-2-LR_{scenario}_{year}           | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/high          | Mean work loss, high intensity/NorESM2-MM                                | chronic_heat/osc/v2/mean_work_loss_high_NorESM2-MM_{scenario}_{year}              | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/ACCESS-CM2                                 | chronic_heat/osc/v2/mean_work_loss_low_ACCESS-CM2_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/CMCC-ESM2                                  | chronic_heat/osc/v2/mean_work_loss_low_CMCC-ESM2_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/CNRM-CM6-1                                 | chronic_heat/osc/v2/mean_work_loss_low_CNRM-CM6-1_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/MIROC6                                     | chronic_heat/osc/v2/mean_work_loss_low_MIROC6_{scenario}_{year}                   | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/MPI-ESM1-2-LR                              | chronic_heat/osc/v2/mean_work_loss_low_MPI-ESM1-2-LR_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/low           | Mean work loss, low intensity/NorESM2-MM                                 | chronic_heat/osc/v2/mean_work_loss_low_NorESM2-MM_{scenario}_{year}               | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/ACCESS-CM2                              | chronic_heat/osc/v2/mean_work_loss_medium_ACCESS-CM2_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/CMCC-ESM2                               | chronic_heat/osc/v2/mean_work_loss_medium_CMCC-ESM2_{scenario}_{year}             | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/CNRM-CM6-1                              | chronic_heat/osc/v2/mean_work_loss_medium_CNRM-CM6-1_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/MIROC6                                  | chronic_heat/osc/v2/mean_work_loss_medium_MIROC6_{scenario}_{year}                | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/MPI-ESM1-2-LR                           | chronic_heat/osc/v2/mean_work_loss_medium_MPI-ESM1-2-LR_{scenario}_{year}         | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | mean_work_loss/medium        | Mean work loss, medium intensity/NorESM2-MM                              | chronic_heat/osc/v2/mean_work_loss_medium_NorESM2-MM_{scenario}_{year}            | historical (2005), SSP126 (2030, 2040, 2050), SSP245 (2030, 2040, 2050), SSP585 (2030, 2040, 2050)                                                                                                                                                        |\n",
+       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/E2O           | chronic_heat/nluu/v2/weeks_water_temp_above_E2O_{scenario}_{year}                 | historical (1991)                                                                                                                                                                                                                                         |\n",
+       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/GFDL          | chronic_heat/nluu/v2/weeks_water_temp_above_GFDL_{scenario}_{year}                | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
+       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/HadGEM        | chronic_heat/nluu/v2/weeks_water_temp_above_HadGEM_{scenario}_{year}              | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
+       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/IPSL          | chronic_heat/nluu/v2/weeks_water_temp_above_IPSL_{scenario}_{year}                | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
+       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/MIROC         | chronic_heat/nluu/v2/weeks_water_temp_above_MIROC_{scenario}_{year}               | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
+       "| ChronicHeat        | weeks_water_temp_above       | Weeks with average water temperature above threshold in °C/NorESM        | chronic_heat/nluu/v2/weeks_water_temp_above_NorESM_{scenario}_{year}              | historical (1991), RCP 2.6 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 4.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 6.0 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090), RCP 8.5 (2020, 2030, 2040, 2050, 2060, 2070, 2080, 2090) |\n",
+       "| CoastalInundation  | flood_depth                  | Flood depth/5%, with subsidence (WRI)                                    | inundation/wri/v2/inuncoast_{scenario}_wtsub_{year}_0_perc_05                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| CoastalInundation  | flood_depth                  | Flood depth/50%, no subsidence (WRI)                                     | inundation/wri/v2/inuncoast_{scenario}_nosub_{year}_0_perc_50                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| CoastalInundation  | flood_depth                  | Flood depth/50%, with subsidence (WRI)                                   | inundation/wri/v2/inuncoast_{scenario}_wtsub_{year}_0_perc_50                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| CoastalInundation  | flood_depth                  | Flood depth/95%, no subsidence (WRI)                                     | inundation/wri/v2/inuncoast_{scenario}_nosub_{year}_0                             | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| CoastalInundation  | flood_depth                  | Flood depth/95%, with subsidence (WRI)                                   | inundation/wri/v2/inuncoast_{scenario}_wtsub_{year}_0                             | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| CoastalInundation  | flood_depth                  | Flood depth/baseline, no subsidence (WRI)                                | inundation/wri/v2/inuncoast_historical_nosub_hist_0                               | historical (1980)                                                                                                                                                                                                                                         |\n",
+       "| CoastalInundation  | flood_depth                  | Flood depth/baseline, with subsidence (WRI)                              | inundation/wri/v2/inuncoast_historical_wtsub_hist_0                               | historical (1980)                                                                                                                                                                                                                                         |\n",
+       "| CoastalInundation  | flood_depth/nosub/5          | Flood depth/5%, no subsidence (WRI)                                      | inundation/wri/v2/inuncoast_{scenario}_nosub_{year}_0_perc_05                     | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| CombinedInundation | flooded_fraction             | Flooded fraction (Jupiter)                                               | combined_flood/jupiter/v1/fraction_{scenario}_{year}                              | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
+       "| Drought            | months/spei12m/below/index   | Drought SPEI index                                                       | drought/osc/v1/months_spei12m_below_index_MIROC6_{scenario}_{year}                | SSP585 (2005, 2030, 2040, 2050, 2080)                                                                                                                                                                                                                     |\n",
+       "| Drought            | months/spei3m/below/-2       | Drought (Jupiter)                                                        | drought/jupiter/v1/months_spei3m_below_-2_{scenario}_{year}                       | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
+       "| Fire               | fire_probability             | Fire probability (Jupiter)                                               | fire/jupiter/v1/fire_probability_{scenario}_{year}                                | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
+       "| Hail               | days/above/5cm               | Large hail days per year (Jupiter)                                       | hail/jupiter/v1/days_above_5cm_{scenario}_{year}                                  | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
+       "| Precipitation      | max/daily/water_equivalent   | Precipitation (Jupiter)                                                  | precipitation/jupiter/v1/max_daily_water_equivalent_{scenario}_{year}             | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
+       "| RiverineInundation | flood_depth                  | Flood depth (TUDelft)                                                    | inundation/river_tudelft/v2/flood_depth_unprot_{scenario}_{year}                  | historical (1985), RCP 4.5 (2035, 2085), RCP 8.5 (2035, 2085)                                                                                                                                                                                             |\n",
+       "| RiverineInundation | flood_depth                  | Flood depth/GFDL-ESM2M (WRI)                                             | inundation/wri/v2/inunriver_{scenario}_0000GFDL-ESM2M_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| RiverineInundation | flood_depth                  | Flood depth/HadGEM2-ES (WRI)                                             | inundation/wri/v2/inunriver_{scenario}_0000HadGEM2-ES_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| RiverineInundation | flood_depth                  | Flood depth/IPSL-CM5A-LR (WRI)                                           | inundation/wri/v2/inunriver_{scenario}_00IPSL-CM5A-LR_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| RiverineInundation | flood_depth                  | Flood depth/MIROC-ESM-CHEM (WRI)                                         | inundation/wri/v2/inunriver_{scenario}_MIROC-ESM-CHEM_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| RiverineInundation | flood_depth                  | Flood depth/NorESM1-M (WRI)                                              | inundation/wri/v2/inunriver_{scenario}_00000NorESM1-M_{year}                      | RCP 4.5 (2030, 2050, 2080), RCP 8.5 (2030, 2050, 2080)                                                                                                                                                                                                    |\n",
+       "| RiverineInundation | flood_depth                  | Flood depth/baseline (WRI)                                               | inundation/wri/v2/inunriver_{scenario}_000000000WATCH_{year}                      | historical (1980)                                                                                                                                                                                                                                         |\n",
+       "| RiverineInundation | flood_sop                    | Standard of protection (TUDelft)                                         | inundation/river_tudelft/v2/flood_sop_{scenario}_{year}                           | historical (1985), RCP 4.5 (2035, 2085), RCP 8.5 (2035, 2085)                                                                                                                                                                                             |\n",
+       "| Subsidence         | land_subsidence_rate         | Land subsidence rate (Davydzenka et Al (2024))                           | subsidence/csm/v1/land_subsidence_rate_{scenario}_{year}                          | historical (2021)                                                                                                                                                                                                                                         |\n",
+       "| WaterRisk          | water_demand                 | Water demand in centimeters/year (Aqueduct 4.0)                          | water_risk/wri/v2/water_demand_{scenario}_{year}                                  | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
+       "| WaterRisk          | water_depletion              | Water depletion (Aqueduct 4.0)                                           | water_risk/wri/v2/water_depletion_{scenario}_{year}                               | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
+       "| WaterRisk          | water_depletion_category     | Water depletion category (Aqueduct 4.0)                                  | water_risk/wri/v2/water_depletion_category_{scenario}_{year}                      | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
+       "| WaterRisk          | water_stress                 | Water stress (Aqueduct 4.0)                                              | water_risk/wri/v2/water_stress_{scenario}_{year}                                  | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
+       "| WaterRisk          | water_stress_category        | Water stress category (Aqueduct 4.0)                                     | water_risk/wri/v2/water_stress_category_{scenario}_{year}                         | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
+       "| WaterRisk          | water_supply                 | Water supply in centimeters/year (Aqueduct 4.0)                          | water_risk/wri/v2/water_supply_{scenario}_{year}                                  | historical (1999), SSP126 (2030, 2050, 2080), SSP370 (2030, 2050, 2080), SSP585 (2030, 2050, 2080)                                                                                                                                                        |\n",
+       "| Wind               | max_speed                    | Max 1 minute sustained wind speed (Jupiter)                              | wind/jupiter/v1/max_1min_{scenario}_{year}                                        | SSP126 (2020, 2030, 2040, 2050, 2075, 2100), SSP585 (2020, 2030, 2040, 2050, 2075, 2100)                                                                                                                                                                  |\n",
+       "| Wind               | max_speed                    | Max wind speed (IRIS)                                                    | wind/iris/v1/max_speed_{scenario}_{year}                                          | historical (2010), SSP119 (2050), SSP245 (2050), SSP585 (2050)                                                                                                                                                                                            |"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "display(Markdown(style + md))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.8"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/docs/images/Logo.png b/docs/images/Logo.png
deleted file mode 100644
index 1352b108561d8d3894d311e736619781b46e41da..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 18549
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
bjaxEQ7;&#9QRSMbBec!I-UTQ><rV!ep1n0n

diff --git a/docs/index.rst b/docs/index.rst
index ebc910ca..01839add 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,7 +1,7 @@
-Physrisk documentation
+Documentation for physrisk
 ========================================
 
-This website contains the documentation for Physrisk, a calculation engine for Physical Climate Risk.
+This website contains the documentation for physrisk, a calculation engine for physical climate risk.
 
 
 .. _cards-clickable:
@@ -62,24 +62,28 @@ This website contains the documentation for Physrisk, a calculation engine for P
       ^^^
       API reference derived from code.
 
-Physical Risk and Resilience
+Physical risk and resilience
 =============================
 
 Physrisk is a library for assessing the physical effects of climate change and thereby the potential benefit of measures to improve resilience.
 Physrisk is primarily designed to run 'bottom-up' calculations that model the impact of climate hazards on large numbers of individual assets
-(including natural) and operations. These calculations can be used to assess financial risks or socio-economic impacts. To do this physrisk collects:
+(including natural). These calculations can be used to assess financial risks or socio-economic impacts. To do this physrisk collects:
 
 - hazard indicators and
-- models of vulnerability of assets/operations to hazards.
+- models of the vulnerability of assets to hazards.
 
-Hazard indicators are on-boarded from public resources or inferred from climate projections, e.g. from CMIP or CORDEX data sets. Indicators are created from code in the
-[hazard repo](https://github.com/os-climate/hazard) to make calculations as transparent as possible.
+Hazard indicators, that is quantities that quantify a hazard, are on-boarded from public data sets or inferred from climate projections, e.g. from CMIP or CORDEX data sets. In both cases, indicator data is created from code in the
+`hazard repo <https://github.com/os-climate/hazard>`_, open-source to make the data lineage as transparent as possible.
 
-Physrisk is also designed to be a hosted, e.g. to provide on-demand calculations. [physrisk-api](https://github.com/os-climate/physrisk-api) and [physrisk-ui](https://github.com/os-climate/physrisk-ui) provide an example API and user interface.
-A [development version of the UI](https://physrisk-ui-sandbox.apps.odh-cl1.apps.os-climate.org) is hosted by OS-Climate.
+The `physrisk repo <https://github.com/os-climate/physrisk>`_ contains the main calculation engine. 
 
-Please also see the `OSC webpage <https://os-climate.org/physical-risk-resilience/>`_
+Physrisk is also designed to be a hosted, e.g. to provide on-demand calculations; the project is a co-operative of members some of whom need to integrate physical risk calculation into other systems. `physrisk-api <https://github.com/os-climate/physrisk-api>`_ and `physrisk-ui <https://github.com/os-climate/physrisk-ui>`_ provide an example API and user interface.
 
+A `development or 'sandbox' version of the UI <https://physrisk-ui-sandbox.apps.odh-cl1.apps.os-climate.org>`_ is hosted by OS-Climate. Although used for demonstration and test, this is a useful way to explore the available hazard data.
+
+Also see the `OSC webpage <https://os-climate.org/physical-risk-resilience/>`_
+
+The getting-started section contains a number of examples that provide a walk-through of physrisk's functionality, via API then running locally. The methodology document gives a more detailed introduction to the subject and describes the models in more formal detail. The user-guide describes the design and conventions of physrisk and implementation detail for sourcing hazard indicator and vulnerability data; it is there, and in the code, that the details of data sources can be found.
 
 .. image:: images/PRR-5.jpg
   :width: 800
@@ -97,9 +101,9 @@ Contents
 .. toctree::
   :maxdepth: 2
 
-  getting-started
+  getting_started/getting_started.rst
   methodology
-  user-guide
+  user_guide/user_guide.rst
   api/physrisk
 
 Indices and tables
diff --git a/docs/methodology.rst b/docs/methodology.rst
index 1242d9d7..7d26d76d 100644
--- a/docs/methodology.rst
+++ b/docs/methodology.rst
@@ -1,5 +1,5 @@
 =================================
-Physical Climate Risk methodology
+Physical climate risk methodology
 =================================
 
 :download:`Download PDF <../methodology/PhysicalRiskMethodology.pdf>`
diff --git a/docs/references.bib b/docs/references.bib
new file mode 100644
index 00000000..e69de29b
diff --git a/docs/user_guide/hazard_indicators/hazard_indicators.rst b/docs/user_guide/hazard_indicators/hazard_indicators.rst
new file mode 100644
index 00000000..57c22dab
--- /dev/null
+++ b/docs/user_guide/hazard_indicators/hazard_indicators.rst
@@ -0,0 +1,9 @@
+Hazard indicators
+=================
+
+The following sections discuss hazard indicators.
+
+.. toctree::
+   :maxdepth: 2
+
+   indicators
\ No newline at end of file
diff --git a/docs/user_guide/hazard_indicators/indicators.ipynb b/docs/user_guide/hazard_indicators/indicators.ipynb
new file mode 100644
index 00000000..596cc8fc
--- /dev/null
+++ b/docs/user_guide/hazard_indicators/indicators.ipynb
@@ -0,0 +1,24 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hazard indicator conventions"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.10.8"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/docs/user_guide/hosting/hosting.rst b/docs/user_guide/hosting/hosting.rst
new file mode 100644
index 00000000..fb191fe7
--- /dev/null
+++ b/docs/user_guide/hosting/hosting.rst
@@ -0,0 +1,8 @@
+Hosting physrisk
+================
+The following sections provide an overview of hosting physrisk.
+
+.. toctree::
+   :maxdepth: 2
+
+   overview
\ No newline at end of file
diff --git a/docs/user_guide/hosting/overview.ipynb b/docs/user_guide/hosting/overview.ipynb
new file mode 100644
index 00000000..40fd7411
--- /dev/null
+++ b/docs/user_guide/hosting/overview.ipynb
@@ -0,0 +1,22 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hosting physrisk\n",
+    "\n",
+    "The physrisk library is designed to be hosted as a service. The [phsrisk-api project](https://github.com/os-climate/physrisk-api) provides an example as to how this can be done.\n",
+    "\n",
+    "\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/docs/user-guide/introduction.ipynb b/docs/user_guide/introduction.ipynb
similarity index 99%
rename from docs/user-guide/introduction.ipynb
rename to docs/user_guide/introduction.ipynb
index b68f5c8c..8a4418ec 100644
--- a/docs/user-guide/introduction.ipynb
+++ b/docs/user_guide/introduction.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Introduction to Physrisk\n",
+    "# Introduction to physrisk\n",
     "\n",
     "## A brief overview\n",
     "Physrisk comprises:\n",
diff --git a/docs/user-guide.rst b/docs/user_guide/user_guide.rst
similarity index 83%
rename from docs/user-guide.rst
rename to docs/user_guide/user_guide.rst
index 62820d72..7515d120 100644
--- a/docs/user-guide.rst
+++ b/docs/user_guide/user_guide.rst
@@ -7,7 +7,11 @@ The following sections document the structures and conventions of Physrisk and a
 
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
+
+   introduction
+   hazard_indicators/hazard_indicators
+   vulnerability/vulnerability
+   hosting/hosting
+
 
-   user-guide/introduction
-   user-guide/vulnerability_config
diff --git a/docs/user_guide/vulnerability/vulnerability.rst b/docs/user_guide/vulnerability/vulnerability.rst
new file mode 100644
index 00000000..87b7903e
--- /dev/null
+++ b/docs/user_guide/vulnerability/vulnerability.rst
@@ -0,0 +1,11 @@
+Vulnerability
+=============
+The following sections provide an overview of how vulnerability models can be created in physrisk. For the most part, this is now done via *vulnerability configuration* that is described in the next section. It is possible to define custom vulnerability models in code but this is typically only needed for special cases.
+
+Vulnerability configuration is generated programmatically from a number of different sources. Notebooks can be created for each family of vulnerability curves to document how this is done.
+
+.. toctree::
+   :maxdepth: 2
+
+   vulnerability_config
+   vulnerability_uncertainty
\ No newline at end of file
diff --git a/docs/user-guide/vulnerability_config.ipynb b/docs/user_guide/vulnerability/vulnerability_config.ipynb
similarity index 99%
rename from docs/user-guide/vulnerability_config.ipynb
rename to docs/user_guide/vulnerability/vulnerability_config.ipynb
index 5694f3a6..02398012 100644
--- a/docs/user-guide/vulnerability_config.ipynb
+++ b/docs/user_guide/vulnerability/vulnerability_config.ipynb
@@ -45,18 +45,18 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Damage/disruption function specification\n",
+    "### Damage/disruption function specification\n",
     "\n",
     "The scheme is designed to allow uncertainly in damage/disruption functions to be specified as well as the deterministic case comprising hazard indicator ($x$) values and the corresponding impact (damage/disruption) ($y$) values. This can be captured by $x$ and $y$ fields each containing an array. A third $z$ field to capture information about the uncertainty in the vulnerability functions.\n",
     "\n",
-    "### Case 1: deterministic damage curve provided\n",
+    "#### Case 1: deterministic damage curve provided\n",
     "The hazard indicator values, $x_i$, are given, $i \\in [1 \\dots n]$ and the corresponding impacts $y_i$.\n",
     "\n",
     "$x = [x_1, x_2, \\dots, x_n]$  \n",
     "$y = [y_1, y_2, \\dots, y_n]$  \n",
     "$z$ is empty\n",
     "\n",
-    "### Case 2: mean and standard deviation provided\n",
+    "#### Case 2: mean and standard deviation provided\n",
     "The hazard indicator values, $x_i$, are given, $i \\in [1 \\dots n]$.\n",
     "\n",
     "$f_i(y) =  \\mathbb{P}(Y=y|x_i)$      \n",
@@ -69,7 +69,7 @@
     "$y = [\\mu_1, \\mu_2, \\dots, \\mu_n ]$  \n",
     "$z = [\\sigma_1, \\sigma_2, \\dots, \\sigma_n ]$\n",
     "\n",
-    "### Case 3: discrete piece-wise linear cumulative density function (CDF) provided\n",
+    "#### Case 3: discrete piece-wise linear cumulative density function (CDF) provided\n",
     "The hazard indicator values, $x_i$, are given, $i \\in [1 \\dots n]$.\n",
     "\n",
     "$F_i(y) = \\mathbb{P}(Y \\leq y|x_i)$\n",
@@ -103,7 +103,7 @@
     "from plotly.subplots import make_subplots\n",
     "\n",
     "plotly.io.renderers.default = \"notebook\"\n",
-    "from physrisk.vulnerability_models.config_based_model import config_items_from_csv, config_items_to_df"
+    "from physrisk.vulnerability_models.config_based_impact_curves import config_items_from_csv, config_items_to_df"
    ]
   },
   {
@@ -322,9 +322,9 @@
     {
      "data": {
       "text/html": [
-       "<div>                            <div id=\"5c6f62a3-b0a7-48a6-bf6d-965a026371fc\" class=\"plotly-graph-div\" style=\"height:525px; width:100%;\"></div>            <script type=\"text/javascript\">                require([\"plotly\"], function(Plotly) {                    window.PLOTLYENV=window.PLOTLYENV || {};                                    if (document.getElementById(\"5c6f62a3-b0a7-48a6-bf6d-965a026371fc\")) {                    Plotly.newPlot(                        \"5c6f62a3-b0a7-48a6-bf6d-965a026371fc\",                        [{\"name\":\"Example damage curve\",\"x\":[0.05,0.5,1.0,1.5,2.0,3.0,4.0,5.0,6.0],\"y\":[0.0,0.25,0.4,0.5,0.6,0.75,0.85,0.95,1.0],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"Example threshold curve\",\"x\":[15.0,25.0,35.0,45.0,55.0,65.0],\"y\":[0.0,0.1,0.25,0.5,0.8,1.0],\"type\":\"scatter\",\"xaxis\":\"x2\",\"yaxis\":\"y2\"}],                        {\"template\":{\"data\":{\"histogram2dcontour\":[{\"type\":\"histogram2dcontour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"choropleth\":[{\"type\":\"choropleth\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"histogram2d\":[{\"type\":\"histogram2d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmap\":[{\"type\":\"heatmap\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmapgl\":[{\"type\":\"heatmapgl\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"contourcarpet\":[{\"type\":\"contourcarpet\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"contour\":[{\"type\":\"contour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"surface\":[{\"type\":\"surface\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"mesh3d\":[{\"type\":\"mesh3d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"scatter\":[{\"fillpattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2},\"type\":\"scatter\"}],\"parcoords\":[{\"type\":\"parcoords\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolargl\":[{\"type\":\"scatterpolargl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"bar\":[{\"error_x\":{\"color\":\"#2a3f5f\"},\"error_y\":{\"color\":\"#2a3f5f\"},\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"bar\"}],\"scattergeo\":[{\"type\":\"scattergeo\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolar\":[{\"type\":\"scatterpolar\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"histogram\":[{\"marker\":{\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"histogram\"}],\"scattergl\":[{\"type\":\"scattergl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatter3d\":[{\"type\":\"scatter3d\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattermapbox\":[{\"type\":\"scattermapbox\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterternary\":[{\"type\":\"scatterternary\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattercarpet\":[{\"type\":\"scattercarpet\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"carpet\":[{\"aaxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"baxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"type\":\"carpet\"}],\"table\":[{\"cells\":{\"fill\":{\"color\":\"#EBF0F8\"},\"line\":{\"color\":\"white\"}},\"header\":{\"fill\":{\"color\":\"#C8D4E3\"},\"line\":{\"color\":\"white\"}},\"type\":\"table\"}],\"barpolar\":[{\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"barpolar\"}],\"pie\":[{\"automargin\":true,\"type\":\"pie\"}]},\"layout\":{\"autotypenumbers\":\"strict\",\"colorway\":[\"#636efa\",\"#EF553B\",\"#00cc96\",\"#ab63fa\",\"#FFA15A\",\"#19d3f3\",\"#FF6692\",\"#B6E880\",\"#FF97FF\",\"#FECB52\"],\"font\":{\"color\":\"#2a3f5f\"},\"hovermode\":\"closest\",\"hoverlabel\":{\"align\":\"left\"},\"paper_bgcolor\":\"white\",\"plot_bgcolor\":\"#E5ECF6\",\"polar\":{\"bgcolor\":\"#E5ECF6\",\"angularaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"radialaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"ternary\":{\"bgcolor\":\"#E5ECF6\",\"aaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"baxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"caxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"coloraxis\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"colorscale\":{\"sequential\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"sequentialminus\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"diverging\":[[0,\"#8e0152\"],[0.1,\"#c51b7d\"],[0.2,\"#de77ae\"],[0.3,\"#f1b6da\"],[0.4,\"#fde0ef\"],[0.5,\"#f7f7f7\"],[0.6,\"#e6f5d0\"],[0.7,\"#b8e186\"],[0.8,\"#7fbc41\"],[0.9,\"#4d9221\"],[1,\"#276419\"]]},\"xaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"yaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"scene\":{\"xaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"yaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"zaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2}},\"shapedefaults\":{\"line\":{\"color\":\"#2a3f5f\"}},\"annotationdefaults\":{\"arrowcolor\":\"#2a3f5f\",\"arrowhead\":0,\"arrowwidth\":1},\"geo\":{\"bgcolor\":\"white\",\"landcolor\":\"#E5ECF6\",\"subunitcolor\":\"white\",\"showland\":true,\"showlakes\":true,\"lakecolor\":\"white\"},\"title\":{\"x\":0.05},\"mapbox\":{\"style\":\"light\"}}},\"xaxis\":{\"anchor\":\"y\",\"domain\":[0.0,0.45],\"title\":{\"text\":\"Flood depth (m)\",\"font\":{\"size\":14}}},\"yaxis\":{\"anchor\":\"x\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Damage as fraction of insurable value\",\"font\":{\"size\":14}}},\"xaxis2\":{\"anchor\":\"y2\",\"domain\":[0.55,1.0],\"title\":{\"text\":\"Threshold (\\u00b0C)\",\"font\":{\"size\":14}}},\"yaxis2\":{\"anchor\":\"x2\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Fractional loss of production\",\"font\":{\"size\":14}}}},                        {\"responsive\": true}                    ).then(function(){\n",
+       "<div>                            <div id=\"1f1fb95c-1ffe-4eae-b304-17932e665b9c\" class=\"plotly-graph-div\" style=\"height:525px; width:100%;\"></div>            <script type=\"text/javascript\">                require([\"plotly\"], function(Plotly) {                    window.PLOTLYENV=window.PLOTLYENV || {};                                    if (document.getElementById(\"1f1fb95c-1ffe-4eae-b304-17932e665b9c\")) {                    Plotly.newPlot(                        \"1f1fb95c-1ffe-4eae-b304-17932e665b9c\",                        [{\"name\":\"Example damage curve\",\"x\":[0.05,0.5,1.0,1.5,2.0,3.0,4.0,5.0,6.0],\"y\":[0.0,0.25,0.4,0.5,0.6,0.75,0.85,0.95,1.0],\"type\":\"scatter\",\"xaxis\":\"x\",\"yaxis\":\"y\"},{\"name\":\"Example threshold curve\",\"x\":[15.0,25.0,35.0,45.0,55.0,65.0],\"y\":[0.0,0.1,0.25,0.5,0.8,1.0],\"type\":\"scatter\",\"xaxis\":\"x2\",\"yaxis\":\"y2\"}],                        {\"template\":{\"data\":{\"histogram2dcontour\":[{\"type\":\"histogram2dcontour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"choropleth\":[{\"type\":\"choropleth\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"histogram2d\":[{\"type\":\"histogram2d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmap\":[{\"type\":\"heatmap\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"heatmapgl\":[{\"type\":\"heatmapgl\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"contourcarpet\":[{\"type\":\"contourcarpet\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"contour\":[{\"type\":\"contour\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"surface\":[{\"type\":\"surface\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"},\"colorscale\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]]}],\"mesh3d\":[{\"type\":\"mesh3d\",\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}],\"scatter\":[{\"fillpattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2},\"type\":\"scatter\"}],\"parcoords\":[{\"type\":\"parcoords\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolargl\":[{\"type\":\"scatterpolargl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"bar\":[{\"error_x\":{\"color\":\"#2a3f5f\"},\"error_y\":{\"color\":\"#2a3f5f\"},\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"bar\"}],\"scattergeo\":[{\"type\":\"scattergeo\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterpolar\":[{\"type\":\"scatterpolar\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"histogram\":[{\"marker\":{\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"histogram\"}],\"scattergl\":[{\"type\":\"scattergl\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatter3d\":[{\"type\":\"scatter3d\",\"line\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattermapbox\":[{\"type\":\"scattermapbox\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scatterternary\":[{\"type\":\"scatterternary\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"scattercarpet\":[{\"type\":\"scattercarpet\",\"marker\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}}}],\"carpet\":[{\"aaxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"baxis\":{\"endlinecolor\":\"#2a3f5f\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"minorgridcolor\":\"white\",\"startlinecolor\":\"#2a3f5f\"},\"type\":\"carpet\"}],\"table\":[{\"cells\":{\"fill\":{\"color\":\"#EBF0F8\"},\"line\":{\"color\":\"white\"}},\"header\":{\"fill\":{\"color\":\"#C8D4E3\"},\"line\":{\"color\":\"white\"}},\"type\":\"table\"}],\"barpolar\":[{\"marker\":{\"line\":{\"color\":\"#E5ECF6\",\"width\":0.5},\"pattern\":{\"fillmode\":\"overlay\",\"size\":10,\"solidity\":0.2}},\"type\":\"barpolar\"}],\"pie\":[{\"automargin\":true,\"type\":\"pie\"}]},\"layout\":{\"autotypenumbers\":\"strict\",\"colorway\":[\"#636efa\",\"#EF553B\",\"#00cc96\",\"#ab63fa\",\"#FFA15A\",\"#19d3f3\",\"#FF6692\",\"#B6E880\",\"#FF97FF\",\"#FECB52\"],\"font\":{\"color\":\"#2a3f5f\"},\"hovermode\":\"closest\",\"hoverlabel\":{\"align\":\"left\"},\"paper_bgcolor\":\"white\",\"plot_bgcolor\":\"#E5ECF6\",\"polar\":{\"bgcolor\":\"#E5ECF6\",\"angularaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"radialaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"ternary\":{\"bgcolor\":\"#E5ECF6\",\"aaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"baxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"},\"caxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\"}},\"coloraxis\":{\"colorbar\":{\"outlinewidth\":0,\"ticks\":\"\"}},\"colorscale\":{\"sequential\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"sequentialminus\":[[0.0,\"#0d0887\"],[0.1111111111111111,\"#46039f\"],[0.2222222222222222,\"#7201a8\"],[0.3333333333333333,\"#9c179e\"],[0.4444444444444444,\"#bd3786\"],[0.5555555555555556,\"#d8576b\"],[0.6666666666666666,\"#ed7953\"],[0.7777777777777778,\"#fb9f3a\"],[0.8888888888888888,\"#fdca26\"],[1.0,\"#f0f921\"]],\"diverging\":[[0,\"#8e0152\"],[0.1,\"#c51b7d\"],[0.2,\"#de77ae\"],[0.3,\"#f1b6da\"],[0.4,\"#fde0ef\"],[0.5,\"#f7f7f7\"],[0.6,\"#e6f5d0\"],[0.7,\"#b8e186\"],[0.8,\"#7fbc41\"],[0.9,\"#4d9221\"],[1,\"#276419\"]]},\"xaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"yaxis\":{\"gridcolor\":\"white\",\"linecolor\":\"white\",\"ticks\":\"\",\"title\":{\"standoff\":15},\"zerolinecolor\":\"white\",\"automargin\":true,\"zerolinewidth\":2},\"scene\":{\"xaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"yaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2},\"zaxis\":{\"backgroundcolor\":\"#E5ECF6\",\"gridcolor\":\"white\",\"linecolor\":\"white\",\"showbackground\":true,\"ticks\":\"\",\"zerolinecolor\":\"white\",\"gridwidth\":2}},\"shapedefaults\":{\"line\":{\"color\":\"#2a3f5f\"}},\"annotationdefaults\":{\"arrowcolor\":\"#2a3f5f\",\"arrowhead\":0,\"arrowwidth\":1},\"geo\":{\"bgcolor\":\"white\",\"landcolor\":\"#E5ECF6\",\"subunitcolor\":\"white\",\"showland\":true,\"showlakes\":true,\"lakecolor\":\"white\"},\"title\":{\"x\":0.05},\"mapbox\":{\"style\":\"light\"}}},\"xaxis\":{\"anchor\":\"y\",\"domain\":[0.0,0.45],\"title\":{\"text\":\"Flood depth (m)\",\"font\":{\"size\":14}}},\"yaxis\":{\"anchor\":\"x\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Damage as fraction of insurable value\",\"font\":{\"size\":14}}},\"xaxis2\":{\"anchor\":\"y2\",\"domain\":[0.55,1.0],\"title\":{\"text\":\"Threshold (\\u00b0C)\",\"font\":{\"size\":14}}},\"yaxis2\":{\"anchor\":\"x2\",\"domain\":[0.0,1.0],\"title\":{\"text\":\"Fractional loss of production\",\"font\":{\"size\":14}}},\"legend\":{\"orientation\":\"h\"}},                        {\"responsive\": true}                    ).then(function(){\n",
        "                            \n",
-       "var gd = document.getElementById('5c6f62a3-b0a7-48a6-bf6d-965a026371fc');\n",
+       "var gd = document.getElementById('1f1fb95c-1ffe-4eae-b304-17932e665b9c');\n",
        "var x = new MutationObserver(function (mutations, observer) {{\n",
        "        var display = window.getComputedStyle(gd).display;\n",
        "        if (!display || display === 'none') {{\n",
@@ -358,24 +358,13 @@
     "c2 = next(c for c in config_items if c.asset_class == \"ManufacturingAsset\" and c.indicator_id==\"days_tas/above/{temp_c}c\")\n",
     "\n",
     "fig1 = make_subplots(rows=1, cols=2)\n",
-    "fig1.add_trace(\n",
-    "    go.Scatter(x=c1.points_x, y=c1.points_y, name=\"Example damage curve\"),\n",
-    "    row=1,\n",
-    "    col=1,\n",
-    ")\n",
-    "fig1.add_trace(\n",
-    "    go.Scatter(x=c2.points_x, y=c2.points_y, name=\"Example threshold curve\"),\n",
-    "    row=1,\n",
-    "    col=2,\n",
-    ")\n",
-    "fig1.update_xaxes(\n",
-    "    title=\"Flood depth (m)\", title_font={\"size\": 14}, row=1, col=1\n",
-    ")\n",
-    "fig1.update_xaxes(\n",
-    "    title=\"Threshold (°C)\", title_font={\"size\": 14}, row=1, col=2\n",
-    ")\n",
+    "fig1.add_scatter(x=c1.points_x, y=c1.points_y, name=\"Example damage curve\", row=1, col=1)\n",
+    "fig1.add_scatter(x=c2.points_x, y=c2.points_y, name=\"Example threshold curve\", row=1, col=2)\n",
+    "fig1.update_xaxes(title=\"Flood depth (m)\", title_font={\"size\": 14}, row=1, col=1)\n",
+    "fig1.update_xaxes(title=\"Threshold (°C)\", title_font={\"size\": 14}, row=1, col=2)\n",
     "fig1.update_yaxes(title=\"Damage as fraction of insurable value\", title_font={\"size\": 14}, row=1, col=1)\n",
-    "fig1.update_yaxes(title=\"Fractional loss of production\", title_font={\"size\": 14}, row=1, col=2)"
+    "fig1.update_yaxes(title=\"Fractional loss of production\", title_font={\"size\": 14}, row=1, col=2)\n",
+    "fig1.update_layout(legend=dict(orientation=\"h\"))"
    ]
   }
  ],
diff --git a/docs/vulnerability_functions/inundation_jrc/onboard.ipynb b/docs/user_guide/vulnerability/vulnerability_functions/inundation_jrc/onboard.ipynb
similarity index 100%
rename from docs/vulnerability_functions/inundation_jrc/onboard.ipynb
rename to docs/user_guide/vulnerability/vulnerability_functions/inundation_jrc/onboard.ipynb
diff --git a/docs/vulnerability_functions/inundation_jrc/raw.csv b/docs/user_guide/vulnerability/vulnerability_functions/inundation_jrc/raw.csv
similarity index 100%
rename from docs/vulnerability_functions/inundation_jrc/raw.csv
rename to docs/user_guide/vulnerability/vulnerability_functions/inundation_jrc/raw.csv
diff --git a/docs/vulnerability_functions/multi_hazard_wri_power_generating_assets/WRI thermal power plant physical climate vulnerability factors.json b/docs/user_guide/vulnerability/vulnerability_functions/multi_hazard_wri_power_generating_assets/WRI thermal power plant physical climate vulnerability factors.json
similarity index 100%
rename from docs/vulnerability_functions/multi_hazard_wri_power_generating_assets/WRI thermal power plant physical climate vulnerability factors.json
rename to docs/user_guide/vulnerability/vulnerability_functions/multi_hazard_wri_power_generating_assets/WRI thermal power plant physical climate vulnerability factors.json
diff --git a/docs/vulnerability_functions/multi_hazard_wri_power_generating_assets/onboard.ipynb b/docs/user_guide/vulnerability/vulnerability_functions/multi_hazard_wri_power_generating_assets/onboard.ipynb
similarity index 100%
rename from docs/vulnerability_functions/multi_hazard_wri_power_generating_assets/onboard.ipynb
rename to docs/user_guide/vulnerability/vulnerability_functions/multi_hazard_wri_power_generating_assets/onboard.ipynb
diff --git a/docs/vulnerability_functions/multi_hazard_wri_power_generating_assets/raw.csv b/docs/user_guide/vulnerability/vulnerability_functions/multi_hazard_wri_power_generating_assets/raw.csv
similarity index 100%
rename from docs/vulnerability_functions/multi_hazard_wri_power_generating_assets/raw.csv
rename to docs/user_guide/vulnerability/vulnerability_functions/multi_hazard_wri_power_generating_assets/raw.csv
diff --git a/docs/vulnerability_functions/wind_eberenz/Table_A2_Impact_Function_Slope.csv b/docs/user_guide/vulnerability/vulnerability_functions/wind_eberenz/Table_A2_Impact_Function_Slope.csv
similarity index 100%
rename from docs/vulnerability_functions/wind_eberenz/Table_A2_Impact_Function_Slope.csv
rename to docs/user_guide/vulnerability/vulnerability_functions/wind_eberenz/Table_A2_Impact_Function_Slope.csv
diff --git a/docs/vulnerability_functions/wind_eberenz/Table_S2_V_half_individual_fitting_per_event.csv b/docs/user_guide/vulnerability/vulnerability_functions/wind_eberenz/Table_S2_V_half_individual_fitting_per_event.csv
similarity index 100%
rename from docs/vulnerability_functions/wind_eberenz/Table_S2_V_half_individual_fitting_per_event.csv
rename to docs/user_guide/vulnerability/vulnerability_functions/wind_eberenz/Table_S2_V_half_individual_fitting_per_event.csv
diff --git a/docs/vulnerability_functions/wind_eberenz/onboard.ipynb b/docs/user_guide/vulnerability/vulnerability_functions/wind_eberenz/onboard.ipynb
similarity index 100%
rename from docs/vulnerability_functions/wind_eberenz/onboard.ipynb
rename to docs/user_guide/vulnerability/vulnerability_functions/wind_eberenz/onboard.ipynb
diff --git a/docs/user-guide/vulnerability_uncertainty.ipynb b/docs/user_guide/vulnerability/vulnerability_uncertainty.ipynb
similarity index 99%
rename from docs/user-guide/vulnerability_uncertainty.ipynb
rename to docs/user_guide/vulnerability/vulnerability_uncertainty.ipynb
index f0c370e9..79ef91d2 100644
--- a/docs/user-guide/vulnerability_uncertainty.ipynb
+++ b/docs/user_guide/vulnerability/vulnerability_uncertainty.ipynb
@@ -4,13 +4,13 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Uncertainty in vulnerability functions\n",
+    "## Uncertainty in vulnerability functions\n",
     "Uncertainty in vulnerability functions can be specified in the vulnerability configuration.\n",
     "\n",
-    "## Deterministic case\n",
+    "### Deterministic case\n",
     "In the deterministic case, that is when there is no uncertainty, the vulnerability function is simply a curve. The hazard indicator values, $x_i$ $i \\in [1 \\dots n]$ are provided with the corresponding impacts (damage/disruption) $y_i$.\n",
     "\n",
-    "## Generical case\n",
+    "### General case\n",
     "In the general case, the hazard indicator values are provided in exactly the same way, but instead of a single impact for each value $x_i$, a cumulative probability density function (CDF) is specified. For a hazard indicator value $x$ that lies between two 'pillar values', the impact would be found in the deterministic case by linear interpolation. In the general case, it is the *CDFs* that are interpolated. \n",
     "\n",
     "The CDFs are specified in a non-parametric way with the cumulative probabilities provided for hazard indicator value $x_i$ for a number of impact pillar values $y_j$.\n",
diff --git a/pdm.lock b/pdm.lock
index 717f7b00..3f1ed053 100644
--- a/pdm.lock
+++ b/pdm.lock
@@ -5,7 +5,7 @@
 groups = ["default", "dev", "doc", "test"]
 strategy = ["inherit_metadata"]
 lock_version = "4.5.0"
-content_hash = "sha256:0ae4c9e8a64a7576986285c6634c580569e175548a0255bd72a5005a0419a7ba"
+content_hash = "sha256:65289094fb74402b5debf6a831ac19dc26582502834c128cb7269a03d485fde1"
 
 [[metadata.targets]]
 requires_python = ">=3.9,<3.11"
@@ -2297,6 +2297,21 @@ files = [
     {file = "platformdirs-4.3.6.tar.gz", hash = "sha256:357fb2acbc885b0419afd3ce3ed34564c13c9b95c89360cd9563f73aa5e2b907"},
 ]
 
+[[package]]
+name = "plotly"
+version = "5.24.1"
+requires_python = ">=3.8"
+summary = "An open-source, interactive data visualization library for Python"
+groups = ["doc"]
+dependencies = [
+    "packaging",
+    "tenacity>=6.2.0",
+]
+files = [
+    {file = "plotly-5.24.1-py3-none-any.whl", hash = "sha256:f67073a1e637eb0dc3e46324d9d51e2fe76e9727c892dde64ddf1e1b51f29089"},
+    {file = "plotly-5.24.1.tar.gz", hash = "sha256:dbc8ac8339d248a4bcc36e08a5659bacfe1b079390b8953533f4eb22169b4bae"},
+]
+
 [[package]]
 name = "pluggy"
 version = "1.5.0"
@@ -3502,6 +3517,17 @@ files = [
     {file = "tabulate-0.9.0.tar.gz", hash = "sha256:0095b12bf5966de529c0feb1fa08671671b3368eec77d7ef7ab114be2c068b3c"},
 ]
 
+[[package]]
+name = "tenacity"
+version = "9.0.0"
+requires_python = ">=3.8"
+summary = "Retry code until it succeeds"
+groups = ["doc"]
+files = [
+    {file = "tenacity-9.0.0-py3-none-any.whl", hash = "sha256:93de0c98785b27fcf659856aa9f54bfbd399e29969b0621bc7f762bd441b4539"},
+    {file = "tenacity-9.0.0.tar.gz", hash = "sha256:807f37ca97d62aa361264d497b0e31e92b8027044942bfa756160d908320d73b"},
+]
+
 [[package]]
 name = "tinycss2"
 version = "1.3.0"
diff --git a/pyproject.toml b/pyproject.toml
index c12aef16..f6ca5f17 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -110,6 +110,7 @@ doc = [
     "sphinx_design",
     "sphinx_rtd_theme",
     "graphviz",
+    "plotly>=5.24.1",
 ]
 dev = [
     "mypy",