From 6d28752265354db8830575d57af87234914416ad Mon Sep 17 00:00:00 2001 From: Tom Augspurger Date: Fri, 2 May 2025 12:20:38 -0600 Subject: [PATCH 1/2] Deprecation notice This deprecates the xarray-assets extension. The deprecation notice includes recommendations to use some other extensions and libraries that would need to exist for us to actually have an alternative (I'm not planning to work on those, but chime in here if you want to). Closes #9 --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d709fad..c6dfe67 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,22 @@ - **Identifier:** - **Field Name Prefix:** xarray - **Scope:** Asset -- **Extension [Maturity Classification](https://github.com/radiantearth/stac-spec/tree/master/extensions/README.md#extension-maturity):** Pilot +- **Extension [Maturity Classification](https://github.com/radiantearth/stac-spec/tree/master/extensions/README.md#extension-maturity):** Deprecated - **Owner**: @TomAugspurger + +# Deprecation Notice + +This extension has been deprecated. While useful, it ended up being to specific to xarray and Python. +Instead of this extension, we recommend the following extensions and libraries to enable opening +xarray Datasets from a STAC item / asset: + +1. A new `zarr` extension to capture metadata about a Zarr hierarchy, like whether it is `consolidated`. +2. The [`storage` extension](https://github.com/stac-extensions/storage) for additional storage-specific information +3. The [xpystac](https://github.com/stac-utils/xpystac) library for opening xarray datasets from STAC metadata, rather than manually extracting information and calling `xarray.open_dataset` directly. + +# Description + This document explains the xarray Assets Extension to the [SpatioTemporal Asset Catalog](https://github.com/radiantearth/stac-spec) (STAC) specification. From c3edd7c0296d1565ffb33a62cd54ad8798c08106 Mon Sep 17 00:00:00 2001 From: Matthias Mohr Date: Wed, 4 Jun 2025 10:05:35 +0200 Subject: [PATCH 2/2] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c6dfe67..770f985 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ This extension has been deprecated. While useful, it ended up being to specific Instead of this extension, we recommend the following extensions and libraries to enable opening xarray Datasets from a STAC item / asset: -1. A new `zarr` extension to capture metadata about a Zarr hierarchy, like whether it is `consolidated`. +1. A yet to create `zarr` extension to capture metadata about a Zarr hierarchy, like whether it is `consolidated`. Proposals are welcome. 2. The [`storage` extension](https://github.com/stac-extensions/storage) for additional storage-specific information 3. The [xpystac](https://github.com/stac-utils/xpystac) library for opening xarray datasets from STAC metadata, rather than manually extracting information and calling `xarray.open_dataset` directly.