11.. include :: ../common_links.inc
22
3- | iris_version | | build_date | [unreleased]
4- ****************************************
3+ v3.13 (24 Jul 2025 [release candidate])
4+ ***************************************
55
66This 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
0 commit comments