Module Overview

The geeViz package provides a comprehensive suite of modules for working with Google Earth Engine in Python. Below is an overview of the core modules available in geeViz.

Core Visualization Modules

geeViz.geeView

Interactive map viewer for Earth Engine datasets. Provides the primary mapper class for creating web-based visualizations with support for querying, charting, and layer management.

geeViz.foliumView

Alternative map viewer using Folium for lightweight, static map generation and Jupyter notebook integration.

Image Processing & Analysis

geeViz.getImagesLib

Comprehensive wrapper functions for accessing and processing Landsat, Sentinel-2, MODIS, and other satellite imagery. Handles compositing, cloud masking, and standardized preprocessing. Preferred Sentinel-2 function: superSimpleGetS2().

geeViz.changeDetectionLib

Tools for running and visualizing change detection algorithms including LandTrendr, CCDC, and VERDET. Includes segmentation and temporal analysis utilities.

geeViz.phEEnoViz

Phenology visualization and analysis tools for examining vegetation temporal patterns and seasonal dynamics.

Output Libraries (geeViz.outputLib)

geeViz.outputLib.charts

Zonal summary and charting library. Auto-detects thematic vs. continuous data, produces Plotly charts (time series, bar, donut, scatter) and D3 Sankey transition diagrams with gradient-colored links. Use chart_type='sankey' for Sankey charts. Formerly geeViz.chartingLib.

geeViz.outputLib.thumbs

Publication-ready thumbnails, animated GIFs, and filmstrip grids from Earth Engine imagery. Includes auto-visualization detection, basemap compositing, projected CRS support, scalebar, north arrow, inset map, and legend rendering.

geeViz.outputLib.reports

Automated report generation combining thumbnails, charts, Sankey diagrams, data tables, and LLM-generated narratives (via Gemini). All EE data requests run in parallel. Supports HTML, Markdown, and PDF with dark/light themes.

geeViz.outputLib.themes

Unified theme system for consistent colors across charts, thumbnails, and reports. Provides named presets (dark, light, teal) and auto-generation from a background color.

Summary Areas

geeViz.getSummaryAreasLib

Functions returning filtered ee.FeatureCollection objects for administrative boundaries (levels 0–4 from geoBoundaries, FAO GAUL, or FieldMaps), USFS units (forests, districts, regions), US census geographies (tracts, block groups, blocks, urban areas), buildings, roads (TIGER 2012-2025 and GRIP4 global), and protected areas.

External Data

geeViz.edwLib

USFS Enterprise Data Warehouse (EDW) REST API client. Search, inspect, and query ~215 Forest Service geospatial services (fire, ownership, vegetation, roads, etc.). Returns GeoJSON loadable into Earth Engine.

geeViz.googleMapsLib

Google Maps Platform client for ground-truthing remote sensing analysis. Includes geocoding, places search, Street View imagery, panorama stitching, AI interpretation (Gemini), semantic segmentation (SegFormer), elevation, air quality, solar, and more. Requires GOOGLE_MAPS_PLATFORM_API_KEY and optionally GEMINI_API_KEY in a .env file.

Data Management Modules

geeViz.taskManagerLib

Utilities for managing Earth Engine export tasks, monitoring progress, and handling batch exports to Drive, Cloud Storage, or Assets.

geeViz.assetManagerLib

Functions for managing Earth Engine assets including uploading, deleting, copying, and organizing asset collections.

geeViz.cloudStorageManagerLib

Tools for interacting with Google Cloud Storage, including uploading, downloading, and managing geospatial data in cloud buckets.

geeViz.gee2Pandas

Utilities for converting Earth Engine data structures (FeatureCollections, charts, zonal statistics) to pandas DataFrames for further analysis.

AI-Assisted Development

geeViz.mcp.server

MCP (Model Context Protocol) server that gives AI coding assistants live access to geeViz and Earth Engine. 22 tools for code execution, API introspection, asset inspection, map control, Google Maps, and report generation. Charting, thumbnails, and EDW queries are accessed via run_code. See the MCP Server guide for setup.

Module Reference

geeViz.geeView	View GEE objects using Python
geeViz.getImagesLib	Get images and organize them so they are easier to work with
geeViz.changeDetectionLib	Apply change detection methods usin GEE
geeViz.outputLib.charts	Zonal Summary & Charting Library for GEE
geeViz.outputLib.thumbs	Generate Earth Engine thumbnails with automatic visualization handling.
geeViz.outputLib.reports	Generate reports from Earth Engine data with LLM-powered narratives.
geeViz.outputLib.themes	Unified theme system for geeViz output libraries.
geeViz.getSummaryAreasLib	Functions for retrieving common summary and study area FeatureCollections.
geeViz.edwLib	USFS Enterprise Data Warehouse (EDW) REST API client.
geeViz.googleMapsLib	Google Maps Platform client for geeViz.
geeViz.taskManagerLib	Monitor and manage tasks programatically
geeViz.assetManagerLib	Helpful functions for managing GEE assets
geeViz.cloudStorageManagerLib	Helpful functions for managing Google Cloud Storage (GCS) buckets and blobs
geeViz.gee2Pandas	Take data from GEE to Pandas and back
geeViz.foliumView	View GEE objects using Folium.
geeViz.phEEnoViz	Visualize the spectral seasonality of an area to facilitate composting methods development
geeViz.mcp.server	geeViz MCP Server -- execution and introspection tools for Earth Engine via geeViz.