# June 23, 2024

# Contact: Danica Schaffer-Smith
# Contact email: danica_schaffer-smith@fws.gov

## Cape Fear River Basin Water Quantity and Quality Baseline Model

This is the Cape Fear River Basin Soil and Water Assessment Tool Water Quantity and Quality Model (CFRB SWAT WQQ Model) created by 
The Nature Conservancy and Arizona State University. This model was developed by modifying a water quantity model developed by the 
U.S. Geological Survey.

Model development is further described in apublication by Schaffer-Smith et al. (2023) and the associated supporting information 
as well as a data release by the U.S. Geological Surey (2023).

## Directories:

# TxtInOut.zip = CFRB SWAT WQQ model
# SWAT_model_data = data representing the extent of the watershed boundary, subbasins, and stream network, as well as inputs including 
soil, slope, land use, and parameters for reservoirs and ponds. 
# Other_SWAT_simulation_files = additional input files available to run the mdoel for the entire period of observed weather from 1979-2019.


## Notes on usage:

This is a text instance of the CFRB SWAT WQQ Model representing contemporary land use and weather conditions from 1979-2019 relying on 
SWAT 2012 source code, revision 681. 

There is no ArcSWAT instance of the CFRB SWAT WQQ Model available. 

The CFRB WQQ SWAT Model can be run from the command prompt (or by double clicking the file 'swat_64rel.exe' in the TxtInOut folder which 
will launch the command prompt and run the model). Alternatively, the model can be run from Matlab, or other code environments for users 
familiar with these methods.

The default simulation is set up to produce daily output for January 1, 2010 through December 31, 2019, which was the calibration period
in the associated study by Schaffer-Smith et al. Other periods can be simulated, but this requires modifying some of the input files in 
the TxtInOut folder (see below).

Please see the SWAT 2012 Documentation for a description of simulation output files and the meanings of the fields for each (available 
from https://swat.tamu.edu/media/69296/swat-io-documentation-2012.pdf). 


# Running the entire simulation period: 

To run the model for the full period from January 1, 1979 through December 31, 2019, two files need to be modified in the TxtInOut 
folder: 1) 'file.cio', 2) '008420000.day'. 

'file.cio' defines the model run parameters. The file included in TxtInOut is set to simulate the period from January 1, 2010 
through December 31, 2019 with daily output. 

'008420000.day' stores the daily observed reservoir outflow from B. Everett Jordan Reservoir (Jordan Lake) located in subbasin 842. 
Each line in this file represents the daily reservoir outflow from January 1, 2010 through December 31, 2019. The length of this file 
must match the length of the simulation period specified in file.cio.

To run the model for the entire period of observed weather available, first make a copy of the TxtInOut directory. Then, copy the two 
files in the directory "Other_SWAT_input_files" and paste them into the copy of the TxtInOut folder to overwrite 'file.cio' and 
'008420000.day'. Run the model using the command prompt or by double clicking 'swat_64.rel.exe'. Note that this will result in very 
large output files. 


## References:

Schaffer-Smith, D., DeMeester, J. E.,Tong, D., Myint, S. W., Libera, D. A.,& Muenich, R. L. (2023). Landscape pollution source dynamics 
highlight priority locations for basin-scale interventions to protect water quality under hydroclimatic variability. Earth'sFuture, 11, 
e2022EF003137. https://doi.org/10.1029/2022EF003137

Gurley, L. N., García, A. M. & Pfeifle, C. M. Soil and Water Assessment Tool (SWAT) models for the Cape Fear River Basin used to simulate 
future streamflow and irrigation demand based on climate and urban growth projections. (2023) doi:10.5066/P98PVDBW.