mkindsg class to hold groups of datasets

- D24_2014 dataset on aerobic soil degradation of 2,4-D from the EU
  assessment as mkindsg object with metadata
- f_time_norm_focus() to do time-step normalisation using the FOCUS
  method
- focus_soil_moisture data with default moisture contents at pF1,
  pF 2 and pF 2.5 for USDA soil types from FOCUS GW guidance
- Dataset generation scripts in inst/dataset_generation
- Depend on R >= 2.15.1 in order to facilitate the use of
  utils::globalVariables()

1 files changed, 72 insertions, 0 deletions

diff --git a/man/f_time_norm_focus.Rd b/man/f_time_norm_focus.Rd
new file mode 100644
index 00000000..9d858312
--- /dev/null
+++ b/man/f_time_norm_focus.Rd
@@ -0,0 +1,72 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/f_time_norm_focus.R
+\name{f_time_norm_focus}
+\alias{f_time_norm_focus}
+\alias{f_time_norm_focus.numeric}
+\alias{f_time_norm_focus.mkindsg}
+\title{Normalisation factors for aerobic soil degradation according to FOCUS guidance}
+\usage{
+f_time_norm_focus(object, ...)
+
+\method{f_time_norm_focus}{numeric}(
+  object,
+  moisture = NA,
+  field_moisture = NA,
+  temperature = object,
+  Q10 = 2.58,
+  walker = 0.7,
+  f_na = NA,
+  ...
+)
+
+\method{f_time_norm_focus}{mkindsg}(object, Q10 = 2.58, walker = 0.7, f_na = NA, ...)
+}
+\arguments{
+\item{object}{An object containing information used for the calculations}
+
+\item{\dots}{Currently not used}
+
+\item{moisture}{Numeric vector of moisture contents in \\\% w/w}
+
+\item{field_moisture}{Numeric vector of moisture contents at field capacity
+(pF2) in \\\% w/w}
+
+\item{temperature}{Numeric vector of temperatures in °C}
+
+\item{Q10}{The Q10 value used for temperature normalisation}
+
+\item{walker}{The Walker exponent used for moisture normalisation}
+
+\item{f_na}{The factor to use for NA values. If set to NA, only factors
+for complete cases will be returned.}
+}
+\description{
+Time step normalisation factors for aerobic soil degradation as described
+in Appendix 8 to the FOCUS kinetics guidance (FOCUS 2014, p. 369).
+}
+\examples{
+f_time_norm_focus(25, 20, 25) # 1.37, compare p. 184
+
+D24_2014$meta
+# No moisture normalisation in the first dataset, so we use f_na = 1 to get
+# Temperature only normalisation as in the EU evaluation
+f_time_norm_focus(D24_2014, f_na = 1)
+# Moisture normalisation for the other four soils is one, as soil moisture
+# is higher than the approximate field capacity derived from the USDA soil
+# type
+}
+\references{
+FOCUS (2006) \dQuote{Guidance Document on Estimating Persistence
+and Degradation Kinetics from Environmental Fate Studies on Pesticides in
+EU Registration} Report of the FOCUS Work Group on Degradation Kinetics,
+EC Document Reference Sanco/10058/2005 version 2.0, 434 pp,
+\url{http://esdac.jrc.ec.europa.eu/projects/degradation-kinetics}
+FOCUS (2014) \dQuote{Generic guidance for Estimating Persistence
+and Degradation Kinetics from Environmental Fate Studies on Pesticides in
+EU Registration} Report of the FOCUS Work Group on Degradation Kinetics,
+Version 1.1, 18 December 2014
+\url{http://esdac.jrc.ec.europa.eu/projects/degradation-kinetics}
+}
+\seealso{
+\link{focus_soil_moisture}
+}