odc-loader
Tooling for constructing xarray objects from parsed metadata
What it is and what it does
odc-loader is a Python library that bridges parsed geospatial metadata and xarray, a popular multi-dimensional array library. It provides tooling to construct xarray Dataset and DataArray objects from metadata, typically used in geospatial and Earth observation workflows where raster data needs to be loaded and organized into labeled, multi-dimensional structures.
The package integrates with dask for lazy loading, rasterio for raster I/O, and odc-geo for geospatial operations. It targets developers working with gridded geospatial data who need programmatic control over how metadata translates into array structures. The library supports Python 3.10 through 3.13 and carries a permissive license, making it suitable for both research and production use.
Use it for:
- Load satellite or aerial imagery metadata and construct xarray datasets for analysis in Jupyter notebooks.
- Build lazy-loaded dask-backed arrays from geospatial metadata for memory-efficient processing of large raster collections.
- Integrate Earth observation data pipelines where metadata parsing and array construction need to be decoupled.
- Construct labeled multi-dimensional arrays from geospatial metadata for time-series or multi-band raster analysis.
- Automate xarray object creation in geospatial data processing workflows that consume parsed metadata.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Constructs xarray objects from parsed geospatial metadata, enabling programmatic assembly of multi-dimensional arrays for raster data workflows.
Yes, if you are working with geospatial raster data and need to programmatically construct xarray objects from metadata. The package has low install friction, active maintenance, no known vulnerabilities, and a permissive license. The six dependencies are standard in geospatial Python (rasterio, dask, xarray, numpy). Install it if your workflow involves metadata-driven array construction; skip it if you only need basic raster I/O without xarray integration.
Install
odc-loader on PyPI
pip
pip install odc-loaderuv
uv add odc-loaderpoetry
poetry add odc-loaderInstalling odc-loader
Before you install
Low friction: pure Python wheel with six runtime dependencies (odc-geo, rasterio, dask, numpy, xarray, typing-extensions). Repository is active with recent commits; last release was 212 days ago, indicating regular maintenance.
License in practice
Permissive license treatment means you can use, modify, and redistribute this package with minimal legal restrictions in most commercial and open-source contexts.
Quickstart
pip install odc-loader
from odc.loader import construct_loader
import xarray as xr
# Construct xarray dataset from parsed metadata
loader = construct_loader(metadata)
dataset = loader.load()
Requires Python 3.10 or later; rasterio may require system libraries (GDAL) depending on your environment.
Verify before relying
- Whether the package is actively maintained beyond the last commit date or if 212 days represents a stable release cycle.
- Specific use-case scenarios beyond generic xarray construction from metadata.
- Performance characteristics when working with large datasets via dask integration.
Package facts
| License | not declared (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 6 — odc-geo, rasterio, dask, numpy, xarray, typing-extensions |
| Maintenance | actively maintained — 212 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 96,399/month — #13,214 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: odc_loader-0.6.4-py3-none-any.whl
Tags
More Python Modules packages
Converts domain names between Unicode and…
permissive · top 100 on PyPI
setuptoolsSetuptools is a Python build backend and…
permissive · top 100 on PyPI
PyYAMLPyYAML parses and emits YAML 1.1 data format,…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
annotated-typesProvides reusable metadata objects for use with…
permissive · top 100 on PyPI
typing-inspectionProvides runtime tools to inspect and…
permissive · top 100 on PyPI
odc-stacConverts STAC (SpatialTemporal Asset Catalog)…
unclear · top 15,000 on PyPI
odc-geoProvides projection-aware geometry classes…
permissive · top 15,000 on PyPI
rasterixRasterix provides tools for analyzing raster…
permissive · top 15,000 on PyPI
xarray-spatialxarray-spatial provides 150+ functions for…
permissive · top 15,000 on PyPI
xarrayxarray adds dimension, coordinate, and…
permissive · top 5,000 on PyPI
rioxarrayrioxarray extends xarray with geospatial and…
permissive · top 5,000 on PyPI
xprojXProj is an Xarray extension that provides…
permissive · top 15,000 on PyPI
spatial_imagespatial-image provides an N-dimensional spatial…
permissive · top 15,000 on PyPI
multiscale-spatial-imageGenerates multiscale image pyramids organized…
permissive · top 15,000 on PyPI
floxFlox provides fast GroupBy reduction operations…
permissive · top 15,000 on PyPI