The Open Rainfall Initiative

Naaulu is a powerful toolbox to estimate, combine, verify and visualize high-resolution precipitation datasets.

Get Started View on GitHub

Features

!!! WORK IN PROGRESS !!!

Rainfall Estimation

Process raw weather radar reflectivity measurements using a basic (Dove) or advanced (Eider) method.

Dataset Combination

Seamlessly combine high resolution datasets into coarser spatial and temporal resolution.

Gauge Verification

Validate estimation accuracy against local or global rain gauge networks using various error metrics.

Plots & Animations

Generate precise 2D spatial figures, sequential temporal video animations, and complete 3D renders of rainfall evolution with built-in mapping tools.

Installation

Bash 
# Clone the repository
git clone https://github.com/naaulu/naaulu.git
cd naaulu

# Check and run the install script
./install.sh

# Activate the python environement
source .venv/bin/activate
PowerShell 
# Clone the repository
git clone https://github.com/naaulu/naaulu.git
cd naaulu

# Check and run the install script
.\install.ps1

# Activate the python environement
.\.venv\Scripts\Activate.ps1

Quickstart

1

Estimate Rainfall

Compute rainfall estimations from radar data at base resolution (5min, 1km). Define the country code (e.g., est), and product method (i.e., dove or eider).

CLI 
naaulu estimate \
  --first 20250711T180500 \
  --last 20250711T190000 \
  --country est \
  --product dove \
2

Combine Into Final Products

Combine the computed partial estimates over a specific duration and resolution:

CLI 
naaulu combine \
  --first 20250711T190000 \
  --country est \
  --duration pt1h \
  --resolution 2km \
  --product dove \
3

Generate Plots & Visualization

Render a high-quality spatial plot of the combined rainfall accumulation:

CLI 
naaulu plot \
  --first 20250711T190000 \
  --country est \
  --duration pt1h \
  --resolution 2km \
  --product dove \
  --network est/ghcn \
  --show \
Rainfall plot example
4

Verify Against Gauges

Validate the rainfall estimates against rain gauge observations and display the scatter plot with error metrics:

CLI 
naaulu verify \
  --first 20250711T190000 \
  --country est \
  --duration pt1h \
  --resolution 2km \
  --product dove \
  --network est/ghcn \
  --show \
Verification scatter plot