xarray-contrib · keewis · Jun 3, 2025 · Jun 3, 2025 · Jun 5, 2025 · Jun 5, 2025
diff --git a/ci/docs.yml b/ci/docs.yml
@@ -29,4 +29,5 @@ dependencies:
   - cdshealpix
   - pip
   - pip:
+      - healpix-geo
       - -e ..
diff --git a/ci/environment.yml b/ci/environment.yml
@@ -16,3 +16,6 @@ dependencies:
   - arro3-core
   - cdshealpix
   - h3ronpy
+  - pip
+  - pip:
+      - healpix-geo
diff --git a/docs/api.rst b/docs/api.rst
@@ -38,6 +38,11 @@ Parameters
 
    Dataset.dggs.grid_info
    Dataset.dggs.params
+
+.. autosummary::
+   :toctree: generated
+   :template: autosummary/accessor_method.rst
+
    Dataset.dggs.decode
 
 
@@ -62,7 +67,12 @@ Parameters
 
    DataArray.dggs.grid_info
    DataArray.dggs.params
-   DataArray.dggs.decode
+
+.. autosummary::
+   :toctree: generated
+   :template: autosummary/accessor_method.rst
+
+   Dataset.dggs.decode
 
 
 Data inference

diff --git a/docs/changelog.md b/docs/changelog.md
@@ -4,11 +4,13 @@
 
 ### New features
 
+- memory-efficient index implementation based on multi-order coverage maps (MOCs) ({pull}`151`)
+
 ### Bug fixes
 
 ### Documentation
 
-- Documentation Contributer Guide + Github Button ({pull}`137`)
+- Documentation Contributor's Guide + Github Button ({pull}`137`)
 
 ### Internal changes
 

diff --git a/docs/conf.py b/docs/conf.py
@@ -115,6 +115,7 @@
     "healpy": ("https://healpy.readthedocs.io/en/latest", None),
     "cdshealpix-python": ("https://cds-astro.github.io/cds-healpix-python", None),
     "shapely": ("https://shapely.readthedocs.io/en/stable", None),
+    "healpix-geo": ("https://healpix-geo.readthedocs.io/en/latest", None),
 }
 
 # -- myst-nb options ---------------------------------------------------------

diff --git a/pyproject.toml b/pyproject.toml
@@ -38,7 +38,9 @@ classifiers = [
 requires-python = ">=3.10"
 dependencies = [
   "xarray",
+  "numpy>=2.0",
   "cdshealpix",
+  "healpix-geo>=0.0.3",
   "h3ronpy",
   "typing-extensions",
   "lonboard>=0.9.3",

diff --git a/xdggs/accessor.py b/xdggs/accessor.py
@@ -29,7 +29,9 @@ def __init__(self, obj: xr.Dataset | xr.DataArray):
         self._name = name
         self._index = index
 
-    def decode(self, grid_info=None, *, name="cell_ids") -> xr.Dataset | xr.DataArray:
+    def decode(
+        self, grid_info=None, *, name="cell_ids", index_options=None, **index_kwargs
+    ) -> xr.Dataset | xr.DataArray:
         """decode the DGGS cell ids
 
         Parameters
@@ -39,6 +41,8 @@ def decode(self, grid_info=None, *, name="cell_ids") -> xr.Dataset | xr.DataArra
             the dataset.
         name : str, default: "cell_ids"
             The name of the coordinate containing the cell ids.
+        index_options, **index_kwargs : dict, optional
+            Additional options to forward to the index.
 
         Returns
         -------
@@ -51,7 +55,12 @@ def decode(self, grid_info=None, *, name="cell_ids") -> xr.Dataset | xr.DataArra
         if isinstance(grid_info, dict):
             var.attrs = grid_info
 
-        return self._obj.drop_indexes(name, errors="ignore").set_xindex(name, DGGSIndex)
+        if index_options is None:
+            index_options = {}
+
+        return self._obj.drop_indexes(name, errors="ignore").set_xindex(
+            name, DGGSIndex, **(index_options | index_kwargs)
+        )
 
     @property
     def index(self) -> DGGSIndex:

diff --git a/xdggs/h3.py b/xdggs/h3.py
@@ -23,7 +23,6 @@
         cells_to_wkb_polygons,
         coordinates_to_cells,
     )
-from xarray.indexes import PandasIndex
 
 from xdggs.grid import DGGSInfo, translate_parameters
 from xdggs.index import DGGSIndex
@@ -208,7 +207,7 @@ class H3Index(DGGSIndex):
 
     def __init__(
         self,
-        cell_ids: Any | PandasIndex,
+        cell_ids: Any | xr.Index,
         dim: str,
         grid_info: DGGSInfo,
     ):
@@ -231,8 +230,8 @@ def from_variables(
     def grid_info(self) -> H3Info:
         return self._grid
 
-    def _replace(self, new_pd_index: PandasIndex):
-        return type(self)(new_pd_index, self._dim, self._grid)
+    def _replace(self, new_index: xr.Index):
+        return type(self)(new_index, self._dim, self._grid)
 
     def _repr_inline_(self, max_width: int):
         return f"H3Index(level={self._grid.level})"
-Original file line number
+Diff line change
@@ Expand Up / @@ -29,4 +29,5 @@ dependencies: @@
       - cdshealpix
       - pip
       - pip:
+          - healpix-geo
           - -e ..