PySTAC is a library for working with SpatialTemporal Asset Catalog in Python 3.
PySTAC has a single dependency (python-dateutil
).
PySTAC can be installed from pip or the source repository.
> pip install pystac
if you'd like to enable the validation feature utilizing the jsonschema project, install with the optional validation
requirements:
> pip install pystac[validation]
From source repository:
> git clone https://github.com/stac-utils/pystac.git
> cd pystac
> pip install .
To install a specific versions of STAC, install the matching version of pystac.
> pip install pystac==0.5.*
The table below shows the corresponding versions between pystac and STAC:
pystac | STAC |
---|---|
1.x | 1.0.x |
0.5.x | 1.0.0-beta.* |
0.4.x | 0.9.x |
0.3.x | 0.8.x |
See the documentation page for the latest docs.
There is a quickstart and tutorials written as jupyter notebooks in the docs/tutorials
folder.
To run the notebooks, run a jupyter notebook with the docs
directory as the notebook directory:
> PYTHONPATH=`pwd`:$PYTHONPATH jupyter notebook --ip 0.0.0.0 --port 8888 --notebook-dir=docs
You can then navigate to the notebooks and execute them.
Requires Jupyter be installed.