arrow-left

All pages
gitbookPowered by GitBook
1 of 54

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...

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...

Loading...

Loading...

hyd

Pointer to the reservoir hydrology file

The pointer to the reservoir hydrology file is a foreign key referencing in .

name
hydrology.res

id (reservoir.res)

ID of the reservoir

The ID of the reservoir is a primary key referenced by the foreign key in . All IDs in the reservoir.res file must be unique.

res
reservoir.con

rel

Pointer to the reservoir and wetland release decision table file

The pointer to the reservoir and wetland release decision table file is a foreign key referencing the name of the decision table in .

res_rel.dtl

yr_op

The year of the simulation that the reservoir becomes operational

The year specified here must be within the simulation period. If 0 is input for yr_op and , the model assumes the reservoir is in operation at the beginning of the simulation.

mon_op

vol_ps

Volume of water needed to fill the reservoir to principal spillway

QSWAT+ assumes an average reservoir depth of 10 m, so the default volume of water needed to fill the reservoir to principal spillway is * 10.

pest

Pointer to the pesticide initialization file

The pointer to the pesticide initialization file is a foreign key referencing name in .

area_es

Reservoir surface area when reservoir is filled to emergency spillway

For SWAT+ to calculate the reservoir surface area each day, the surface area at two different water volumes must be defined. Variables referring to the principal spillway can be thought of as variables referring to the normal reservoir storage volume, while variables referring to the emergency spillway can be thought of as variables referring to the maximum reservoir storage volume.

By default, QSWAT+ will assume that the reservoir surface area at emergency spillway equals * 1.15.

area_ps
pest_water.ini
area_ps

evap_co

Lake evaporation coefficient

d50

Median particle size of suspended and benthic sediment

SWAT+ calculates the median sediment particle diameter for impoundments located within a landscape unit using the equation

d50=exp⁡(0.41∗mc100+2.71∗msilt100+5.7∗ms100)d_{50}=exp⁡(0.41*\frac{m_c}{100}+2.71*\frac{m_{silt}}{100}+5.7*\frac{m_s}{100})d50​=exp⁡(0.41∗100mc​​+2.71∗100msilt​​+5.7∗100ms​​)

where d50d_{50}d50​ is the median particle size of the sediment (µm), mcm_cmc​ is percent clay in the surface soil layer, msiltm_{silt}msilt​ is the percent silt in the surface soil layer, and msm_sms​ is the percent sand in the surface soil layer.

Because reservoirs are located on the channel network and receive sediment from the entire area upstream, defaulting the sand, silt, and clay fractions to those of a single LSU or HRU in the upstream area is not appropriate. Instead, the user may set the median particle size diameter to a representative value.

The table below lists the D50 values of different sediment classes:

Sediment class
Size [µm]
Approximate size

Fine Sand

94

Coarse Silt

47

Medium Silt

11.7

Not visible to the human eye

Fine Silt

4.9

Clay

1.95

Boulders

> 256,000

> Volley ball

Cobbles

> 64,000

> Tennis ball

Pebbles

> 2,000

> Match Head

Coarse Sand

1,500

Medium Sand

375

carbon

Organic carbon in suspended and benthic sediment

nsed

Equilibrium sediment concentration in the reservoir

The amount of suspended solid settling that occurs in the water body on a given day is calculated as a function of concentration. Settling occurs only when the sediment concentration in the water body exceeds the equilibrium sediment concentration specified by the user.

name (nutrients.res)

Name of the reservoir and wetland nutrient record

The name of the reservoir and wetland nutrient record is a primary key referenced by the foreign keys in and in . All names in the nutrient.res file must be unique.

nut
reservoir.res
nut
wetland.wet

n_stl

Nitrogen settling rate outside the mid-year nutrient settling period

A negative settling rate indicates that the reservoir sediments are a source of N. A positive settling rate indicates that the reservoir sediments are a sink for N.

theta_p

Temperature adjustment for phosphorus loss (settling)

n_min_stl

Minimum nitrogen concentration for settling

theta_n

Temperature adjustment for nitrogen loss (settling)

mid_start

Beginning month of the mid-year nutrient settling period

The model allows the user to define two settling rates for each nutrient and the time of the year during which each settling rate is used. A variation in settling rates is allowed so that impact of temperature and other seasonal factors may be accounted for in the modeling of nutrient settling. To use only one settling rate for the entire year, both variables for the nutrient may be set to the same value. Setting all variables to zero will cause the model to ignore settling of nutrients in the water body.

secchi_co

Water clarity coefficient for the reservoir

The clarity of the reservoir is expressed by the secchi-disk depth, which is calculated as a function of chlorophyll a. Because suspended sediment also can affect water clarity, the water clarity coefficient has been added to the equation to allow users to adjust for the impact of factors other than chlorophyll a on water clarity.

mid_p_stl

Phosphorus settling rate during the mid-year nutrient settling period

A negative settling rate indicates that the reservoir sediments are a source of P. A positive settling rate indicates that the reservoir sediments are a sink for P.

For natural lakes, measured phosphorus settling velocities most frequently fall in the range of 5 to 20 m/year although values less than 1 m/year to over 200 m/year have been reported (Chapra, 1997). Panuska and Robertson (1999) noted that the range in apparent settling velocity values for man-made reservoirs tends to be significantly greater than for natural lakes. Higgins and Kim (1981) reported phosphorus apparent settling velocity values from –90 to 269 m/year for 18 reservoirs in Tennessee with a median value of 42.2 m/year. For 27 Midwestern reservoirs, Walker and Kiihner (1978) reported phosphorus apparent settling velocities ranging from –1 to 125 m/year with an average value of 12.7 m/year.

The table below lists recommended apparent settling velocity values for phosphorus (Panuska and Robertson, 1999):

Water body nutrient dynamics
Settling velocity [m/year]

Shallow water bodies with high net internal phosphorus flux

<= 0

Water bodies with moderate net internal phosphorus flux

1 - 5

Water bodies with minimal net internal phosphorus flux

5 - 16

Water bodies with high net internal phosphorus removal

> 16

p_stl

Phosphorus settling rate outside the mid-year nutrient settling period

A negative settling rate indicates that the reservoir sediments are a source of P. A positive settling rate indicates that the reservoir sediments are a sink for P.

For natural lakes, measured phosphorus settling velocities most frequently fall in the range of 5 to 20 m/year although values less than 1 m/year to over 200 m/year have been reported (Chapra, 1997). Panuska and Robertson (1999) noted that the range in apparent settling velocity values for man-made reservoirs tends to be significantly greater than for natural lakes. Higgins and Kim (1981) reported phosphorus apparent settling velocity values from –90 to 269 m/year for 18 reservoirs in Tennessee with a median value of 42.2 m/year. For 27 Midwestern reservoirs, Walker and Kiihner (1978) reported phosphorus apparent settling velocities ranging from –1 to 125 m/year with an average value of 12.7 m/year.

The table below lists recommended apparent settling velocity values for phosphorus (Panuska and Robertson, 1999):

Water body nutrient dynamics
Settling velocity [m/year]

Shallow water bodies with high net internal phosphorus flux

<= 0

Water bodies with moderate net internal phosphorus flux

1 - 5

Water bodies with minimal net internal phosphorus flux

5 - 16

Water bodies with high net internal phosphorus removal

> 16

width

Width of weir

height

Height of weir above reservoir bottom

linear_c

Weir discharge linear coefficient

init

Pointer to the reservoir and wetland initialization file

The pointer to the reservoir and wetland initialization file is a foreign key referencing in .

name
initial.res

sed

Pointer to the reservoir and wetland sediment file

The pointer to the reservoir and wetland sediment file is a foreign key referencing in .

name
sediment.res

reservoir.res

This file contains pointers referencing several files that specify the reservoir properties.

Field
Description
Type

ID of the reservoir

integer

Name of the reservoir

string

​

Pointer to the reservoir and wetland initialization file

string

Pointer to the reservoir hydrology file

string

Pointer to the reservoir and wetland release decision table file

string

​

Pointer to the reservoir and wetland sediment file

string

Pointer to the reservoir and wetland nutrient file

string

id
name
init
hyd​
rel​
sed
nut​

name (initial.res)

Name of the reservoir and wetland initialization record

The name of the reservoir and wetland initialization record is a primary key referenced by the foreign keys init in reservoir.res and init in wetland.wet. All names in the initial.res file must be unique.

Reservoirs and Ponds

Reservoirs are impoundments located on the channel network of the watershed. Reservoirs receive loadings from upstream channels and potentially from surrounding routing units. They usually discharge into one downstream channel. Ponds may or may not receive flow and loadings from upstream channels. Some ponds have an outflow that connects them to a downstream channel, while others are not connected to the stream network.

Both reservoirs and ponds are simulated in SWAT+ using the reservoir input files:

  • Main reservoir file: reservoir.res

  • Reservoir and wetland initialization:

  • Reservoir hydrology:

  • Reservoir and wetland sediment:

  • Reservoir and wetland nutrients:

  • Reservoir weir:

  • Reservoir and wetland release:

nut

Pointer to the reservoir and wetland nutrient file

The pointer to the reservoir and wetland nutrient file is a foreign key referencing in .

initial.res
hydrology.res
sediment.res
nutrients.res
weir.res
res_rel.dtl
name
nutrients.res

name (reservoir.res)

Name of the reservoir

The SWAT+ Editor assigns a name to every object, which is typically the abbreviation of the object type followed by the object number in QSWAT+. However, the name of the reservoir is not used by SWAT+, so the user may change it.

salt

Pointer to the salt initialization file

initial.res

This file contains pointers referencing several files that specify the reservoir and wetland initialization parameters.

Field
Description
Type

​

Name of the reservoir and wetland initialization record

string

​

Pointer to the organic-mineral initialization file

string

​

circle-exclamation

There are no plans to work on the pathogen and heavy metal routines in the foreseeable future unless there is a demand for it in the user community.

hydrology.res

This file contains the reservoir hydrology parameters.

Field
Description
Type
Unit
Default
Range

Pointer to the pesticide initialization file

string

path​

Currently not used

string

hmet​

Currently not used

string

salt​

Pointer to the salt initialization file

string

name
org_min
pest

The year of the simulation that the reservoir becomes operational

integer

n/a

1

1-9999

The month of the simulation that the reservoir becomes operational

integer

n/a

1

1-12

Reservoir surface area when reservoir is filled to principal spillway

real

ha

1500.0

1-3000.0

Volume of water needed to fill the reservoir to principal spillway

real

ha-m

1500.0

15.0-3000.0

Reservoir surface area when reservoir is filled to emergency spillway

real

ha

500.0

1.0-1000.0

Volume of water needed to fill the reservoir to emergency spillway

real

ha-m

55.0

10.0-100.0

Hydraulic conductivity of the reservoir bottom

real

mm/hr

0.0

0.0-1.0

Reservoir evaporation coefficient

real

n/a

0.60

0.0-1.0

Shape coefficient 1 for reservoirs

real

n/a

0.0

Shape coefficient 2 for reservoirs

real

n/a

0.0

name

Name of the reservoir hydrology record

string

n/a

n/a

n/a

yr_op
mon_op
area_ps
vol_ps
area_es
vol_es
k
evap_co
shp_co1
shp_co2

sed_stl

Sediment settling rate

area_ps

Reservoir surface area when reservoir is filled to principal spillway

For SWAT+ to calculate the reservoir surface area each day, the surface area at two different water volumes must be defined. Variables referring to the principal spillway can be thought of as variables referring to the normal reservoir storage volume, while variables referring to the emergency spillway can be thought of as variables referring to the maximum reservoir storage volume.

If a shapefile is used to implement reservoirs in QSWAT+, the interface will assume that the reservoir surface area at principal spillway equals the area of the polygon.

name (hydrology.res)

Name of the reservoir hydrology record

The name of the reservoir hydrology record is a primary key referenced by the foreign key hyd in reservoir.res. All names in the hydrology.res file must be unique.

mon_op

The month of the simulation that the reservoir becomes operational

If 0 is input for yr_op and mon_op, the model assumes the reservoir is in operation at the beginning of the simulation.

vol_es

Volume of water needed to fill the reservoir to emergency spillway

QSWAT+ assumes an average reservoir depth of 10 m, so the default volume of water needed to fill the reservoir to principal spillway is area_es * 10.

org_min

Pointer to the organic-mineral initialization file

The pointer to the organic-mineral initialization file is a foreign key referencing name in om_water.ini.

k

Hydraulic conductivity of the reservoir bottom

If seepage occurs in the reservoir, the hydraulic conductivity must be set to a value other than 0.

shp_co2

Shape coefficient 2 for reservoirs

If shp_co2 is set to 0, the model will estimate this value.

name (sediment.res)

Name of the reservoir and wetland sediment record

The name of the reservoir and wetland sediment record is a primary key referenced by the foreign keys sed in reservoir.res and sed in wetland.wet. All names in the sediment.res file must be unique.

shp_co1

Shape coefficient 1 for reservoirs

If shp_co1 is set to 0, the model will estimate this value.

stl_vel

Sediment settling velocity

mid_end

Ending month of the mid-year nutrient settling period

The model allows the user to define two settling rates for each nutrient and the time of the year during which each settling rate is used. A variation in settling rates is allowed so that impact of temperature and other seasonal factors may be accounted for in the modeling of nutrient settling. To use only one settling rate for the entire year, both variables for the nutrient may be set to the same value. Setting all variables to zero will cause the model to ignore settling of nutrients in the water body.

p_min_stl

Minimum phosphorus concentration for settling

sediment.res

This file contains the reservoir and wetland sediment parameters.

Field
Description
Type
Unit
Default
Range

Name of the reservoir and wetland sediment record

string

n/a

n/a

nutrients.res

This file contains the reservoir and wetland nutrient parameters.

Field
Description
Type
Unit
Default
Range

Name of the reservoir and wetland nutrient record

string

n/a

n/a

n/a

Equilibrium sediment concentration in the reservoir

real

kg/L

1.0

1.0-5000.0

Median particle size of suspended and benthic sediment

real

μm

10.0

Organic carbon in suspended and benthic sediment

real

%

Bulk density of benthic sediment

real

t/m^3

Sediment settling rate

real

n/a

1.0

Sediment settling velocity

real

m/d

1.0

name

n/a

Beginning month of the mid-year nutrient settling period

integer

n/a

5

0-12

Ending month of the mid-year nutrient settling period

integer

n/a

10

0-12

Nitrogen settling rate during the mid-year nutrient settling period

real

m/day

5.50

1.0-15.0

Nitrogen settling rate outside the mid-year nutrient settling period

real

m/day

5.50

1.0-15.0

Phosphorus settling rate during the mid-year nutrient settling period

real

m/day

10.0

2.0-20.0

Phosphorus settling rate outside the mid-year nutrient settling period

real

m/day

10.0

2.0-20.0

Chlorophyll-a production coefficient for the reservoir

real

n/a

1.0

0.0-1.0

Water clarity coefficient for the reservoir

real

n/a

1.0

0.50-2.0

Temperature adjustment for nitrogen loss (settling)

real

n/a

1.0

Temperature adjustment for phosphorus loss (settling)

real

n/a

1.0

Minimum nitrogen concentration for settling

real

ppm

0.10

Minimum phosphorus concentration for settling

real

ppm

0.01

name
nsed
d50
carbon
bd
sed_stl
stl_vel
mid_start
mid_end
mid_n_stl
n_stl
mid_p_stl
p_stl
chla_co
secchi_co
theta_n
theta_p
n_min_stl
p_min_stl

name (weir.res)

Name of the reservoir weir record

The name of the reservoir weir record is a primary key referenced by the foreign key xxx in res_rel.dtl. All names in the weir.res file must be unique.

chla_co

Chlorophyll-a production coefficient for the reservoir

The chlorophyll a concentration in the reservoir is calculated from the total phosphorus concentration. The equation assumes the system is phosphorus-limited. The chlorophyll a coefficient was added to the equation to allow the user to adjust results to account for other factors not included in the basic equation, e.g. nitrogen limitations.

bd

Bulk density of benthic sediment

mid_n_stl

Nitrogen settling rate during the mid-year nutrient settling period

A negative settling rate indicates that the reservoir sediments are a source of N. A positive settling rate indicates that the reservoir sediments are a sink for N.

exp_k

Weir discharge exponential coefficient

weir.res

This file contains the reservoir weir parameters.

Field
Description
Type
Unit
Default
Range

Name of the reservoir weir record

string

n/a

n/a

n/a

Weir discharge linear coefficient

real

none

Weir discharge exponential coefficient

real

none

Width of weir

real

m

Height of weir above reservoir bottom

real

m

name
linear_c
exp_k
width
height