Skip to content

Repository files navigation

AlphaEarth Change Detection — UT Austin Geoscience Hackathon

Our project leverages cutting-edge remote sensing to identify and monitor land cover changes, visualizing our changing world with effective and efficient data sources. By integrating advanced algorithms and datasets, we provide a comprehensive tool for understanding the dynamics of our changing planet — supporting researchers and professionals across geography and geology to detect, measure, and analyze the changes that interest them.

Click here for an interactive dashboard.

For a narrative walkthrough, open notebooks/AlphaEarth_Story.ipynb (visualizations are interactive and cannot be rendered on GitHub; see screenshots below).


Team Alpha

Mentor: Dr. Brendon Hall — Sr. Manager in AI for Energy & Utilities, Deloitte

Meet The Team


Quickstart

1. Set up the environment

conda env create -f environment.yml
conda activate alphaearth

2. Authenticate with Google Earth Engine

earthengine authenticate
python -m ipykernel install --user --name alphaearth --display-name "alphaearth"

Need a GEE project? Register at earthengine.google.com. Free tier is sufficient.

3. Launch notebooks

jupyter lab

Run in this order:

#NotebookPurpose
1notebooks/alpha_tutorial.ipynbAlphaEarth K-means clustering intro
2notebooks/AlphaEarth_Story.ipynbMain narrative: cosine similarity, dam detection, Austin urban growth
3notebooks/AlphaEarth_Interactive_Mapping.ipynbDraw AOI → real-time change detection + inspector
4notebooks/AlphaEarth_LandTrendr_ChangeComparison.ipynbSide-by-side comparison across 15 sites + IoU analysis
5notebooks/LandTrendr_AlphaEarth.ipynbDeep-dive LandTrendr statistics; exports CSVs to outputs/

4. Smoke test (no GEE auth required)

python -m scripts.smoke_test

What We Built

Detect and compare land-use change across 15 western U.S. sites using two complementary algorithms:

AlgorithmMethodTime range
AlphaEarthCosine similarity on 64-dim satellite embeddings (GOOGLE/SATELLITE_EMBEDDING/V1/ANNUAL)2017–2024
LandTrendrSpectral-temporal NDVI trajectory fitting (Landsat)2016–2024

Both produce three standardized layers — YOD (year of change), MAG (magnitude), DUR (duration) — and IoU analysis compares their overlap.

Study sites (15):

CategorySites
UrbanizationAustin TX, Dallas TX, Houston TX, Bend OR, Portland OR, Sacramento CA
WildfiresBootleg OR (2021), Camp Fire CA (2018), Dixie CA (2021), Mosquito CA (2022), Santiam OR (2020)
Forest / LoggingAngelina TX, Coos Bay OR, Mt Hood OR, Shasta-Trinity CA

Repository Layout

AlphaEarthHack/
├── notebooks/ # Main Jupyter notebooks (run in order above)
├── scripts/ # smoke_test.py
├── src/ # Shared constants (EE asset paths, thresholds)
├── images/ # Figures referenced in notebooks and README
├── outputs/ # Generated CSVs / PNGs (git-ignored)
├── data/ # Local data placeholder (git-ignored)
├── backup/ # Archived exploratory notebooks
├── environment.yml # Conda environment spec (Python 3.12)
└── pyproject.toml # Ruff lint config

Visualizations

Global ViewYears Side-By-Side
Global ViewYears Side by Side
Cosine Similarity (areas of change)Similar Feature Detection
Cosine SimilaritySearch
AlphaEarth MagnitudeAlphaEarth Duration
AE_Mag_masked_AustinAE_Dur_masked_Austin
LandTrendr MagnitudeLandTrendr Duration
LandTrendr_Mag_masked_AustinLandTrendr_Dur_masked_Austin
Interactive Dissimilarity PlotExport Options
Interactive_AE_dissimilarity_plot_TESLA_AustinInteractive_AE_exporting_options_TESLA_Austin

IoU comparison across 15 sites


Open Source Libraries & Datasets

Google DeepMind · Google AlphaEarth · LandTrendr · GeoAI · NumPy · tqdm · ipyleaflet · Google Earth Engine · Leaflet.js · Plotly.js


References

Brown, C. F., et al. (2025). AlphaEarth Foundations. arXiv:2507.22291.

Kennedy, R. E., et al. (2018). Implementation of the LandTrendr Algorithm on Google Earth Engine. Remote Sensing, 10(5), 691.

Gorelick, N., et al. (2017). Google Earth Engine: Planetary-scale geospatial analysis for everyone. Remote Sensing of Environment, 202, 18–27.

Harris, C. R., et al. (2020). Array programming with NumPy. Nature, 585, 357–362.

Janowicz, K., et al. (2020). GeoAI. Int. J. Geographical Information Science, 34(4), 625–636.

da Costa-Luis, C. O. (2019). tqdm. Journal of Open Source Software, 4(37), 1277.


License

BSD 3-Clause — see LICENSE.

Releases

Packages

Used by

Contributors

Languages