Skip to main content

Python library for working with the SpatioTemporal Asset Catalog (STAC) specification

Reason this release was yanked:

JSONSchemas were not distributed

Project description

PySTAC

Build Status PyPI version Conda (channel only) Documentation codecov Gitter License

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pystac-1.8.0.tar.gz (124.1 kB view hashes)

Uploaded Source

Built Distribution

pystac-1.8.0-py3-none-any.whl (161.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page