Skip to content

Commit d6e487e

Browse files
authored
whatsnew updates for v3.13.0rc0 (#6583)
* whatsnew updates for v3.13.0rc0 * fix whatsnew entry
1 parent c46b1c9 commit d6e487e

File tree

3 files changed

+37
-120
lines changed

3 files changed

+37
-120
lines changed

docs/src/whatsnew/latest.rst renamed to docs/src/whatsnew/3.13.rst

Lines changed: 35 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,43 @@
11
.. include:: ../common_links.inc
22

3-
|iris_version| |build_date| [unreleased]
4-
****************************************
3+
v3.13 (24 Jul 2025 [release candidate])
4+
***************************************
55

66
This document explains the changes made to Iris for this release
77
(:doc:`View all changes <index>`.)
88

99

10-
.. dropdown:: |iris_version| Release Highlights
10+
.. dropdown:: v3.13 Release Highlights
1111
:color: primary
1212
:icon: info
1313
:animate: fade-in
1414
:open:
1515

16-
The highlights for this major/minor release of Iris include:
16+
The highlights for this minor release of Iris include:
1717

18-
* N/A
18+
* Extended :data:`iris.loading.LOAD_PROBLEMS` to all NetCDF objects added
19+
to a :class:`~iris.cube.Cube` during loading, thus providing richer
20+
diagnostics to help understand loading issues.
21+
22+
* Added support for loading and saving multiple *Coordinate Reference
23+
Systems* (CRS) for a :class:`~iris.cube.Cube` when using NetCDF.
24+
Additionally, we can now generate a *Well-Known Text* (`WKT`_)
25+
representation of the CRS when saving, which can be useful for
26+
interoperability with other tools.
27+
28+
* Made :class:`~iris.MeshCoord` immutable, with automatic updates when the
29+
associated mesh changes.
30+
31+
* Enabled correct loading and saving of bounds for
32+
`CF Parametric Vertical Coordinates`_.
33+
34+
* In terms of performance, we have made significant improvements to the
35+
memory usage of hybrid coordinates, which are now automatically rechunked
36+
to avoid excessive memory usage. This is particularly useful for large
37+
datasets with derived coordinates, and reference surfaces are now lazy by
38+
default. Additionally, we've extended NetCDF compression to include
39+
auxiliary coordinates and ancillary variables, which can help reduce file
40+
sizes and improve loading times 🚀
1941

2042
And finally, get in touch with us on :issue:`GitHub<new/choose>` if you have
2143
any issues or feature requests for improving Iris. Enjoy!
@@ -65,7 +87,7 @@ This document explains the changes made to Iris for this release
6587
See `CRS Grid Mappings and Projections`_ for more information.
6688
(:issue:`3388`:, :pull:`6536`:)
6789

68-
#. `@ESadek-MO`_ made MeshCoords immutable. :class:`iris.MeshCoord`s are now updated automatically when
90+
#. `@ESadek-MO`_ made :class:`~iris.MeshCoord`\s immutable. :class:`iris.MeshCoord`\s are now updated automatically when
6991
changing the attached mesh. All changes to the :class:`iris.MeshCoord` should instead be done to
7092
the relevant :class:`iris.Coord` located on the attached :class:`iris.MeshXY`. This change also affects
7193
the behaviour when calling :attr:`iris.MeshCoord.points` and :attr:`MeshCoord.bounds`, which will return
@@ -84,17 +106,17 @@ This document explains the changes made to Iris for this release
84106
to also include any auxiliary coordinates and ancillary variables with the same ``shape``.
85107
(:issue:`6539`, :pull:`6552`)
86108

87-
#. `@pp-mo`_ added support for saving and loading the special ``GRIB_PARAM`` attributes to netcdf, as used
109+
#. `@pp-mo`_ added support for saving and loading the special ``GRIB_PARAM`` attributes to NetCDF, as used
88110
by iris-grib to record the exact grib-file encoding of phenomenon types. This means that data sourced
89-
from GRIB grib files can be freely saved and re-loaded to netcdf without loss of information.
111+
from GRIB grib files can be freely saved and re-loaded to NetCDF without loss of information.
90112
(`Issue Iris-grib#596 <https://github.com/SciTools/iris-grib/issues/596>`__, :pull:`6566`).
91113

92114

93115
🐛 Bugs Fixed
94116
=============
95117

96118
#. `@HGWright`_ added a new warning to inform users that the boolean coordinate generated by
97-
:meth:`iris.coord_categorisation.add_season_membership` is not saveable to netcdf. (:pull:`6305`)
119+
:meth:`iris.coord_categorisation.add_season_membership` is not saveable to NetCDF. (:pull:`6305`)
98120

99121
#. `@bouweandela`_ changed the ``convert_units`` method on cubes and coordinates
100122
so it also converts the values of the attributes ``"actual_range"``,
@@ -106,7 +128,7 @@ This document explains the changes made to Iris for this release
106128
#. `@stephenworsley`_ fixed the html representation of cubes in Jupyter when coordinates
107129
share the same name. (:pull:`6476`)
108130

109-
#. `@schlunma`_ fixed loading of netCDF files with coordinates that have
131+
#. `@schlunma`_ fixed loading of NetCDF files with coordinates that have
110132
non-string units. (:issue:`6505`, :pull:`6506`)
111133

112134
#. `@ukmo-ccbunney`_ correctly set the ``bplon`` PP field parameter when saving
@@ -191,7 +213,7 @@ This document explains the changes made to Iris for this release
191213
(:issue:`2985`, :pull:`6562`)
192214

193215
#. `@pp-mo`_ made a unified mechanism for 'managed' cube attributes: ones which get
194-
converted between an iris-internal and an in-file form for saving/loading to netcdf,
216+
converted between an iris-internal and an in-file form for saving/loading to NetCDF,
195217
such as STASH objects in a STASH attribute.
196218
(:pull:`6566`).
197219

@@ -210,3 +232,5 @@ This document explains the changes made to Iris for this release
210232
.. _CRS Grid Mappings and Projections: https://cfconventions.org/Data/cf-conventions/cf-conventions-1.12/cf-conventions.html#grid-mappings-and-projections
211233
.. _Ncdata: https://github.com/pp-mo/ncdata
212234
.. _Trusted Publishing: https://docs.pypi.org/trusted-publishers/
235+
.. _WKT: https://www.ogc.org/standards/wkt-crs/
236+
.. _CF Parametric Vertical Coordinates: https://cfconventions.org/Data/cf-conventions/cf-conventions-1.12/cf-conventions.html#parametric-vertical-coordinates

docs/src/whatsnew/index.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@
66
What's New in Iris
77
------------------
88

9-
.. include:: latest.rst
9+
.. include:: 3.13.rst
1010

1111
.. toctree::
1212
:maxdepth: 1
1313
:hidden:
1414

15-
latest.rst
15+
3.13.rst
1616
3.12.rst
1717
3.11.rst
1818
3.10.rst

docs/src/whatsnew/latest.rst.template

Lines changed: 0 additions & 107 deletions
This file was deleted.

0 commit comments

Comments
 (0)