Data, Model files, Results, Figures, and Scripts used in the analysis completed in the paper "Quantifying Dynamic Gains and Losses Using Inverse Water Temperature Modeling" is provided in the accompanying files.

PLEASE NOTE: 
-To run scripts download each zip file in the resource (Data.zip, Figures.zip, Models.zip, and Scripts.zip) and un-zip the files inside a common folder. The provided Python scripts are written using relative paths assuming the above folders are all sub-folders inside one common folder. 

- The HydroCouple Model input and output results for each calibration run used in the calibration of the Base Model and estimation of lateral flows for the Medium and High resolution models are not included do to the number and size of files. The output is available for the optimized calibration solution for each calibration period and the full model period at each resolution. The model temperature and flow output is provide for the top 50 solutions in each calibration period necessary to produce Figures S10-S46 in the Supplemental Information accompanying the manuscript. Python scripts are provided that will conduct the calibration of the Base Model and the estimation of lateral flows. Note that each calibration or lateral flow estimation script takes approximately 24-48 hours to run on a standard workstation desktop computer. HydroCouple input and output files are provided for the finalized models and results shown in the manuscript and SI. Results from the calibration of the base model and lateral flow estimations are provided as .csv files that show the goodness of fit values for each parameter set as described in the manuscript.  

- HydroCouple needs to be installed on the host computer to run any model or model calibration scripts and the absolute file path to the HydroCouple.exe needs to be provided. All scripts that analysis the calibration results or generate figures can be run without installing HydroCouple.
- HydroCouple can be downloaded and installed from the following location: https://www.hydrocouple.org/
- HydroCouple is also hosted on the following GitHub page: https://github.com/HydroCouple

List of Folders and Contents:

Data: Contains data used as input into models. See README_Data.txt file in the Data folder for detailed description of files in subfolders
- Subfolders:
	- Heat_timeseries: heat timeseries for the four gaged tributaries and subfolders containing the timeseries of heat added to or subtracted from each model cell for each model version due to lateral flows.
	- Meteorological_timeseries: meteorological forcing data for the model.
	- Model_Geometry: channel geometry for the model.
	- Q_timeseries: flow timeseries for the gaged tributaries and mainstem sites and subfolders containing the timeseries of flow added to or subtracted from each model cell for each model version due to lateral flows and the interpolated reach scale lateral flows.
	- Radiation_factors_SVF: radiation factors and sky view factors for models.
	- WT_timeseries: Water Temperature timeseries from stream gages and placed HOBO loggers in springs, tributaries, and the river.

Figures: Contains all figures used in the Paper and SI


Models: Contains HydroCouple input and outputs for each model version (Base Calibration, Low Resolution, Medium Resolution, High Resolution) and the results for the lateral flow estimation in each of the 18 model periods for both the medium and high resolution reach resolutions. 
- Subfolders:
	- version_Base_Calibrated_Model_LowerSection: HydroCouple input and output for the base model in the lower section.
	- version_Base_Calibrated_Model_UpperSection: HydroCouple input and output for the base model in the upper section.
	- version_LowResolution_FullModel: HydroCouple input and output for the low resolution model.
	- version_MediumResolution_FullModel: HydroCouple input and output for the medium resolution model.
	- version_HighResolution_FullModel: HydroCouple input and output for the high resolution model.
	- Results: 	- Parameter calibration results for each of the 18 calibration periods, for the medium and high resolutions, and the base model. 
			- the four files named xxxxxSection_xxxxResolution_Top50 contain the model results for flow and temperature for the top 50 optimized solutions for each calibration period at the Medium and High-Resolution for the Upper and Lower Sections.  
	NOTE: other folder with the format "version_YYYYMMDD_Section_Resolution" or  contain the model results for each calibration period at the Medium and High Resolution using the multi-parameter calibration optimized lateral flow values. 


Scripts: Python scripts used for analysis, figure generation, and model calibration and lateral flow estimation. 
- Subfolders:
	- Base Model Scripts: Scripts for conducting the base model calibration and analysis of the results.
	- Figure Scripts: Scripts for generating the figures that appear in the manuscript and SI
	- High Resolution Scripts: Scripts for conducting the high resolution estimation of lateral flows, analysis of the results, and running the final high resolution model. 
	- Low Resolution Scripts: Scripts for running the low resolution model. 
	- Medium Resolution Scripts: Scripts for conducting the medium resolution estimation of lateral flows, analysis of the results, and running the final medium resolution model. 
	- Model_Functions_v2.py: this python file contains functions used by the different modeling and calibration scripts for importing data and setting up and executing the HydroCouple model files. 

Analysis was completed using:
- Python version 3.10.14. The additional python libraries required to set up a python environment to run all scripts found in this resource can be found in the python_environment_setup.yml file in the Scripts folder. 
- HydroCouple version 1.4.1 and can be found at https://github.com/HydroCouple/HydroCoupleComposer/releases