/sat-stac

Python library for creating and working with STAC catalogs

Primary LanguagePythonMIT LicenseMIT

sat-stac

CircleCI PyPI version codecov

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

  • Open and update existing catalogs
  • Traverse through catalogs
  • Create a new catalogs
  • Add or remove a STAC Collection from a catalog
  • Add or remove STAC Items from a catalog
  • Create a hierarchical STAC catalog from STAC Items.

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

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 was created by Development Seed and is part of a collection of tools called sat-utils.