From fbfffc0e47171cac03797340fde697a75a5afd61 Mon Sep 17 00:00:00 2001
From: Johannes Ranke <jranke@uni-bremen.de>
Date: Mon, 26 Nov 2018 11:44:27 +0100
Subject: Add AIC method for mmkin column objects

Static documentation rebuilt by pkgdown
---
 man/AIC.mmkin.Rd | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 man/AIC.mmkin.Rd

(limited to 'man/AIC.mmkin.Rd')

diff --git a/man/AIC.mmkin.Rd b/man/AIC.mmkin.Rd
new file mode 100644
index 00000000..e7f5c228
--- /dev/null
+++ b/man/AIC.mmkin.Rd
@@ -0,0 +1,44 @@
+\name{AIC.mmkin}
+\alias{AIC.mmkin}
+\title{
+  Calculated the AIC for a column of an mmkin object
+}
+\description{
+  Provides a convenient way to compare different kineti models fitted to the
+  same dataset.
+}
+\usage{
+  \method{AIC}{mmkin}(object, ..., k = 2)
+}
+\arguments{
+  \item{object}{
+    An object of class \code{\link{mmkin}}, containing only one column.
+  }
+  \item{\dots}{
+    For compatibility with the generic method
+  }
+  \item{k}{
+    As in the generic method
+  }
+}
+\value{
+  As in the generic method (a numeric value for single fits, or a dataframe if
+  there are several fits in the column).
+}
+\examples{
+  f <- mmkin(c("SFO", "FOMC", "DFOP"),
+    list("FOCUS A" = FOCUS_2006_A,
+         "FOCUS C" = FOCUS_2006_C))
+  AIC(f[1, "FOCUS A"]) # We get a single number for a single fit
+
+  # For FOCUS A, the models fit almost equally well, so the higher the number
+  # of parameters, the higher (worse) the AIC
+  AIC(f[, "FOCUS A"])
+  AIC(f[, "FOCUS A"], k = 0) # If we do not penalize additional parameters, we get nearly the same
+
+  # For FOCUS C, the more complex models fit better
+  AIC(f[, "FOCUS C"])
+}
+\author{
+  Johannes Ranke
+}
-- 
cgit v1.2.1