Merge branch 'main' into feat/add-s1-slc-burst-selection-notebook

Author: clausmichele

.github/workflows/pre-commit.yaml

@@ -28,7 +28,7 @@ exclude: "generate_gallery.py"
 repos:
   # Autoformat and lint Python code (exclude notebooks from ruff-format)
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.6
+    rev: v0.15.7
     hooks:
       - id: ruff
         types_or: [python, jupyter]
@@ -45,7 +45,7 @@ repos:
 
   # Autoformat and linting, misc. details
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v6.0.0
     hooks:
       - id: end-of-file-fixer
       - id: requirements-txt-fixer
@@ -54,21 +54,21 @@ repos:
 
   # Black for Python files
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.8.0
+    rev: 26.3.1
     hooks:
       - id: black
         types: [python]
 
   # Black for Jupyter notebooks
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.8.0
+    rev: 26.3.1
     hooks:
       - id: black-jupyter
         types: [jupyter]
 
   # NBQA for notebook-specific black formatting
   - repo: https://github.com/nbQA-dev/nbQA
-    rev: 1.9.0
+    rev: 1.9.1
     hooks:
       - id: nbqa-black
         types: [jupyter]

.pre-commit-config.yaml

@@ -70,7 +70,7 @@ const plugin = {
           jupyterHubUrl =
             "https://jupyterhub.user.eopf.eodc.eu/hub/login?next=" +
             encodeURIComponent(spawn_next) +
-            "%23fancy-forms-config=%7B%22profile%22%3A%22choose-your-environment%22%2C%22image%22%3A%22unlisted_choice%22%2C%22image%3Aunlisted_choice%22%3A%22yuvraj1989%2Feopf-zarr-driver%3Alatest%22%2C%20%22autoStart%22%3A%22true%22%7D";
+            "%23fancy-forms-config=%7B%22profile%22%3A%22choose-your-environment%22%2C%22image%22%3A%22unlisted_choice%22%2C%22image%3Aunlisted_choice%22%3A%22yuvraj1989%2Feopf-zarr-driver%3A4.1%22%2C%20%22autoStart%22%3A%22true%22%7D";
         } else {
           jupyterHubUrl =
             "https://jupyterhub.user.eopf.eodc.eu/hub/login?next=" +

add-jupyterhub-button.mjs

@@ -172,6 +172,12 @@ const plugin = {
               description:
                 "Notebooks demonstrating XArray, GDAL, XCube, Zarr, and more",
             },
+            {
+              title: "🔧 Tutorials",
+              link: "gallery-tutorials",
+              description:
+                "Notebooks demonstrating the main workflows for accessing and working with the data.",
+            },
           ];
 
           const cards = categories.map((cat) => ({
@@ -304,6 +310,8 @@ function getTagIcon(tag) {
     gdal: "🗺️",
     stac: "📋",
     zarr: "📦",
+    dask: "🧮",
+    basic: "👶",
   };
   return icons[tag] || "🏷️";
 }

gallery-page.mjs

@@ -286,19 +286,61 @@ def generate_gallery_pages(notebook_tags, output_dir="notebooks"):
     # Generate main gallery index
     with open(f"{output_dir}/gallery.md", "w") as f:
         f.write("""---
-title: Notebook Gallery
+title: Gallery
 ---
 
-# Notebook Gallery
+## How to run the notebooks
 
-```{gallery-grid}
-:category: all
-:columns: 1 1 2 3
-```
+The notebooks can be run on the **EOPF Sentinel Zarr Samples JupyterHub**. Each notebook integrates a Launch in JupyterHub button.
+
+![Screenshot: Launch Notebook button](static/launch_notebook.jpg)
+
+---
+
+Click **Sign in with CDSE IdP** to proceed.
+
+You will be redirected to the CDSE login page:
+
+![Screenshot: CDSE Login Page](static/CDSE_login.png)
+
+---
+
+Please log in using your **CDSE user account**.  
+If you do not have one, create one now, it's free!
+
+Once logged in, you will be able to run your notebook in JupyterLab!
+
+---
+
+If you encounter any problem or have suggestions, please let us know on GitHub, opening a new issue [here](https://github.com/EOPF-Sample-Service/eopf-sample-notebooks/issues).
 
-""")
 
-        f.write("<!-- Generated by gallery plugin -->\n")
+## Notebooks Gallery
+
+Click on the category to explore the corresponding notebooks!
+
+### Sentinel Data
+<a class="link" href="gallery-sentinel#sentinel-1" ><p style="background-color:white;"><span class="gallery-tag tag-sentinel-1">🛰️ sentinel-1</span></p></a>
+<a class="link" href="gallery-sentinel#sentinel-2" ><p style="background-color:white;"><span class="gallery-tag tag-sentinel-2">🛰️ sentinel-2</span></p></a>
+<a class="link" href="gallery-sentinel#sentinel-3" ><p style="background-color:white;"><span class="gallery-tag tag-sentinel-3">🛰️ sentinel-3</span></p></a>
+                
+### Application Topics
+<a class="link" href="gallery-topics#land-applications" ><p style="background-color:white;"><span class="gallery-tag tag-land">🌱 land</span></p></a>
+<a class="link" href="gallery-topics#climate-monitoring" ><p style="background-color:white;"><span class="gallery-tag tag-climate-change">🌡️ climate-change</span></p></a>
+<a class="link" href="gallery-topics#marine-applications" ><p style="background-color:white;"><span class="gallery-tag tag-marine">🌊 marine</span></p></a>
+<a class="link" href="gallery-topics#emergency-and-security-applications" ><p style="background-color:white;"><span class="gallery-tag tag-security">🔒 security</span></p></a>
+
+### Tools & Libraries
+<a class="link" href="gallery-tools/#xarray" ><p style="background-color:white;"><span class="gallery-tag tag-xarray">📊 xarray</span></p></a>
+<a class="link" href="gallery-tools/#xarray-eopf-plugin" ><p style="background-color:white;"><span class="gallery-tag tag-xarray-eopf">🔌 xarray-eopf</span></p></a>
+<a class="link" href="gallery-tools/#xcube-eopf-plugin" ><p style="background-color:white;"><span class="gallery-tag tag-xcube">🏷️ xcube</span></p></a>
+<a class="link" href="gallery-tools/#gdal" ><p style="background-color:white;"><span class="gallery-tag tag-gdal">🗺️ gdal</span></p></a>
+
+### Basic Tutorials
+<a class="link" href="gallery-tutorials/#dask" ><p style="background-color:white;"><span class="gallery-tag tag-dask">🧮 dask</span></p></a>
+<a class="link" href="gallery-tutorials/#basic-data-access" ><p style="background-color:white;"><span class="gallery-tag tag-basic">👶 basic</span></p></a>
+
+""")
 
     # Generate Sentinel category page
     with open(categories["sentinel"]["file"], "w") as f:
@@ -308,6 +350,10 @@ def generate_gallery_pages(notebook_tags, output_dir="notebooks"):
 
 # {categories["sentinel"]["title"]}
 
+<a class="link" href="gallery-sentinel#sentinel-1" ><p style="background-color:white;"><span class="gallery-tag tag-sentinel-1">🛰️ sentinel-1</span></p></a>
+<a class="link" href="gallery-sentinel#sentinel-2" ><p style="background-color:white;"><span class="gallery-tag tag-sentinel-2">🛰️ sentinel-2</span></p></a>
+<a class="link" href="gallery-sentinel#sentinel-3" ><p style="background-color:white;"><span class="gallery-tag tag-sentinel-3">🛰️ sentinel-3</span></p></a>
+
 {categories["sentinel"]["description"]}
 
 ## Sentinel-1
@@ -341,6 +387,12 @@ def generate_gallery_pages(notebook_tags, output_dir="notebooks"):
 
 # {categories["topics"]["title"]}
 
+<a class="link" href="gallery-topics#land-applications" ><p style="background-color:white;"><span class="gallery-tag tag-land">🌱 land</span></p></a>
+<a class="link" href="gallery-topics#climate-monitoring" ><p style="background-color:white;"><span class="gallery-tag tag-climate-change">🌡️ climate-change</span></p></a>
+<a class="link" href="gallery-topics#marine-applications" ><p style="background-color:white;"><span class="gallery-tag tag-marine">🌊 marine</span></p></a>
+<a class="link" href="gallery-topics#emergency-and-security-applications" ><p style="background-color:white;"><span class="gallery-tag tag-security">🔒 security</span></p></a>
+
+
 {categories["topics"]["description"]}
 
 ## Land Applications
@@ -381,6 +433,11 @@ def generate_gallery_pages(notebook_tags, output_dir="notebooks"):
 
 # {categories["tools"]["title"]}
 
+<a class="link" href="gallery-tools/#xarray" ><p style="background-color:white;"><span class="gallery-tag tag-xarray">📊 xarray</span></p></a>
+<a class="link" href="gallery-tools/#xarray-eopf-plugin" ><p style="background-color:white;"><span class="gallery-tag tag-xarray-eopf">🔌 xarray-eopf</span></p></a>
+<a class="link" href="gallery-tools/#xcube-eopf-plugin" ><p style="background-color:white;"><span class="gallery-tag tag-xcube">🏷️ xcube</span></p></a>
+<a class="link" href="gallery-tools/#gdal" ><p style="background-color:white;"><span class="gallery-tag tag-gdal">🗺️ gdal</span></p></a>
+
 {categories["tools"]["description"]}
 
 ## Xarray
@@ -422,27 +479,31 @@ def generate_gallery_pages(notebook_tags, output_dir="notebooks"):
 
     # Generate Tutorials category page
     with open(categories["tutorials"]["file"], "w") as f:
-        f.write("""---
-title: Tutorials
+        f.write(f"""---
+title: {categories["tutorials"]["title"]}
 ---
 
-# Tutorials
+# {categories["tutorials"]["title"]}
 
-Notebooks demonstrating the main workflows for accessing and working with the data
+<a class="link" href="gallery-tutorials/#dask" ><p style="background-color:white;"><span class="gallery-tag tag-dask">🧮 dask</span></p></a>
+<a class="link" href="gallery-tutorials/#basic-data-access" ><p style="background-color:white;"><span class="gallery-tag tag-basic">👶 basic</span></p></a>
+
+{categories["tutorials"]["description"]}
 
 ## Dask
 
-```{gallery-grid}
+```{{gallery-grid}}
 :category: dask
 :columns: 1 1 2 3
 ```
 
 ## Basic Data Access
 
-```{gallery-grid}
+```{{gallery-grid}}
 :category: basic
 :columns: 1 1 2 3
 ```
+
         """)
 
 

generate_gallery.py

@@ -21,7 +21,7 @@ project:
   license:
     content: CC-BY-4.0
     code: Apache-2.0
-  copyright: "2025"
+  copyright: "2026"
   toc:
     # Main navigation
     - file: notebooks/README.md
@@ -67,12 +67,13 @@ project:
         - file: notebooks/Sentinel-1/Sentinel-1_Soil_moisture.ipynb
         - file: notebooks/Sentinel-3/GDAL_Sentinel-3_Multi-Product-Demo.ipynb
         - file: notebooks/Sentinel-1/GDAL_Sentinel-1_SLC_Burst_Selection.ipynb
+        - file: notebooks/Sentinel-1/GDAL_Sentinel-1_GCP_Geolocation.ipynb
 
     # Gallery categories (visible in navigation)
-    - file: notebooks/gallery-tutorials.md
     - file: notebooks/gallery-sentinel.md
     - file: notebooks/gallery-topics.md
     - file: notebooks/gallery-tools.md
+    - file: notebooks/gallery-tutorials.md
   subject: earth and related environmental sciences
 
 site: