geeviz 2025.10.1

A package to help with GEE data processing, analysis, and visualization

geeViz

The Earth Engine Visualization Toolkit for Python

Docs Google Earth Engine

---

geeViz makes exploring, visualizing, and analyzing Earth Engine data and geospatial imagery easy in Python. Whether you’re an analyst, scientist, or just getting started, geeViz offers interactive mapping, time series, and advanced charting—without the JavaScript overhead.

Developed by RedCastle Resources, geeViz features a powerful, customizable map viewer and Pythonic interfaces for working with Google Earth Engine (GEE).

---

🌟 Key Features

• 🌎 Interactive Map Viewer (launches in your browser)
• 🔍 Layer toggling, opacity, visualization tools, querying, & area charting
• ⏳ Dynamic time-lapse creation from GEE ImageCollections
• 📈 Built-in charting & analysis tools (point/polygon, time series, area stats)
• 📝 Jupyter/Colab support and standalone scripting
• ⚡ Supports Landsat, Sentinel-2, MODIS, LCMS, LCMAP, and more
• 🏗️ Extensive examples and ready-to-run wrappers

---

🌍 Quick Links

• 📦 PyPI: pypi.org/project/geeViz
• 🔗 Docs/Home: geeviz.org
• 📝 Notebooks & Scripts: examples/
• 👫 Community Repo: github.com/gee-community/geeViz
• 🏛️ Forest Service GitHub: code.fs.usda.gov/forest-service/geeViz

JavaScript Version & Related Links

• GEE Playground Module
• JS Modules on GitHub
• Forest Service JS Repo

---

📚 Documentation & Help

• geeViz Documentation and API Reference
• See examples/ for Jupyter/Colab notebooks and scripts.
• Need help? Email us at [e-mail].

---

🚀 Installation

The fastest way to get started:

1. Sign up for Google Earth Engine
2. Install geeViz via pip:

   pip install geeViz
   

3. Authenticate your Google account with Earth Engine:

   earthengine authenticate
   

---

Manual / Advanced Installation

1. Install the Earth Engine Python API if not present:

   pip install earthengine-api
   

2. Clone this repository:

   git clone https://github.com/gee-community/geeViz
   

3. Optionally, add or symlink the geeViz folder to your Python site-packages.

4. To update to the latest version:

   pip install geeViz --upgrade
   

   or, if installed via Git:

   git pull origin master
   

geeViz is also mirrored at code.fs.usda.gov/forest-service/geeViz.

---

🛠️ Getting Started

geeViz comes with ready-to-run examples and templates for fast onboarding.

▶️ Example: Launch in Python Authenticate and then try: from geeViz.examples import geeViewExample Explore other examples: from geeViz.examples import timeLapseExample from geeViz.examples import getLandsatWrapper from geeViz.examples import getSentinel2Wrapper from geeViz.examples import getCombinedLandsatSentinel2Wrapper from geeViz.examples import harmonicRegressionWrapper from geeViz.examples import LANDTRENDRWrapper from geeViz.examples import LANDTRENDRViz from geeViz.examples import CCDCViz from geeViz.examples import lcmsViewerExample from geeViz.examples import LCMAP_and_LCMS_Viewer from geeViz.examples import phEEnoVizWrapper from geeViz.examples import GFSTimeLapse

---

📒 Use with Jupyter & Colab

• Interactive notebooks are in the examples/ directory (see docs ➔).
• The geeViz map viewer also works directly inside Jupyter and Google Colab.

---

🗺️ Features at a Glance

• One line mapping: Map any GEE image or collection instantly
• Interactive: Toggle layers, set opacity, area/point query, and chart
• Dynamic Time-Lapses: Animate temporal stacks and export GIFs
• No JavaScript required: Pure Python interface

---

🙌 Contributing

We love contributions and new users!

• Share a GEE script, notebook, or suggestion?
  📩 [e-mail]
• Pull requests & feature requests:
  github.com/gee-community/geeViz

---

📄 License

geeViz is released under the Apache 2.0 License.
See the LICENSE file for details.