# streamDepletr v0.1.1

Monthly downloads

## Estimate Streamflow Depletion Due to Groundwater Pumping

Implementation of analytical models for estimating streamflow
depletion due to groundwater pumping, and other related tools. Functions
are broadly split into two groups: (1) analytical streamflow depletion
models, which estimate streamflow depletion for a single stream reach
resulting from groundwater pumping; and (2) depletion apportionment
equations, which distribute estimated streamflow depletion among multiple
stream reaches within a stream network. See Zipper et al. (2018) <doi:10.1029/2018WR022707>
for more information on depletion apportionment equations and Zipper et
al. (2019) <doi:10.1029/2018WR024403> for more information on analytical
depletion functions, which combine analytical models and depletion apportionment
equations.

## Readme

# streamDepletr

streamDepletr is an R package with functions for assessing the impacts of groundwater pumping on streams. There are two primary categories of functions:

- Analytical streamflow depletion models, which estimate the change in
groundwater inputs to a stream resulting from pumping (
`hunt`

,`glover`

,`hantush`

,`intermittent_pumping`

) - Depletion apportionment equations, which distribute streamflow
depletion estimating using the analytical models to different
reaches within a stream network (
`apportion_inverse`

,`apportion_web`

,`apportion_polygon`

,`apportion_wedge`

) - Data preparation functions to prepare inputs for the analytical
models and depletion apportionment equations
(
`depletion_max_distance`

,`prep_reach_dist`

,`streambed_conductance`

)

Combined, these functions will allow the user to estimate the impacts of an existing or proposed well (or group of wells) on individual stream reaches within a stream network.

## Installation

You can install streamDepletr from CRAN:
`install.packages("streamDepletr")`

Alternately, you can use `devtools`

to install the development version:

```
devtools::install_github("FoundrySpatial/streamDepletr", build_vignettes=T)
```

## Example

Calculate and plot streamflow depletion as a fraction of the pumping
rate (`Qf`

) over the 100 days of pumping:

```
require(streamDepletr)
#> Loading required package: streamDepletr
# calculate depletion fraction
Qf <- glover(t = seq(1,100), # timesteps to evaluate
d = 150, # well to stream distance
S = 0.10, # specific yield
Tr = 50*1e-5*86400) # 50 m thick aquifer with hydraulic conductivity of 1e-5 m/s
# plot
plot(seq(1,100), Qf, type="l", xlab="Time [days]", ylab="Qf, Streamflow Depletion Fraction")
```

For more examples, please check out the package vignette:

`browseVignettes("streamDepletr")`

## Package Development

streamDepletr was developed by Foundry Spatial Ltd. and the University of Victoria with support from the National Sciences and Engineering Research Council of Canada.

## Functions in streamDepletr

Name | Description | |

hantush | Streamflow depletion in partially penetrating stream with semipervious streambed. | |

streambed_conductance | Estimate streambed conductance. | |

intermittent_pumping | Streamflow depletion for an intermittent pumping schedule using superposition. | |

induce_infiltration_time | Calculate the critical time at which stream transitions from gaining to losing. | |

prep_reach_dist | Calculate the distance from a well to each reach within a stream network. This function splits a polyline stream network up into a series of evenly spaced points and calculates the distance from each of those points to a well. | |

stream_lines | Stream network for Sixmile Creek Watershed, Wisconsin, USA. Extracted from US NHDPlus v2.1 national seamless dataset. | |

glover | Streamflow depletion with fully-penetrating stream and no streambed. | |

induce_infiltration_rate | Calculate the pumping rate at which pumping will induce infiltration from stream. | |

hunt | Streamflow depletion in partially penetrating stream with semipervious streambed. | |

depletion_max_distance | Calculate maximum distance at which streamflow depletion will exceed a user-selected threshold. Note that this only considers a single stream - depletion apportionment does not occur. | |

discharge_df | Streamflow for Sixmile Creek and Dorn Creek. | |

apportion_web | Distribute streamflow depletion within a stream network using web distance weighting. | |

apportion_wedge | Distribute streamflow depletion between two streams in a wedge-shaped aquifer. | |

apportion_inverse | Distribute streamflow depletion within a stream network using inverse distance weighting. | |

apportion_polygon | Distribute streamflow depletion within a stream network using web distance Thiessen polygons. | |

No Results! |

## Vignettes of streamDepletr

Name | ||

Comparison_DepletionApportionment.png | ||

Comparison_DepletionApportionment.svg | ||

Comparison_Glover+Hunt.png | ||

Comparison_Glover+Hunt.svg | ||

Sixmile_Map+Discharge.png | ||

intro-to-streamDepletr.Rmd | ||

No Results! |

## Last month downloads

## Details

Copyright | Foundry Spatial Ltd. |

URL | https://github.com/FoundrySpatial/streamDepletr |

BugReports | https://github.com/FoundrySpatial/streamDepletr/issues |

License | BSD_3_clause + file LICENSE |

Encoding | UTF-8 |

LazyData | true |

RoxygenNote | 7.0.2 |

VignetteBuilder | knitr |

NeedsCompilation | no |

Packaged | 2020-03-24 15:59:10 UTC; samzipper |

Repository | CRAN |

Date/Publication | 2020-03-25 15:00:02 UTC |

#### Include our badge in your README

```
[![Rdoc](http://www.rdocumentation.org/badges/version/streamDepletr)](http://www.rdocumentation.org/packages/streamDepletr)
```