# Paired storms approach reveals post-fire flood characteristics and drivers- data and visualizations - ReadMe.txt
# Canham, H., Lane, B. (2025). Paired storms approach reveals post-fire flood characteristics and drivers - data and visualizations, HydroShare, 
  Canham, H., B. Lane (2025). Paired storms approach reveals post-fire flood characteristics and drivers - data and visualizations, HydroShare, 
  http://www.hydroshare.org/resource/6fd1abb8ad924bd9a0fa5d197de51059

# Utah Water Research Laboratory
# Utah State University

# September 2025
# Updated December 2025 - updated code and files for revised text

# Contact
	Haley Canham - haley.canham@usu.edu
	Belize Lane - belize.lane@usu.edu

# The intermediate data analysis and data files to visualize post-fire flood-producing storms and quantify change in post-fire runoff using dataset developed by the RREDI Toolkit (Canham & Lane, 2024) and Paired Storms Framework (Canham & Lane, 2025).

# This resource is referenced by:
	Canham, H. A., Lane, B. (in revision). Paired storms approach reveals post-fire flood characteristics and drivers, Water Resources Research 

# This resource is derived from:
	Canham, H., Lane, B. (2025). Paired Storms Framework for Post-Fire Flood Analysis, HydroShare, http://www.hydroshare.org/resource/e232f1ee789a4d03aa276008da2b7afb
	Canham, H., Lane, B. (2024). Rainfall-Runoff Event Detection and Identification (RREDI) toolkit, HydroShare,
		http://www.hydroshare.org/resource/797fe26dfefb4d658b8f8bc898b320de
		
# Contents
	DataFiles -> folder containing all necessary input data files to generate tables and figures
		Watershed Folders -> individual folder for seven study watersheds, contains watershed specific data files referenced by scripts
			ArroyoSeco
			AshCanyonCreek
			CacheLaPoudreRiver
			ClearCreek
			ShitikeCreek
			ValleyCreek
			WetBottomCreek
				Within each watershed folder:
					x_AllRunoff_WYTcorrected.csv -> RREDI toolkit output containing all rainfall-runoff events identified 
					x_AllStormMetrics.csv -> All storms identified including all storm metrics (including disturbance category)
					x_MonthlyValues -> monthly average flow and precipitation 
					x_PostFloods.csv -> identified post-fire flow events identified in this analysis
					x_PostFloods_Storm{}.csv -> Paired storm metrics for identified paired storm for each post-fire flood
					x_StormSun_Grids_max.csv -> Accumulated depth grid for every storm
					Fire_Outline.csv -> Binary grid associated with AORC grid delineating fire outline
					intensity_{}.csv -> storm intensity for each plotted storm in text
					magnitude_{}.csv -> storm magnitude for each plotted storm in text
					Multipliers_x.csv -> calculated multipliers for each post-fire flow peak and paired storm
					OrganizedGrid.csv -> coordinates associated with AORC grid for this watershed
					P_storms_x_1989_2024.csv -> storms identified in RREDI toolkit 
					PFF_ARI_x.xlsx -> annual recurrence intervals for each identified post-fire peak flow 
					Q_I_x_USGSx_x_x.csv -> 15-minute flow from USGS 
					Watershed_Outline.csv -> Binary grid associated with AORC grid delineating watershed outline
		PFFStorms_ARI.xlsx -> Post-fire peak flow storms calculated ARI range 
		PrecipDurInt.csv -> Precip-Duration Intensity curves retrieved from Atlas 14 for each watershed
		Table3.xlsx -> Table 3 data 
	Outputs -> folder to contain outputs from provided scripts. All intermediate analysis and data manipulation was completed using RREDI Toolkit (Canham & Lane, 2024) and Paired Storms Framework (Canham & Lane, 2025).
		Fig1b.png
		Fig3a.png
		Fig4.png
		Fig5.png
		Fig6.png
		Table2_xxx.csv -> Table 2 for individual watersheds
		Table3.xlsx
	Scripts -> folder to contain Figure and table generation scripts
		Fig1b.py
		Fig3a.py
		Fig3B_7abc.py
		Fig4.py
		Fig5.py
		Fig6.py
		Table2.py -> Table 2 for individual watersheds
		libraries.txt -> virtual environment library versions to run scripts