Skip to content

tberends/google-groundsource-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Groundsource Flood Explorer

Interactive web explorer for Google's Groundsource dataset — a collection of 2.6 million flood events extracted from news articles across 150+ countries (2000–2026).

Features

  • Heatmap — geographic density visualization of flood events on a dark-themed world map
  • Timeline — bar chart showing monthly event counts with interactive range selection
  • Animation — step through months to see how flood reporting evolves over time
  • Brush selection — drag handles on the timeline to filter the map to a specific date range
  • Detail view — zoom in to see per-event geometries with popups for UUID, dates and area
  • Dataset info overlay — in-app description of methodology, validation and references

Website

The application can be explorer via https://tberends.github.io/google-groundsource-explorer/

Data

The raw dataset (groundsource_2026.parquet, 636 MB) is not included in the repository. The site uses pre-processed JSON files in the data/ directory generated by the preprocessing scripts.

Re-generate data files

  1. Download the parquet file from Zenodo and place it in the repo root
  2. Install dependencies: pip install -r requirements.txt
  3. Generate timeline and heatmap data: python scripts/preprocess.py
  4. Generate per-tile geometry detail files: python scripts/preprocess_tiles.py

Dataset reference

Mayo, R., Zlydenko, O., et al. (2026). Groundsource: A Dataset of Flood Events from News. Google Research.

About

Explorer of Google's Groundsource dataset consisting of flood events from news

Resources

License

Stars

Watchers

Forks

Contributors