Skip to main content

Tooling for converting STAC metadata to ODC data model

Project description


Documentation Status Test Status Test Coverage Run Examples in Binder

Load STAC items into xarray Datasets. Process locally or distribute data loading and computation with Dask.



catalog =
query =
xx = odc.stac.load(
    bands=["red", "green", "blue"],

For more details see Documentation and Sample Notebooks, or try it out on Binder.


Using pip

pip install odc-stac

To install with botocore support (for working with AWS):

pip install 'odc-stac[botocore]'

Using Conda

This package is be available on conda-forge channel:

conda install -c conda-forge odc-stac

From unreleased source

To use development version of odc-stac install dependencies from conda, then install odc-stac with pip.

Sample environment.yml is provided below.

  - conda-forge
  - odc-geo
  - xarray
  - numpy
  - dask
  - pandas
  - affine
  - rasterio
  - toolz
  - pystac
  - pystac-client
  - pip
  - pip:
    - "git+"


To develop odc-stac locally using pip (assuming you have virtualenvwrapper installed):

git clone
cd odc-stac
mkvirtualenv odc-stac
pip install -e .
pip install -r requirements-dev.txt

Run tests with pytest:


Linting is provided by mypy, pylint, and black:

black --check .
pylint -v odc
mypy odc

Project details

Download files

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

Source Distribution

odc_stac-0.3.10rc2.tar.gz (85.0 kB view hashes)

Uploaded Source

Built Distribution

odc_stac-0.3.10rc2-py3-none-any.whl (84.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page