Reorganise repository using standard package layout

1 files changed, 81 insertions, 0 deletions

diff --git a/man/GUS.Rd b/man/GUS.Rd
new file mode 100644
index 0000000..f1f5f28
--- /dev/null
+++ b/man/GUS.Rd
@@ -0,0 +1,81 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/GUS.R
+\name{GUS}
+\alias{GUS}
+\alias{GUS.chent}
+\alias{GUS.numeric}
+\alias{print.GUS_result}
+\title{Groundwater ubiquity score based on Gustafson (1989)}
+\usage{
+GUS(...)
+
+\method{GUS}{numeric}(DT50, Koc, ...)
+
+\method{GUS}{chent}(chent, degradation_value = "DT50ref",
+  lab_field = "laboratory", redox = "aerobic", sorption_value = "Kfoc",
+  degradation_aggregator = geomean, sorption_aggregator = geomean, ...)
+
+\method{print}{GUS_result}(x, ..., digits = 1)
+}
+\arguments{
+\item{...}{Included in the generic to allow for further arguments later. Therefore
+this also had to be added to the specific methods.}
+
+\item{DT50}{Half-life of the chemical in soil. Should be a field
+half-life according to Gustafson (1989). However, leaching to the sub-soil
+can not completely be excluded in field dissipation experiments and Gustafson
+did not refer to any normalisation procedure, but says the field study should
+be conducted under use conditions.}
+
+\item{Koc}{The sorption constant normalised to organic carbon. Gustafson
+does not mention the nonlinearity of the sorption constant commonly
+found and usually described by Freundlich sorption, therefore it is 
+unclear at which reference concentration the Koc should be observed
+(and if the reference concentration would be in soil or in porewater).}
+
+\item{chent}{If a chent is given with appropriate information present in its
+chyaml field, this information is used, with defaults specified below.}
+
+\item{degradation_value}{Which of the available degradation values should 
+be used?}
+
+\item{lab_field}{Should laboratory or field half-lives be used? This
+defaults to lab in this implementation, in order to avoid
+double-accounting for mobility. If comparability with the original GUS
+values given by Gustafson (1989) is desired, non-normalised first-order
+field half-lives obtained under actual use conditions should be used.}
+
+\item{redox}{Aerobic or anaerobic degradation data}
+
+\item{sorption_value}{Which of the available sorption values should be used?
+Defaults to Kfoc as this is what is generally available from the European
+pesticide peer review process. These values generally use a reference
+concentration of 1 mg/L in porewater, that means they would be expected to
+be Koc values at a concentration of 1 mg/L in the water phase.}
+
+\item{degradation_aggregator}{Function for aggregating half-lives}
+
+\item{sorption_aggregator}{Function for aggregation Koc values}
+
+\item{x}{An object of class GUS_result to be printed}
+
+\item{digits}{The number of digits used in the print method}
+}
+\value{
+A list with the DT50 and Koc used as well as the resulting score
+  of class GUS_result
+}
+\description{
+The groundwater ubiquity score GUS is calculated according to
+the following equation
+\deqn{GUS = \log_{10} DT50_{soil} (4 - \log_{10} K_{oc})}{GUS = log10 DT50soil * (4 - log10 Koc)}
+}
+\author{
+Johannes Ranke
+}
+\references{
+Gustafson, David I. (1989) Groundwater ubiquity score: a simple
+method for assessing pesticide leachability. \emph{Environmental
+toxicology and chemistry} \bold{8}(4) 339–57.
+}
+