moczarr

Sparse-DGGS xarray reader for morton-hive zarr stores: MOC-declared domains, arithmetic shard paths, lazy dense views.

moczarr opens stores written by zagg under the morton-hive layout convention: a digit tree of self-describing zarr v3 leaves keyed by morton decimal ids, with a static manifest and hierarchical coverage MOCs declaring where data exists — so a reader intersects an area of interest arithmetically instead of listing objects or materializing a global grid.

import moczarr

ds = moczarr.open_hive("s3://bucket/prefix", aoi=["433142"], anonymous=True)

Features

open_hive() — one call from store root (local path or s3://bucket/prefix) to a lazy xarray.Dataset; AOI covers (packed morton words or decimal strings, mixed orders) and time-window scoping resolve through coverage metadata, not object listings. An AOI over no coverage is a data answer: a schema-correct empty dataset, not an error.
A MOC-backed lazy index (the default) — the row domain held as a rank-space interval set built from the same coverage arithmetic that selected the leaves; the on-disk cell arrays are never read, and the morton coordinate is fabricated on demand (sel/isel/alignment as interval arithmetic; index_kind="pandas" materializes instead).
Exact NESTED fabrication — HEALPix NESTED cell_ids derived exactly from the packed morton words ("NESTED is fabricated, never stored").
Cross-resolution joins — morton truncation makes coarse↔fine work a vectorized lookup: parent_cells for fine→coarse groupby aggregation, join_coarse for the coarse→fine broadcast, no I/O.
xdggs integration (moczarr[xdggs]) — a registered "morton" grid, so ds.dggs.sel_latlon, cell_boundaries, zoom_to work on any open_hive result.

Docs: espg.github.io/moczarr — quickstart, concepts, API reference, and the example notebook (runnable on binder via the badge above).

Install

pip install moczarr            # core reader
pip install 'moczarr[xdggs]'   # + the ds.dggs accessor integration

Until the first PyPI release lands, install from git:

pip install 'moczarr[xdggs] @ git+https://github.com/espg/moczarr'

Development (uses uv):

uv sync --extra test --extra xdggs
uv run pytest -v

The convention

moczarr is the read side of a convention owned elsewhere: the morton-hive layout and morton decimal ids are specified in the mortie specification, and the coverage tiers, commit-stamp semantics, and reader architecture in zagg's sparse_coverage.md (§4 coverage, §5 reader, §6 xarray extension). Plan and progress: espg/moczarr#1.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moczarr-0.3.0.tar.gz (273.4 kB view details)

Uploaded Aug 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

moczarr-0.3.0-py3-none-any.whl (117.0 kB view details)

Uploaded Aug 4, 2026 Python 3

File details

Details for the file moczarr-0.3.0.tar.gz.

File metadata

Download URL: moczarr-0.3.0.tar.gz
Upload date: Aug 4, 2026
Size: 273.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for moczarr-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`2d8abfe0062851bb5378668e50b22eaf60435c1da776df3e8881c884ae26acdb`
MD5	`a59ce84a2c9fca8ad0a49496812ceb5a`
BLAKE2b-256	`d88774efc1c6c67c0f070bbe2f6869d769cabd78ebd1afe53e22cb117dad3033`

See more details on using hashes here.

Provenance

The following attestation bundles were made for moczarr-0.3.0.tar.gz:

Publisher: publish.yml on espg/moczarr

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: moczarr-0.3.0.tar.gz
- Subject digest: 2d8abfe0062851bb5378668e50b22eaf60435c1da776df3e8881c884ae26acdb
- Sigstore transparency entry: 2337885725
- Sigstore integration time: Aug 4, 2026
Source repository:
- Permalink: espg/moczarr@476c362e5bcc768ae65675ed2aac4bb7879eb637
- Branch / Tag: refs/tags/0.3.0
- Owner: https://github.com/espg
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@476c362e5bcc768ae65675ed2aac4bb7879eb637
- Trigger Event: push