Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Name of the PET station
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Name of the weather generator station
The name of the weather generator station is a foreign key referencing the primary key name in weather-wgn.cli.
Name of the precipitation station
Name of the weather generator station
The name of the weather generator station is a primary key referenced by in .
Name of the atmospheric deposition station
The name of the atmospheric deposition station is a foreign key referencing the station names in .
If no atmospheric deposition data are available, "null" should be entered instead of an atmospheric deposition station name.
This file contains weather generator data to be used for a SWAT+ setup.
The weather generator file contains weather generator data for any number of stations. For each weather generator station, there will be one line specifying the name of the station, its latitude, longitude, and elevation, and the number of years of maximum monthly 0.5 h rainfall data used to define values for . There are no headers for this line. These variables are listed in the first table below. The second line for each weather generator station contains the headers for the following 12 lines, which list the weather generator data for each month of the year. An overview of the weather generator data variables is given in the second table below.
A SWAT+ Global Weather Generator Database containing weather generator datasets for almost 180,000 stations across the globe can be downloaded from the SWAT website: .
If the user wishes to add a new weather generator station, the use of the WGN Parameters Estimation Tool or the WGN Excel macro is recommended. Both can be downloaded from the SWAT website: .
Field | Description | Type | Unit |
---|
Field | Description | Type | Unit | Range |
---|
Name of the relative humidity station
Number of years of maximum monthly 0.5 h rainfall data
This variable is used to calculate values for pcp_hhr.
If no value is specified, the model will set yrs_pcp = 10.
Average or mean daily minimum air temperature for month
This value is calculated by summing the minimum air temperature for every day in the month for all years of record and dividing the sum by the number of days:
where is the mean daily minimum temperature for the month (ºC), is the daily minimum temperature on day in month (ºC), and is the total number of daily minimum temperature records for month .
Average or mean daily maximum air temperature for month
This value is calculated by summing the maximum air temperature for every day in the month for all years of record and dividing the sum by the number of days:
where is the mean daily maximum temperature for the month (ºC), is the daily maximum temperature on day in month (ºC), and is the total number of daily maximum temperature records for month .
Standard deviation for daily maximum air temperature in month
This parameter quantifies the variability in maximum temperature for each month. The standard deviation is calculated as
where is the standard deviation for daily maximum temperature in month (ºC), is the daily maximum temperature on day in month (ºC), is the average daily maximum temperature for the month (ºC), and is the total number of daily maximum temperature records for month .
Name of weather generator station | string | n/a |
latitude | Latitude of weather generator station | real | Decimal Degrees |
longitude | Longitude of weather generator station | real | Decimal Degrees |
elevation | Elevation of weather generator station | real | m |
Number of years of maximum monthly 0.5 h rainfall data used to define values for pcp_hhr | integer | years |
Average or mean daily maximum air temperature for month | real | °C | -30 - 50 |
Average or mean daily minimum air temperature for month | real | °C | -40 - 40 |
Standard deviation for daily maximum air temperature in month | real | °C | 0.1 - 100 |
Standard deviation for daily minimum air temperature in month | real | °C | 0.1 - 30 |
Average or mean total monthly precipitation | real | mm | 0 - 600 |
Standard deviation for daily precipitation in month | real | mm/day | 0.1 - 50 |
Skew coefficient for daily precipitation in month | real | mm | -50 - 20 |
Probability of a wet day following a dry day in the month | real | n/a | 0 - 0.95 |
Probability of a wet day following a wet day in the month | real | n/a | 0 - 0.95 |
Average number of days of precipitation in month | real | n/a | 0 - 31 |
Maximum 0.5-hour rainfall in month | real | mm | 0 - 125 |
Average daily solar radiation for month | real | MJ/m^2/day | 0 - 750 |
Average daily dew point temperature for each month (ºC) or relative humidity (fraction) | real | °C or fraction | -50 - 25 |
Average daily wind speed in month | real | m/s | 0 - 100 |
Probability of a wet day following a wet day in the month
The probability is calculated as
where is the probability of a wet day following a wet day in month , is the number of times a wet day followed a wet day in month for the entire period of record, and is the number of wet days in month during the entire period of record. A wet day is a day with > 0 mm precipitation.
Probability of a wet day following a dry day in the month
The probability is calculated as
where is the probability of a wet day following a dry day in month , is the number of times a wet day followed a dry day in month for the entire period of record, and is the number of dry days in month during the entire period of record. A dry day is a day with 0 mm of precipitation. A wet day is a day with > 0 mm precipitation.
Average or mean total monthly precipitation
The average or mean total monthly precipitation is calculated as
where is the mean monthly precipitation (mm H2O), is the daily precipitation for day in month (mm H2O), is the total number of records in month used to calculate the average, and is the number of years of daily precipitation records used in calculation.
Standard deviation for daily minimum air temperature in month
This parameter quantifies the variability in minimum temperature for each month. The standard deviation is calculated as
where is the standard deviation for daily minimum temperature in month (ºC), is the daily minimum temperature on day in month (ºC), is the average daily minimum temperature for the month (ºC), and is the total number of daily minimum temperature records for month .
Skew coefficient for daily precipitation in month
This parameter quantifies the symmetry of the precipitation distribution around the monthly mean. The skew coefficient is calculated as
where is the skew coefficient for precipitation in the month, is the total number of daily precipitation records for month , is the amount of precipitation for day in month (mm H2O), is the average precipitation for the month (mm H2O), and is the standard deviation for daily precipitation in month (mm H2O). Daily precipitation values of 0 mm are included in the skew coefficient calculation.
Standard deviation for daily precipitation in month
This parameter quantifies the variability in precipitation for each month. The standard deviation is calculated as
where is the standard deviation for daily precipitation in month (mm H2O), is the amount of precipitation for day in month (mm H2O), is the average precipitation for the month (mm H2O), and is the total number of daily precipitation records for month . Daily precipitation values of 0 mm are included in the standard deviation calculation.
SWAT+ requires daily data for precipitation, maximum and minimum air temperature, solar radiation, relative humidity, and wind speed. The model can read in observed weather data or generate values using the weather generator. Climate data will be generated in two instances: when the user specifies that simulated weather data will be used or when there are missing values in the observed weather data. A Global Weather Generator Database containing weather generator datasets in SWAT+ format for almost 180,000 stations across the globe can be downloaded from the SWAT website: .
If observed data is used, one data file has to be provided for each station and variable. The data files for precipitation, temperature, solar radiation, relative humidity, and wind speed should have the file extensions .pcp, .tem, .slr, .hmd, and .wnd, respectively. The names of all available data files for precipitation, temperature, solar radiation, relative humidity, and wind speed will be listed in , , , , and , respectively.
If the user wishes to run simulations at a sub-daily time step, precipitation data has to be provided at the simulation time step.
Each spatial object in a SWAT+ setup will be assigned the weather stations that are closest to its centroid. Because the precipitation, temperature, solar radiation, relative humidity, and wind speed stations might be at different locations, several combinations of weather stations might be needed for a SWAT+ setup. These combinations will be listed as a record in . Each of them will be given a unique name, which is referenced by the connect files for the different spatial objects. In addition, the name of the closest weather generator station will be specified, which points to . Finally, the user has the option to specify the name of an atmospheric deposition record, which points to .
There is also a field available for specifying the name of a wind direction data file, but the wind direction routines in SWAT+ are currently not functional and there are no plans to work on them in the foreseeable future.
The flowchart below illustrates the relationships between the different SWAT+ climate files.
Average number of days of precipitation in month
This parameter is calculated as
where is the average number of days of precipitation in month , is the number of wet days in month during the entire period of record, and is the number of years of record.
Average daily solar radiation for month
This value is calculated by summing the total solar radiation for every day in the month for all years of record and dividing the sum by the number of days:
where is the mean daily solar radiation for the month (MJ/m2/day), is the total solar radiation reaching the earth’s surface on day in month (MJ/m2/day), and is the total number of daily solar radiation records for month .
Maximum 0.5-hour rainfall in month
This value represents the most extreme 30-minute rainfall intensity recorded in the entire period of record.
Average daily wind speed in month
This value is calculated by summing the average or mean wind speed values for every day in the month for all years of record and dividing the sum by the number of days:
where is the mean daily wind speed for the month (m/s), is the average wind speed for day in month (ºC), and N is the total number of daily wind speed records for month .
Name of the weather station
The name of the weather station is a primary key referenced by wst in 'object'.con.
Average daily dew point temperature for each month (ºC) or relative humidity (fraction)
If all twelve months are < 1.0, the model assumes the data provided is relative humidity. Relative humidity is defined as the amount of water vapor in the air as a fraction of saturation humidity. If any month has a value > 1.0, the model assumes the data provided is dewpoint temperature.
Dew point temperature is the temperature at which the actual vapor pressure present in the atmosphere is equal to the saturation vapor pressure. This value is calculated by summing the dew point temperature for every day in the month for all years of record and dividing the sum by the number of days:
where is the mean daily dew point temperature for the month (ºC), is the dew point temperature for day in month (ºC), and is the total number of daily dew point records for month . Please refer to the SWAT+ Theoretical Documentation for the equations used to convert dew point to relative humidity.
Name of the solar radiation station
Name of the temperature station
This file lists the weather stations defined for a SWAT+ setup.
Field | Description | Type |
---|---|---|
These files contain all information needed by the model about observed solar radiation data.
The solar radiation data files contain the observed precipitation input data. They are named by the user and must have the file ending *.slr. There must be one file per station used in the simulation. As in all SWAT+ input files, the first line in the solar radiation data files is reserved for user comments. The second line contains the column headers for the third line, which lists basic information about the station.
Field | Description | Type | Unit |
---|
Starting in the fourth line, the year, Julian day, and solar radiation are listed. There are no headers for these columns.
Field | Description | Type | Unit |
---|
A negative 99.0 (-99.0) should be inserted for missing data. This value tells SWAT+ to generate a solar radiation value for that day.
The slr.cli file lists the names of the solar radiation data files used in the simulation. The first line is reserved for user comments. The second line is reserved for the column header "filename". The user can list as many solar radiation data file names as needed for the simulation. Only one file name should be listed per line. All file names listed in must be listed here. For every file name listed in slr.cli, a file with that name must be provided by the user that contains the solar radiation data measured at the station.
Time step of the atmospheric deposition data
Option | Description |
---|
This file contains observed atmospheric deposition data.
SWAT+ is able to read in monthly, yearly, and average annual atmospheric deposition values. Reading in daily values is currently not an option in SWAT+. The time step of the atmospheric deposition data has to be specified by the user in codes.bsn and the time step of the data in atmo.cli has to match the specified time step.
The structure of the file atmo.cli varies slightly depending on the time step of the data. As in all SWAT+ input files, the first line is reserved for user comments. The second line contains the column headers for the third line, which lists basic information about the atmospheric deposition stations.
Field | Description | Type |
---|
Below, there will be 5 lines for each station included in the atmospheric deposition file. In the first of these, the name of the station will be specified. It is followed by 4 lines of data:
Wet deposition of ammonia nitrogen
Wet deposition of nitrate nitrogen
Dry deposition of ammonia nitrogen
Dry deposition of nitrate nitrogen
The number of values listed in the data lines depends on the number of months or years data is available for.
Name of the weather station
string
Name of the weather generator station
string
Name of the precipitation station
string
Name of the temperature station
string
Name of the solar radiation station
string
Name of the relative humidity station
string
Name of the wind speed station
string
wnd_dir
Name of the wind direction station (currently not used)
string
Name of the atmospheric deposition station
string
mo | Monthly |
yr | Yearly |
aa | Average annual |
nbyr | Length of the solar radiation time series | integer | years |
tstep | Time step of the solar radiation data | integer | n/a |
lat | Latitude of the solar radiation station | real | Decimal Degrees |
lon | Longitude of the solar radiation station | real | Decimal Degrees |
elev | Elevation of the solar radiation station | real | m |
year | Year of the observation | integer | n/a |
jday | Julian day of the observation | integer | n/a |
slr | Observed solar radiation | real | MJ/m^2/day |
Number of months or years data is available for
For monthly and yearly data, the number of months and number of years of atmospheric deposition data included in the file should be entered, respectively. For average annual data this parameter should be set to 0.
num_sta | Number of stations included in the file | integer |
Time step of the atmospheric deposition data | integer |
mo_init | First month data is available for (0 for yearly and average annual data) | integer |
yr_init | First year data is available for (0 for average annual data) | integer |
Number of months or years data is available for | integer |
These files contain all information needed by the model about observed temperature data.
The temperature data files contain the observed temperature input data. They are named by the user and must have the file ending *.tmp. There must be one file per station used in the simulation. As in all SWAT+ input files, the first line in the temperature data files is reserved for user comments. The second line contains the column headers for the third line, which lists basic information about the station.
Field | Description | Type | Unit |
---|---|---|---|
Starting in the fourth line, the year, Julian day, and the maximum and minimum temperatures are listed. There are no headers for these columns.
Field | Description | Type | Unit |
---|---|---|---|
A negative 99.0 (-99.0) should be inserted for missing data. This value tells SWAT+ to generate minimum and maximum temperatures for that day.
The tmp.cli file lists the names of the temperature data files used in the simulation. The first line is reserved for user comments. The second line is reserved for the column header "filename". The user can list as many temperature data file names as needed for the simulation. Only one file name should be listed per line. All file names listed in weather-sta.cli must be listed here. For every file name listed in tmp.cli, a file with that name must be provided by the user that contains the temperature data measured at the station.
These files contain all information needed by the model about observed relative humidity data.
The relative humidity data files contain the observed relative humidity input data. They are named by the user and must have the file ending *.hmd. There must be one file per station used in the simulation. As in all SWAT+ input files, the first line in the relative humidity data files is reserved for user comments. The second line contains the column headers for the third line, which lists basic information about the station.
Field | Description | Type | Unit |
---|
Starting in the fourth line, the year, Julian day, and the relative humidity are listed. There are no headers for these columns.
Field | Description | Type | Unit |
---|
A negative 99.0 (-99.0) should be inserted for missing data. This value tells SWAT+ to generate a relative humidity value for that day.
The hmd.cli file lists the names of the relative humidity data files used in the simulation. The first line is reserved for user comments. The second line is reserved for the column header "filename". The user can list as many relative humidity data file names as needed for the simulation. Only one file name should be listed per line. All file names listed in must be listed here. For every file name listed in hmd.cli, a file with that name must be provided by the user that contains the relative humidity data measured at the station.
nbyr
Length of the temperature time series
integer
years
tstep
Time step of the temperature data
integer
n/a
lat
Latitude of the temperature station
real
Decimal Degrees
lon
Longitude of the temperature station
real
Decimal Degrees
elev
Elevation of the temperature station
real
m
year
Year of the observation
integer
n/a
jday
Julian day of the observation
integer
n/a
tmpmax
Observed maximum temperature
real
°C
tmpmin
Observed minimum temperature
real
°C
nbyr | Length of the relative humidity time series | integer | years |
tstep | Time step of the relative humidity data | integer | n/a |
lat | Latitude of the relative humidity station | real | Decimal Degrees |
lon | Longitude of the relative humidity station | real | Decimal Degrees |
elev | Elevation of the relative humidity station | real | m |
year | Year of the observation | integer | n/a |
jday | Julian day of the observation | integer | n/a |
hmd | Observed relative humidity | real | fraction |
These files contain all information needed by the model about observed wind speed data.
The wind speed data files contain the observed precipitation input data. They are named by the user and must have the file ending *.wnd. There must be one file per station used in the simulation. As in all SWAT+ input files, the first line in the wind speed data files is reserved for user comments. The second line contains the column headers for the third line, which lists basic information about the station.
Field | Description | Type | Unit |
---|---|---|---|
Starting in the fourth line, the year, Julian day, and wind speed are listed. There are no headers for these columns.
Field | Description | Type | Unit |
---|---|---|---|
A negative 99.0 (-99.0) should be inserted for missing data. This value tells SWAT+ to generate a wind speed value for that day.
The wnd.cli file lists the names of the wind speed data files used in the simulation. The first line is reserved for user comments. The second line is reserved for the column header "filename". The user can list as many wind speed data file names as needed for the simulation. Only one file name should be listed per line. All file names listed in weather-sta.cli must be listed here. For every file name listed in wnd.cli, a file with that name must be provided by the user that contains the wind speed data measured at the station.
nbyr
Length of the wind speed time series
integer
years
tstep
Time step of the wind speed data
integer
n/a
lat
Latitude of the wind speed station
real
Decimal Degrees
lon
Longitude of the wind speed station
real
Decimal Degrees
elev
Elevation of the wind speed station
real
m
year
Year of the observation
integer
n/a
jday
Julian day of the observation
integer
n/a
wnd
Observed wind speed
real
m/s
These files contain all information needed by the model about observed precipitation data.
The precipitation data files contain the observed precipitation input data. They are named by the user and must have the file ending *.pcp. There must be one file per station used in the simulation. As in all SWAT+ input files, the first line in the precipitation data files is reserved for user comments. The second line contains the column headers for the third line, which lists basic information about the station.
Field | Description | Type | Unit |
---|---|---|---|
Starting in the fourth line, the year, Julian day, and precipitation amount are listed. There are no headers for these columns.
Field | Description | Type | Unit |
---|---|---|---|
If the user wishes to run simulations at a sub-daily time step, precipitation data has to be provided at the simulation time step. Currently, the model is able to run at an hourly time step. Smaller time steps have not been tested yet. Three additional columns need to be included in the hourly precipitation files:
Field | Description | Type | Unit |
---|---|---|---|
A negative 99.0 (-99.0) should be inserted for missing data. This value tells SWAT+ to generate precipitation for that day.
The pcp.cli file lists the names of the precipitation data files used in the simulation. The first line is reserved for user comments. The second line is reserved for the column header "filename". The user can list as many precipitation data file names as needed for the simulation. Only one file name should be listed per line. All file names listed in weather-sta.cli must be listed here. For every file name listed in pcp.cli, a file with that name must be provided by the user that contains the precipitation data measured at the station.
nbyr
Length of the precipitation time series
integer
years
tstep
Time step of the precipitation data
integer
n/a
lat
Latitude of the precipitation station
real
Decimal Degrees
lon
Longitude of the precipitation station
real
Decimal Degrees
elev
Elevation of the precipitation station
real
m
year
Year of the observation
integer
n/a
jday
Julian day of the observation
integer
n/a
pcp
Observed precipitation
real
mm
year
Year of the observation
integer
n/a
jday
Julian day of the observation
integer
n/a
mon
Month of the observation
integer
n/a
day
Day of the observation
integer
n/a
hr
Time of the observation
integer
n/a
pcp
Observed precipitation
real
mm