[general]
name=Rain to Flood Analysis
qgisMinimumVersion=3.16
description=A comprehensive hydrological analysis tool that transforms rainfall data into flood inundation maps. The plugin performs rainfall frequency analysis, runoff calculations using SCS methods, generates flood hydrographs, creates flood inundation maps, and produces HEC-HMS compatible outputs. It supports multiple rainfall data sources including IMD, CHIRPS, Open-Meteo, and Excel files for both daily and hourly analysis.
version=2.1
author=Rahul Pandey
email=rahulpandey696@gmail.com
about=This advanced hydrological plugin processes rainfall data from multiple sources (IMD, CHIRPS, Open-Meteo, Excel) to perform comprehensive flood analysis. Key features include: 24-hour standard flood analysis, flash flood analysis with hourly data, DEM and slope processing, frequency analysis using Gumbel/Log-Pearson III/GEV methods, SCS Curve Number runoff calculations, unit hydrograph generation, flood inundation mapping, and HEC-HMS input file export. The plugin is designed for hydrologists, water resources engineers, and flood risk assessment professionals.
changelog=Version 2.1: Added Flash Flood Analysis with hourly data support; Added Open-Meteo and Excel data sources; Enhanced DEM and slope processing; Improved flood mapping algorithms; Added HEC-HMS export functionality; Fixed CHIRPS data extraction for global users; Added dependency management system\n\nVersion 1.1: Initial release with basic IMD and CHIRPS support, standard 24-hour flood analysis
tracker=https://github.com/rahulpandey696/Rain2Flood/issues
repository=https://github.com/rahulpandey696/Rain2Flood
homepage=https://github.com/rahulpandey696/Rain2Flood
tags=hydrology,flood,rainfall,analysis,hec-hms,water,discharge,inundation,scs-curve-number,unit-hydrograph,frequency-analysis,imd,chirps,open-meteo
icon=icon.png
category=Hydrology
experimental=False
deprecated=False
plugin_dependencies=imdlib,xarray,geopandas,rasterio,shapely,scipy,pandas,numpy,matplotlib,openpyxl

[settings]
hasProcessingProvider=yes
hasProjectProvider=no

[qgis]
minimum_version=3.16
maximum_version=4.99
default_separator=;

[license]
name=GNU GPL v3+
file=LICENSE

[requirements]
os=windows,linux,osx
python_requires=3.7
pip_requires=imdlib,xarray,geopandas,rasterio,shapely,scipy,pandas,numpy,matplotlib,openpyxl

[changelog]
2.1=Added Flash Flood Analysis with hourly rainfall support; Added Open-Meteo API integration for global hourly/daily data; Added Excel file support for custom rainfall data; Enhanced DEM and slope processing with automated catchment extraction; Improved flood mapping with Manning's equation-based depth calculation; Added HEC-HMS input file export functionality; Fixed CHIRPS data extraction for global users; Added comprehensive dependency management system; Improved user interface with point selection from map and calendar widgets; Added multiple analysis methods (SCS Unit Hydrograph, Rational Method, Time-Area Method)
1.1=Initial release: Basic IMD and CHIRPS rainfall data support; Standard 24-hour flood frequency analysis; SCS-CN runoff calculations; Basic flood mapping capabilities

[algorithm_flood_analysis]
description=Standard 24-Hour Flood Analysis: Performs comprehensive hydrological analysis using daily rainfall data. Computes design rainfall for various return periods, calculates peak discharge using SCS methods, generates flood hydrographs, and creates flood inundation maps.

[algorithm_flash_flood_analysis]  
description=Flash Flood Analysis (Hourly): Specialized analysis for short-duration flood events using hourly rainfall data. Calculates short-duration maxima (1hr, 3hr, 6hr, 12hr, 24hr), performs frequency analysis, and generates flash flood hydrographs with improved visualization.

[algorithm_dem_slope_processing]
description=DEM and Slope Processing: Preprocesses digital elevation models by reprojecting to target CRS, cropping to catchment boundaries, and calculating slope percentages. Essential preparation step for accurate flood modeling.

[algorithm_rainfall_downloader]
description=Rainfall Data Downloader: Downloads rainfall data from multiple sources including Open-Meteo (global hourly/daily), IMD (India), and processes Excel files. Generates rainfall statistics and visualization graphs.

[references]
reference1=Nandi, Saswata, Pratiman Patel, and Sabyasachi Swain. "IMDLIB: An open-source library for retrieval, processing and spatiotemporal exploratory assessments of gridded meteorological observation datasets over India." Environmental Modelling & Software 171 (2024): 105869.
reference2=Funk, C. et al. "The climate hazards infrared precipitation with stations—a new environmental record for monitoring extremes." Scientific Data 2.1 (2015): 1-21. (CHIRPS)
reference3=Soil Conservation Service (SCS). "National Engineering Handbook, Section 4: Hydrology." USDA, 1972.
reference4=Open-Meteo API: https://open-meteo.com/