Home

Awesome

sat-stac

CircleCI PyPI version codecov

This is a Python 3 library for reading and working with existing Spatio-Temporal Asset Catalogs (STAC). It can be used to

The features for creating and updating existing catalogs in past versions have been removed in 0.4.0. If writing catalogs is needed, see PySTAC.

Installation

sat-stac has minimal dependencies (requests and python-dateutil). To install sat-stac from PyPi: sat-stac can be installed from pip or the source repository.

$ pip install sat-stac

From source repository:

$ git clone https://github.com/sat-utils/sat-stac.git
$ cd sat-stac
$ pip install .

Versions

To install a specific versions of sat-stac, install the matching version of sat-stac.

pip install sat-stac==0.1.0

The table below shows the corresponding versions between sat-stac and STAC:

sat-stacSTAC
0.1.x0.6.x - 0.7.x
0.2.x0.6.x - 0.7.x
0.3.x0.6.x - 0.9.x
0.4.x0.6.x - 1.0.0-beta.1

Tutorials

There are two tutorials. Tutorial-1 includes an overview of how to create and manipulate STAC static catalogs. Tutorial-2 is on the Python classes that reflect STAC entities: Catalogs, Collections, and Items.

About

sat-stac is part of a collection of tools called sat-utils.