RunWaterBalance: Run Water Balance
In USGS-R/wrv: Wood River Valley Groundwater-Flow Model

Description Usage Arguments Value Author(s) See Also Examples

This function estimates natural and incidental groundwater recharge at the water table, and pumping demand at production wells. A water-balance approach is used to calculate these volumetric flow rate estimates, where positive values are flow into the aqufer system (groundwater recharge), and negative values are flow out of the system (groundwater discharge).

RunWaterBalance(
  r.grid,
  tr.stress.periods,
  ss.stress.periods = NULL,
  canal.seep = wrv::canal.seep,
  comb.sw.irr = wrv::comb.sw.irr,
  div.gw = wrv::div.gw,
  div.sw = wrv::div.sw,
  div.ww = wrv::div.ww,
  efficiency = wrv::efficiency,
  entity.components = wrv::entity.components,
  et = wrv::et,
  irr.entities = wrv::irr.entities,
  land.surface = wrv::land.surface,
  pod.gw = wrv::pod.gw,
  priority.cuts = wrv::priority.cuts,
  r.canals = wrv::r.canals,
  rs.entities = wrv::rs.entities,
  rs.rech.non.irr = wrv::rs.rech.non.irr,
  verbose = FALSE
)

`r.grid`	RasterLayer. Gridded numeric values where NA indicates an ‘inactive’ cell in the top model layer.
`tr.stress.periods`	Date. Vector of start and end dates for each stress period in the simulation.
`ss.stress.periods`	Date. Vector of start and end dates for stress periods used to create steady-state conditions.
`canal.seep`	data.frame. See `canal.seep` dataset for details.
`comb.sw.irr`	data.frame. See `comb.sw.irr` dataset for details.
`div.gw`	data.frame. See `div.gw` dataset for details.
`div.sw`	data.frame. See `div.sw` dataset for details.
`div.ww`	data.frame. See `div.gw` dataset for details.
`efficiency`	data.frame. See `efficiency` dataset for details.
`entity.components`	list. See `entity.components` dataset for details.
`et`	RasterStack. See `et` dataset for details.
`irr.entities`	SpatialPolygonsDataFrame. See `irr.entities` dataset for details.
`land.surface`	RasterLayer. See `land.surface` dataset for details.
`pod.gw`	data.frame. See `pod.gw` dataset for details.
`priority.cuts`	data.frame. See `priority.cuts` dataset for details.
`r.canals`	RasterLayer. See `r.canals` dataset for details.
`rs.entities`	RasterStack. See `rs.entities` dataset for details.
`rs.rech.non.irr`	RasterStack. See `rs.rech.non.irr` dataset for details.
`verbose`	logical. Indicates whether to return summary tables: `natural.rech`, `inciden.rech`, and `pumping.rech`.

Returns an object of class list with the following components:

(1) Water-table flow data (combines natural and incidental groundwater recharge) are stored in areal.rech, an object of RasterStack class with raster layers for each model stress period; cell values are specified as volumetric flow rates in cubic meters per day.

(2) Production well pumping data are stored in pod.rech, an object of data.frame class with the following components:

WMISNumber: unique number assigned to a water right point of diversion.
ss,199501,...,201012: volumetric flow rate, specified for each stress period, in cubic meters per day.

(3) Natural groundwater recharge data are stored in natural.rech, an object of data.frame class with the following components:

YearMonth: calendar year and month YYYYMM.
Area: land-surface area of non-irrigated lands, in square meters.
ET: evapotranspiration on non-irrigated lands, in cubic meters per month.
Rech: volumetric flow rate, in cubic meters per month.

(4) Incidental groundwater recharge data are stored in inciden.rech, an object of data.frame class with the following components:

EntityName: name of the irrigation entity.
YearMonth: calendar year and month YYYYMM.
SWDiv: surface-water diversions, in cubic meters per month.
SeepFrac: canal seepage as a fraction of diversions, a dimensionless quantity.
CanalSeep: canal seepage, in cubic meters per month.
SWDel: surface-water delivered to field headgates, in cubic meters per month.
area.sw: area irrigated by only surface water, in square meters.
et.sw: evapotranspiration on lands irrigated by only surface water, in cubic meters per month.
precip.sw: precipitation on lands irrigated by only surface water, in cubic meters per month.
cir.sw: crop irrigation requirement on lands irrigated by only surface water, in cubic meters per month.
area.mix: area irrigated by both surface and groundwater, in square meters.
et.mix: evapotranspiration on lands irrigated by both surface and groundwater, in cubic meters per month.
precip.mix: precipitation on lands irrigated by both surface and groundwater, in cubic meters per month.
cir.mix: crop irrigation requirement on lands irrigated by both surface and groundwater, in cubic meters per month.
area.gw: area irrigated by only groundwater, in square meters.
et.gw: evapotranspiration on lands irrigated by only groundwater, in cubic meters per month.
precip.gw: precipitation on lands irrigated by only groundwater, in cubic meters per month.
cir.gw: crop irrigation requirement on lands irrigated by only groundwater, in cubic meters per month.
Eff: irrigation efficiency, a dimensionless quantity.
GWDiv: recorded groundwater diversions, in cubic meters per month.
WWDiv: inflow to municipal wastewater treatment plants, in cubic meters per month.
hg.sw: surface-water delivered to field headgates on lands irrigated by only surface water, in cubic meters per month.
hg.mix: surface-water delivered to field headgates on lands irrigation by both surface and groundwater, in cubic meters per month.
rech.sw: incidental groundwater recharge beneath lands irrigated by only surface water, in cubic meters per month.
gw.dem.mix: groundwater demand on lands irrigated by both surface and groundwater, in cubic meters per month.
gw.div.est: calculated groundwater diversions, in cubic meters per month.
rech.mix: incidental groundwater recharge beneath lands irrigated by both surface and groundwater, in cubic meters per month.
gw.only: groundwater demand on lands irrigated by only groundwater in entities with lands also irrigated by both surface and groundwater, in cubic meters per month.
rech.muni: incidental groundwater recharge beneath entities with lands irrigated by only groundwater and lands irrigated by both surface and groundwater, in cubic meters per month.
gw.dem.gw: groundwater demand on lands irrigated by only groundwater in entities without surface-water irrigation, in cubic meters per month.
rech.gw: incidental groundwater recharge beneath lands irrigated by only groundwater, in cubic meters per month.
area.model: area of the irrigation entity that is located in the model domain, in square meters.

Volumetric flow rates are calculated for their respective area in the irrigation entity—not just that part overlying the model area. Flow rate values are given this way in order to facilitate with quality assurance of the water-budget calculation. To calculate a simulated volumetric-flow rate: divide the flow rate by the affected area, and then multiply this value by the area of the irrigation entity that is located in the model domain (area.model).

(5) Well pumping data are also stored in pumping.rech (see pod.rech component), an object of data.frame class with the following components: