1 files changed, 77 insertions, 0 deletions
diff --git a/man/kinfit.Rd b/man/kinfit.Rd
new file mode 100644
index 0000000..f0301fd
--- /dev/null
+++ b/man/kinfit.Rd
@@ -0,0 +1,77 @@
+\name{kinfit}
+\Rdversion{1.1}
+\alias{kinfit}
+\title{
+Fit kinetic models to chemical degradation data
+}
+\description{
+  A selection of kinetic models as defined in the FOCUS kinetics report from
+  2006 are fitted to a given dataframe of chemical degradation data.
+}
+\usage{
+kinfit(kindata, kinmodels = c("SFO"), parent.0.user = NA, 
+  start.SFO = list(parent.0 = NA, k = NA), 
+  start.FOMC = list(parent.0 = NA, alpha = NA, beta = NA), 
+  start.DFOP = list(parent.0 = NA, k1 = NA, k2 = NA, g = NA),
+  start.HS = list(parent.0 = NA, k1 = NA, k2 = NA, tb = NA),
+  algorithm = "port")
+}
+\arguments{
+  \item{kindata}{
+    A data frame containing a time variable named \code{t} and concentration 
+    data for the parent compound named \code{parent}.
+  }
+  \item{kinmodels}{
+    An array of character strings which are names of the models to be fit.
+    Possible names are \code{\link{SFO}}, \code{\link{FOMC}}, \code{\link{DFOP}}
+    and \code{\link{HS}}.
+  }
+  \item{parent.0.user}{
+    The user can give a starting estimate for parent.0 here, overriding other
+    potential sources for starting values as specified below.
+  }
+  \item{start.SFO}{
+    A list of starting parameters for fitting the \code{\link{SFO}} model,
+    containing \code{parent.0} and \code{k}. 
+  }
+  \item{start.FOMC}{
+    A list of starting parameters for fitting the \code{\link{FOMC}} model,
+    containing \code{parent.0}, \code{alpha} and \code{beta}. 
+  }
+  \item{start.DFOP}{
+    A list of starting parameters for fitting the \code{\link{DFOP}} model,
+    containing \code{parent.0}, \code{k1}, \code{k2} and \code{g}. 
+  }
+  \item{start.HS}{
+    A list of starting parameters for fitting the \code{\link{HS}} model,
+    containing \code{parent.0}, \code{k1}, \code{k2} and \code{tb}. 
+  }
+  \item{algorithm}{
+    The algorithm to use for the calls to \code{\link{nls}}.
+  }
+}
+\details{
+  Per default all starting parameters are \code{NA} and the function tries to
+  find suitable starting parameters on its own.
+}
+\value{
+  A list of models of class \code{nls} representing the models that were
+  fitted successfully.
+}
+\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://focus.jrc.ec.europa.eu/dk} 
+}
+\author{ Johannes Ranke }
+\examples{
+data(FOCUS_2006_A)
+(kinfits <- kinfit(FOCUS_2006_A))
+data(FOCUS_2006_B)
+(kinfits <- kinfit(FOCUS_2006_B, kinmodels=c("SFO","FOMC")))
+}
+\keyword{ models }
+\keyword{ regression }
+\keyword{ nonlinear }