odc-stac

odc.stac

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

Usage

odc.stac.load

catalog = pystac_client.Client.open(...)
query = catalog.search(...)
xx = odc.stac.load(
    query.items(),
    bands=["red", "green", "blue"],
)
xx.red.plot.imshow(col="time")

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

Installation

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.

channels:
  - conda-forge
dependencies:
  - odc-geo
  - xarray
  - numpy
  - dask
  - pandas
  - affine
  - rasterio
  - toolz
  - pystac
  - pystac-client
  - pip
  - pip:
    - "git+https://github.com/opendatacube/odc-stac/"

Developing

To develop odc-stac locally it’s best to use provided devcontainer.

git clone https://github.com/opendatacube/odc-stac
code odc-stac

Once running inside the dev container, run tests with pytest:

pytest

Linting is provided by mypy, pylint, and black:

black --check .
pylint -v odc
mypy odc

Metadata

Release files for odc-stac 0.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for odc-stac 0.5.3
File	Size	Uploaded
odc_stac-0.5.3.tar.gz	296.2 kB	Jul 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for odc-stac 0.5.3
File	Interpreter	ABI	Platform	Reset
odc_stac-0.5.3-py3-none-any.whl 44.1 kB Jul 30, 2026	Python 3	none	any	Details

Total release size: 340.4 kB

Release files / odc_stac-0.5.3.tar.gz

Download URL	odc_stac-0.5.3.tar.gz
Size	296.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`00144973748880115f3e261401b0378f14c1bcf6490b0bbeb3c18e9c68508b4e`
BLAKE2b-256 checksum How to use checksums	`83bb428165d3ff727791531559d1049fb4fad7899a6f878e769378d0b3269f31`
Upload date	Jul 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / odc_stac-0.5.3-py3-none-any.whl

Download URL	odc_stac-0.5.3-py3-none-any.whl
Size	44.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0597532a46003c9462d04e5015ebd9f2e2dec40892c6a4bcc515b278e789179a`
BLAKE2b-256 checksum How to use checksums	`c279936fc1d69f1a1102f2e0bae76ad2ca1cab3503e69a2ae900e843dbd86a2c`
Upload date	Jul 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`