Python library for working with Spatiotemporal Asset Catalog (STAC).
Project description
PySTAC
PySTAC is a library for working with SpatialTemporal Asset Catalog in Python 3.
Installation
PySTAC has a single required dependency (python-dateutil).
PySTAC can be installed from pip or the source repository.
> 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]
From source repository:
> git clone https://github.com/stac-utils/pystac.git
> cd pystac
> pip install .
Versions
To install a version of PySTAC that works with a specific versions of the STAC specification, install the matching version of PySTAC from the following table.
| 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 |
For instance, to work with STAC v0.9.x:
pip install pystac==0.4.0
STAC spec versions below 0.8 are not supported by PySTAC.
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:
> 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.
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.
Source Distribution
Built Distribution
Hashes for pystac-1.0.0rc2-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7103c219eaccdb23a62fcb0ea995cbcec87fc0c160f0486aca83a14cce016209 |
|
| MD5 | 93317dc329c5d5b94feac7afc5bb5a6b |
|
| BLAKE2b-256 | bcfa4b35e76847250aff850e61adbc7fabde72a4ca584589d8762277984397ab |
