TABLES & FIGURES BY MODULE

[Rwema25]

TABLES & FIGURES BY MODULE

🌾 fetch_data — Climate Data Ingestion

Output Format: CSV, JSON
Tables:

• Daily time-series with columns: date, precipitation, max_temperature, min_temperature, humidity, solar_radiation, wind_speed (varies by source)

Figures: None (raw data only)

---

📅 season_analysis — Rainy Season Detection

Output Format: CSV, JSON
Tables:

• Season Summary (CSV):
  • year, season_number, onset, cessation, regime, length_days, total_rainfall_mm, rainy_days, dry_days, dry_spells, annual_rain_mm, humid_result
  • Livestock metrics: mean_thi, max_thi, thi_stress_days (if livestock mode enabled)
• Long-Term Means (JSON):
  • Per-season aggregates: mean onset date, mean length, mean rainfall, etc.

Figures: None

---

📊 climate_statistics — Climate Metrics & Aggregation

Output Format: JSON (primary) + CSV exports
Tables:

• raw_climate_summary: Mean, Min, Max, Std per variable per season
• overall_statistics: Per season:
  • Precipitation totals & stats
  • Temperature stats (avg, max, min)
  • ET0 (evapotranspiration)
  • Water balance: NDWS, NDWL0, WRSI
  • VPD (vapor pressure deficit)
  • Heat stress: Humidex, THI
• season_statistics: Per-season headline metrics
• monthly_series (CSV): Aggregated daily→monthly data
• spei / spi (CSV): Drought indices with date, value, classification
• annual_summary: Year-by-year humidity test results

Figures: None

---

📈 compare_periods — Historical Period Comparison

Output Format: JSON, Text console
Tables:

• Comparison structure (per variable per season):
  • focal (value for focal year)
  • baseline_avg (average across baseline period)
  • diff (focal - baseline)
  • pct_change ((diff / baseline) × 100)
• Includes: Precipitation, temperature, water stress, heat stress comparisons

Figures: None

---

⚠️ calculate_hazards — Crop Hazard Assessment

Output Format: JSON, Text console, optional CSV
Tables:

• hazard_indicators: For each hazard type:

  Hazard	focal_value	baseline_avg	diff	stress_category	reasoning
  Precipitation	—	—	—	no/moderate/severe/extreme_stress	—
  TAVG (avg temp)	—	—	—	—	—
  NDD (normalized degree days)	—	—	—	—	—
  NTx35 (days >35°C)	—	—	—	—	—
  NTx40 (days >40°C)	—	—	—	—	—
  NDWS (water stress days)	—	—	—	—	—
  NDWL0 (waterlogging days)	—	—	—	—	—
  WRSI (water requirement %)	—	—	—	—	—
  THI (livestock heat index)	—	—	—	—	—
  HUMIDEX (human heat index)	—	—	—	—	—

Figures: None

---

🌦️ weather_station (download) — Station Discovery

Output Format: CSV, JSON, HTML (interactive)
Tables:

• Candidate Stations (CSV):
  • station_id, station_name, distance_km, elevation_diff_m
  • Data completeness per variable: precip_complete_%, temp_complete_%
  • data_years, selection_status, selection_rank, selection_reason

Figures: None (HTML has interactive table with filtering/sorting)

---

🔄 weather_station (compare) — Station vs. Grid Validation

Output Format: JSON, optional CSV, optional HTML + PNG
Tables:

• Validation Metrics (JSON): Per (grid_source, variable) pair:
  • n_overlap_days, correlation, rmse, bias, mae, annual_total_grid, annual_total_station, pct_diff, wet_day_agreement_%
• Daily Comparison (optional CSV):
  • date, grid_source, variable, station_value, grid_value, diff, pct_diff, quality_flag

Figures (optional PNG plots):

• Time-series comparison (grid vs. station over time)
• Scatter plot (grid vs. station values)
• Box plot (distribution by variable/source)

---

🌍 climatology — Climatic Normals & Indices

Output Format: JSON, CSV (per index), optional PNG
Tables:

• WMO Monthly Normals (ltm_monthly):
  • month, precip_mm, tmax_c, tmin_c, humidity_%, solar_rad, et0_mm
• Drought Indices (spei / spi - CSV):
  • date, spei_value / spi_value, classification (wet/normal/moderate_drought/severe_drought/extreme_drought)
• VPD Statistics (vpd):
  • Monthly vapor pressure deficit values
• Livestock Heat Stress (THI - CSV):
  • date, daily_thi, thi_classification (cool/thermal_comfort/heat_stress/severe_heat_stress)
• Human Heat Stress (Humidex - CSV):
  • date, daily_humidex, humidex_classification (comfortable/warm/very_warm/hot/very_hot/dangerous/extreme_caution)

Figures (optional PNG):

• Monthly climatology line plots
• Drought index time-series
• Heat stress categories over time

---

🔗 compare_datasets — Multi-Source Comparison

Output Format: Per-source CSV, Per-source PNG, Multi-source PNG
Tables:

• {source}_annual_timeseries.csv: year, per-variable annual totals/means
• {source}_monthly_climatology.csv: month, per-variable monthly means
• Console summary table: Mean, Min, Max, Std, Coefficient of Variation per source

Figures (PNG at 150 DPI):

• Per-source:
  • {source}_annual_timeseries.png (line plot: annual trends)
  • {source}_monthly_climatology.png (bar or line plot: seasonal pattern)
• Multi-source:
  • multisource_annual_{variable}.png (overlay comparison of all sources, annual)
  • multisource_monthly_climatology_{variable}.png (overlay comparison of all sources, monthly)

---

QUICK SUMMARY TABLE

Module	Primary Output	Tables	Figures	Report
fetch_data	CSV/JSON	Daily time-series	❌	❌
season_analysis	CSV + JSON	Season summary + LTM stats	❌	Console text
climate_statistics	JSON + CSV	Raw summary, overall, seasonal, monthly, SPEI/SPI	❌	JSON + console
compare_periods	JSON	Baseline vs. focal (with diffs & %)	❌	JSON + console
calculate_hazards	JSON	Hazard indicators with stress bands	❌	JSON + console
weather_station (download)	CSV + JSON + HTML	Station candidates with QA metrics	❌	Interactive HTML
weather_station (compare)	JSON + CSV (opt.)	Validation metrics (correlation, RMSE, bias, etc.)	⚠️ Optional	JSON + optional HTML
climatology	JSON + CSV	LTM monthly norms, drought/heat indices	⚠️ Optional	JSON + console
compare_datasets	CSV per source + PNG	Annual & monthly per-source tables	✅ PNG plots	Console statistics

Legend: ❌ = No figures | ⚠️ = Optional figures | ✅ = Figures included

---