Skip to content

Python library for creating and working with STAC catalogs

License

Notifications You must be signed in to change notification settings

sat-utils/sat-stac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

5f29039 · Dec 7, 2019
Jul 16, 2019
Dec 7, 2019
Sep 19, 2019
Nov 3, 2018
Nov 3, 2018
Dec 7, 2019
Oct 12, 2018
Nov 4, 2018
Sep 20, 2019
Nov 3, 2018
Jan 15, 2019
Dec 8, 2018
Sep 7, 2019
Jul 16, 2019

Repository files navigation

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
0.3.x 0.6.x - 0.8.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 is part of a collection of tools called sat-utils.