The main Python codes for PIPE and derived 142 paired events

This project is an automated Python data processing PIPE workflow designed to identify and quantify precipitation-inundation paired events, mainly including 3 process:  extreme precipitation events extraction, inundation area extraction and 'precipitation-inundation' events pairing. This project consists of three sequential Python scripts and one final CSV output table.

The workflow begins with Precip_Extraction.py, then Inundation_Extraction.py and finally, Paired_Events.py, producing the results to the final output file, Final_Paired_Events.csv.

To run these scripts, you will need to provide your own input data, including: original annual NetCDF precipitation files, basic geospatial shapefiles (like the basin boundary), hydrological shapefiles (river network and catchment units), original daily surface water rasters, and a surface water body occurrence raster.

The included Final_Paired_Events.csv file is the final dataset generated by this workflow. It contains the 142 paired events identified. Each row represents a single paired event, detailing its precipitation dates (Precip_Start_Date, Precip_End_Date), the corresponding minimum and maximum inundation dates (Min_Date, Max_Date), the total precipitation volume (Total_Water_Aligned), the calculated net inundation area (Inundation_Omission_Filled), the Inundation-Precipitation Ratio (IPR), the precipitation's spatial centroid (Lon_C), and the final comprehensive Certainty score for the pairing.

For more details, please refer to:J. Su, P. Lin, K. Zheng, X. Lei, Z. Yin, A. Hou, S. Xie (2025, in review). Observation-Based Spatiotemporal Analysis of the Evolving Flood Regulation Capacity for the Yangtze River Basin.