{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "title-welcome",
   "metadata": {},
   "source": [
    "# Earth Data Challenge: Intro Demo Notebooks\n",
    "\n",
    "These notebooks showcase cloud-based Earth data analysis. Most of them use **Google Earth Engine** and **geemap**.\n",
    "\n",
    "Each demo is self-contained (5-7 minutes) and teaches a different remote sensing concept or dataset. You can work through them in order or jump to topics that interest you."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "what-youll-learn",
   "metadata": {},
   "source": [
    "## What You'll Learn\n",
    "\n",
    "These demos cover:\n",
    "- **Remote sensing fundamentals**: NDVI, surface temperature, change detection\n",
    "- **Multiple sensor types**: optical (Sentinel-2, MODIS), radar (Sentinel-1), thermal\n",
    "- **Different Earth systems**: agriculture, cities, rivers, oceans, atmosphere, soil\n",
    "- **Practical skills**: filtering image collections, computing indices, creating visualizations, exporting data"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "the-demos",
   "metadata": {},
   "source": [
    "## The Demos\n",
    "\n",
    "---\n",
    "\n",
    "### 00 - GEE Connect\n",
    "**Purpose**: Required setup for all Google Earth Engine notebooks  \n",
    "**What it does**: Initializes your connection to Earth Engine and Cloud Storage  \n",
    "**When to use**: Copy this cell and run it at the start of every GEE notebook\n",
    "\n",
    "---\n",
    "\n",
    "### 01 - Missouri NDVI\n",
    "**Question**: How green is Missouri, and how does vegetation health vary across the state?  \n",
    "**Dataset**: Sentinel-2 surface reflectance  \n",
    "**Skills**: Connecting to Earth Engine, loading satellite imagery, computing NDVI, cloud masking, interactive map visualization\n",
    "\n",
    "---\n",
    "\n",
    "### 02 - Watching Crops Grow\n",
    "**Question**: Can we watch crops grow from space throughout the growing season?  \n",
    "**Dataset**: Sentinel-2 surface reflectance  \n",
    "**Skills**: Monthly composites, side-by-side map comparison, creating animated GIFs, tracking vegetation change over time\n",
    "\n",
    "---\n",
    "\n",
    "### 03 - Urban Heat Islands\n",
    "**Question**: Why is downtown St. Louis 10°F hotter than Forest Park?  \n",
    "**Dataset**: MODIS Land Surface Temperature  \n",
    "**Skills**: Thermal remote sensing, temperature unit conversion, comparing temperature to vegetation, extracting point values\n",
    "\n",
    "---\n",
    "\n",
    "### 04 - Mapping a Flood\n",
    "**Question**: How can we map floods when clouds block optical satellites?  \n",
    "**Dataset**: Sentinel-1 SAR (radar)  \n",
    "**Skills**: SAR image interpretation, before/after change detection, flood extent mapping, calculating flooded area\n",
    "\n",
    "---\n",
    "\n",
    "### 05 - Tracking Wildfires\n",
    "**Question**: How did the 2019-2020 Australian \"Black Summer\" fires spread across the continent?  \n",
    "**Dataset**: MODIS Active Fire (MOD14A1), MODIS Burned Area (MCD64A1)  \n",
    "**Skills**: Thermal anomaly detection, fire radiative power, monthly fire progression, burned area statistics\n",
    "\n",
    "---\n",
    "\n",
    "### 06 - Ocean Color and Currents\n",
    "**Question**: What can ocean color tell us about where marine life thrives?  \n",
    "**Dataset**: MODIS-Aqua Ocean Color (chlorophyll-a, sea surface temperature)  \n",
    "**Skills**: Ocean remote sensing, chlorophyll concentration mapping, seasonal patterns, Mississippi River plume\n",
    "\n",
    "---\n",
    "\n",
    "### 07 - Soil Properties\n",
    "**Question**: Why do some fields drain well and others stay muddy?  \n",
    "**Dataset**: OpenLandMap soil data (derived from SSURGO)  \n",
    "**Skills**: Mapping clay content, organic carbon, and pH; comparing soil properties to cropland patterns\n",
    "\n",
    "---\n",
    "\n",
    "### 08 - Earthquake Patterns\n",
    "**Question**: Where do earthquakes occur, and what patterns reveal plate tectonics?  \n",
    "**Dataset**: USGS Earthquake API  \n",
    "**Skills**: Fetching API data, mapping global earthquake patterns, exploring the New Madrid Seismic Zone, magnitude-frequency analysis\n",
    "\n",
    "---\n",
    "\n",
    "### 09 - Climate Trends\n",
    "**Question**: Is Missouri getting warmer? Wetter? How much has climate changed in 40 years?  \n",
    "**Dataset**: ERA5-Land Monthly reanalysis  \n",
    "**Skills**: Working with reanalysis data, computing decadal temperature change, time series plotting, calculating warming rates\n",
    "\n",
    "---\n",
    "\n",
    "### 10 - River Response to Storms\n",
    "**Question**: When it rains in Kansas City, how long until the Missouri River rises in St. Louis?  \n",
    "**Dataset**: USGS Water Services API (streamflow), ERA5 precipitation  \n",
    "**Skills**: Fetching streamflow data, hydrograph analysis, calculating flood wave travel time, connecting rainfall to river response"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "getting-started",
   "metadata": {},
   "source": [
    "## Getting Started\n",
    "\n",
    "**Running a notebook:**\n",
    "1. Double-click a notebook to open it\n",
    "2. Run cells with `Shift+Enter` or the play button\n",
    "3. Run all cells with `Run > Run All Cells`\n",
    "\n",
    "**Using interactive maps:**\n",
    "- Click and drag to pan\n",
    "- Scroll to zoom\n",
    "- Click the layer control (upper right) to toggle layers on/off\n",
    "- Split maps have a draggable slider to compare layers\n",
    "\n",
    "**If something breaks:**\n",
    "- `Kernel > Restart Kernel` clears everything and lets you start fresh\n",
    "- Make sure you run cells in order from top to bottom\n",
    "- If `geemap` isn't found, run the `%pip install` cell and restart the kernel\n",
    "\n",
    "**Want to experiment?**\n",
    "- Make a copy: `File > Save Notebook As...` and save to your team's folder\n",
    "- Don't modify these demo notebooks directly (they're shared!)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "data-sources",
   "metadata": {},
   "source": [
    "## Data Sources\n",
    "\n",
    "These demos use publicly available datasets from:\n",
    "- **Google Earth Engine Data Catalog**: Sentinel-1, Sentinel-2, MODIS, Landsat, ERA5, and more\n",
    "- **USGS**: Earthquake catalog, streamflow data (Water Services API)\n",
    "- **NOAA/ECMWF**: Climate reanalysis, ocean data\n",
    "- **USDA/NRCS**: Soil survey data (via OpenLandMap)\n",
    "\n",
    "All satellite data accessed via [Google Earth Engine](https://earthengine.google.com/)."
   ]
  }
 ],
 "metadata": {
  "environment": {
   "kernel": "edc",
   "name": "workbench-notebooks.m137",
   "type": "gcloud",
   "uri": "us-docker.pkg.dev/deeplearning-platform-release/gcr.io/workbench-notebooks:m137"
  },
  "kernelspec": {
   "display_name": "EEPS EDC (Local)",
   "language": "python",
   "name": "edc"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.10.19"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}