Usage
dp_supply(Q, capacity, target, surface_area, max_depth, evap, S_disc = 1000, R_disc = 10, loss_exp = 2, S_initial = 1, plot = TRUE, rep_rrv = FALSE)
Arguments
Q
vector or time series object. Net inflow totals to the reservoir. Recommended units: Mm^3 (Million cubic meters).
capacity
numerical. The reservoir storage capacity. Recommended units: Mm^3 (Million cubic meters).
target
numerical. The target release constant. Recommended units: Mm^3 (Million cubic meters).
surface_area
numerical. The reservoir water surface area at maximum capacity. Recommended units: km^2 (square kilometers).
max_depth
numerical. The maximum water depth of the reservoir at maximum capacity. If omitted, the depth-storage-area relationship will be estimated from surface area and capacity only. Recommended units: meters.
evap
vector or time series object of length Q, or a numerical constant. Evaporation from losses from reservoir surface. Varies with level if depth and surface_area parameters are specified. Recommended units: meters, or kg/m2 * 10 ^ -3.
S_disc
integer. Storage discretization--the number of equally-sized storage states. Default = 1000.
R_disc
integer. Release discretization. Default = 10 divisions.
loss_exp
numeric. The exponent of the penalty cost function--i.e., Cost[t] <- ((target - release[t]) / target) ^ **loss_exp**). Default value is 2.
S_initial
numeric. The initial storage as a ratio of capacity (0
plot
logical. If TRUE (the default) the storage behavior diagram and release time series are plotted.
rep_rrv
logical. If TRUE then reliability, resilience and vulnerability metrics are computed and returned.