Metadata-Version: 2.4
Name: dynamical-catalog
Version: 0.5.0
Summary: Load dynamical.org weather datasets in one line
Project-URL: Homepage, https://dynamical.org
Project-URL: Repository, https://github.com/dynamical-org/dynamical-catalog
Project-URL: Catalog, https://dynamical.org/catalog/
Project-URL: Issues, https://github.com/dynamical-org/dynamical-catalog/issues
Author-email: "dynamical.org" <feedback@dynamical.org>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >=3.12
Requires-Dist: icechunk~=2.0
Requires-Dist: xarray>=2025.1.2
Requires-Dist: zarr~=3.0
Provides-Extra: dev
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-mock; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# dynamical-catalog

Load [dynamical.org](https://dynamical.org) weather datasets in one line.

See [dynamical.org/catalog](https://dynamical.org/catalog/) for dataset documentation.

## Install

```bash
pip install dynamical-catalog
```

```bash
uv add dynamical-catalog
```

## Usage

```python
import dynamical_catalog

# Optional: let us know who you are so we can improve the catalog!
dynamical_catalog.identify("you@example.com")

# Open a dataset as an xarray Dataset via its icechunk repository
ds = dynamical_catalog.open("noaa-gfs-forecast")

# Additional arguments are passed through to `xr.open_zarr`
ds = dynamical_catalog.open("noaa-gfs-forecast", chunks=None)

# Get the underlying Zarr store if you want even more control
store = dynamical_catalog.get_store("noaa-gfs-forecast")
ds = xr.open_zarr(store)

# List all available datasets
dynamical_catalog.list()
```
