stactools documentation

stactools is a library for working with SpatioTemporal Asset Catalogs (STAC). It is based on PySTAC. The stactools package provides:

• A core Python API, available via stactools.core, which provides high-level utility functions for working with STAC objects

• A command-line interface, available via the stac command, e.g.:

$ stac --help

There are a variety of stactools packages built for specific datasets or to provide extra functionality. See the stactools-packages website and the stactools-packages Github organization for more information.

Requirements

• Python 3.8 or greater

STAC version support

All versions of stactools support STAC v1.0.0.

Installation

$ pip install stactools

Filesystem I/O is provided by fsspec. To enable AWS S3 support via s3fs, you can enable it during installation.

$ pip install 'stactools[s3]'

Note

If you need to access s3 data via requester pays, use this environment variable: AWS_REQUEST_PAYER='requester'.