From 4a901d76f755e92b9d1c2ffc8831ce1d1ae5a223 Mon Sep 17 00:00:00 2001 From: Deepak Cherian Date: Wed, 9 Jul 2025 12:52:51 -0700 Subject: [PATCH 1/5] Add release notes for v2025.07.1 Release in prep for a talk at SciPy 2025 on flexible indexes. See https://xarray-indexes.readthedocs.io/ for more! --- doc/whats-new.rst | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index f97f12ffc9f..9d1780d99da 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -7,22 +7,23 @@ What's New .. _whats-new.2025.07.1: -v2025.07.1 (unreleased) ------------------------ +v2025.07.1 (July 10, 2025) +-------------------------- + +This release brings a lot of improvements to flexible indexes functionality, including new classes +to ease building of new indexes with custom coordinate transforms (:py:class:`indexes.CoordinateTransformIndex`) +and tree-like index structures (:py:class:`indexes.NDPointIndex`). +See a new `gallery `_ showing off the possibilities enabled by flexible indexes. + New Features ~~~~~~~~~~~~ +- New :py:class:`xarray.indexes.NDPointIndex`, which by default uses :py:class:`scipy.spatial.KDTree` under the hood for + the selection of irregular, n-dimensional data (:pull:`10478`). + By `Benoit Bovy `_. - Allow skipping the creation of default indexes when opening datasets (:pull:`8051`). By `Benoit Bovy `_ and `Justus Magin `_. -Breaking changes -~~~~~~~~~~~~~~~~ - - -Deprecations -~~~~~~~~~~~~ - - Bug fixes ~~~~~~~~~ @@ -35,7 +36,7 @@ Bug fixes Documentation ~~~~~~~~~~~~~ - +- New `gallery `_ showing off the possibilities enabled by flexible indexes. Internal Changes ~~~~~~~~~~~~~~~~ @@ -63,9 +64,6 @@ New Features - Expose :py:class:`~xarray.indexes.RangeIndex`, and :py:class:`~xarray.indexes.CoordinateTransformIndex` as public api under the ``xarray.indexes`` namespace. By `Deepak Cherian `_. -- New :py:class:`xarray.indexes.NDPointIndex`, which by default uses :py:class:`scipy.spatial.KDTree` under the hood for - the selection of irregular, n-dimensional data (:pull:`10478`). - By `Benoit Bovy `_. - Support zarr-python's new ``.supports_consolidated_metadata`` store property (:pull:`10457``). by `Tom Nicholas `_. - Better error messages when encoding data to be written to disk fails (:pull:`10464`). From df293a5bf779e27aa5428a63492b5c33f2723589 Mon Sep 17 00:00:00 2001 From: Deepak Cherian Date: Wed, 9 Jul 2025 13:02:14 -0700 Subject: [PATCH 2/5] fix --- doc/whats-new.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 9d1780d99da..fdb902a69b8 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -15,6 +15,8 @@ to ease building of new indexes with custom coordinate transforms (:py:class:`in and tree-like index structures (:py:class:`indexes.NDPointIndex`). See a new `gallery `_ showing off the possibilities enabled by flexible indexes. +Thanks to the 7 contributors to this release: +Benoit Bovy, Deepak Cherian, Dhruva Kumar Kaushal, Dimitri Papadopoulos Orfanos, Illviljan, Justus Magin and Tom Nicholas New Features ~~~~~~~~~~~~ @@ -36,7 +38,7 @@ Bug fixes Documentation ~~~~~~~~~~~~~ -- New `gallery `_ showing off the possibilities enabled by flexible indexes. +- `New gallery `_ showing off the possibilities enabled by flexible indexes. Internal Changes ~~~~~~~~~~~~~~~~ From 1321c6149e5831aff9abc6a58e9bfbe4febdd546 Mon Sep 17 00:00:00 2001 From: Deepak Cherian Date: Wed, 9 Jul 2025 13:04:29 -0700 Subject: [PATCH 3/5] Add TreeADapter to api --- doc/api.rst | 1 + xarray/indexes/__init__.py | 3 ++- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/api.rst b/doc/api.rst index f4a6dc6677d..b46d807e8d4 100644 --- a/doc/api.rst +++ b/doc/api.rst @@ -1616,6 +1616,7 @@ These classes are building blocks for more complex Indexes: indexes.CoordinateTransform indexes.CoordinateTransformIndex indexes.NDPointIndex + indexes.TreeAdapter The Index base class for building custom indexes: diff --git a/xarray/indexes/__init__.py b/xarray/indexes/__init__.py index 2cba69607f3..20aa5a75929 100644 --- a/xarray/indexes/__init__.py +++ b/xarray/indexes/__init__.py @@ -10,7 +10,7 @@ PandasIndex, PandasMultiIndex, ) -from xarray.indexes.nd_point_index import NDPointIndex +from xarray.indexes.nd_point_index import NDPointIndex, TreeAdapter from xarray.indexes.range_index import RangeIndex __all__ = [ @@ -21,4 +21,5 @@ "PandasIndex", "PandasMultiIndex", "RangeIndex", + "TreeAdapter", ] From 0819414fe435a1e3fd228b21839a3cf373b97ab2 Mon Sep 17 00:00:00 2001 From: Deepak Cherian Date: Wed, 9 Jul 2025 17:34:27 -0700 Subject: [PATCH 4/5] fix --- doc/whats-new.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index fdb902a69b8..a06c60254af 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -13,7 +13,7 @@ v2025.07.1 (July 10, 2025) This release brings a lot of improvements to flexible indexes functionality, including new classes to ease building of new indexes with custom coordinate transforms (:py:class:`indexes.CoordinateTransformIndex`) and tree-like index structures (:py:class:`indexes.NDPointIndex`). -See a new `gallery `_ showing off the possibilities enabled by flexible indexes. +See a `new gallery `_ showing off the possibilities enabled by flexible indexes. Thanks to the 7 contributors to this release: Benoit Bovy, Deepak Cherian, Dhruva Kumar Kaushal, Dimitri Papadopoulos Orfanos, Illviljan, Justus Magin and Tom Nicholas @@ -38,7 +38,7 @@ Bug fixes Documentation ~~~~~~~~~~~~~ -- `New gallery `_ showing off the possibilities enabled by flexible indexes. +- A `new gallery `_ showing off the possibilities enabled by flexible indexes. Internal Changes ~~~~~~~~~~~~~~~~ From 9ac1d000884f55037f2895cd1990e1db6a7d9738 Mon Sep 17 00:00:00 2001 From: Deepak Cherian Date: Wed, 9 Jul 2025 19:04:55 -0600 Subject: [PATCH 5/5] Update doc/whats-new.rst --- doc/whats-new.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index a06c60254af..b00215ad74e 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -7,7 +7,7 @@ What's New .. _whats-new.2025.07.1: -v2025.07.1 (July 10, 2025) +v2025.07.1 (July 09, 2025) -------------------------- This release brings a lot of improvements to flexible indexes functionality, including new classes