marsSimulatedLevelSeries_ft: Simulated Water Level

View source: R/mars_water_level_functions.R

marsSimulatedLevelSeries_ftR Documentation

Simulated Water Level

Description

Simulates water level in subsurface stormwater infiltration system with underdrain. Note: This version of the package targets the PG12 database, and simulating rain gage events is deprecated. The rain event variable name is hard-coded to the radar IDs.

Usage

marsSimulatedLevelSeries_ft(
  dtime_est,
  rainfall_in,
  event,
  infil_footprint_ft2,
  dcia_ft2,
  orifice_height_ft = NA,
  orifice_diam_in = NA,
  storage_depth_ft,
  storage_vol_ft3,
  infil_rate_inhr = 0.06,
  initial_water_level_ft = 0,
  runoff_coeff = 1,
  discharge_coeff = 0.62
)

Arguments

dtime_est

A vector of POSIXct date times, in ascending order

rainfall_in

Rainfall depths during periods corresponding to times in dtime_est (in)

event

A vector of Event IDs

infil_footprint_ft2

Total area of the system that is open to infiltration (sf)

dcia_ft2

Directly connected impervious area (sf)

orifice_height_ft

Orifice height (ft) (NA if no orifice outlet)

orifice_diam_in

Orifice diameter (in) (NA if no orifice outlet)

storage_depth_ft

Maximum storage depth (ft)

storage_vol_ft3

Maximum storage volume (pore space) (cf)

infil_rate_inhr

System design infiltration rate (in/hr)

initial_water_level_ft

Initial water Level (ft); either a single value or a vector of length equal to and corresponding to length(unique(event)) (Default = 0)

runoff_coeff

Rational method coefficient (Default = 1)

discharge_coeff

Orifice discharge coefficient (Default = 0.62)

Value

Output is a dataframe with the following columns: dtime_est, rainfall_in, radar_event_uid, simulated_depth_ft, simulated_vol_ft3, simulated_orifice_vol_ft3

See Also

simulation.stats

Examples

simulated_data <- marsSimulatedLevelSeries_ft(dtime_est = marsSampleRain$dtime_est, 
  rainfall_in = marsSampleRain$rainfall_in, 
  event = marsSampleRain$event,
  infil_footprint_ft2 = smp_stats$infil_footprint_ft2[7], 
  dcia_ft2 = smp_stats$dcia_ft2[7],
  orifice_height_ft = smp_stats$orifice_height_ft[7],
  orifice_diam_in = smp_stats$orifice_diam_in[7],
  storage_depth_ft = smp_stats$storage_depth_ft[7],
  storage_vol_ft3 = smp_stats$storage_vol_ft3[7],
  infil_rate_inhr = smp_stats$infil_rate_inhr[7])



taywater/pwdgsi documentation built on April 19, 2024, 11:10 a.m.