update from develop

Author: EddyCMWF

.gitignore

@@ -159,6 +159,4 @@ cython_debug/
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-.idea/
-
-_build
+#.idea/

C3S–POS–LINE.png

@@ -1,8 +1,6 @@
 # c3s-training
-
 Master repository for the notebooks to be included in the C3S JupyterBook
-
-## C3SBook
+# C3SBook
 
 This repository contains a book of notebooks generated with Jupyter Book. Below are the instructions for working with this project, including how the structure of the notebooks works and how to perform the build and deploy process of the book.
 
@@ -34,40 +32,10 @@ ghp-import -n -p -f _build/html
 # Run our notebooks
 
 In the `notebooks` folder, you'll find all the Jupyter notebooks.
-
-Additionally, there's a `environment.yml` file, containing the conda channels and a list of python dependencies needed for running our notebooks, as presented in the example below
-
+Additionally, there's a `requirements.txt` file included, containing the necessary Python libraries for running the notebooks. You can install all the required libraries by executing the following command in your terminal:
 
 ```bash
-name: example-environment
-channels:
-  - conda-forge
-  - defaults
-dependencies:
-  - numpy == 1.26.4
-  - cdsapi == 0.6.1
-  - pandas == 2.1.4
-  - netCDF4 == 1.6.2
-  - dask == 2023.11.0
-  - xarray == 2023.6.0 
-  - matplotlib == 3.8.0 
-  - cartopy == 0.22.0
-  - jupyterlab==4.3.4
-  - myst-parser==4.0.0
+pip install -r requirements.txt
 ```
 
-The first line of the environment.yml file sets the new environment’s name and you can activate this environment by executing the following commands in your terminal:
-
-
-```bash
-conda env create -f environment.yml
-conda activate example-environment
-```
-To verify that the environment is installed correctly and check the list of environments available you can execute  
-
-```bash
-conda env list
-```
-
-
 To run the notebooks on your local machine, please refer to [C3S Book:How to run these tutorials ](https://ecmwf-training.github.io/c3s-training/how-to-run-these-tutorials.html) section for detailed instructions.

LogoLine_EC_Cop_ECMWF.png

@@ -1,7 +1,7 @@
 # Book settings
 # Learn more at https://jupyterbook.org/customize/config.html
 
-title: Copernicus Climate Change Service (C3S) training book
+title: Copernicus Climate Change Service (C3S) Training Book
 author: the Copernicus Climate Change Service (C3S), entrusted to ECMWF (European Centre for Medium-Range Weather Forecasts)
 
 # Force re-execution of notebooks on each build.
@@ -18,24 +18,19 @@ latex:
 # Information about where the book exists on the web
 repository:
   url: https://github.com/ecmwf-training/C3S-training # Online location of your book
-  branch: main # Which branch of the repository should be used when creating links (optional)
+  branch: develop # Which branch of the repository should be used when creating links (optional)
 
 # Add GitHub buttons to your book
 # See https://jupyterbook.org/customize/config.html#add-a-link-to-your-repository
 html:
   use_issues_button: true
   use_repository_button: true
-  announcement: "⚠️This is a TEST version, this is not an official website⚠️"
+  announcement: "⚠️This is a TEST Version, this is not an official website⚠️"
   extra_footer: |
     <script src="_static/custom.js"></script>
 
+launch_buttons:
+  binderhub_url: "https://mybinder.org" # The URL for your BinderHub (e.g., https://mybinder.org)
+
 exclude_patterns: ["**.ipynb_checkpoints", "**README.md"]
 
-launch_buttons:
-  notebook_interface: "jupyterlab"  # or "classic"
-  #  WAITING FOR JUPYTERHUB TO BE READY:
-  # jupyterhub_url: "https://jupyterhub.ecmwf.int"
-  binderhub_url: "https://mybinder.org"  # The URL for your BinderHub (e.g., https://mybinder.org)
-  #  COLAB AND DEEPNOTE NOT COMPATIBLE WITH SUBMODULES
-  # colab_url: "https://colab.research.google.com"  # The URL for Google Colab (e.g., https://colab.research.google.com)
-  # deepnote_url: "https://deepnote.com"  # The URL for Deepnote (e.g., https://deepnote.com)

README.md

@@ -10,117 +10,100 @@ parts:
         title: How to run these tutorials
   - caption: Tutorials
     chapters:
-      - file: observations/intro
-        title: Observations 
-        sections:
-          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/intro
-            title: Satellite observations - atmospheric physics
-            sections:
-              # ERB
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/erb-outgoing-longwave-radiation
-                title: Outgoing longwave radiation
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/erb-clara-climatology
-                title: Analysis of the CLARA Earth radiation budget product
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/erb-ceres-climatology
-                title: Analysis of the CERES Earth radiation budget product
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/total-solar-irradiance
-                title: Total solar irradiance
-              # SRB
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/srb-climatology-and-anomaly
-                title: Surface radiation budget climatologies and anomalies
-              # Atmos Humidity and Cloud
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/cloud-cover-climatology
-                title: Cloud fractional cover climatology
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/total-column-water-vapour-combi
-                title: Total column water vapour
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/tropospheric-humidity-from-radio-occultation
-                title: Tropospheric humidity estimates from satellite-based radio occultation measurements
-              # Precipitation
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/precipitation-giraffe
-                title: Exploring precipitation information in the GIRAFFE dataset
-          - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/intro
-            title: Satellite observations - atmospheric composition  
-            sections:
-              # Ozone
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/total-ozone-columns
-                title: Total ozone columns
-              # # GHG
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/greenhouse-gases-level2-products
-                title: Greenhouse gas level 2 products
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/greenhouse-gases-level3-products
-                title: Greenhouse gas level 3 products
-              # # Aerosol
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/aerosol-single-sensor-demonstrator
-                title: Exploration of the aerosol properties products
-              - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/aerosol-multi-sensor-record
-                title: A multi-sensor climate data record of aerosol properties
-          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/intro
-            title: Satellite observations - hydrology and cryosphere
-            sections:
-          #     #Surface Water      
-              - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/soil-moisture-anomalies
-                title: Soil moisture anomaly analysis
-              - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/lake-water-level
-                title: Lake water level timeseries
-              - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/lake-surface-water-temperature
-                title: Lake surface water temperature analysis
-          #     #Ice Sheets
-          #     - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/ice-sheet-surface-elevation
-          #       title: Ice sheet surface elevation
-              - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/ice-sheet-velocity
-                title: Ice sheet velocity
-              - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/ice-sheet-mass-balance
-                title: Ice sheet mass balance
-              - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/glacier-mass-change
-                title: Glacier mass change
-          - file: submodules/c3s-training-submodule-sat-obs-ocean/intro
-            title: Satellite observations - Ocean
-            sections:
-              - file: submodules/c3s-training-submodule-sat-obs-ocean/viewer-for-sealevel-product
-                title: Sea level and surface currents
-              - file: submodules/c3s-training-submodule-sat-obs-ocean/ocean-colour-sea-surface-temperature
-                title: Ocean colour and sea surface temperature
-          - file: submodules/c3s-training-submodule-sat-obs-land/intro
-            title: Satellite observations - Land
-            sections:
-              - file: submodules/c3s-training-submodule-sat-obs-land/lai-fapar-mean-with-inverse-variance-weights
-                title: Time average of LAI and fAPAR using inverse variance weights
-              - file: submodules/c3s-training-submodule-sat-obs-land/exploring-surface-albedo
-                title: Exploring surface albedo
       - file: submodules/c3s-training-submodule-reanalysis/intro
         title: Reanalysis 
         sections:
           - file: submodules/c3s-training-submodule-reanalysis/reanalysis-climatology
             title: Climatology
           - file: submodules/c3s-training-submodule-reanalysis/reanalysis-heatwave
-            title: Heatwave analysis
+            title: Heatwave Analysis
           - file: submodules/c3s-training-submodule-reanalysis/reanalysis-temp-record
-            title: Temperature record
-      - file: submodules/c3s-training-submodule-seasonal-forecast/intro
-        title: Seasonal forecasts 
-        sections:
-          - file: submodules/c3s-training-submodule-seasonal-forecast/sf-anomalies
-            title: Seasonal forecast anomalies
-          - file: submodules/c3s-training-submodule-seasonal-forecast/sf-verification
-            title: Seasonal forecast verification
+            title: Temperature Record
       - file: submodules/c3s-training-submodule-projections/intro
-        title: Climate projections 
+        title: Climate Projections 
         sections:
           - file: submodules/c3s-training-submodule-projections/projections-cmip6
-            title: Global climate projections (CMIP6)
+            title: Global Climate Projections (CMIP6)
           - file: submodules/c3s-training-submodule-projections/projections-cordex
-            title: Regional climate projections (CORDEX)
+            title: Regional Climate Projections (CORDEX)
+      - file: submodules/c3s-training-submodule-seasonal-forecast/intro
+        title: Seasonal Forecasts 
+        sections:
+          - file: submodules/c3s-training-submodule-seasonal-forecast/sf-anomalies
+            title: Seasonal Forecast Anomalies
+          - file: submodules/c3s-training-submodule-seasonal-forecast/sf-verification
+            title: Seasonal Forecast Verification
       - file: submodules/c3s-training-submodule-climate-indices/intro
-        title: Climate indicators
+        title: Climate Indices 
         sections:
           - file: submodules/c3s-training-submodule-climate-indices/ci-windchill
             title: Windchill
-          - file: submodules/c3s-training-submodule-climate-indices/warm-and-wet-days-indicator
-            title: Warm and wet days indicator
-          - file: submodules/c3s-training-submodule-climate-indices/gtsmip-water-levels
-            title: Coastal water levels and storm surges
+      - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/intro
+        title: Satellite Observations - Atmospheric Physic  
+        sections:
+          # ERB
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/erb-outgoing-longwave-radiation
+            title: Outgoing Longwave Radiation
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/erb-clara-climatology
+            title: Analysis of the CLARA Earth radiation budget product
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/erb-ceres-climatology
+            title: Analysis of the CERES Earth radiation budget product
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/total-solar-irradiance
+            title: Total Solar Irradiance
+          # SRB
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/srb-climatology-and-anomaly
+            title: Surface radiation budget climatologies and anomalies
+          # Atmos Humidity and Cloud
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/total-column-water-vapour-combi
+            title: Total column water vapour
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/tropospheric-humidity-from-radio-occultation
+            title: Tropospheric humidity estimates from satellite-based radio occultation measurements
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/cloud-cover-climatology
+            title: Cloud fractional cover climatology
+          # Precipitation
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-physics/precipitation-giraffe
+            title: Exploring Precipitation information in the GIRAFFE dataset
+      - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/intro
+        title: Satellite Observations - Atmospheric Composition  
+        sections:
+          # GHG
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/greenhouse-gases-level2-products
+            title: Greenhouse Gas Level 2 Products
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/greenhouse-gases-level3-products
+            title: Greenhouse Gas Level 3 Products
+          # Aerosol
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/aerosol-single-sensor-demonstrator
+            title: Aerosol Single Sensor Demonstrator
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/aerosol-multi-sensor-record
+            title: Aerosol Multi-Sensor Record
+          # Ozone
+          - file: submodules/c3s-training-submodule-sat-obs-atmos-comp/total-ozone-columns
+            title: Total Ozone Columns
+      - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/intro
+        title: Satellite Observations - Hydrology and Cryosphere
+        sections:
+          #Surface Water      
+          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/soil-moisture-anomalies
+            title: Soil Moisture Anomaly Analysis
+          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/lake-water-level
+            title: Lake Water Level Timeseries
+          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/lake-surface-water-temperature
+            title: Lake Surface Water Temperature Analysis
+          #Ice Sheets
+          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/ice-sheet-surface-elevation
+            title: Ice Sheet Surface Elevation
+          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/ice-sheet-velocity
+            title: Ice Sheet Velocity
+          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/ice-sheet-mass-balance
+            title: Ice Sheet Mass Balance
+          - file: submodules/c3s-training-submodule-sat-obs-hydro-cryo/glacier-mass-change
+            title: Glacier Mass Change
+      #- file: submodules/c3s-training-submodule-sat-obs-ocean/intro
+      #  title: Satellite Observations - Ocean
+      #- file: submodules/c3s-training-submodule-sat-obs-land/intro
+      #  title: Satellite Observations - Land
       - file: submodules/copernicus-emergency-service-tutorial/intro
-        title: Tutorials using Copernicus emergency management service data
+        title: Tutorials using Copernicus Emergency Management Service data
         sections:
           - file: submodules/visualising-fwi-for-esotc/visualising-fwi-for-esotc
             title: Visualising fire weather index (FWI)
@@ -132,10 +115,10 @@ parts:
   - caption: ECMWF
     chapters:
       - url: https://climate.copernicus.eu/help-and-support
-        title: Help & support
+        title: Help & Support
       - url: https://climate.copernicus.eu/
         title: Copernicus Climate Change Service (C3S)
       - url: https://cds.climate.copernicus.eu/
         title: Copernicus Climate Data Store (CDS)
       - url: https://climate.copernicus.eu/user-learning-services/
-        title: C3S learning services
+        title: C3S Learning Services

_config.yml

@@ -1,48 +1,25 @@
 # Developer instructions
 
-## Updating the submodules
-
-This repository does not automatically update the submodules, this is intentional and is to ensure that
-the content is updated periodically and with the approval of the owners.
-
-The following commands will update all the submodules to the current HEAD of the "main" branch.
-
-```
-# Change to submodule directory
-cd submodules
-
-# Update all submodules
-./update-submodules 
-
-# If happy with updates, git add, commit and push
-git add .
-git commit -m"Update submodules"
-git push
-```
-
-## Build the JupyterBook locally
-
-### Create a JUPYTER-BUILD environment with dependencies installed:
+# Create a JUPYTER-BUILD environment with dependencies installed:
 
 ```
 . ./developer/create-environment-for-build
 ```
 
-### Rebuild jupyter book
+## Rebuild jupyter book
 
 ```
 rm -rf _build
 jupyter-book build --all .
 ```
 
-### View local build
+## Copy to gh-pages
 
 ```
-open _build/html/index.html
+ghp-import -n -p -f _build/html
 ```
 
 
-
 ## Troubleshooting notes
 
-1. Multiple Level 1 Headers (#) in a notebook seems to break the _toc definition of title. It is also bad practice so discourage.
+1. Multiple Level 1 Headers (#) in a notebook seems to break the _toc definition of title. It is also bad practice so discourage.