EDA Example Notebooks

This repository is designed to serve as an introduction to the EarthDaily Platform.

NOTE: To gain access to the Earth Data Store data referenced in this repo, please create an EarthDaily account

Installation

The majority of the examples located in this repo rely on the EarthDaily Python client. Each notebook series contains a requirements.txt file containing packages which must be installed ahead of time.

To begin, create a new Python virtual environment >3.10 and activate it, we recommend using Conda. Once your environment is activated, install the dependencies contained in this repository with the following:

pip install -r requirements.txt

NOTE: For detailed environment management instructions, refer to the Virtual Environment Setup Instructions

Authentication

In each notebook directory there is a sample EDS.env file which should be updated with your credentials. This file can be downloaded from the EarthDaily Account Management page:

    EDS_AUTH_URL=https://api.earthdaily.com/account_management/v1/authentication/api_tokens/exchange
    EDS_CLIENT_ID=EARTHDAILY_API_TOKEN
    EDS_SECRET=<Use the Provision new api credentials button to fetch the API token>
    EDS_API_URL=https://api.earthdaily.com/platform/v1/stac

Overview

A general outline of the tutorial notebooks contained in this repo is as follows:

Basic Examples

• Getting Started with EarthDaily.ipynb
• Introduction to EDA Datacubes.ipynb

EarthMosaics

• Introduction to EDA EarthMosaics.ipynb
• EDA Mosaics - EarthMosaics vs Sentinel-2 NDVI.ipynb
• EDA Mosaics - Dixie Fire Burn Extent.ipynb
• EDA Mosaics - Rio Grande do Sul Flood Extent.ipynb

Appendix

Virtual Environment Setup Instructions

Windows - Anaconda and Miniconda

The following are steps to set up a new Conda environment and set up the EarthDaily Python Client:

1. Download and run the .exe located at the Anaconda Downloads page

2. Open the Anaconda Prompt

3. Create a new virtual environment by running the following in your Terminal:

    conda create -n earthdaily jupyter
   

4. Active your new virtual environment by running the following in your Terminal:

    conda activate earthdaily
   

5. Install earthdaily by running the following in your Terminal:

    pip install earthdaily
   

6. Install the EarthDaily Example Notebooks by running the following in your Terminal:

    git clone https://github.com/earthdaily/Example-Notebooks.git
   

7. Initialize the Jupyter Lab client by running the following in your Terminal:

    jupyter lab
   

8. Navigate to the newly cloned Example Notebooks folder