This is an Intake data source for SpatioTemporal Asset Catalogs (STAC). The STAC specification provides a common metadata specification, API, and catalog format to describe geospatial assets, so they can more easily indexed and discovered. A 'spatiotemporal asset' is any file that represents information about the earth captured in a certain space and time.
Intake-STAC provides an opinionated way for users to load Assets from STAC catalogs into the scientific Python ecosystem. It uses the intake-xarray plugin and supports several file formats including GeoTIFF, netCDF, GRIB, and OpenDAP.
Intake-STAC has a few requirements, such as Intake, intake-xarray and sat-stac. Intake-stac can be installed in any of the following ways:
We recommend installing the latest release with conda
:
$ conda install -c conda-forge intake-stac
Or the latest development version with pip
:
$ pip install git+https://github.com/intake/intake-stac
from intake import open_stac_catalog
catalog_url = 'https://raw.githubusercontent.com/cholmes/sample-stac/master/stac/catalog.json'
cat = open_stac_catalog(catalog_url)
cat['Houston-East-20170831-103f-100d-0f4f-RGB'].metadata
da = cat['Houston-East-20170831-103f-100d-0f4f-RGB']['thumbnail'].to_dask()
da
The examples/ directory contains some example Jupyter Notebooks that can be used to test the functionality.
To install a specific versions of intake-stac, specify the version in the install command
pip install intake-stac==0.3.0
The table below shows the corresponding versions between intake-stac and STAC:
intake-stac | STAC |
---|---|
0.2.x | 0.6.x |
0.3.x | 1.0.x |
intake-stac was created as part of the Pangeo initiative under support from the NASA-ACCESS program. See the initial design document.