This repository contains example Jupyter notebooks for working with STAC, OpenDataCube, and Dask.
The ODC Planetary Computer and the ODC Landsat on AWS notebooks were presented at FOSS4G-2021, see the accompanying slides.
The aois directory contains several example GeoJSON features that can be used as AOIs for querying STAC APIs.
The Dockerfile and docker-compose files can be used to run a Jupyter Notebook container complete with all needed libraries.
For Dask there are a few options:
- Use Dask Gateway to launch a Dask cluster in your preferred cloud provider. The Planetary Computer notebook uses Dask Gateway to launch a cluster within the Planetary Computer environment.
- Use a local Dask cluster - no external setup is required, but is useful for development and trying out Dask. The data will be downloaded to the local Dask cluster.
- Use coiled.io to easily manage Dask clusters with any cloud provider and region. Great way to get started when running local notebooks and for tracking costs.
First, create a .env file in the root directory of this repository and provide the following environment variables:
- AWS_ACCESS_KEY_ID="your id"
- AWS_SECRET_ACCESS_KEY="your secret key"
- AWS_REQUEST_PAYER=requester
If you are using temporary credentials, you also need to set:
- AWS_SESSION_TOKEN="your session token"
Note: Only some notebooks, e.g. notebooks/odc-landsat.ipynb, require AWS credentials.
If you are only running notebooks that do NOT require AWS credentials (e.g. notebooks/odc-planetary-computer.ipynb), you can simply create an empty .env file.
Then build the Docker container:
$ docker compose build
Then run using Docker compose:
$ docker compose up
After starting up the container it will print a local URL that can be copy and pasted into a browser.
The notebooks in this repository were created by Element 84.