Exposit runoff calculations for surface water

3 files changed, 105 insertions, 0 deletions

diff --git a/man/PEC_sw_exposit_runoff.Rd b/man/PEC_sw_exposit_runoff.Rd
new file mode 100644
index 0000000..7ed18b6
--- /dev/null
+++ b/man/PEC_sw_exposit_runoff.Rd
@@ -0,0 +1,47 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/PEC_sw_exposit_runoff.R
+\name{PEC_sw_exposit_runoff}
+\alias{PEC_sw_exposit_runoff}
+\title{Calculate PEC surface water due to runoff and erosion as in Exposit 3}
+\source{
+Excel 3.01 spreadsheet available from
+  \url{https://www.bvl.bund.de/DE/04_Pflanzenschutzmittel/03_Antragsteller/04_Zulassungsverfahren/07_Naturhaushalt/psm_naturhaush_node.html#doc1400590bodyText3}
+}
+\usage{
+PEC_sw_exposit_runoff(rate, Koc, DT50 = Inf, t_runoff = 3,
+  exposit_reduction_version = c("3.01", "2.0"), V_ditch = 30,
+  V_event = 100)
+}
+\arguments{
+\item{rate}{The application rate in g/ha}
+
+\item{Koc}{The sorption coefficient to soil organic carbon}
+
+\item{DT50}{The soil half-life in days}
+
+\item{t_runoff}{The time between application and the runoff event, where degradation occurs, in days}
+
+\item{exposit_reduction_version}{The version of the reduction factors to be used}
+
+\item{V_ditch}{The volume of the ditch is assumed to be 1 m * 100 m * 30 cm = 30 m3}
+
+\item{V_event}{The unreduced runoff volume, equivalent to 10 mm precipitation on 1 ha}
+}
+\value{
+A list containing the following components
+  \describe{
+    \item{Input}{A matrix containing dissolved and bound input for the different distances}
+    \item{PEC_sw_runoff}{A matrix containing PEC values for dissolved and bound substance
+      for the different distances. If the rate was given in g/ha, the PECsw are in microg/L.}
+  }
+}
+\description{
+This is a reimplementation of the calculation described in the Exposit 3.01 spreadsheet file,
+in the worksheet "Konzept Runoff". Calculation of sediment PEC values is not implemented.
+}
+\examples{
+  PEC_sw_exposit_runoff(500, 150)
+}
+\seealso{
+\code{\link{perc_runoff_exposit}} for runoff loss percentages and \code{\link{perc_runoff_reduction_exposit}} for runoff reduction percentages used
+}
diff --git a/man/perc_runoff_exposit.Rd b/man/perc_runoff_exposit.Rd
new file mode 100644
index 0000000..70f80c5
--- /dev/null
+++ b/man/perc_runoff_exposit.Rd
@@ -0,0 +1,29 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/PEC_sw_exposit_runoff.R
+\docType{data}
+\name{perc_runoff_exposit}
+\alias{perc_runoff_exposit}
+\alias{Koc_breaks}
+\title{Runoff loss percentages as used in Exposit 3}
+\format{A data frame with percentage values for the dissolved fraction and the fraction
+  bound to eroding particles, with Koc classes used as row names
+  \describe{
+    \item{dissolved}{The percentage of the applied substance transferred to an
+      adjacent water body in the dissolved phase}
+    \item{bound}{The percentage of the applied substance transferred to an
+      adjacent water body bound to eroding particles}
+  }}
+\source{
+Excel 3.01 spreadsheet available from
+  \url{https://www.bvl.bund.de/DE/04_Pflanzenschutzmittel/03_Antragsteller/04_Zulassungsverfahren/07_Naturhaushalt/psm_naturhaush_node.html#doc1400590bodyText3}
+}
+\usage{
+Koc_breaks
+}
+\description{
+A table of the loss percentages used in Exposit 3 for the twelve different Koc classes
+}
+\examples{
+print(perc_runoff_exposit)
+}
+\keyword{datasets}
diff --git a/man/perc_runoff_reduction_exposit.Rd b/man/perc_runoff_reduction_exposit.Rd
new file mode 100644
index 0000000..51b067d
--- /dev/null
+++ b/man/perc_runoff_reduction_exposit.Rd
@@ -0,0 +1,29 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/PEC_sw_exposit_runoff.R
+\docType{data}
+\name{perc_runoff_reduction_exposit}
+\alias{perc_runoff_reduction_exposit}
+\alias{buffers}
+\title{Runoff reduction percentages as used in Exposit}
+\format{A named list of data frames with reduction percentage values for the
+dissolved fraction and the fraction bound to eroding particles, with
+vegetated buffer widths as row names. The names of the list items are the Exposit versions
+from which the values were taken.
+  \describe{
+    \item{dissolved}{The reduction percentage for the dissolved phase}
+    \item{bound}{The reduction percentage for the particulate phase}
+  }}
+\source{
+Excel 3.01 spreadsheet available from
+  \url{https://www.bvl.bund.de/DE/04_Pflanzenschutzmittel/03_Antragsteller/04_Zulassungsverfahren/07_Naturhaushalt/psm_naturhaush_node.html#doc1400590bodyText3}
+}
+\usage{
+buffers
+}
+\description{
+A table of the runoff reduction percentages used in Exposit 3 for different vegetated buffer widths
+}
+\examples{
+print(perc_runoff_reduction_exposit)
+}
+\keyword{datasets}