Ndvi2Gif Tutorial#

Welcome to the comprehensive tutorial for Ndvi2Gif, a Python library for multi-seasonal remote sensing analysis with Google Earth Engine.

Ndvi2Gif Banner

What is Ndvi2Gif?#

Ndvi2Gif is a powerful remote sensing analytics suite that simplifies access to global satellite data through Google Earth Engine. While its name highlights the ability to create seasonal GIF animations, the true power of this tool lies in its capability to compute and export pixel-wise statistics for any region on Earth, across any time span covered by supported remote sensing datasets.

Key Features#

  • ๐Ÿ›ฐ๏ธ Multi-Sensor Support: Sentinel-1/2/3, Landsat 4-9, MODIS, ERA5-Land, CHIRPS (7 platforms)

  • ๐Ÿ“Š 88 Variables: 40+ vegetation indices + 47 ERA5 climate variables + CHIRPS precipitation

  • ๐ŸŒก๏ธ Climate Analysis: Temperature, precipitation, soil moisture, radiation, wind (1950-present)

  • ๐Ÿค– Machine Learning: Supervised and unsupervised land cover classification (8 algorithms)

  • ๐Ÿ“ˆ Time Series Analysis: Trend detection, phenology metrics, climate statistics

  • ๐ŸŒ Global Coverage: Process any region on Earth with intelligent data type handling

  • ๐Ÿ“ค Flexible Export: GeoTIFF, Google Drive, Earth Engine Assets

  • ๐ŸŽจ Visualization: Automated GIF generation and interactive dashboards

What Youโ€™ll Learn#

This tutorial will guide you through:

  1. Getting Started: Installation, authentication, and your first analysis

  2. Core Tutorials: Step-by-step guides for common workflows

  3. Advanced Features: SAR processing, time series, classification

  4. Use Cases: Real-world applications in agriculture, wetlands, drought assessment

  5. Reference: Complete API documentation and indices catalog

Quick Example#

import ee
from ndvi2gif import NdviSeasonality

# Authenticate and initialize
ee.Initialize()

# Create seasonal NDVI composite
ndvi = NdviSeasonality(
    roi='your_area.shp',
    sat='S2',
    periods=12,
    start_year=2023,
    end_year=2024,
    index='ndvi'
)

# Generate animated GIF
ndvi.get_gif('ndvi_evolution.gif')

Who Should Use This Tutorial?#

  • ๐ŸŒพ Agricultural researchers monitoring crop phenology

  • ๐ŸŒŠ Environmental scientists assessing water quality

  • ๐ŸŒณ Ecologists studying vegetation dynamics

  • ๐Ÿ›ฐ๏ธ Remote sensing analysts working with multi-temporal data

  • ๐ŸŽ“ Students learning satellite image analysis

Prerequisites#

  • Basic Python knowledge

  • Familiarity with geospatial concepts (optional but helpful)

  • Google Earth Engine account (free for research and education)

Support & Community#

Citation#

If you use Ndvi2Gif in your research, please cite:

@software{garcia_diaz_ndvi2gif_2025,
  author = {Garcรญa Dรญaz, Diego},
  title = {ndvi2gif: Multi-Seasonal Remote Sensing Analysis Suite},
  url = {https://github.com/Digdgeo/Ndvi2Gif},
  version = {1.0.0},
  year = {2025}
}

Letโ€™s get started! ๐Ÿš€