Chardata plus encoded datasets

.github/workflows/benchmarks_report.yml

@@ -54,7 +54,7 @@ jobs:
           echo "reports_exist=$reports_exist" >> "$GITHUB_OUTPUT"
 
       - name: Store artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: benchmark_reports
           path: benchmark_reports
@@ -68,7 +68,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Download artifact
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           name: benchmark_reports
           path: .github/workflows/benchmark_reports

.github/workflows/benchmarks_run.yml

@@ -157,15 +157,15 @@ jobs:
       - name: Upload any benchmark reports
         # Uploading enables more downstream processing e.g. posting a PR comment.
         if: success() || steps.overnight.outcome == 'failure'
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: benchmark_reports
           path: .github/workflows/benchmark_reports
 
       - name: Archive asv results
         # Store the raw ASV database(s) to help manual investigations.
         if: ${{ always() }}
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: asv-raw-results
           path: benchmarks/.asv/results

.github/workflows/ci-linkchecks.yml

@@ -23,7 +23,7 @@ jobs:
 
       - name: Link Checker
         id: lychee
-        uses: lycheeverse/lychee-action@a8c4c7cb88f0c7386610c35eb25108e448569cb0
+        uses: lycheeverse/lychee-action@8646ba30535128ac92d33dfc9133794bfdd9b411
         with:
           token: ${{secrets.GITHUB_TOKEN}}
           fail: false

.github/workflows/ci-manifest.yml

@@ -23,4 +23,4 @@ concurrency:
 jobs:
   manifest:
     name: "check-manifest"
-    uses: scitools/workflows/.github/workflows/ci-manifest.yml@2026.01.0
+    uses: scitools/workflows/.github/workflows/ci-manifest.yml@2026.03.2

.github/workflows/ci-template-check.yml

@@ -10,7 +10,7 @@ on:
 
 jobs:
   prompt-share:
-    uses: scitools/workflows/.github/workflows/ci-template-check.yml@2026.01.0
+    uses: scitools/workflows/.github/workflows/ci-template-check.yml@2026.03.2
     secrets: inherit
     with:
       pr_number: ${{ github.event.pull_request.number }}

.github/workflows/ci-tests.yml

@@ -35,18 +35,18 @@ jobs:
       fail-fast: false
       matrix:
         os: ["ubuntu-latest"]
-        python-version: ["3.13"]
+        python-version: ["3.14"]
         session: ["doctest", "gallery"]
         include:
           - os: "ubuntu-latest"
-            python-version: "3.13"
+            python-version: "3.14"
             session: "tests"
             coverage: "--coverage"
           - os: "ubuntu-latest"
-            python-version: "3.12"
+            python-version: "3.13"
             session: "tests"
           - os: "ubuntu-latest"
-            python-version: "3.11"
+            python-version: "3.12"
             session: "tests"
 
     env:

.github/workflows/ci-wheels.yml

@@ -37,7 +37,7 @@ jobs:
       run: |
         pipx run build
 
-    - uses: actions/upload-artifact@v6
+    - uses: actions/upload-artifact@v7
       with:
         name: pypi-artifacts
         path: ${{ github.workspace }}/dist/*
@@ -52,7 +52,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.12", "3.13", "3.14"]
         session: ["wheel"]
     env:
       ENV_NAME: "ci-wheels"
@@ -61,7 +61,7 @@ jobs:
       with:
         fetch-depth: 0
 
-    - uses: actions/download-artifact@v7
+    - uses: actions/download-artifact@v8
       with:
         name: pypi-artifacts
         path: ${{ github.workspace }}/dist
@@ -116,7 +116,7 @@ jobs:
     name: "show artifacts"
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/download-artifact@v7
+    - uses: actions/download-artifact@v8
       with:
         name: pypi-artifacts
         path: ${{ github.workspace }}/dist
@@ -137,7 +137,7 @@ jobs:
     # and check for the SciTools repo
     if: github.event_name == 'push' && github.event.ref == 'refs/heads/main' && github.repository_owner == 'SciTools'
     steps:
-    - uses: actions/download-artifact@v7
+    - uses: actions/download-artifact@v8
       with:
         name: pypi-artifacts
         path: ${{ github.workspace }}/dist
@@ -159,7 +159,7 @@ jobs:
     # upload to PyPI for every tag starting with 'v'
     if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags/v') && github.repository_owner == 'SciTools'
     steps:
-    - uses: actions/download-artifact@v7
+    - uses: actions/download-artifact@v8
       with:
         name: pypi-artifacts
         path: ${{ github.workspace }}/dist

.github/workflows/refresh-lockfiles.yml

@@ -14,5 +14,5 @@ on:
 
 jobs:
   refresh_lockfiles:
-    uses: scitools/workflows/.github/workflows/refresh-lockfiles.yml@2026.01.0
+    uses: scitools/workflows/.github/workflows/refresh-lockfiles.yml@2026.03.2
     secrets: inherit

.lycheeignore

@@ -4,16 +4,17 @@ file:///
 # DEAD : legacy in various old whatsnews
 https://biggus.readthedocs.io
 
-# unkown problem, works in browser : used in further_topics/ugrid/data_model
+# unknown problem, works in browser : used in
+#  docs/src/user_manual/explanation/mesh_data_model.rst
 https://doi.org/10.3390/jmse2010194
 
-# DEAD, todo:remove, used in docs/src/userguide/plotting_a_cube.rst
+# DEAD, todo:remove, used in docs/src/user_manual/tutorial/plotting_a_cube.rst
 https://effbot.org
 
 # nonfunctional, found in some code examples
 https://foo/
 
-# DEAD, todo:remove, used in docs/src/further_topics/ugrid/data_model.rst
+# DEAD, todo:remove, used in docs/src/user_manual/explanation/mesh_data_model.rst
 https://ibm-design-language.eu-de.mybluemix.net/design/language/resources/color-library
 
 # DEAD, legacy in whatsnew/1.4.rst
@@ -45,14 +46,14 @@ https://stickler-ci.com
 # DEAD, todo:remove, used in lib/iris/symbols.py
 https://www.wmo.int/pages/prog/www/DPFS/documents/485_Vol_I_en_colour.pdf
 
-# DEAD, todo:remove, used in docs/src/userguide/plotting_a_cube.rst
+# DEAD, todo:remove, used in docs/src/user_manual/tutorial/plotting_a_cube.rst
 # unkown problem, works in browser : used in docs/src/index.rst
 https://www.flaticon.com
 
 # nonfunctional example, used in lib/iris/io/__init__.py
 https://www.thing.com
 
-# DEAD, todo:remove, used in docs/src/userguide/plotting_a_cube.rst
+# DEAD, todo:remove, used in docs/src/user_manual/tutorial/plotting_a_cube.rst
 https://www.personal.psu.edu/cab38/ColorBrewer/ColorBrewer_updates.html
 
 # nonfunctional, found in some code examples

.pre-commit-config.yaml

@@ -35,7 +35,7 @@ repos:
     -   id: no-commit-to-branch
 
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.14.10"
+    rev: "v0.15.4"
     hooks:
     -   id: ruff
         types: [file, python]

.readthedocs.yml

@@ -23,7 +23,7 @@ conda:
 
 sphinx:
   configuration: docs/src/conf.py
-  fail_on_warning: false
+  fail_on_warning: true
 
 python:
   install:

.ruff.toml

@@ -96,7 +96,7 @@ lint.ignore = [
 
     # flake8-pytest-style (PT)
     # https://docs.astral.sh/ruff/rules/#flake8-pytest-style-pt
-    "PT",
+    "PT019",
 
     # flake8-raise (RSE)
     # https://docs.astral.sh/ruff/rules/#flake8-raise-rse

benchmarks/bm_runner.py

@@ -67,7 +67,7 @@ def _check_requirements(package: str) -> None:
 
 def _prep_data_gen_env() -> None:
     """Create or access a separate, unchanging environment for generating test data."""
-    python_version = "3.13"
+    python_version = "3.14"
     data_gen_var = "DATA_GEN_PYTHON"
     if data_gen_var in environ:
         echo("Using existing data generation environment.")

docs/gallery_code/general/plot_SOI_filtering.py

@@ -2,6 +2,11 @@
 Applying a Filter to a Time-Series
 ==================================
 
+.. how-to:: Applying a Filter to a Time-Series
+   :tags: topic_plotting;topic_maths_stats
+
+   How to apply a low pass filter to an Iris Cube via rolling_window().
+
 This example demonstrates low pass filtering a time-series by applying a
 weighted running mean over the time dimension.
 

docs/gallery_code/general/plot_anomaly_log_colouring.py

@@ -2,6 +2,11 @@
 Colouring Anomaly Data With Logarithmic Scaling
 ===============================================
 
+.. how-to:: Colouring Anomaly Data With Logarithmic Scaling
+   :tags: topic_plotting;topic_maths_stats
+
+   How to visualise values using a logarithmic scale.
+
 In this example, we need to plot anomaly data where the values have a
 "logarithmic" significance  -- i.e. we want to give approximately equal ranges
 of colour between data values of, say, 1 and 10 as between 10 and 100.

docs/gallery_code/general/plot_coriolis.py

@@ -2,6 +2,11 @@
 Deriving the Coriolis Frequency Over the Globe
 ==============================================
 
+.. how-to:: Deriving the Coriolis Frequency Over the Globe
+   :tags: topic_plotting;topic_data_model
+
+   How to create your own Cube from computed data and visualise it.
+
 This code computes the Coriolis frequency and stores it in a cube with
 associated metadata. It then plots the Coriolis frequency on an orthographic
 projection.

docs/gallery_code/general/plot_cross_section.py

@@ -2,6 +2,11 @@
 Cross Section Plots
 ===================
 
+.. how-to:: Cross Section Plots
+   :tags: topic_plotting;topic_slice_combine
+
+   How to visualise cross-sections of multi-dimensional Cubes.
+
 This example demonstrates contour plots of a cross-sectioned multi-dimensional
 cube which features a hybrid height vertical coordinate system.
 

docs/gallery_code/general/plot_custom_aggregation.py

@@ -2,6 +2,11 @@
 Calculating a Custom Statistic
 ==============================
 
+.. how-to:: Calculating a Custom Statistic
+   :tags: topic_plotting;topic_maths_stats
+
+   How to define and use a custom aggregation operation, including visualisation.
+
 This example shows how to define and use a custom
 :class:`iris.analysis.Aggregator`, that provides a new statistical operator for
 use with cube aggregation functions such as :meth:`~iris.cube.Cube.collapsed`,

docs/gallery_code/general/plot_custom_file_loading.py

@@ -2,6 +2,11 @@
 Loading a Cube From a Custom File Format
 ========================================
 
+.. how-to:: Loading a Cube From a Custom File Format
+   :tags: topic_plotting;topic_load_save
+
+   How to visualise data from a file Iris does not natively support.
+
 This example shows how a custom text file can be loaded using the standard Iris
 load mechanism.
 

docs/gallery_code/general/plot_global_map.py

@@ -2,6 +2,11 @@
 Quickplot of a 2D Cube on a Map
 ===============================
 
+.. how-to:: Quickplot of a 2D Cube on a Map
+   :tags: topic_plotting
+
+   A demonstration of basic iris.quickplot use.
+
 This example demonstrates a contour plot of global air temperature. The plot
 title and the labels for the axes are automatically derived from the metadata.
 

docs/gallery_code/general/plot_inset.py

@@ -2,6 +2,11 @@
 Test Data Showing Inset Plots
 =============================
 
+.. how-to:: Test Data Showing Inset Plots
+   :tags: topic_plotting;topic_maths_stats
+
+   How to create inset plots within a main plot.
+
 This example demonstrates the use of a single 3D data cube with time, latitude
 and longitude dimensions to plot a temperature series for a single latitude
 coordinate, with an inset plot of the data region.

docs/gallery_code/general/plot_lineplot_with_legend.py

@@ -2,6 +2,11 @@
 Multi-Line Temperature Profile Plot
 ===================================
 
+.. how-to:: Multi-Line Temperature Profile Plot
+   :tags: topic_plotting
+
+   How to plot multiple lines on a single plot with a legend.
+
 """  # noqa: D205, D212, D400
 
 import matplotlib.pyplot as plt

docs/gallery_code/general/plot_polar_stereo.py

@@ -2,6 +2,11 @@
 Example of a Polar Stereographic Plot
 =====================================
 
+.. how-to:: Example of a Polar Stereographic Plot
+   :tags: topic_plotting
+
+   A demonstration of plotting data defined on an alternative map projection.
+
 Demonstrates plotting data that are defined on a polar stereographic
 projection.
 

docs/gallery_code/general/plot_polynomial_fit.py

@@ -2,6 +2,11 @@
 Fitting a Polynomial
 ====================
 
+.. how-to:: Fitting a Polynomial
+   :tags: topic_plotting;topic_maths_stats;topic_data_model
+
+   How to compute and plot a polynomial fit to 1D data in an Iris cube.
+
 This example demonstrates computing a polynomial fit to 1D data from an Iris
 cube, adding the fit to the cube's metadata, and plotting both the 1D data and
 the fit.

docs/gallery_code/general/plot_projections_and_annotations.py

@@ -2,6 +2,11 @@
 Plotting in Different Projections
 =================================
 
+.. how-to:: Plotting in Different Projections
+   :tags: topic_plotting;topic_interoperability
+
+   How to overlay data from two different map projections and add graphics.
+
 This example shows how to overlay data and graphics in different projections,
 demonstrating various features of Iris, Cartopy and matplotlib.
 

docs/gallery_code/general/plot_rotated_pole_mapping.py

@@ -2,6 +2,11 @@
 Rotated Pole Mapping
 ====================
 
+.. how-to:: Rotated Pole Mapping
+   :tags: topic_plotting
+
+   How to visualise data via different methods and coordinate systems.
+
 This example uses several visualisation methods to achieve an array of
 differing images, including:
 

docs/gallery_code/general/plot_zonal_means.py

@@ -2,6 +2,11 @@
 Zonal Mean Diagram of Air Temperature
 =====================================
 
+.. how-to:: Zonal Mean Diagram of Air Temperature
+   :tags: topic_plotting;topic_maths_stats
+
+   How to use aligned plots to visualise collapsed dimensional statistics.
+
 This example demonstrates aligning a linear plot and a cartographic plot
 using Matplotlib.
 

docs/gallery_code/meteorology/plot_COP_1d.py

@@ -2,6 +2,11 @@
 Global Average Annual Temperature Plot
 ======================================
 
+.. how-to:: Global Average Annual Temperature Plot
+   :tags: topic_plotting;topic_slice_combine;topic_maths_stats
+
+   How to spatially constrain data, compute statistics and visualise a comparison.
+
 Produces a time-series plot of North American temperature forecasts for 2
 different emission scenarios. Constraining data to a limited spatial area also
 features in this example.