Skip to content

About

Examples and tutorials for accessing LCMS data. LCMS is produced by RedCastle Resources and the US Forest Service via an enterprise agreement with Google.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

23 Commits

Folders and files

Repository files navigation

LCMS Outreach — Data Access and Analysis in Google Earth Engine

LCMS    USDA Forest Service    RedCastle Resources

LCMS data access and analysis. Notebooks and examples, developed for the Ecological Society of America (ESA) Meeting, July 2026, Salt Lake City.

This repo contains two workshop notebooks, standalone examples, and reporting scripts demonstrating how to access and analyze the USDA Forest Service Landscape Change Monitoring System (LCMS) in Google Earth Engine (GEE) using the geeViz Python library.

If you are new to LCMS, start with the notebooks/lcms_introduction.ipynb notebook. If you are interested in a deeper dive into forest management and recovery, try the notebooks/macdunn_harvest_recovery.ipynb notebook.

Keep an eye out for additional comments, or submit requests for examples using Issues or pull requests. We welcome contributions and feedback!

LCMS is also accessible via the LCMS Data Explorer GUI, the GEE catalog, and the USFS Raster Data Gateway.


What is LCMS?

Willamette_NF_Change.gif

The Landscape Change Monitoring System (LCMS) is an annual remote sensing product produced by the USDA Forest Service Geospatial Office (GO). It maps land cover, land use, and change processes across CONUS, Alaska, Hawaii, Puerto Rico, and the US Virgin Islands 30 m resolution from 1985 to present.

Three annual thematic products:

Band Description Key Classes
Change The dominant change process Wildfire, Insect/Disease, Tree Removal, Vegetation Gain, Stable, …
Land_Cover What is physically on the ground Trees, Shrubs, Grass/Forb/Herb, Barren, Water, Snow/Ice
Land_Use How the land is used or managed Forest, Agriculture, Developed, Rangeland/Pasture, Other

GEE catalog asset: 'projects/gtac-data-publish/assets/LCMS/Product_Version/2025-11' (latest release; covers 1985–2025)


Repository Structure

lcms-outreach/
├── README.md                          ← you are here
├── requirements.txt                   ← Python dependencies
│
├── notebooks/                         ← Workshop notebooks (start here)
│   ├── lcms_introduction.ipynb        ← Intro: H.J. Andrews Experimental Forest
│   └── macdunn_harvest_recovery.ipynb ← Deep dive: McDonald-Dunn harvest/recovery
│
├── examples/                          ← Standalone scripts and supplemental notebooks
│   ├── LCMS_Levels_Viewer_Notebook.ipynb  ← Crosswalk LCMS to different thematic levels
│   └── time_lapse_example.py          ← Minimal time-lapse script
│
├── reporting/                         ← geeViz report generation examples
│   ├── report_gsl_landcover.py        ← Great Salt Lake land cover report
│   └── report_lolo_fire.py            ← Lolo National Forest fire report
│
├── data/
│   ├── aois/                          ← Study area GeoJSON boundaries
│   └── metadata/                      ← LCMS class lookup tables (JSON)
│
└── resources/
    ├── 20260730_ESA_Workshop_Slides.pdf  ← Slide deck presented at Ecological Society of America (ESA) Meeting, Salt Lake City, July 2026
    ├── Housman_etal_LCMS_2026.pdf  ← Publication in Nature Scientific Data describing LCMS methods and products
    └── LCMS_v2024-10_Data_Explorer_Overview.pdf  ← LCMS Explorer GUI walkthrough

Notebooks

notebooks/lcms_introduction.ipynb

Study area: H.J. Andrews Experimental Forest — a 64 km² Long Term Ecological Research (LTER) site in the western Oregon Cascades with experimental harvest in the 1950s through 70s, followed by natural recovery and watershed-specific experimentation. Check out this timeline of research and management events: H.J. Andrews Timeline.

Research question: What can 40 years of LCMS data reveal about land cover and change at a long-term ecological research site?

Section Analysis
1 · Setup GEE authentication and library imports
2 · Study Area H.J. Andrews boundary and watersheds from local GeoJSON
3 · Load LCMS Filter collection, inspect bands and class tables
4 · Interactive Map geeViz map with Land Cover, Land Use, and Change layers (2025)
5 · Time Lapse Animated slider through all three LCMS bands, 1985–2025
6 · Change Agents Over Time Annual area chart of key disturbance classes
7 · Land Cover Over Time Stacked area chart of all Land Cover classes 1985–2025
8 · Tree Canopy Cover USFS TCC product paired with LCMS Change record
9 · Next Steps Interpretation guide and ideas for further exploration

notebooks/macdunn_harvest_recovery.ipynb

Study area: McDonald-Dunn Research Forest — ~11,500 acres in the Oregon Coast Range foothills, actively managed by Oregon State University with well-documented harvest history.

Research question: How do actively managed compartments cycle through LCMS-detectable change and recovery stages across the 40-year record?

Section Analysis
1 · Setup GEE authentication and library imports
2 · Study Area McDonald-Dunn boundary and age-class polygons
3 · Load LCMS Filter collection, inspect Change classes relevant to active management
4 · Interactive Map Current land cover + harvest history layers
5 · Age-Class Stands Select representative stands per harvest age class (9–60 years)
6 · Recovery Trajectories Annual Land Cover % per stand from 1985–2025
7 · Change Agent Signatures Tree Removal and Successional Growth timing per stand
8 · Combined Comparison Tree cover % across all age classes on one chart
8b · TCC Trajectories USFS Tree Canopy Cover % per stand
8c · TCC + Change Agent Side-by-side panels: canopy cover vs. change agents
9 · Land Use Sankey Land Use transition flow diagram across four decades
10 · Time-Lapse Map Animated Change and Land Cover, 1985–2025
11 · Bonus Classify every pixel by years-as-trees (successional maturity proxy)
12 · Takeaways Key findings and next steps

Examples

examples/LCMS_Levels_Viewer_Notebook.ipynb

Demonstrates how to crosswalk LCMS products to different thematic levels — remapping the full class set to coarser aggregations and updating symbology accordingly. Covers all three products (Change, Land Cover, Land Use) and shows how accuracy changes across levels.

examples/time_lapse_example.py

Minimal standalone script showing how to build an LCMS time-lapse animation with geeViz.


Reporting Scripts

Scripts in reporting/ demonstrate using LCMS data with the geeViz Report API — generating multi-section HTML analysis reports for a given study area.

Script Study Area / Topic
report_gsl_landcover.py Great Salt Lake — land cover change report
report_lolo_fire.py Lolo National Forest — fire disturbance report

Setup

Prerequisites

  • A Google Earth Engine account — sign up free
  • A GEE Cloud Project — create one (free for non-commercial use, but with computation limits)
  • Python ≥ 3.9

Install dependencies

pip install -r requirements.txt

Authenticate with GEE

Run this once per machine:

earthengine authenticate

Or call ee.Authenticate() inside the first notebook cell (already included, commented out).

Open a notebook

jupyter lab
# or
jupyter notebook

Then open a notebook from the notebooks/ folder and run cells top-to-bottom (Kernel → Restart & Run All). The recommendation is to start with the lcms_introduction.ipynb notebook, then move on to macdunn_harvest_recovery.ipynb.

⚠️ Replace 'your-project-id' in the Setup cell with your actual GEE Cloud project ID before running.


Key Libraries

Library Purpose
earthengine-api Python client for Google Earth Engine
geeViz USFS GTAC visualization and analysis toolkit built on EE
plotly Interactive charts (included via geeViz)
pandas DataFrame manipulation

LCMS Data Access

Additional Resources

  • LCMS Home page - Official LCMS site with links to data, methods, and documentation
  • geeViz documentation - Python library for visualizing and analyzing data in GEE
  • geeViz MCP documentation - Info for setting up a model context protocol (MCP) to facilitate natural-language prompting for GEE analysis
  • Training for Building LCMS — a separate repo with example notebooks for building LCMS products in GEE. Originally delivered at Geo for Good 2023.

LCMS Data Explorer Instructions

See tutorials/LCMS_v2024-10_Data_Explorer_Overview.pdf for a step-by-step GUI walkthrough of the LCMS Data Explorer web application.

Methods

Methods | LCMS v2025-11 Methods

LCMS User Survey

Enjoying the LCMS data and tools? Please consider filling out the LCMS User Survey to help us improve future releases.

Citations

Peer-reviewed publication

Housman, I.W., Healey, S.P., Heyer, J., Hardwick, E., Zhiqiang, Y., Ross, J., and Megown, K. Coincident maps of changing land cover, land use, and forest condition in the United States, 1985-present. Sci Data 13, 575 (2026). https://doi.org/10.1038/s41597-026-06743-0

License

Code in this repository is released under the Apache License 2.0. LCMS data are produced by RedCastle Resources and the USDA Forest Service via an enterprise agreement with Google; see their data use policy for citation requirements.

About

Examples and tutorials for accessing LCMS data. LCMS is produced by RedCastle Resources and the US Forest Service via an enterprise agreement with Google.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages