Recall (Point Source/Inlet)

Please note: there was a long outstanding issues with time series recall in version 2.0.x of SWAT+ Editor due to a missed change in format of the model. This should be corrected in SWAT+ Editor 2.1.2 and greater. Please update your software and project and reach out if you encounter any issues.

Recall objects are used for connecting point source or inlet data to your watershed. If you added point source in QSWAT+, when you import your project into SWAT+ Editor it will be connected via the recall section.

By default, constant data with all zero values during the default simulation period is added. To add your own recall data, click the recall item in the edit menu under connections.

Sample Data

Download sample data. Please read the README.txt file in the zip carefully.

Constant Data

By default, your recall data is imported as constant. To insert your values, you can edit each item individually by clicking the edit button and manually entering each value. Alternatively, you may upload a CSV of your data.

From the recall section, click the import/export button from the action bar at the bottom. Import is selected by default, so click the export button toggle. Choose a folder name, and click the export data button to get a template for your data.

Constant data will be located in the recall.csv file in the directory you selected. Edit the CSV as needed, save, and then go back to the editor and click the import/output button again. This time toggle the import button. Choose your directory containing your modified files and click the import CSV data button. Your updated values will appear in the table.

Time Series Data

By default recall data is imported as constant, however this can be changed by clicking the edit button next to a row in the recall data table. Select the new time step for your data: daily, monthly, or yearly. Click the save changes button. Next, press the back button to go back to the table view. Click the import/export button. Import is selected by default, so click the export button toggle. Choose a folder name, and click the export data button to get a template for your data.

Your directory may now contain two files: a recall.csv containing constant data, and another csv file named for the recall object (e.g., pt002) you changed to time series.

Open the time series file after it is exported to see the template for your data. Modify your data as needed matching the time step you selected previously. Be sure the years match your simulation run time.

You change other recall objects from constant to time series, and you can mix and match all different types (constant, yearly, monthly, and daily). For any recall objects moving from constant to time series, first delete its row in recall.csv. Then create a new csv with the file name matching the recall object's name and insert your time series data. Similarly, if you want to move from time series back to constant, just delete the time series file and add a row back into recall.csv for the object.

To import your data, click the import/export data button again and this time click to toggle import. Choose your directory and click import data. Your new data will appear in the table.

Recall Table Definitions

SWAT+ Input File	Database Table
recall.rec	recall_rec

Field	Type	Description
id	int	Auto-assigned identifier
name	text	Name of recall object
rec_typ	int	Time step for recall object (1-daily, 2-monthly, 3-yearly)

Each record in recall_rec will have a data file named {name}.rec. All of this data is stored in a single recall_dat table in the database.

SWAT+ Input File	Database Table
{name}.rec	recall_dat

Field	Type	Description	Units
jday	int	Julian day
mo	int	Month
day_mo	int	Day of the month
yr	int	Year
ob_typ	text	Type of recall
ob_name	text	Name of recall object
flo	real	Volume of water	m^3
sed	real	Sediment	metric ton
orgn	real	Organic nitrogen	kg N
sedp	real	Organic phosphorus	kg P
no3	real	Nitrate	kg N
solp	real	Mineral (soluble P)	kg P
chla	real	Chlorophyll-a	kg
nh3	real	Ammonia	kg N
no2	real	Nitrogen dioxide	kg N
cbod	real	Carbonaceous biological oxygen demand	kg
doc	real	Dissolved oxygen	kg
sand	real	Detached sand
silt	real	Detached silt
clay	real	Detached clay
sag	real	Detached small ag
lag	real	Detached large ag
gravel	real	Gravel
tmp	real	Temperature	deg c

SWAT+ Documentation

Point Sources and InletsSWAT+ Documentation