Python library for working with the SpatioTemporal Asset Catalog (STAC) specification
Project description
PySTAC
PySTAC is a library for working with the SpatioTemporal Asset Catalog specification in Python 3.
Installation
Install from PyPi (recommended)
pip install pystac
If you would like to enable the validation feature utilizing the
jsonschema project, install with the optional
validation requirements:
pip install 'pystac[validation]'
If you would like to use the orjson instead of the
standard json library for JSON serialization/deserialization, install with the
optional orjson requirements:
pip install 'pystac[orjson]'
If you would like to use a custom RetryStacIO class for automatically retrying
network requests when reading with PySTAC, you'll need
urllib3:
pip install 'pystac[urllib3]'
If you are using jupyter notebooks and want to enable pretty display of pystac objects you'll need jinja2
pip install 'pystac[jinja2]'
Install from source
git clone https://github.com/stac-utils/pystac.git
cd pystac
pip install .
See the installation page for more options.
Documentation
See the documentation page for the latest docs.
Developing
See contributing docs for details on contributing to this project.
Running the quickstart and tutorials
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:
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
