Awesome
sat-stac
This is a Python 3 library for reading and working with existing Spatio-Temporal Asset Catalogs (STAC). It can be used to
- Open and traverse STAC catalogs
- Download assets from STAC Items, using templated path names
- Save and load Self-contained STAC catalogs
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-stac | STAC |
|---|---|
| 0.1.x | 0.6.x - 0.7.x |
| 0.2.x | 0.6.x - 0.7.x |
| 0.3.x | 0.6.x - 0.9.x |
| 0.4.x | 0.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.