From 6f5f4db66cf87cd2e1ed8963c07086259d3d414c Mon Sep 17 00:00:00 2001 From: Martin Yeo <40734014+trexfeathers@users.noreply.github.com> Date: Tue, 17 Mar 2026 15:41:55 +0000 Subject: [PATCH 1/2] Whats-New updates for v3.15.0rc0 . (#6986) --- docs/src/whatsnew/{latest.rst => 3.15.rst} | 61 +++++++++--- docs/src/whatsnew/index.rst | 4 +- docs/src/whatsnew/latest.rst.template | 107 --------------------- 3 files changed, 49 insertions(+), 123 deletions(-) rename docs/src/whatsnew/{latest.rst => 3.15.rst} (73%) delete mode 100644 docs/src/whatsnew/latest.rst.template diff --git a/docs/src/whatsnew/latest.rst b/docs/src/whatsnew/3.15.rst similarity index 73% rename from docs/src/whatsnew/latest.rst rename to docs/src/whatsnew/3.15.rst index 4988eca6e0..b6c4fa4e43 100644 --- a/docs/src/whatsnew/latest.rst +++ b/docs/src/whatsnew/3.15.rst @@ -1,21 +1,45 @@ .. include:: ../common_links.inc -|iris_version| |build_date| [unreleased] -**************************************** +v3.15 (17 Mar 2026 [release candidate]) +*************************************** This document explains the changes made to Iris for this release (:doc:`View all changes `.) -.. dropdown:: |iris_version| Release Highlights +.. dropdown:: v3.15 Release Highlights :color: primary :icon: info :animate: fade-in :open: - The highlights for this major/minor release of Iris include: + The highlights for this minor release of Iris include: - * N/A + * Overhauling the user documentation structure to maximise discoverability + and engagement with user needs going forward. + + * NIMROD loader improvements to expand the types of NIMROD files Iris can load. + + * Documentation page explaining how to access files in S3 buckets. + + * Compatibility with Pandas version 3. + + * Several large pieces of work **behind the scenes** to put Iris in the best + possible place for the future. To be continued! + + * Investigating how Iris can provide native `Zarr`_ loading and saving + (beyond what is already possible via `ncdata`_). + + * Completed a 2-year project converting all tests from unittest to pytest, + including compliance with the Ruff `PT` standard. + + * In-progress work to fully support arrays of characters/strings. + + * Investigating how Iris can integrate with the `Pint`_ units library, to + increase interoperability with the wider scientific Python ecosystem. + + * Layout groundwork for making Iris fully Pip-installable, reducing the + dependency footprint and improving handling of optional dependencies. And finally, get in touch with us on :issue:`GitHub` if you have any issues or feature requests for improving Iris. Enjoy! @@ -60,19 +84,27 @@ This document explains the changes made to Iris for this release 🐛 Bugs Fixed ============= -#. N/A +#. `@ukmo-ccbunney`_ changed formatting of numpy scalars attributes when generating a + Cube/Coord summary to use ``str`` representation instead of ``repr``. + (:pull:`6966`, :issue:`6692`) 💣 Incompatible Changes ======================= -#. N/A +#. `@hsteptoe`_ and `@ESadek-MO`_ (reviewer) disabled the ``copy`` behaviour + across :mod:`iris.pandas`, as it is incompatible with Pandas v3 (see + `New pandas v3 copy behaviour`_). The parameter is still present, to help + mitigate disruption, but now marked for deprecation. (:pull:`6948`, + :issue:`6761`) 🚀 Performance Enhancements =========================== -#. N/A +#. Note that ``libnetcdf`` version 4.10.0 (released 25th Feb 2026) improves + NetCDF loading and saving performance, measured between 20-40% in Iris' + benchmarks (:issue:`6984`). 🔥 Deprecations @@ -89,7 +121,8 @@ This document explains the changes made to Iris for this release 🔗 Dependencies =============== -#. N/A +#. `@hsteptoe`_ and `@ESadek-MO`_ (reviewer) made :mod:`iris.pandas` + interoperability compatible with pandas v3. (:pull:`6948`, :issue:`6761`) 📚 Documentation @@ -103,7 +136,8 @@ This document explains the changes made to Iris for this release #. :user:`bjlittle` added the ``:user:`` `extlinks`_ ``github`` user convenience. (:pull:`6931`) -#. `@pp-mo`_ added a page on how to access datafiles in S3 buckets. +#. `@pp-mo`_ added a page on how to access datafiles in S3 buckets: + :doc:`/user_manual/tutorial/s3_io`. (:issue:`6374`, :pull:`6951`) #. `@trexfeathers`_, `@stephenworsley`_, `@ESadek-MO`_ and `@tkknight`_ reorganised **all** @@ -144,10 +178,6 @@ This document explains the changes made to Iris for this release #. `@hsteptoe`_ and `@ESadek-MO`_ (reviewer) added static type hinting to :mod:`iris.pandas`. (:pull:`6948`) -#. `@ukmo-ccbunney`_ changed formatting of numpy scalars attributes when generating a - Cube/Coord summary to use ``str`` representation instead of ``repr``. - (:pull:`6966`, :issue:`6692`) - .. comment Whatsnew author names (@github name) in alphabetical order. Note that, core dev names are automatically included by the common_links.inc: @@ -160,3 +190,6 @@ This document explains the changes made to Iris for this release .. _New pandas v3 copy behaviour: https://pandas.pydata.org/docs/whatsnew/v3.0.0.html#consistent-copy-view-behaviour-with-copy-on-write .. _SPEC0 Minimum Supported Dependencies: https://scientific-python.org/specs/spec-0000/ +.. _Zarr: https://zarr.dev/ +.. _ncdata: https://github.com/SciTools/ncdata +.. _Pint: https://github.com/hgrecco/pint diff --git a/docs/src/whatsnew/index.rst b/docs/src/whatsnew/index.rst index 0e9d1ef6a6..41f2eef0a3 100644 --- a/docs/src/whatsnew/index.rst +++ b/docs/src/whatsnew/index.rst @@ -6,13 +6,13 @@ What's New in Iris ------------------ -.. include:: latest.rst +.. include:: 3.15.rst .. toctree:: :maxdepth: 1 :hidden: - latest.rst + 3.15.rst 3.14.rst 3.13.rst 3.12.rst diff --git a/docs/src/whatsnew/latest.rst.template b/docs/src/whatsnew/latest.rst.template deleted file mode 100644 index fedddec5c0..0000000000 --- a/docs/src/whatsnew/latest.rst.template +++ /dev/null @@ -1,107 +0,0 @@ -.. include:: ../common_links.inc - -|iris_version| |build_date| [unreleased] -**************************************** - -This document explains the changes made to Iris for this release -(:doc:`View all changes `.) - - -.. dropdown:: |iris_version| Release Highlights - :color: primary - :icon: info - :animate: fade-in - :open: - - The highlights for this major/minor release of Iris include: - - * N/A - - And finally, get in touch with us on :issue:`GitHub` if you have - any issues or feature requests for improving Iris. Enjoy! - - -NOTE: section BELOW is a template for bugfix patches -==================================================== - (Please remove this section when creating an initial 'latest.rst') - -|iris_version| |build_date| -=========================== - -.. dropdown:: |iris_version| Patches - :color: primary - :icon: alert - :animate: fade-in - - The patches in this release of Iris include: - - #. N/A - -NOTE: section ABOVE is a template for bugfix patches -==================================================== - (Please remove this section when creating an initial 'latest.rst') - - -📢 Announcements -================ - -#. N/A - - -✨ Features -=========== - -#. N/A - - -🐛 Bugs Fixed -============= - -#. N/A - - -💣 Incompatible Changes -======================= - -#. N/A - - -🚀 Performance Enhancements -=========================== - -#. N/A - - -🔥 Deprecations -=============== - -#. N/A - - -🔗 Dependencies -=============== - -#. N/A - - -📚 Documentation -================ - -#. N/A - - -💼 Internal -=========== - -#. N/A - - -.. comment - Whatsnew author names (@github name) in alphabetical order. Note that, - core dev names are automatically included by the common_links.inc: - - - - -.. comment - Whatsnew resources in alphabetical order: \ No newline at end of file From 877562ee0f61e8e92f97e605d6fcd6fecac3083b Mon Sep 17 00:00:00 2001 From: Martin Yeo Date: Tue, 17 Mar 2026 18:03:41 +0000 Subject: [PATCH 2/2] Restore latest Whats-New files. --- docs/src/whatsnew/index.rst | 3 +- docs/src/whatsnew/latest.rst | 86 +++++++++++++++++++++ docs/src/whatsnew/latest.rst.template | 107 ++++++++++++++++++++++++++ 3 files changed, 195 insertions(+), 1 deletion(-) create mode 100644 docs/src/whatsnew/latest.rst create mode 100644 docs/src/whatsnew/latest.rst.template diff --git a/docs/src/whatsnew/index.rst b/docs/src/whatsnew/index.rst index 41f2eef0a3..b9d5cb59ce 100644 --- a/docs/src/whatsnew/index.rst +++ b/docs/src/whatsnew/index.rst @@ -6,12 +6,13 @@ What's New in Iris ------------------ -.. include:: 3.15.rst +.. include:: latest.rst .. toctree:: :maxdepth: 1 :hidden: + latest.rst 3.15.rst 3.14.rst 3.13.rst diff --git a/docs/src/whatsnew/latest.rst b/docs/src/whatsnew/latest.rst new file mode 100644 index 0000000000..9022446cb8 --- /dev/null +++ b/docs/src/whatsnew/latest.rst @@ -0,0 +1,86 @@ +.. include:: ../common_links.inc + +|iris_version| |build_date| [unreleased] +**************************************** + +This document explains the changes made to Iris for this release +(:doc:`View all changes `.) + + +.. dropdown:: |iris_version| Release Highlights + :color: primary + :icon: info + :animate: fade-in + :open: + + The highlights for this major/minor release of Iris include: + + * N/A + + And finally, get in touch with us on :issue:`GitHub` if you have + any issues or feature requests for improving Iris. Enjoy! + + +📢 Announcements +================ + +#. N/A + + +✨ Features +=========== + +#. N/A + + +🐛 Bugs Fixed +============= + +#. N/A + + +💣 Incompatible Changes +======================= + +#. N/A + + +🚀 Performance Enhancements +=========================== + +#. N/A + + +🔥 Deprecations +=============== + +#. N/A + + +🔗 Dependencies +=============== + +#. N/A + + +📚 Documentation +================ + +#. N/A + + +💼 Internal +=========== + +#. N/A + + +.. comment + Whatsnew author names (@github name) in alphabetical order. Note that, + core dev names are automatically included by the common_links.inc: + + + + +.. comment + Whatsnew resources in alphabetical order: \ No newline at end of file diff --git a/docs/src/whatsnew/latest.rst.template b/docs/src/whatsnew/latest.rst.template new file mode 100644 index 0000000000..fedddec5c0 --- /dev/null +++ b/docs/src/whatsnew/latest.rst.template @@ -0,0 +1,107 @@ +.. include:: ../common_links.inc + +|iris_version| |build_date| [unreleased] +**************************************** + +This document explains the changes made to Iris for this release +(:doc:`View all changes `.) + + +.. dropdown:: |iris_version| Release Highlights + :color: primary + :icon: info + :animate: fade-in + :open: + + The highlights for this major/minor release of Iris include: + + * N/A + + And finally, get in touch with us on :issue:`GitHub` if you have + any issues or feature requests for improving Iris. Enjoy! + + +NOTE: section BELOW is a template for bugfix patches +==================================================== + (Please remove this section when creating an initial 'latest.rst') + +|iris_version| |build_date| +=========================== + +.. dropdown:: |iris_version| Patches + :color: primary + :icon: alert + :animate: fade-in + + The patches in this release of Iris include: + + #. N/A + +NOTE: section ABOVE is a template for bugfix patches +==================================================== + (Please remove this section when creating an initial 'latest.rst') + + +📢 Announcements +================ + +#. N/A + + +✨ Features +=========== + +#. N/A + + +🐛 Bugs Fixed +============= + +#. N/A + + +💣 Incompatible Changes +======================= + +#. N/A + + +🚀 Performance Enhancements +=========================== + +#. N/A + + +🔥 Deprecations +=============== + +#. N/A + + +🔗 Dependencies +=============== + +#. N/A + + +📚 Documentation +================ + +#. N/A + + +💼 Internal +=========== + +#. N/A + + +.. comment + Whatsnew author names (@github name) in alphabetical order. Note that, + core dev names are automatically included by the common_links.inc: + + + + +.. comment + Whatsnew resources in alphabetical order: \ No newline at end of file