aboutsummaryrefslogtreecommitdiff
path: root/docs/articles
diff options
context:
space:
mode:
Diffstat (limited to 'docs/articles')
-rw-r--r--docs/articles/FOCUS_D.R24
-rw-r--r--docs/articles/FOCUS_D.html255
-rw-r--r--docs/articles/FOCUS_D_cache/html/__packages8
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.RDatabin0 -> 3187 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdb0
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.RDatabin0 -> 2948 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdbbin0 -> 1776 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdxbin0 -> 147 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.RDatabin0 -> 2747 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdbbin0 -> 100313 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdxbin0 -> 170 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.RDatabin0 -> 2803 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdb0
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.RDatabin0 -> 2787 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdb0
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.RDatabin0 -> 4626 bytes
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdb0
-rw-r--r--docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-5-1.pngbin0 -> 74304 bytes
-rw-r--r--docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-6-1.pngbin0 -> 13789 bytes
-rw-r--r--docs/articles/FOCUS_L.R39
-rw-r--r--docs/articles/FOCUS_L.html671
-rw-r--r--docs/articles/FOCUS_L_cache/html/__packages8
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.RDatabin0 -> 3906 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdbbin0 -> 94590 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdxbin0 -> 168 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.RDatabin0 -> 2846 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdbbin0 -> 364 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdxbin0 -> 161 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.RDatabin0 -> 2942 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdbbin0 -> 110729 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdxbin0 -> 185 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.RDatabin0 -> 4161 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdb0
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.RDatabin0 -> 2860 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdbbin0 -> 389 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdxbin0 -> 161 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.RDatabin0 -> 2937 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdbbin0 -> 102249 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdxbin0 -> 171 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.RDatabin0 -> 4103 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdb0
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.RDatabin0 -> 2951 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdbbin0 -> 473 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdxbin0 -> 162 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.RDatabin0 -> 4010 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdbbin0 -> 94254 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdxbin0 -> 168 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.RDatabin0 -> 2828 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdb0
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.RDatabin0 -> 2824 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdb0
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.RDatabin0 -> 3976 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdbbin0 -> 94578 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdxbin0 -> 168 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.RDatabin0 -> 2886 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdbbin0 -> 411 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdxbin0 -> 161 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.RDatabin0 -> 2893 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdbbin0 -> 94065 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdxbin0 -> 168 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.RDatabin0 -> 3898 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdbbin0 -> 94222 bytes
-rw-r--r--docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdxbin0 -> 168 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-10-1.pngbin0 -> 28716 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-12-1.pngbin0 -> 52644 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-13-1.pngbin0 -> 21438 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-15-1.pngbin0 -> 36854 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-4-1.pngbin0 -> 23253 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-5-1.pngbin0 -> 14728 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-6-1.pngbin0 -> 23593 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-8-1.pngbin0 -> 27575 bytes
-rw-r--r--docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-9-1.pngbin0 -> 28058 bytes
-rw-r--r--docs/articles/FOCUS_Z.R93
-rw-r--r--docs/articles/FOCUS_Z.Rnw274
-rw-r--r--docs/articles/FOCUS_Z.aux26
-rw-r--r--docs/articles/FOCUS_Z.bbl15
-rw-r--r--docs/articles/FOCUS_Z.blg46
-rw-r--r--docs/articles/FOCUS_Z.log821
-rw-r--r--docs/articles/FOCUS_Z.out4
-rw-r--r--docs/articles/FOCUS_Z.pdfbin0 -> 239565 bytes
-rw-r--r--docs/articles/FOCUS_Z.tex566
-rw-r--r--docs/articles/FOCUS_Z.toc4
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.RDatabin0 -> 3289 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdbbin0 -> 25733 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdxbin0 -> 176 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.RDatabin0 -> 3303 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdbbin0 -> 27314 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdxbin0 -> 176 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.RDatabin0 -> 3053 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdbbin0 -> 25771 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdxbin0 -> 170 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.RDatabin0 -> 2882 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdb0
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.RDatabin0 -> 3141 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdb0
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdxbin0 -> 113 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.RDatabin0 -> 3562 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdbbin0 -> 16564 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdxbin0 -> 171 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.RDatabin0 -> 3567 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdbbin0 -> 16548 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdxbin0 -> 174 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.RDatabin0 -> 3520 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdbbin0 -> 15981 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdxbin0 -> 169 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.RDatabin0 -> 3249 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdbbin0 -> 19433 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdxbin0 -> 170 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.RDatabin0 -> 3902 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdbbin0 -> 23550 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdxbin0 -> 175 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.RDatabin0 -> 3308 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdbbin0 -> 25240 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdxbin0 -> 176 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.RDatabin0 -> 3243 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdbbin0 -> 21191 bytes
-rw-r--r--docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdxbin0 -> 176 bytes
-rw-r--r--docs/articles/cache/__packages6
-rw-r--r--docs/articles/compiled_models.R42
-rw-r--r--docs/articles/compiled_models.html156
-rw-r--r--docs/articles/compiled_models_files/figure-html/benchmark_FOMC_SFO-1.pngbin0 -> 9876 bytes
-rw-r--r--docs/articles/compiled_models_files/figure-html/benchmark_SFO_SFO-1.pngbin0 -> 12134 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_1-1.pdfbin0 -> 7496 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_10-1.pdfbin0 -> 11048 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_11-1.pdfbin0 -> 11072 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_11a-1.pdfbin0 -> 10940 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_11b-1.pdfbin0 -> 5023 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_2-1.pdfbin0 -> 7481 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_3-1.pdfbin0 -> 7482 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_5-1.pdfbin0 -> 9099 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_6-1.pdfbin0 -> 10771 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_7-1.pdfbin0 -> 10754 bytes
-rw-r--r--docs/articles/figure/FOCUS_2006_Z_fits_9-1.pdfbin0 -> 9392 bytes
-rw-r--r--docs/articles/header.tex22
-rw-r--r--docs/articles/index.html107
-rw-r--r--docs/articles/mkin.R22
-rw-r--r--docs/articles/mkin.html181
-rw-r--r--docs/articles/mkin_cache/html/__packages8
-rw-r--r--docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.RDatabin0 -> 3144 bytes
-rw-r--r--docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdbbin0 -> 105086 bytes
-rw-r--r--docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdxbin0 -> 235 bytes
-rw-r--r--docs/articles/mkin_files/figure-html/unnamed-chunk-2-1.pngbin0 -> 112161 bytes
-rw-r--r--docs/articles/mkin_vignettes.css16
-rw-r--r--docs/articles/references.bib112
153 files changed, 3526 insertions, 0 deletions
diff --git a/docs/articles/FOCUS_D.R b/docs/articles/FOCUS_D.R
new file mode 100644
index 00000000..c3881e80
--- /dev/null
+++ b/docs/articles/FOCUS_D.R
@@ -0,0 +1,24 @@
+## ---- include = FALSE----------------------------------------------------
+library(knitr)
+opts_chunk$set(tidy = FALSE, cache = TRUE)
+
+## ----data----------------------------------------------------------------
+library("mkin")
+print(FOCUS_2006_D)
+
+## ----model---------------------------------------------------------------
+SFO_SFO <- mkinmod(parent = mkinsub("SFO", "m1"), m1 = mkinsub("SFO"))
+print(SFO_SFO$diffs)
+
+## ----fit-----------------------------------------------------------------
+fit <- mkinfit(SFO_SFO, FOCUS_2006_D, quiet = TRUE)
+
+## ----plot, fig.height = 5------------------------------------------------
+plot(fit, show_residuals = TRUE)
+
+## ----plot_2, fig.height = 4----------------------------------------------
+mkinparplot(fit)
+
+## ------------------------------------------------------------------------
+summary(fit)
+
diff --git a/docs/articles/FOCUS_D.html b/docs/articles/FOCUS_D.html
new file mode 100644
index 00000000..df259e21
--- /dev/null
+++ b/docs/articles/FOCUS_D.html
@@ -0,0 +1,255 @@
+<!DOCTYPE html>
+<!-- Generated by pkgdown: do not edit by hand --><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Example evaluation of FOCUS Example Dataset D &bull; mkin</title><!-- jquery --><script src="https://code.jquery.com/jquery-3.1.0.min.js" integrity="sha384-nrOSfDHtoPMzJHjVTdCopGqIqeYETSXhZDFyniQ8ZHcVy08QesyHcnOUpMpqnmWq" crossorigin="anonymous"></script><!-- Bootstrap --><link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous"><script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script><!-- Font Awesome icons --><link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" integrity="sha384-T8Gy5hrqNKT+hzMclPo118YTQO6cYprQmhrYwIiQ/3axmI1hQomh7Ud2hPOy8SP1" crossorigin="anonymous"><!-- pkgdown --><link href="../pkgdown.css" rel="stylesheet"><script src="../jquery.sticky-kit.min.js"></script><script src="../pkgdown.js"></script><!-- mathjax --><script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script><!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]--></head><body>
+ <div class="container template-vignette">
+ <header><div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="../index.html">mkin</a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav"><li>
+ <a href="../index.html">Home</a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul><ul class="nav navbar-nav navbar-right"><li>
+ <a href="https://github.com/jranke/mkin">
+ <span class="fa fa-github fa-lg"></span>
+
+ </a>
+</li>
+ </ul></div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+ </header><div class="row">
+ <div class="col-md-9">
+ <div class="page-header toc-ignore">
+ <h1>Example evaluation of FOCUS Example Dataset D</h1>
+ <h4 class="author">Johannes Ranke</h4>
+
+ <h4 class="date">2016-10-26</h4>
+ </div>
+
+
+
+<div class="contents">
+<p>This is just a very simple vignette showing how to fit a degradation model for a parent compound with one transformation product using <code>mkin</code>. After loading the library we look a the data. We have observed concentrations in the column named <code>value</code> at the times specified in column <code>time</code> for the two observed variables named <code>parent</code> and <code>m1</code>.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">library</span>(<span class="st">"mkin"</span>)
+<span class="kw">print</span>(FOCUS_2006_D)</code></pre></div>
+<pre><code>## name time value
+## 1 parent 0 99.46
+## 2 parent 0 102.04
+## 3 parent 1 93.50
+## 4 parent 1 92.50
+## 5 parent 3 63.23
+## 6 parent 3 68.99
+## 7 parent 7 52.32
+## 8 parent 7 55.13
+## 9 parent 14 27.27
+## 10 parent 14 26.64
+## 11 parent 21 11.50
+## 12 parent 21 11.64
+## 13 parent 35 2.85
+## 14 parent 35 2.91
+## 15 parent 50 0.69
+## 16 parent 50 0.63
+## 17 parent 75 0.05
+## 18 parent 75 0.06
+## 19 parent 100 NA
+## 20 parent 100 NA
+## 21 parent 120 NA
+## 22 parent 120 NA
+## 23 m1 0 0.00
+## 24 m1 0 0.00
+## 25 m1 1 4.84
+## 26 m1 1 5.64
+## 27 m1 3 12.91
+## 28 m1 3 12.96
+## 29 m1 7 22.97
+## 30 m1 7 24.47
+## 31 m1 14 41.69
+## 32 m1 14 33.21
+## 33 m1 21 44.37
+## 34 m1 21 46.44
+## 35 m1 35 41.22
+## 36 m1 35 37.95
+## 37 m1 50 41.19
+## 38 m1 50 40.01
+## 39 m1 75 40.09
+## 40 m1 75 33.85
+## 41 m1 100 31.04
+## 42 m1 100 33.13
+## 43 m1 120 25.15
+## 44 m1 120 33.31</code></pre>
+<p>Next we specify the degradation model: The parent compound degrades with simple first-order kinetics (SFO) to one metabolite named m1, which also degrades with SFO kinetics.</p>
+<p>The call to mkinmod returns a degradation model. The differential equations represented in R code can be found in the character vector <code>$diffs</code> of the <code>mkinmod</code> object. If a C compiler (gcc) is installed and functional, the differential equation model will be compiled from auto-generated C code.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">SFO_SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinmod.html">mkinmod</a></span>(<span class="dt">parent =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"SFO"</span>, <span class="st">"m1"</span>), <span class="dt">m1 =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"SFO"</span>))</code></pre></div>
+<pre><code>## Successfully compiled differential equation model from auto-generated C code.</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">print</span>(SFO_SFO$diffs)</code></pre></div>
+<pre><code>## parent
+## "d_parent = - k_parent_sink * parent - k_parent_m1 * parent"
+## m1
+## "d_m1 = + k_parent_m1 * parent - k_m1_sink * m1"</code></pre>
+<p>We do the fitting without progress report (<code>quiet = TRUE</code>).</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">fit &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(SFO_SFO, FOCUS_2006_D, <span class="dt">quiet =</span> <span class="ot">TRUE</span>)</code></pre></div>
+<p>A plot of the fit including a residual plot for both observed variables is obtained using the <code>plot</code> method for <code>mkinfit</code> objects.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">plot</span>(fit, <span class="dt">show_residuals =</span> <span class="ot">TRUE</span>)</code></pre></div>
+<p><img src="FOCUS_D_files/figure-html/unnamed-chunk-5-1.png" width="672"></p>
+<p>Confidence intervals for the parameter estimates are obtained using the <code>mkinparplot</code> function.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw"><a href="../reference/mkinparplot.html">mkinparplot</a></span>(fit)</code></pre></div>
+<p><img src="FOCUS_D_files/figure-html/unnamed-chunk-6-1.png" width="672"></p>
+<p>A comprehensive report of the results is obtained using the <code>summary</code> method for <code>mkinfit</code> objects.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">summary</span>(fit)</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:10 2016
+## Date of summary: Wed Oct 26 23:18:10 2016
+##
+## Equations:
+## d_parent = - k_parent_sink * parent - k_parent_m1 * parent
+## d_m1 = + k_parent_m1 * parent - k_m1_sink * m1
+##
+## Model predictions using solution type deSolve
+##
+## Fitted with method Port using 153 model solutions performed in 0.628 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 100.7500 state
+## k_parent_sink 0.1000 deparm
+## k_parent_m1 0.1001 deparm
+## k_m1_sink 0.1002 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 100.750000 -Inf Inf
+## log_k_parent_sink -2.302585 -Inf Inf
+## log_k_parent_m1 -2.301586 -Inf Inf
+## log_k_m1_sink -2.300587 -Inf Inf
+##
+## Fixed parameter values:
+## value type
+## m1_0 0 state
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 99.600 1.61400 96.330 102.900
+## log_k_parent_sink -3.038 0.07826 -3.197 -2.879
+## log_k_parent_m1 -2.980 0.04124 -3.064 -2.897
+## log_k_m1_sink -5.248 0.13610 -5.523 -4.972
+##
+## Parameter correlation:
+## parent_0 log_k_parent_sink log_k_parent_m1 log_k_m1_sink
+## parent_0 1.00000 0.6075 -0.06625 -0.1701
+## log_k_parent_sink 0.60752 1.0000 -0.08740 -0.6253
+## log_k_parent_m1 -0.06625 -0.0874 1.00000 0.4716
+## log_k_m1_sink -0.17006 -0.6253 0.47163 1.0000
+##
+## Residual standard error: 3.211 on 36 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 99.600000 61.720 2.024e-38 96.330000 1.029e+02
+## k_parent_sink 0.047920 12.780 3.050e-15 0.040890 5.616e-02
+## k_parent_m1 0.050780 24.250 3.407e-24 0.046700 5.521e-02
+## k_m1_sink 0.005261 7.349 5.758e-09 0.003992 6.933e-03
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 6.398 4 15
+## parent 6.827 3 6
+## m1 4.490 1 9
+##
+## Resulting formation fractions:
+## ff
+## parent_sink 0.4855
+## parent_m1 0.5145
+## m1_sink 1.0000
+##
+## Estimated disappearance times:
+## DT50 DT90
+## parent 7.023 23.33
+## m1 131.761 437.70
+##
+## Data:
+## time variable observed predicted residual
+## 0 parent 99.46 9.960e+01 -1.385e-01
+## 0 parent 102.04 9.960e+01 2.442e+00
+## 1 parent 93.50 9.024e+01 3.262e+00
+## 1 parent 92.50 9.024e+01 2.262e+00
+## 3 parent 63.23 7.407e+01 -1.084e+01
+## 3 parent 68.99 7.407e+01 -5.083e+00
+## 7 parent 52.32 4.991e+01 2.408e+00
+## 7 parent 55.13 4.991e+01 5.218e+00
+## 14 parent 27.27 2.501e+01 2.257e+00
+## 14 parent 26.64 2.501e+01 1.627e+00
+## 21 parent 11.50 1.253e+01 -1.035e+00
+## 21 parent 11.64 1.253e+01 -8.946e-01
+## 35 parent 2.85 3.148e+00 -2.979e-01
+## 35 parent 2.91 3.148e+00 -2.379e-01
+## 50 parent 0.69 7.162e-01 -2.624e-02
+## 50 parent 0.63 7.162e-01 -8.624e-02
+## 75 parent 0.05 6.074e-02 -1.074e-02
+## 75 parent 0.06 6.074e-02 -7.382e-04
+## 100 parent NA 5.151e-03 NA
+## 100 parent NA 5.151e-03 NA
+## 120 parent NA 7.155e-04 NA
+## 120 parent NA 7.155e-04 NA
+## 0 m1 0.00 0.000e+00 0.000e+00
+## 0 m1 0.00 0.000e+00 0.000e+00
+## 1 m1 4.84 4.803e+00 3.704e-02
+## 1 m1 5.64 4.803e+00 8.370e-01
+## 3 m1 12.91 1.302e+01 -1.140e-01
+## 3 m1 12.96 1.302e+01 -6.400e-02
+## 7 m1 22.97 2.504e+01 -2.075e+00
+## 7 m1 24.47 2.504e+01 -5.748e-01
+## 14 m1 41.69 3.669e+01 5.000e+00
+## 14 m1 33.21 3.669e+01 -3.480e+00
+## 21 m1 44.37 4.165e+01 2.717e+00
+## 21 m1 46.44 4.165e+01 4.787e+00
+## 35 m1 41.22 4.331e+01 -2.093e+00
+## 35 m1 37.95 4.331e+01 -5.363e+00
+## 50 m1 41.19 4.122e+01 -2.831e-02
+## 50 m1 40.01 4.122e+01 -1.208e+00
+## 75 m1 40.09 3.645e+01 3.643e+00
+## 75 m1 33.85 3.645e+01 -2.597e+00
+## 100 m1 31.04 3.198e+01 -9.416e-01
+## 100 m1 33.13 3.198e+01 1.148e+00
+## 120 m1 25.15 2.879e+01 -3.640e+00
+## 120 m1 33.31 2.879e+01 4.520e+00</code></pre>
+</div>
+ </div>
+
+ <div class="col-md-3 hidden-xs hidden-sm" id="sidebar">
+ </div>
+
+</div>
+
+
+ <footer><div class="copyright">
+ <p>Developed by Johannes Ranke, Eurofins Regulatory AG.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="http://hadley.github.io/pkgdown/">pkgdown</a>.</p>
+</div>
+
+ </footer></div>
+
+ </body></html>
diff --git a/docs/articles/FOCUS_D_cache/html/__packages b/docs/articles/FOCUS_D_cache/html/__packages
new file mode 100644
index 00000000..8042c1f3
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/__packages
@@ -0,0 +1,8 @@
+base
+minpack.lm
+rootSolve
+inline
+mkin
+knitr
+microbenchmark
+ggplot2
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.RData b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.RData
new file mode 100644
index 00000000..ab5bdfb2
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.RData
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdb b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdb
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdx b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-2_97560c30ad0c097f3807f1e18320a130.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.RData b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.RData
new file mode 100644
index 00000000..580644b8
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.RData
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdb b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdb
new file mode 100644
index 00000000..f8c084a8
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdx b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdx
new file mode 100644
index 00000000..e0718d0f
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-3_8555aac018c25054a7b7c6e1c3222cbb.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.RData b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.RData
new file mode 100644
index 00000000..70504d5a
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.RData
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdb b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdb
new file mode 100644
index 00000000..314f58de
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdx b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdx
new file mode 100644
index 00000000..b11317c6
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-4_c4f4f0bac445d50ee790d1ce8921103e.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.RData b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.RData
new file mode 100644
index 00000000..8a7ff122
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.RData
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdb b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdb
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdx b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-5_e12b7460b9b5808704fd83e871da502a.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.RData b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.RData
new file mode 100644
index 00000000..675d9215
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.RData
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdb b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdb
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdx b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-6_86fcc5fbb808b9fc011ed172dce76d10.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.RData b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.RData
new file mode 100644
index 00000000..0dcf0e32
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.RData
Binary files differ
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdb b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdb
diff --git a/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdx b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_D_cache/html/unnamed-chunk-7_940a932199b6610a3d4e88a8ba9f3d29.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-5-1.png b/docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-5-1.png
new file mode 100644
index 00000000..c0b0c2db
--- /dev/null
+++ b/docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-5-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-6-1.png b/docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-6-1.png
new file mode 100644
index 00000000..6700e527
--- /dev/null
+++ b/docs/articles/FOCUS_D_files/figure-html/unnamed-chunk-6-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L.R b/docs/articles/FOCUS_L.R
new file mode 100644
index 00000000..858d483e
--- /dev/null
+++ b/docs/articles/FOCUS_L.R
@@ -0,0 +1,39 @@
+## ----fig.width = 7, fig.height = 6---------------------------------------
+m.L2.DFOP <- mkinfit("DFOP", FOCUS_2006_L2_mkin, quiet = TRUE)
+plot(m.L2.DFOP, show_residuals = TRUE, show_errmin = TRUE,
+ main = "FOCUS L2 - DFOP")
+summary(m.L2.DFOP, data = FALSE)
+
+## ------------------------------------------------------------------------
+FOCUS_2006_L3 = data.frame(
+ t = c(0, 3, 7, 14, 30, 60, 91, 120),
+ parent = c(97.8, 60, 51, 43, 35, 22, 15, 12))
+FOCUS_2006_L3_mkin <- mkin_wide_to_long(FOCUS_2006_L3)
+
+## ----fig.height = 8------------------------------------------------------
+# Only use one core here, not to offend the CRAN checks
+mm.L3 <- mmkin(c("SFO", "FOMC", "DFOP"), cores = 1,
+ list("FOCUS L3" = FOCUS_2006_L3_mkin), quiet = TRUE)
+plot(mm.L3)
+
+## ----fig.height = 5------------------------------------------------------
+summary(mm.L3[["DFOP", 1]])
+plot(mm.L3[["DFOP", 1]], show_errmin = TRUE)
+
+## ------------------------------------------------------------------------
+FOCUS_2006_L4 = data.frame(
+ t = c(0, 3, 7, 14, 30, 60, 91, 120),
+ parent = c(96.6, 96.3, 94.3, 88.8, 74.9, 59.9, 53.5, 49.0))
+FOCUS_2006_L4_mkin <- mkin_wide_to_long(FOCUS_2006_L4)
+
+## ----fig.height = 6------------------------------------------------------
+# Only use one core here, not to offend the CRAN checks
+mm.L4 <- mmkin(c("SFO", "FOMC"), cores = 1,
+ list("FOCUS L4" = FOCUS_2006_L4_mkin),
+ quiet = TRUE)
+plot(mm.L4)
+
+## ----fig.height = 8------------------------------------------------------
+summary(mm.L4[["SFO", 1]], data = FALSE)
+summary(mm.L4[["FOMC", 1]], data = FALSE)
+
diff --git a/docs/articles/FOCUS_L.html b/docs/articles/FOCUS_L.html
new file mode 100644
index 00000000..cb3096e0
--- /dev/null
+++ b/docs/articles/FOCUS_L.html
@@ -0,0 +1,671 @@
+<!DOCTYPE html>
+<!-- Generated by pkgdown: do not edit by hand --><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Example evaluation of FOCUS Laboratory Data L1 to L3 &bull; mkin</title><!-- jquery --><script src="https://code.jquery.com/jquery-3.1.0.min.js" integrity="sha384-nrOSfDHtoPMzJHjVTdCopGqIqeYETSXhZDFyniQ8ZHcVy08QesyHcnOUpMpqnmWq" crossorigin="anonymous"></script><!-- Bootstrap --><link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous"><script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script><!-- Font Awesome icons --><link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" integrity="sha384-T8Gy5hrqNKT+hzMclPo118YTQO6cYprQmhrYwIiQ/3axmI1hQomh7Ud2hPOy8SP1" crossorigin="anonymous"><!-- pkgdown --><link href="../pkgdown.css" rel="stylesheet"><script src="../jquery.sticky-kit.min.js"></script><script src="../pkgdown.js"></script><!-- mathjax --><script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script><!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]--></head><body>
+ <div class="container template-vignette">
+ <header><div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="../index.html">mkin</a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav"><li>
+ <a href="../index.html">Home</a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul><ul class="nav navbar-nav navbar-right"><li>
+ <a href="https://github.com/jranke/mkin">
+ <span class="fa fa-github fa-lg"></span>
+
+ </a>
+</li>
+ </ul></div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+ </header><div class="row">
+ <div class="col-md-9">
+ <div class="page-header toc-ignore">
+ <h1>Example evaluation of FOCUS Laboratory Data L1 to L3</h1>
+ <h4 class="author">Johannes Ranke</h4>
+
+ <h4 class="date">2016-10-26</h4>
+ </div>
+
+
+
+<div class="contents">
+<div id="laboratory-data-l1" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#laboratory-data-l1" class="anchor"> </a></body></html>Laboratory Data L1</h1>
+<p>The following code defines example dataset L1 from the FOCUS kinetics report, p.&nbsp;284:</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">library</span>(<span class="st">"mkin"</span>, <span class="dt">quietly =</span> <span class="ot">TRUE</span>)
+FOCUS_2006_L1 =<span class="st"> </span><span class="kw">data.frame</span>(
+ <span class="dt">t =</span> <span class="kw">rep</span>(<span class="kw">c</span>(<span class="dv">0</span>, <span class="dv">1</span>, <span class="dv">2</span>, <span class="dv">3</span>, <span class="dv">5</span>, <span class="dv">7</span>, <span class="dv">14</span>, <span class="dv">21</span>, <span class="dv">30</span>), <span class="dt">each =</span> <span class="dv">2</span>),
+ <span class="dt">parent =</span> <span class="kw">c</span>(<span class="fl">88.3</span>, <span class="fl">91.4</span>, <span class="fl">85.6</span>, <span class="fl">84.5</span>, <span class="fl">78.9</span>, <span class="fl">77.6</span>,
+ <span class="fl">72.0</span>, <span class="fl">71.9</span>, <span class="fl">50.3</span>, <span class="fl">59.4</span>, <span class="fl">47.0</span>, <span class="fl">45.1</span>,
+ <span class="fl">27.7</span>, <span class="fl">27.3</span>, <span class="fl">10.0</span>, <span class="fl">10.4</span>, <span class="fl">2.9</span>, <span class="fl">4.0</span>))
+FOCUS_2006_L1_mkin &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkin_wide_to_long.html">mkin_wide_to_long</a></span>(FOCUS_2006_L1)</code></pre></div>
+<p>Here we use the assumptions of simple first order (SFO), the case of declining rate constant over time (FOMC) and the case of two different phases of the kinetics (DFOP). For a more detailed discussion of the models, please see the FOCUS kinetics report.</p>
+<p>Since mkin version 0.9-32 (July 2014), we can use shorthand notation like <code>"SFO"</code> for parent only degradation models. The following two lines fit the model and produce the summary report of the model fit. This covers the numerical analysis given in the FOCUS report.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">m.L1.SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(<span class="st">"SFO"</span>, FOCUS_2006_L1_mkin, <span class="dt">quiet =</span> <span class="ot">TRUE</span>)
+<span class="kw">summary</span>(m.L1.SFO)</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:11 2016
+## Date of summary: Wed Oct 26 23:18:11 2016
+##
+## Equations:
+## d_parent = - k_parent_sink * parent
+##
+## Model predictions using solution type analytical
+##
+## Fitted with method Port using 37 model solutions performed in 0.089 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 89.85 state
+## k_parent_sink 0.10 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 89.850000 -Inf Inf
+## log_k_parent_sink -2.302585 -Inf Inf
+##
+## Fixed parameter values:
+## None
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 92.470 1.36800 89.570 95.370
+## log_k_parent_sink -2.347 0.04057 -2.433 -2.261
+##
+## Parameter correlation:
+## parent_0 log_k_parent_sink
+## parent_0 1.0000 0.6248
+## log_k_parent_sink 0.6248 1.0000
+##
+## Residual standard error: 2.948 on 16 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 92.47000 67.58 2.170e-21 89.57000 95.3700
+## k_parent_sink 0.09561 24.65 1.867e-14 0.08773 0.1042
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 3.424 2 7
+## parent 3.424 2 7
+##
+## Resulting formation fractions:
+## ff
+## parent_sink 1
+##
+## Estimated disappearance times:
+## DT50 DT90
+## parent 7.249 24.08
+##
+## Data:
+## time variable observed predicted residual
+## 0 parent 88.3 92.471 -4.1710
+## 0 parent 91.4 92.471 -1.0710
+## 1 parent 85.6 84.039 1.5610
+## 1 parent 84.5 84.039 0.4610
+## 2 parent 78.9 76.376 2.5241
+## 2 parent 77.6 76.376 1.2241
+## 3 parent 72.0 69.412 2.5884
+## 3 parent 71.9 69.412 2.4884
+## 5 parent 50.3 57.330 -7.0301
+## 5 parent 59.4 57.330 2.0699
+## 7 parent 47.0 47.352 -0.3515
+## 7 parent 45.1 47.352 -2.2515
+## 14 parent 27.7 24.247 3.4528
+## 14 parent 27.3 24.247 3.0528
+## 21 parent 10.0 12.416 -2.4163
+## 21 parent 10.4 12.416 -2.0163
+## 30 parent 2.9 5.251 -2.3513
+## 30 parent 4.0 5.251 -1.2513</code></pre>
+<p>A plot of the fit is obtained with the plot function for mkinfit objects.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">plot</span>(m.L1.SFO, <span class="dt">show_errmin =</span> <span class="ot">TRUE</span>, <span class="dt">main =</span> <span class="st">"FOCUS L1 - SFO"</span>)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-4-1.png" width="576"></p>
+<p>The residual plot can be easily obtained by</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw"><a href="../reference/mkinresplot.html">mkinresplot</a></span>(m.L1.SFO, <span class="dt">ylab =</span> <span class="st">"Observed"</span>, <span class="dt">xlab =</span> <span class="st">"Time"</span>)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-5-1.png" width="576"></p>
+<p>For comparison, the FOMC model is fitted as well, and the <span class="math inline">\(\chi^2\)</span> error level is checked.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">m.L1.FOMC &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(<span class="st">"FOMC"</span>, FOCUS_2006_L1_mkin, <span class="dt">quiet=</span><span class="ot">TRUE</span>)</code></pre></div>
+<pre><code>## Warning in mkinfit("FOMC", FOCUS_2006_L1_mkin, quiet = TRUE): Optimisation by method Port did not converge.
+## Convergence code is 1</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">plot</span>(m.L1.FOMC, <span class="dt">show_errmin =</span> <span class="ot">TRUE</span>, <span class="dt">main =</span> <span class="st">"FOCUS L1 - FOMC"</span>)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-6-1.png" width="576"></p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">summary</span>(m.L1.FOMC, <span class="dt">data =</span> <span class="ot">FALSE</span>)</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:12 2016
+## Date of summary: Wed Oct 26 23:18:12 2016
+##
+##
+## Warning: Optimisation by method Port did not converge.
+## Convergence code is 1
+##
+##
+## Equations:
+## d_parent = - (alpha/beta) * 1/((time/beta) + 1) * parent
+##
+## Model predictions using solution type analytical
+##
+## Fitted with method Port using 188 model solutions performed in 0.434 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 89.85 state
+## alpha 1.00 deparm
+## beta 10.00 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 89.850000 -Inf Inf
+## log_alpha 0.000000 -Inf Inf
+## log_beta 2.302585 -Inf Inf
+##
+## Fixed parameter values:
+## None
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 92.47 1.422 89.44 95.50
+## log_alpha 15.43 15.080 -16.71 47.58
+## log_beta 17.78 15.090 -14.37 49.93
+##
+## Parameter correlation:
+## parent_0 log_alpha log_beta
+## parent_0 1.0000 0.1129 0.1112
+## log_alpha 0.1129 1.0000 1.0000
+## log_beta 0.1112 1.0000 1.0000
+##
+## Residual standard error: 3.045 on 15 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 9.247e+01 65.150 4.044e-20 8.944e+01 9.550e+01
+## alpha 5.044e+06 1.271 1.115e-01 5.510e-08 4.618e+20
+## beta 5.276e+07 1.259 1.137e-01 5.732e-07 4.857e+21
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 3.619 3 6
+## parent 3.619 3 6
+##
+## Estimated disappearance times:
+## DT50 DT90 DT50back
+## parent 7.25 24.08 7.25</code></pre>
+<p>We get a warning that the default optimisation algorithm <code>Port</code> did not converge, which is an indication that the model is overparameterised, <em>i.e.</em> contains too many parameters that are ill-defined as a consequence.</p>
+<p>And in fact, due to the higher number of parameters, and the lower number of degrees of freedom of the fit, the <span class="math inline">\(\chi^2\)</span> error level is actually higher for the FOMC model (3.6%) than for the SFO model (3.4%). Additionally, the parameters <code>log_alpha</code> and <code>log_beta</code> internally fitted in the model have excessive confidence intervals, that span more than 25 orders of magnitude (!) when backtransformed to the scale of <code>alpha</code> and <code>beta</code>. Also, the t-test for significant difference from zero does not indicate such a significant difference, with p-values greater than 0.1, and finally, the parameter correlation of <code>log_alpha</code> and <code>log_beta</code> is 1.000, clearly indicating that the model is overparameterised.</p>
+<p>The <span class="math inline">\(\chi^2\)</span> error levels reported in Appendix 3 and Appendix 7 to the FOCUS kinetics report are rounded to integer percentages and partly deviate by one percentage point from the results calculated by mkin. The reason for this is not known. However, mkin gives the same <span class="math inline">\(\chi^2\)</span> error levels as the kinfit package and the calculation routines of the kinfit package have been extensively compared to the results obtained by the KinGUI software, as documented in the kinfit package vignette. KinGUI was the first widely used standard package in this field. Also, the calculation of <span class="math inline">\(\chi^2\)</span> error levels was compared with KinGUII, CAKE and DegKin manager in a project sponsored by the German Umweltbundesamt <span class="citation">(Ranke, n.d.)</span>.</p>
+</div>
+<div id="laboratory-data-l2" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#laboratory-data-l2" class="anchor"> </a></body></html>Laboratory Data L2</h1>
+<p>The following code defines example dataset L2 from the FOCUS kinetics report, p.&nbsp;287:</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">FOCUS_2006_L2 =<span class="st"> </span><span class="kw">data.frame</span>(
+ <span class="dt">t =</span> <span class="kw">rep</span>(<span class="kw">c</span>(<span class="dv">0</span>, <span class="dv">1</span>, <span class="dv">3</span>, <span class="dv">7</span>, <span class="dv">14</span>, <span class="dv">28</span>), <span class="dt">each =</span> <span class="dv">2</span>),
+ <span class="dt">parent =</span> <span class="kw">c</span>(<span class="fl">96.1</span>, <span class="fl">91.8</span>, <span class="fl">41.4</span>, <span class="fl">38.7</span>,
+ <span class="fl">19.3</span>, <span class="fl">22.3</span>, <span class="fl">4.6</span>, <span class="fl">4.6</span>,
+ <span class="fl">2.6</span>, <span class="fl">1.2</span>, <span class="fl">0.3</span>, <span class="fl">0.6</span>))
+FOCUS_2006_L2_mkin &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkin_wide_to_long.html">mkin_wide_to_long</a></span>(FOCUS_2006_L2)</code></pre></div>
+<div id="sfo-fit-for-l2" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#sfo-fit-for-l2" class="anchor"> </a></body></html>SFO fit for L2</h2>
+<p>Again, the SFO model is fitted and the result is plotted. The residual plot can be obtained simply by adding the argument <code>show_residuals</code> to the plot command.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">m.L2.SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(<span class="st">"SFO"</span>, FOCUS_2006_L2_mkin, <span class="dt">quiet=</span><span class="ot">TRUE</span>)
+<span class="kw">plot</span>(m.L2.SFO, <span class="dt">show_residuals =</span> <span class="ot">TRUE</span>, <span class="dt">show_errmin =</span> <span class="ot">TRUE</span>,
+ <span class="dt">main =</span> <span class="st">"FOCUS L2 - SFO"</span>)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-8-1.png" width="672"></p>
+<p>The <span class="math inline">\(\chi^2\)</span> error level of 14% suggests that the model does not fit very well. This is also obvious from the plots of the fit, in which we have included the residual plot.</p>
+<p>In the FOCUS kinetics report, it is stated that there is no apparent systematic error observed from the residual plot up to the measured DT90 (approximately at day 5), and there is an underestimation beyond that point.</p>
+<p>We may add that it is difficult to judge the random nature of the residuals just from the three samplings at days 0, 1 and 3. Also, it is not clear <em>a priori</em> why a consistent underestimation after the approximate DT90 should be irrelevant. However, this can be rationalised by the fact that the FOCUS fate models generally only implement SFO kinetics.</p>
+</div>
+<div id="fomc-fit-for-l2" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#fomc-fit-for-l2" class="anchor"> </a></body></html>FOMC fit for L2</h2>
+<p>For comparison, the FOMC model is fitted as well, and the <span class="math inline">\(\chi^2\)</span> error level is checked.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">m.L2.FOMC &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(<span class="st">"FOMC"</span>, FOCUS_2006_L2_mkin, <span class="dt">quiet =</span> <span class="ot">TRUE</span>)
+<span class="kw">plot</span>(m.L2.FOMC, <span class="dt">show_residuals =</span> <span class="ot">TRUE</span>,
+ <span class="dt">main =</span> <span class="st">"FOCUS L2 - FOMC"</span>)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-9-1.png" width="672"></p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">summary</span>(m.L2.FOMC, <span class="dt">data =</span> <span class="ot">FALSE</span>)</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:12 2016
+## Date of summary: Wed Oct 26 23:18:12 2016
+##
+## Equations:
+## d_parent = - (alpha/beta) * 1/((time/beta) + 1) * parent
+##
+## Model predictions using solution type analytical
+##
+## Fitted with method Port using 81 model solutions performed in 0.191 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 93.95 state
+## alpha 1.00 deparm
+## beta 10.00 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 93.950000 -Inf Inf
+## log_alpha 0.000000 -Inf Inf
+## log_beta 2.302585 -Inf Inf
+##
+## Fixed parameter values:
+## None
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 93.7700 1.8560 89.5700 97.9700
+## log_alpha 0.3180 0.1867 -0.1044 0.7405
+## log_beta 0.2102 0.2943 -0.4555 0.8759
+##
+## Parameter correlation:
+## parent_0 log_alpha log_beta
+## parent_0 1.00000 -0.09553 -0.1863
+## log_alpha -0.09553 1.00000 0.9757
+## log_beta -0.18628 0.97567 1.0000
+##
+## Residual standard error: 2.628 on 9 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 93.770 50.510 1.173e-12 89.5700 97.970
+## alpha 1.374 5.355 2.296e-04 0.9009 2.097
+## beta 1.234 3.398 3.949e-03 0.6341 2.401
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 6.205 3 3
+## parent 6.205 3 3
+##
+## Estimated disappearance times:
+## DT50 DT90 DT50back
+## parent 0.8092 5.356 1.612</code></pre>
+<p>The error level at which the <span class="math inline">\(\chi^2\)</span> test passes is much lower in this case. Therefore, the FOMC model provides a better description of the data, as less experimental error has to be assumed in order to explain the data.</p>
+</div>
+<div id="dfop-fit-for-l2" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#dfop-fit-for-l2" class="anchor"> </a></body></html>DFOP fit for L2</h2>
+<p>Fitting the four parameter DFOP model further reduces the <span class="math inline">\(\chi^2\)</span> error level.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">m.L2.DFOP &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(<span class="st">"DFOP"</span>, FOCUS_2006_L2_mkin, <span class="dt">quiet =</span> <span class="ot">TRUE</span>)
+<span class="kw">plot</span>(m.L2.DFOP, <span class="dt">show_residuals =</span> <span class="ot">TRUE</span>, <span class="dt">show_errmin =</span> <span class="ot">TRUE</span>,
+ <span class="dt">main =</span> <span class="st">"FOCUS L2 - DFOP"</span>)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-10-1.png" width="672"></p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">summary</span>(m.L2.DFOP, <span class="dt">data =</span> <span class="ot">FALSE</span>)</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:13 2016
+## Date of summary: Wed Oct 26 23:18:14 2016
+##
+## Equations:
+## d_parent = - ((k1 * g * exp(-k1 * time) + k2 * (1 - g) * exp(-k2 *
+## time)) / (g * exp(-k1 * time) + (1 - g) * exp(-k2 *
+## time))) * parent
+##
+## Model predictions using solution type analytical
+##
+## Fitted with method Port using 336 model solutions performed in 0.803 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 93.95 state
+## k1 0.10 deparm
+## k2 0.01 deparm
+## g 0.50 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 93.950000 -Inf Inf
+## log_k1 -2.302585 -Inf Inf
+## log_k2 -4.605170 -Inf Inf
+## g_ilr 0.000000 -Inf Inf
+##
+## Fixed parameter values:
+## None
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 93.9500 NA NA NA
+## log_k1 3.1370 NA NA NA
+## log_k2 -1.0880 NA NA NA
+## g_ilr -0.2821 NA NA NA
+##
+## Parameter correlation:</code></pre>
+<pre><code>## Warning in print.summary.mkinfit(x): Could not estimate covariance matrix; singular system:</code></pre>
+<pre><code>## Could not estimate covariance matrix; singular system:
+##
+## Residual standard error: 1.732 on 8 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 93.9500 NA NA NA NA
+## k1 23.0400 NA NA NA NA
+## k2 0.3369 NA NA NA NA
+## g 0.4016 NA NA NA NA
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 2.53 4 2
+## parent 2.53 4 2
+##
+## Estimated disappearance times:
+## DT50 DT90 DT50_k1 DT50_k2
+## parent 0.5335 5.311 0.03009 2.058</code></pre>
+<p>Here, the DFOP model is clearly the best-fit model for dataset L2 based on the chi^2 error level criterion. However, the failure to calculate the covariance matrix indicates that the parameter estimates correlate excessively. Therefore, the FOMC model may be preferred for this dataset.</p>
+</div>
+</div>
+<div id="laboratory-data-l3" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#laboratory-data-l3" class="anchor"> </a></body></html>Laboratory Data L3</h1>
+<p>The following code defines example dataset L3 from the FOCUS kinetics report, p.&nbsp;290.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">FOCUS_2006_L3 =<span class="st"> </span><span class="kw">data.frame</span>(
+ <span class="dt">t =</span> <span class="kw">c</span>(<span class="dv">0</span>, <span class="dv">3</span>, <span class="dv">7</span>, <span class="dv">14</span>, <span class="dv">30</span>, <span class="dv">60</span>, <span class="dv">91</span>, <span class="dv">120</span>),
+ <span class="dt">parent =</span> <span class="kw">c</span>(<span class="fl">97.8</span>, <span class="dv">60</span>, <span class="dv">51</span>, <span class="dv">43</span>, <span class="dv">35</span>, <span class="dv">22</span>, <span class="dv">15</span>, <span class="dv">12</span>))
+FOCUS_2006_L3_mkin &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkin_wide_to_long.html">mkin_wide_to_long</a></span>(FOCUS_2006_L3)</code></pre></div>
+<div id="use-mmkin-to-fit-multiple-models" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#use-mmkin-to-fit-multiple-models" class="anchor"> </a></body></html>Use mmkin to fit multiple models</h2>
+<p>As of mkin version 0.9-39 (June 2015), we can fit several models to one or more datasets in one call to the function <code>mmkin</code>. The datasets have to be passed in a list, in this case a named list holding only the L3 dataset prepared above.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="co"># Only use one core here, not to offend the CRAN checks</span>
+mm.L3 &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mmkin.html">mmkin</a></span>(<span class="kw">c</span>(<span class="st">"SFO"</span>, <span class="st">"FOMC"</span>, <span class="st">"DFOP"</span>), <span class="dt">cores =</span> <span class="dv">1</span>,
+ <span class="kw">list</span>(<span class="st">"FOCUS L3"</span> =<span class="st"> </span>FOCUS_2006_L3_mkin), <span class="dt">quiet =</span> <span class="ot">TRUE</span>)
+<span class="kw">plot</span>(mm.L3)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-12-1.png" width="672"></p>
+<p>The <span class="math inline">\(\chi^2\)</span> error level of 21% as well as the plot suggest that the SFO model does not fit very well. The FOMC model performs better, with an error level at which the <span class="math inline">\(\chi^2\)</span> test passes of 7%. Fitting the four parameter DFOP model further reduces the <span class="math inline">\(\chi^2\)</span> error level considerably.</p>
+</div>
+<div id="accessing-elements-of-mmkin-objects" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#accessing-elements-of-mmkin-objects" class="anchor"> </a></body></html>Accessing elements of mmkin objects</h2>
+<p>The objects returned by mmkin are arranged like a matrix, with models as a row index and datasets as a column index.</p>
+<p>We can extract the summary and plot for <em>e.g.</em> the DFOP fit, using square brackets for indexing which will result in the use of the summary and plot functions working on mkinfit objects.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">summary</span>(mm.L3[[<span class="st">"DFOP"</span>, <span class="dv">1</span>]])</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:15 2016
+## Date of summary: Wed Oct 26 23:18:15 2016
+##
+## Equations:
+## d_parent = - ((k1 * g * exp(-k1 * time) + k2 * (1 - g) * exp(-k2 *
+## time)) / (g * exp(-k1 * time) + (1 - g) * exp(-k2 *
+## time))) * parent
+##
+## Model predictions using solution type analytical
+##
+## Fitted with method Port using 137 model solutions performed in 0.323 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 97.80 state
+## k1 0.10 deparm
+## k2 0.01 deparm
+## g 0.50 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 97.800000 -Inf Inf
+## log_k1 -2.302585 -Inf Inf
+## log_k2 -4.605170 -Inf Inf
+## g_ilr 0.000000 -Inf Inf
+##
+## Fixed parameter values:
+## None
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 97.7500 1.43800 93.7500 101.70000
+## log_k1 -0.6612 0.13340 -1.0310 -0.29100
+## log_k2 -4.2860 0.05902 -4.4500 -4.12200
+## g_ilr -0.1229 0.05121 -0.2651 0.01925
+##
+## Parameter correlation:
+## parent_0 log_k1 log_k2 g_ilr
+## parent_0 1.00000 0.1640 0.01315 0.4253
+## log_k1 0.16400 1.0000 0.46478 -0.5526
+## log_k2 0.01315 0.4648 1.00000 -0.6631
+## g_ilr 0.42526 -0.5526 -0.66310 1.0000
+##
+## Residual standard error: 1.439 on 4 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 97.75000 67.970 1.404e-07 93.75000 101.70000
+## k1 0.51620 7.499 8.460e-04 0.35650 0.74750
+## k2 0.01376 16.940 3.557e-05 0.01168 0.01621
+## g 0.45660 25.410 7.121e-06 0.40730 0.50680
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 2.225 4 4
+## parent 2.225 4 4
+##
+## Estimated disappearance times:
+## DT50 DT90 DT50_k1 DT50_k2
+## parent 7.464 123 1.343 50.37
+##
+## Data:
+## time variable observed predicted residual
+## 0 parent 97.8 97.75 0.05396
+## 3 parent 60.0 60.45 -0.44933
+## 7 parent 51.0 49.44 1.56338
+## 14 parent 43.0 43.84 -0.83632
+## 30 parent 35.0 35.15 -0.14707
+## 60 parent 22.0 23.26 -1.25919
+## 91 parent 15.0 15.18 -0.18181
+## 120 parent 12.0 10.19 1.81395</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">plot</span>(mm.L3[[<span class="st">"DFOP"</span>, <span class="dv">1</span>]], <span class="dt">show_errmin =</span> <span class="ot">TRUE</span>)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-13-1.png" width="672"></p>
+<p>Here, a look to the model plot, the confidence intervals of the parameters and the correlation matrix suggest that the parameter estimates are reliable, and the DFOP model can be used as the best-fit model based on the <span class="math inline">\(\chi^2\)</span> error level criterion for laboratory data L3.</p>
+<p>This is also an example where the standard t-test for the parameter <code>g_ilr</code> is misleading, as it tests for a significant difference from zero. In this case, zero appears to be the correct value for this parameter, and the confidence interval for the backtransformed parameter <code>g</code> is quite narrow.</p>
+</div>
+</div>
+<div id="laboratory-data-l4" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#laboratory-data-l4" class="anchor"> </a></body></html>Laboratory Data L4</h1>
+<p>The following code defines example dataset L4 from the FOCUS kinetics report, p.&nbsp;293:</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">FOCUS_2006_L4 =<span class="st"> </span><span class="kw">data.frame</span>(
+ <span class="dt">t =</span> <span class="kw">c</span>(<span class="dv">0</span>, <span class="dv">3</span>, <span class="dv">7</span>, <span class="dv">14</span>, <span class="dv">30</span>, <span class="dv">60</span>, <span class="dv">91</span>, <span class="dv">120</span>),
+ <span class="dt">parent =</span> <span class="kw">c</span>(<span class="fl">96.6</span>, <span class="fl">96.3</span>, <span class="fl">94.3</span>, <span class="fl">88.8</span>, <span class="fl">74.9</span>, <span class="fl">59.9</span>, <span class="fl">53.5</span>, <span class="fl">49.0</span>))
+FOCUS_2006_L4_mkin &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkin_wide_to_long.html">mkin_wide_to_long</a></span>(FOCUS_2006_L4)</code></pre></div>
+<p>Fits of the SFO and FOMC models, plots and summaries are produced below:</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="co"># Only use one core here, not to offend the CRAN checks</span>
+mm.L4 &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mmkin.html">mmkin</a></span>(<span class="kw">c</span>(<span class="st">"SFO"</span>, <span class="st">"FOMC"</span>), <span class="dt">cores =</span> <span class="dv">1</span>,
+ <span class="kw">list</span>(<span class="st">"FOCUS L4"</span> =<span class="st"> </span>FOCUS_2006_L4_mkin),
+ <span class="dt">quiet =</span> <span class="ot">TRUE</span>)
+<span class="kw">plot</span>(mm.L4)</code></pre></div>
+<p><img src="FOCUS_L_files/figure-html/unnamed-chunk-15-1.png" width="672"></p>
+<p>The <span class="math inline">\(\chi^2\)</span> error level of 3.3% as well as the plot suggest that the SFO model fits very well. The error level at which the <span class="math inline">\(\chi^2\)</span> test passes is slightly lower for the FOMC model. However, the difference appears negligible.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">summary</span>(mm.L4[[<span class="st">"SFO"</span>, <span class="dv">1</span>]], <span class="dt">data =</span> <span class="ot">FALSE</span>)</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:15 2016
+## Date of summary: Wed Oct 26 23:18:16 2016
+##
+## Equations:
+## d_parent = - k_parent_sink * parent
+##
+## Model predictions using solution type analytical
+##
+## Fitted with method Port using 46 model solutions performed in 0.108 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 96.6 state
+## k_parent_sink 0.1 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 96.600000 -Inf Inf
+## log_k_parent_sink -2.302585 -Inf Inf
+##
+## Fixed parameter values:
+## None
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 96.44 1.94900 91.670 101.200
+## log_k_parent_sink -5.03 0.07999 -5.225 -4.834
+##
+## Parameter correlation:
+## parent_0 log_k_parent_sink
+## parent_0 1.0000 0.5865
+## log_k_parent_sink 0.5865 1.0000
+##
+## Residual standard error: 3.651 on 6 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 96.440000 49.49 2.283e-09 91.670000 1.012e+02
+## k_parent_sink 0.006541 12.50 8.008e-06 0.005378 7.955e-03
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 3.287 2 6
+## parent 3.287 2 6
+##
+## Resulting formation fractions:
+## ff
+## parent_sink 1
+##
+## Estimated disappearance times:
+## DT50 DT90
+## parent 106 352</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">summary</span>(mm.L4[[<span class="st">"FOMC"</span>, <span class="dv">1</span>]], <span class="dt">data =</span> <span class="ot">FALSE</span>)</code></pre></div>
+<pre><code>## mkin version: 0.9.44.9000
+## R version: 3.3.1
+## Date of fit: Wed Oct 26 23:18:16 2016
+## Date of summary: Wed Oct 26 23:18:16 2016
+##
+## Equations:
+## d_parent = - (alpha/beta) * 1/((time/beta) + 1) * parent
+##
+## Model predictions using solution type analytical
+##
+## Fitted with method Port using 66 model solutions performed in 0.151 s
+##
+## Weighting: none
+##
+## Starting values for parameters to be optimised:
+## value type
+## parent_0 96.6 state
+## alpha 1.0 deparm
+## beta 10.0 deparm
+##
+## Starting values for the transformed parameters actually optimised:
+## value lower upper
+## parent_0 96.600000 -Inf Inf
+## log_alpha 0.000000 -Inf Inf
+## log_beta 2.302585 -Inf Inf
+##
+## Fixed parameter values:
+## None
+##
+## Optimised, transformed parameters with symmetric confidence intervals:
+## Estimate Std. Error Lower Upper
+## parent_0 99.1400 1.6800 94.820 103.5000
+## log_alpha -0.3506 0.3725 -1.308 0.6068
+## log_beta 4.1740 0.5635 2.726 5.6230
+##
+## Parameter correlation:
+## parent_0 log_alpha log_beta
+## parent_0 1.0000 -0.5365 -0.6083
+## log_alpha -0.5365 1.0000 0.9913
+## log_beta -0.6083 0.9913 1.0000
+##
+## Residual standard error: 2.315 on 5 degrees of freedom
+##
+## Backtransformed parameters:
+## Confidence intervals for internally transformed parameters are asymmetric.
+## t-test (unrealistically) based on the assumption of normal distribution
+## for estimators of untransformed parameters.
+## Estimate t value Pr(&gt;t) Lower Upper
+## parent_0 99.1400 59.020 1.322e-08 94.8200 103.500
+## alpha 0.7042 2.685 2.178e-02 0.2703 1.835
+## beta 64.9800 1.775 6.807e-02 15.2600 276.600
+##
+## Chi2 error levels in percent:
+## err.min n.optim df
+## All data 2.029 3 5
+## parent 2.029 3 5
+##
+## Estimated disappearance times:
+## DT50 DT90 DT50back
+## parent 108.9 1644 494.9</code></pre>
+</div>
+<div id="references" class="section level1 unnumbered">
+<h1 class="hasAnchor"><html><body><a href="#references" class="anchor"> </a></body></html>References</h1>
+<div id="refs" class="references">
+<div id="ref-ranke2014">
+<p>Ranke, Johannes. n.d. &ldquo;Pr&uuml;fung und Validierung von Modellierungssoftware als Alternative zu ModelMaker 4.0.&rdquo; Umweltbundesamt Projektnummer 27452.</p>
+</div>
+</div>
+</div>
+</div>
+ </div>
+
+ <div class="col-md-3 hidden-xs hidden-sm" id="sidebar">
+ <div id="tocnav">
+ <h2>Contents</h2>
+ <ul class="nav nav-pills nav-stacked"><li><a href="#laboratory-data-l1">Laboratory Data L1</a></li>
+ <li><a href="#laboratory-data-l2">Laboratory Data L2</a><ul class="nav nav-pills nav-stacked"><li><a href="#sfo-fit-for-l2">SFO fit for L2</a></li>
+ <li><a href="#fomc-fit-for-l2">FOMC fit for L2</a></li>
+ <li><a href="#dfop-fit-for-l2">DFOP fit for L2</a></li>
+ </ul></li>
+ <li><a href="#laboratory-data-l3">Laboratory Data L3</a><ul class="nav nav-pills nav-stacked"><li><a href="#use-mmkin-to-fit-multiple-models">Use mmkin to fit multiple models</a></li>
+ <li><a href="#accessing-elements-of-mmkin-objects">Accessing elements of mmkin objects</a></li>
+ </ul></li>
+ <li><a href="#laboratory-data-l4">Laboratory Data L4</a></li>
+ <li><a href="#references">References</a></li>
+ </ul></div>
+ </div>
+
+</div>
+
+
+ <footer><div class="copyright">
+ <p>Developed by Johannes Ranke, Eurofins Regulatory AG.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="http://hadley.github.io/pkgdown/">pkgdown</a>.</p>
+</div>
+
+ </footer></div>
+
+ </body></html>
diff --git a/docs/articles/FOCUS_L_cache/html/__packages b/docs/articles/FOCUS_L_cache/html/__packages
new file mode 100644
index 00000000..8042c1f3
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/__packages
@@ -0,0 +1,8 @@
+base
+minpack.lm
+rootSolve
+inline
+mkin
+knitr
+microbenchmark
+ggplot2
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.RData
new file mode 100644
index 00000000..ed0c5a13
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdb
new file mode 100644
index 00000000..e3db00f2
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdx
new file mode 100644
index 00000000..70daf843
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-10_17bd4df3f9dbbfdb646235ad948e7903.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.RData
new file mode 100644
index 00000000..6727797f
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdb
new file mode 100644
index 00000000..cc81096d
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdx
new file mode 100644
index 00000000..9c4afcfd
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-11_55afc351baf052d70313229bbfe083b1.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.RData
new file mode 100644
index 00000000..f1fd1a1e
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdb
new file mode 100644
index 00000000..06f854c7
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdx
new file mode 100644
index 00000000..7fe7b836
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-12_475fd4322218ba45b9d4c6570ce82306.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.RData
new file mode 100644
index 00000000..c6df11f0
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdb
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-13_fe41237f20ce0e1192c2720eb7747508.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.RData
new file mode 100644
index 00000000..cb12b63e
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdb
new file mode 100644
index 00000000..4bc303bf
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdx
new file mode 100644
index 00000000..e25dd615
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-14_d1d0018379d20457895c7e55068a1dd4.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.RData
new file mode 100644
index 00000000..cca9f00d
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdb
new file mode 100644
index 00000000..504ba4a3
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdx
new file mode 100644
index 00000000..9adbac6d
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-15_455b679cd6cc9762c244b80513c515c8.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.RData
new file mode 100644
index 00000000..0a05f4f5
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdb
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-16_f0c16cb42c39ff3e0802b1bed681fcd7.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.RData
new file mode 100644
index 00000000..89b8234c
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdb
new file mode 100644
index 00000000..05a10d06
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdx
new file mode 100644
index 00000000..1c1f9696
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-2_6d7c6df950fe0059e9d9a95eee862d26.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.RData
new file mode 100644
index 00000000..2a76a0d2
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdb
new file mode 100644
index 00000000..9edd1973
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdx
new file mode 100644
index 00000000..dbf0a9e4
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-3_b475c6205236b47de3205266a85d05eb.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.RData
new file mode 100644
index 00000000..b950c4bc
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdb
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-4_4baef7cf5b3c7ae95499feb05dc0e5fa.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.RData
new file mode 100644
index 00000000..59911e29
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdb
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-5_99a08d47988f0a43ccc269459e2a16f2.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.RData
new file mode 100644
index 00000000..70899dc6
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdb
new file mode 100644
index 00000000..f8510279
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdx
new file mode 100644
index 00000000..e8b039d3
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-6_f68425c53adf6d973b0313f640ab22c4.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.RData
new file mode 100644
index 00000000..2aac9f45
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdb
new file mode 100644
index 00000000..11549909
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdx
new file mode 100644
index 00000000..1fa42d6e
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-7_7e8f2e6290a4398ce495c06f62b5eb5a.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.RData
new file mode 100644
index 00000000..2d69bb7d
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdb
new file mode 100644
index 00000000..57d39958
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdx
new file mode 100644
index 00000000..4473deeb
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-8_50faede8d3b8c141ad3337c437834082.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.RData b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.RData
new file mode 100644
index 00000000..231deb0f
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.RData
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdb b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdb
new file mode 100644
index 00000000..609d7b43
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdb
Binary files differ
diff --git a/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdx b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdx
new file mode 100644
index 00000000..6c25eae6
--- /dev/null
+++ b/docs/articles/FOCUS_L_cache/html/unnamed-chunk-9_4097275e9142f8a1f53afaf3c3c84573.rdx
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-10-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-10-1.png
new file mode 100644
index 00000000..bb174c01
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-10-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-12-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-12-1.png
new file mode 100644
index 00000000..cab1f123
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-12-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-13-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-13-1.png
new file mode 100644
index 00000000..4ef79892
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-13-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-15-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-15-1.png
new file mode 100644
index 00000000..b8eef14c
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-15-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-4-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-4-1.png
new file mode 100644
index 00000000..860ec47b
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-4-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-5-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-5-1.png
new file mode 100644
index 00000000..5131f700
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-5-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-6-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-6-1.png
new file mode 100644
index 00000000..2908e5ea
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-6-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-8-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-8-1.png
new file mode 100644
index 00000000..b4bcc8fc
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-8-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-9-1.png b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-9-1.png
new file mode 100644
index 00000000..21a8c2e3
--- /dev/null
+++ b/docs/articles/FOCUS_L_files/figure-html/unnamed-chunk-9-1.png
Binary files differ
diff --git a/docs/articles/FOCUS_Z.R b/docs/articles/FOCUS_Z.R
new file mode 100644
index 00000000..5fc8f123
--- /dev/null
+++ b/docs/articles/FOCUS_Z.R
@@ -0,0 +1,93 @@
+## ----FOCUS_2006_Z_fits_1, echo=TRUE, fig.height=6-------------------
+Z.2a <- mkinmod(Z0 = mkinsub("SFO", "Z1"),
+ Z1 = mkinsub("SFO"))
+m.Z.2a <- mkinfit(Z.2a, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.2a)
+summary(m.Z.2a, data = FALSE)$bpar
+
+## ----FOCUS_2006_Z_fits_2, echo=TRUE, fig.height=6-------------------
+Z.2a.ff <- mkinmod(Z0 = mkinsub("SFO", "Z1"),
+ Z1 = mkinsub("SFO"),
+ use_of_ff = "max")
+
+m.Z.2a.ff <- mkinfit(Z.2a.ff, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.2a.ff)
+summary(m.Z.2a.ff, data = FALSE)$bpar
+
+## ----FOCUS_2006_Z_fits_3, echo=TRUE, fig.height=6-------------------
+Z.3 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO"), use_of_ff = "max")
+m.Z.3 <- mkinfit(Z.3, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.3)
+summary(m.Z.3, data = FALSE)$bpar
+
+## ----FOCUS_2006_Z_fits_5, echo=TRUE, fig.height=7-------------------
+Z.5 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO"), use_of_ff = "max")
+m.Z.5 <- mkinfit(Z.5, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.5)
+
+## ----FOCUS_2006_Z_fits_6, echo=TRUE, fig.height=8-------------------
+Z.FOCUS <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFO"),
+ use_of_ff = "max")
+m.Z.FOCUS <- mkinfit(Z.FOCUS, FOCUS_2006_Z_mkin,
+ parms.ini = m.Z.5$bparms.ode,
+ quiet = TRUE)
+plot_sep(m.Z.FOCUS)
+summary(m.Z.FOCUS, data = FALSE)$bpar
+endpoints(m.Z.FOCUS)
+
+## ----FOCUS_2006_Z_fits_7, echo=TRUE, fig.height=8-------------------
+Z.mkin.1 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFORB"))
+m.Z.mkin.1 <- mkinfit(Z.mkin.1, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.mkin.1)
+summary(m.Z.mkin.1, data = FALSE)$cov.unscaled
+
+## ----FOCUS_2006_Z_fits_9, echo=TRUE, fig.height=8-------------------
+Z.mkin.3 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO"))
+m.Z.mkin.3 <- mkinfit(Z.mkin.3, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.mkin.3)
+
+## ----FOCUS_2006_Z_fits_10, echo=TRUE, fig.height=8------------------
+Z.mkin.4 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFO"))
+m.Z.mkin.4 <- mkinfit(Z.mkin.4, FOCUS_2006_Z_mkin,
+ parms.ini = m.Z.mkin.3$bparms.ode,
+ quiet = TRUE)
+plot_sep(m.Z.mkin.4)
+
+## ----FOCUS_2006_Z_fits_11, echo=TRUE, fig.height=8------------------
+Z.mkin.5 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFORB"))
+m.Z.mkin.5 <- mkinfit(Z.mkin.5, FOCUS_2006_Z_mkin,
+ parms.ini = m.Z.mkin.4$bparms.ode[1:4],
+ quiet = TRUE)
+plot_sep(m.Z.mkin.5)
+
+## ----FOCUS_2006_Z_fits_11a, echo=TRUE-------------------------------
+m.Z.mkin.5a <- mkinfit(Z.mkin.5, FOCUS_2006_Z_mkin,
+ parms.ini = c(m.Z.mkin.5$bparms.ode[1:7],
+ k_Z3_bound_free = 0),
+ fixed_parms = "k_Z3_bound_free",
+ quiet = TRUE)
+plot_sep(m.Z.mkin.5a)
+
+## ----FOCUS_2006_Z_fits_11b, echo=TRUE-------------------------------
+mkinparplot(m.Z.mkin.5a)
+
+## ----FOCUS_2006_Z_fits_11b_endpoints, echo=TRUE---------------------
+endpoints(m.Z.mkin.5a)
+
diff --git a/docs/articles/FOCUS_Z.Rnw b/docs/articles/FOCUS_Z.Rnw
new file mode 100644
index 00000000..5a66db24
--- /dev/null
+++ b/docs/articles/FOCUS_Z.Rnw
@@ -0,0 +1,274 @@
+%\VignetteIndexEntry{Example evaluation of FOCUS dataset Z}
+%\VignetteEngine{knitr::knitr}
+\documentclass[12pt,a4paper]{article}
+\usepackage{a4wide}
+\input{header}
+\hypersetup{
+ pdftitle = {Example evaluation of FOCUS dataset Z},
+ pdfsubject = {Manuscript},
+ pdfauthor = {Johannes Ranke},
+ colorlinks = {true},
+ linkcolor = {blue},
+ citecolor = {blue},
+ urlcolor = {red},
+ hyperindex = {true},
+ linktocpage = {true},
+}
+
+\begin{document}
+
+<<include=FALSE>>=
+require(knitr)
+opts_chunk$set(engine='R', tidy = FALSE, cache = TRUE)
+options(width=70)
+@
+
+\title{Example evaluation of FOCUS dataset Z}
+\author{\textbf{Johannes Ranke} \\[0.5cm]
+%EndAName
+Wissenschaftlicher Berater\\
+Kronacher Str. 8, 79639 Grenzach-Wyhlen, Germany\\[0.5cm]
+and\\[0.5cm]
+University of Bremen\\
+}
+\maketitle
+
+\thispagestyle{empty} \setcounter{page}{0}
+
+\clearpage
+
+\tableofcontents
+
+\textbf{Key words}: Kinetics, FOCUS, nonlinear optimisation
+
+\section{The data}
+
+The following code defines the example dataset from Appendix 7 to the FOCUS kinetics
+report \citep{FOCUSkinetics2011}, p.350.
+
+<<FOCUS_2006_Z_data, echo=TRUE, eval=TRUE>>=
+require(mkin)
+LOD = 0.5
+FOCUS_2006_Z = data.frame(
+ t = c(0, 0.04, 0.125, 0.29, 0.54, 1, 2, 3, 4, 7, 10, 14, 21,
+ 42, 61, 96, 124),
+ Z0 = c(100, 81.7, 70.4, 51.1, 41.2, 6.6, 4.6, 3.9, 4.6, 4.3, 6.8,
+ 2.9, 3.5, 5.3, 4.4, 1.2, 0.7),
+ Z1 = c(0, 18.3, 29.6, 46.3, 55.1, 65.7, 39.1, 36, 15.3, 5.6, 1.1,
+ 1.6, 0.6, 0.5 * LOD, NA, NA, NA),
+ Z2 = c(0, NA, 0.5 * LOD, 2.6, 3.8, 15.3, 37.2, 31.7, 35.6, 14.5,
+ 0.8, 2.1, 1.9, 0.5 * LOD, NA, NA, NA),
+ Z3 = c(0, NA, NA, NA, NA, 0.5 * LOD, 9.2, 13.1, 22.3, 28.4, 32.5,
+ 25.2, 17.2, 4.8, 4.5, 2.8, 4.4))
+
+FOCUS_2006_Z_mkin <- mkin_wide_to_long(FOCUS_2006_Z)
+@
+
+\section{Parent compound and one metabolite}
+
+The next step is to set up the models used for the kinetic analysis. As the
+simultaneous fit of parent and the first metabolite is usually straightforward,
+Step 1 (SFO for parent only) is skipped here. We start with the model 2a,
+with formation and decline of metabolite Z1 and the pathway from parent
+directly to sink included (default in mkin).
+
+<<FOCUS_2006_Z_fits_1, echo=TRUE, fig.height=6>>=
+Z.2a <- mkinmod(Z0 = mkinsub("SFO", "Z1"),
+ Z1 = mkinsub("SFO"))
+m.Z.2a <- mkinfit(Z.2a, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.2a)
+summary(m.Z.2a, data = FALSE)$bpar
+@
+
+As obvious from the parameter summary (the \texttt{bpar} component of the
+summary), the kinetic rate constant from parent compound Z to sink
+is negligible. Accordingly, the exact magnitude of the fitted parameter
+\texttt{log k\_Z0\_sink} is ill-defined and the covariance matrix is not
+returned (not shown, would be visible in the complete summary).
+This suggests, in agreement with the analysis in the FOCUS kinetics report, to
+simplify the model by removing the pathway to sink.
+
+A similar result can be obtained when formation fractions are used in the model
+formulation:
+
+<<FOCUS_2006_Z_fits_2, echo=TRUE, fig.height=6>>=
+Z.2a.ff <- mkinmod(Z0 = mkinsub("SFO", "Z1"),
+ Z1 = mkinsub("SFO"),
+ use_of_ff = "max")
+
+m.Z.2a.ff <- mkinfit(Z.2a.ff, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.2a.ff)
+summary(m.Z.2a.ff, data = FALSE)$bpar
+@
+
+Here, the ilr transformed formation fraction fitted in the model takes a very
+large value, and the backtransformed formation fraction from parent Z to Z1 is
+practically unity. Again, the covariance matrix is not returned as the model is
+overparameterised.
+
+The simplified model is obtained by setting the list component \texttt{sink} to
+\texttt{FALSE}.\footnote{If the model formulation without formation fractions
+is used, the same effect can be obtained by fixing the parameter \texttt{k\_Z\_sink}
+to a value of zero.}
+
+In the following, we use the parameterisation with formation fractions in order
+to be able to compare with the results in the FOCUS guidance, and as it
+makes it easier to use parameters obtained in a previous fit when adding a further
+metabolite.
+
+<<FOCUS_2006_Z_fits_3, echo=TRUE, fig.height=6>>=
+Z.3 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO"), use_of_ff = "max")
+m.Z.3 <- mkinfit(Z.3, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.3)
+summary(m.Z.3, data = FALSE)$bpar
+@
+
+As there is only one transformation product for Z0 and no pathway
+to sink, the formation fraction is internally fixed to unity.
+
+\section{Including metabolites Z2 and Z3}
+
+As suggested in the FOCUS report, the pathway to sink was removed for metabolite Z1 as
+well in the next step. While this step appears questionable on the basis of the above results, it
+is followed here for the purpose of comparison. Also, in the FOCUS report, it is
+assumed that there is additional empirical evidence that Z1 quickly and exclusively
+hydrolyses to Z2.
+
+<<FOCUS_2006_Z_fits_5, echo=TRUE, fig.height=7>>=
+Z.5 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO"), use_of_ff = "max")
+m.Z.5 <- mkinfit(Z.5, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.5)
+@
+
+Finally, metabolite Z3 is added to the model. We use the optimised
+differential equation parameter values from the previous fit in order to
+accelerate the optimization.
+
+<<FOCUS_2006_Z_fits_6, echo=TRUE, fig.height=8>>=
+Z.FOCUS <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFO"),
+ use_of_ff = "max")
+m.Z.FOCUS <- mkinfit(Z.FOCUS, FOCUS_2006_Z_mkin,
+ parms.ini = m.Z.5$bparms.ode,
+ quiet = TRUE)
+plot_sep(m.Z.FOCUS)
+summary(m.Z.FOCUS, data = FALSE)$bpar
+endpoints(m.Z.FOCUS)
+@
+
+This fit corresponds to the final result chosen in Appendix 7 of the FOCUS
+report. Confidence intervals returned by mkin are based on internally
+transformed parameters, however.
+
+\section{Using the SFORB model for parent and metabolites}
+
+As the FOCUS report states, there is a certain tailing of the time course of metabolite
+Z3. Also, the time course of the parent compound is not fitted very well using the
+SFO model, as residues at a certain low level remain.
+
+Therefore, an additional model is offered here, using the single first-order
+reversible binding (SFORB) model for metabolite Z3. As expected, the $\chi^2$
+error level is lower for metabolite Z3 using this model and the graphical
+fit for Z3 is improved. However, the covariance matrix is not returned.
+
+<<FOCUS_2006_Z_fits_7, echo=TRUE, fig.height=8>>=
+Z.mkin.1 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFORB"))
+m.Z.mkin.1 <- mkinfit(Z.mkin.1, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.mkin.1)
+summary(m.Z.mkin.1, data = FALSE)$cov.unscaled
+@
+
+Therefore, a further stepwise model building is performed starting from the
+stage of parent and two metabolites, starting from the assumption that the model
+fit for the parent compound can be improved by using the SFORB model.
+
+<<FOCUS_2006_Z_fits_9, echo=TRUE, fig.height=8>>=
+Z.mkin.3 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO"))
+m.Z.mkin.3 <- mkinfit(Z.mkin.3, FOCUS_2006_Z_mkin, quiet = TRUE)
+plot_sep(m.Z.mkin.3)
+@
+
+This results in a much better representation of the behaviour of the parent
+compound Z0.
+
+Finally, Z3 is added as well. These models appear overparameterised (no
+covariance matrix returned) if the sink for Z1 is left in the models.
+
+<<FOCUS_2006_Z_fits_10, echo=TRUE, fig.height=8>>=
+Z.mkin.4 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFO"))
+m.Z.mkin.4 <- mkinfit(Z.mkin.4, FOCUS_2006_Z_mkin,
+ parms.ini = m.Z.mkin.3$bparms.ode,
+ quiet = TRUE)
+plot_sep(m.Z.mkin.4)
+@
+
+The error level of the fit, but especially of metabolite Z3, can be improved if
+the SFORB model is chosen for this metabolite, as this model is capable of
+representing the tailing of the metabolite decline phase.
+
+<<FOCUS_2006_Z_fits_11, echo=TRUE, fig.height=8>>=
+Z.mkin.5 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
+ Z1 = mkinsub("SFO", "Z2", sink = FALSE),
+ Z2 = mkinsub("SFO", "Z3"),
+ Z3 = mkinsub("SFORB"))
+m.Z.mkin.5 <- mkinfit(Z.mkin.5, FOCUS_2006_Z_mkin,
+ parms.ini = m.Z.mkin.4$bparms.ode[1:4],
+ quiet = TRUE)
+plot_sep(m.Z.mkin.5)
+@
+
+The summary view of the backtransformed parameters shows that we get no
+confidence intervals due to overparameterisation. As the optimized
+\texttt{k\_Z3\_bound\_free} is excessively small, it seems reasonable to fix it to
+zero.
+
+<<FOCUS_2006_Z_fits_11a, echo=TRUE>>=
+m.Z.mkin.5a <- mkinfit(Z.mkin.5, FOCUS_2006_Z_mkin,
+ parms.ini = c(m.Z.mkin.5$bparms.ode[1:7],
+ k_Z3_bound_free = 0),
+ fixed_parms = "k_Z3_bound_free",
+ quiet = TRUE)
+plot_sep(m.Z.mkin.5a)
+@
+
+As expected, the residual plots for Z0 and Z3 are more random than in the case of the
+all SFO model for which they were shown above. In conclusion, the model
+\texttt{Z.mkin.5a} is proposed as the best-fit model for the dataset from
+Appendix 7 of the FOCUS report.
+
+A graphical representation of the confidence intervals can finally be obtained.
+
+<<FOCUS_2006_Z_fits_11b, echo=TRUE>>=
+mkinparplot(m.Z.mkin.5a)
+@
+
+The endpoints obtained with this model are
+
+<<FOCUS_2006_Z_fits_11b_endpoints, echo=TRUE>>=
+endpoints(m.Z.mkin.5a)
+@
+
+It is clear the degradation rate of Z3 towards the end of the experiment
+is very low as DT50\_Z3\_b2 (the second Eigenvalue of the system of two differential
+equations representing the SFORB system for Z3, corresponding to the slower rate
+constant of the DFOP model) is reported to be infinity. However, this appears
+to be a feature of the data.
+
+\bibliographystyle{plainnat}
+\bibliography{references}
+
+\end{document}
+% vim: set foldmethod=syntax:
diff --git a/docs/articles/FOCUS_Z.aux b/docs/articles/FOCUS_Z.aux
new file mode 100644
index 00000000..f997f2d7
--- /dev/null
+++ b/docs/articles/FOCUS_Z.aux
@@ -0,0 +1,26 @@
+\relax
+\providecommand\hyper@newdestlabel[2]{}
+\providecommand\HyperFirstAtBeginDocument{\AtBeginDocument}
+\HyperFirstAtBeginDocument{\ifx\hyper@anchor\@undefined
+\global\let\oldcontentsline\contentsline
+\gdef\contentsline#1#2#3#4{\oldcontentsline{#1}{#2}{#3}}
+\global\let\oldnewlabel\newlabel
+\gdef\newlabel#1#2{\newlabelxx{#1}#2}
+\gdef\newlabelxx#1#2#3#4#5#6{\oldnewlabel{#1}{{#2}{#3}}}
+\AtEndDocument{\ifx\hyper@anchor\@undefined
+\let\contentsline\oldcontentsline
+\let\newlabel\oldnewlabel
+\fi}
+\fi}
+\global\let\hyper@last\relax
+\gdef\HyperFirstAtBeginDocument#1{#1}
+\providecommand\HyField@AuxAddToFields[1]{}
+\providecommand\HyField@AuxAddToCoFields[2]{}
+\citation{FOCUSkinetics2011}
+\@writefile{toc}{\contentsline {section}{\numberline {1}The data}{1}{section.1}}
+\@writefile{toc}{\contentsline {section}{\numberline {2}Parent compound and one metabolite}{2}{section.2}}
+\@writefile{toc}{\contentsline {section}{\numberline {3}Including metabolites Z2 and Z3}{8}{section.3}}
+\@writefile{toc}{\contentsline {section}{\numberline {4}Using the SFORB model for parent and metabolites}{12}{section.4}}
+\bibstyle{plainnat}
+\bibdata{references}
+\bibcite{FOCUSkinetics2011}{{1}{2011}{{FOCUS Work Group on Degradation Kinetics}}{{}}}
diff --git a/docs/articles/FOCUS_Z.bbl b/docs/articles/FOCUS_Z.bbl
new file mode 100644
index 00000000..451497c8
--- /dev/null
+++ b/docs/articles/FOCUS_Z.bbl
@@ -0,0 +1,15 @@
+\begin{thebibliography}{1}
+\providecommand{\natexlab}[1]{#1}
+\providecommand{\url}[1]{\texttt{#1}}
+\expandafter\ifx\csname urlstyle\endcsname\relax
+ \providecommand{\doi}[1]{doi: #1}\else
+ \providecommand{\doi}{doi: \begingroup \urlstyle{rm}\Url}\fi
+
+\bibitem[{FOCUS Work Group on Degradation Kinetics}(2011)]{FOCUSkinetics2011}
+{FOCUS Work Group on Degradation Kinetics}.
+\newblock \emph{Generic guidance for estimating persistence and degradation
+ kinetics from environmental fate studies on pesticides in EU registration},
+ 1.0 edition, November 2011.
+\newblock URL \url{http://focus.jrc.ec.europa.eu/dk}.
+
+\end{thebibliography}
diff --git a/docs/articles/FOCUS_Z.blg b/docs/articles/FOCUS_Z.blg
new file mode 100644
index 00000000..1da213fb
--- /dev/null
+++ b/docs/articles/FOCUS_Z.blg
@@ -0,0 +1,46 @@
+This is BibTeX, Version 0.99d (TeX Live 2015/dev/Debian)
+Capacity: max_strings=35307, hash_size=35307, hash_prime=30011
+The top-level auxiliary file: FOCUS_Z.aux
+The style file: plainnat.bst
+Database file #1: references.bib
+You've used 1 entry,
+ 2773 wiz_defined-function locations,
+ 599 strings with 5084 characters,
+and the built_in function-call counts, 324 in all, are:
+= -- 28
+> -- 10
+< -- 1
++ -- 4
+- -- 3
+* -- 23
+:= -- 57
+add.period$ -- 3
+call.type$ -- 1
+change.case$ -- 4
+chr.to.int$ -- 1
+cite$ -- 2
+duplicate$ -- 17
+empty$ -- 26
+format.name$ -- 4
+if$ -- 59
+int.to.chr$ -- 1
+int.to.str$ -- 1
+missing$ -- 0
+newline$ -- 13
+num.names$ -- 4
+pop$ -- 6
+preamble$ -- 1
+purify$ -- 3
+quote$ -- 0
+skip$ -- 13
+stack$ -- 0
+substring$ -- 2
+swap$ -- 3
+text.length$ -- 0
+text.prefix$ -- 0
+top$ -- 0
+type$ -- 11
+warning$ -- 0
+while$ -- 3
+width$ -- 0
+write$ -- 20
diff --git a/docs/articles/FOCUS_Z.log b/docs/articles/FOCUS_Z.log
new file mode 100644
index 00000000..c90bf27b
--- /dev/null
+++ b/docs/articles/FOCUS_Z.log
@@ -0,0 +1,821 @@
+This is pdfTeX, Version 3.14159265-2.6-1.40.15 (TeX Live 2015/dev/Debian) (preloaded format=pdflatex 2015.11.18) 24 OCT 2016 13:58
+entering extended mode
+ restricted \write18 enabled.
+ %&-line parsing enabled.
+**\nonstopmode \input ./FOCUS_Z.tex
+(./FOCUS_Z.tex (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls
+Document Class: article 2014/09/29 v1.4h Standard LaTeX document class
+(/usr/share/texlive/texmf-dist/tex/latex/base/size12.clo
+File: size12.clo 2014/09/29 v1.4h Standard LaTeX file (size option)
+)
+\c@part=\count79
+\c@section=\count80
+\c@subsection=\count81
+\c@subsubsection=\count82
+\c@paragraph=\count83
+\c@subparagraph=\count84
+\c@figure=\count85
+\c@table=\count86
+\abovecaptionskip=\skip41
+\belowcaptionskip=\skip42
+\bibindent=\dimen102
+)
+(/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty
+Package: graphicx 2014/04/25 v1.0g Enhanced LaTeX Graphics (DPC,SPQR)
+
+(/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty
+Package: keyval 2014/05/08 v1.15 key=value parser (DPC)
+\KV@toks@=\toks14
+)
+(/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty
+Package: graphics 2009/02/05 v1.0o Standard LaTeX Graphics (DPC,SPQR)
+
+(/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty
+Package: trig 1999/03/16 v1.09 sin cos tan (DPC)
+)
+(/usr/share/texlive/texmf-dist/tex/latex/latexconfig/graphics.cfg
+File: graphics.cfg 2010/04/23 v1.9 graphics configuration of TeX Live
+)
+Package graphics Info: Driver file: pdftex.def on input line 91.
+
+(/usr/share/texlive/texmf-dist/tex/latex/pdftex-def/pdftex.def
+File: pdftex.def 2011/05/27 v0.06d Graphics/color for pdfTeX
+
+(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/infwarerr.sty
+Package: infwarerr 2010/04/08 v1.3 Providing info/warning/error messages (HO)
+)
+(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ltxcmds.sty
+Package: ltxcmds 2011/11/09 v1.22 LaTeX kernel commands for general use (HO)
+)
+\Gread@gobject=\count87
+))
+\Gin@req@height=\dimen103
+\Gin@req@width=\dimen104
+)
+(/usr/share/texlive/texmf-dist/tex/latex/graphics/color.sty
+Package: color 2014/04/23 v1.1a Standard LaTeX Color (DPC)
+
+(/usr/share/texlive/texmf-dist/tex/latex/latexconfig/color.cfg
+File: color.cfg 2007/01/18 v1.5 color configuration of teTeX/TeXLive
+)
+Package color Info: Driver file: pdftex.def on input line 137.
+)
+(/usr/share/texlive/texmf-dist/tex/latex/framed/framed.sty
+Package: framed 2011/10/22 v 0.96: framed or shaded text with page breaks
+\OuterFrameSep=\skip43
+\fb@frw=\dimen105
+\fb@frh=\dimen106
+\FrameRule=\dimen107
+\FrameSep=\dimen108
+)
+(/usr/share/texlive/texmf-dist/tex/latex/base/alltt.sty
+Package: alltt 1997/06/16 v2.0g defines alltt environment
+)
+(/usr/share/texlive/texmf-dist/tex/latex/a4wide/a4wide.sty
+Package: a4wide 1994/08/30
+
+(/usr/share/texlive/texmf-dist/tex/latex/ntgclass/a4.sty
+Package: a4 2004/04/15 v1.2g A4 based page layout
+)) (./header.tex
+(/usr/share/texlive/texmf-dist/tex/latex/booktabs/booktabs.sty
+Package: booktabs 2005/04/14 v1.61803 publication quality tables
+\heavyrulewidth=\dimen109
+\lightrulewidth=\dimen110
+\cmidrulewidth=\dimen111
+\belowrulesep=\dimen112
+\belowbottomsep=\dimen113
+\aboverulesep=\dimen114
+\abovetopsep=\dimen115
+\cmidrulesep=\dimen116
+\cmidrulekern=\dimen117
+\defaultaddspace=\dimen118
+\@cmidla=\count88
+\@cmidlb=\count89
+\@aboverulesep=\dimen119
+\@belowrulesep=\dimen120
+\@thisruleclass=\count90
+\@lastruleclass=\count91
+\@thisrulewidth=\dimen121
+)
+(/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amsfonts.sty
+Package: amsfonts 2013/01/14 v3.01 Basic AMSFonts support
+\@emptytoks=\toks15
+\symAMSa=\mathgroup4
+\symAMSb=\mathgroup5
+LaTeX Font Info: Overwriting math alphabet `\mathfrak' in version `bold'
+(Font) U/euf/m/n --> U/euf/b/n on input line 106.
+)
+(/usr/share/texlive/texmf-dist/tex/latex/base/latexsym.sty
+Package: latexsym 1998/08/17 v2.2e Standard LaTeX package (lasy symbols)
+\symlasy=\mathgroup6
+LaTeX Font Info: Overwriting symbol font `lasy' in version `bold'
+(Font) U/lasy/m/n --> U/lasy/b/n on input line 47.
+)
+(/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty
+Package: amsmath 2013/01/14 v2.14 AMS math features
+\@mathmargin=\skip44
+
+For additional information on amsmath, use the `?' option.
+(/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty
+Package: amstext 2000/06/29 v2.01
+
+(/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty
+File: amsgen.sty 1999/11/30 v2.0
+\@emptytoks=\toks16
+\ex@=\dimen122
+))
+(/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty
+Package: amsbsy 1999/11/29 v1.2d
+\pmbraise@=\dimen123
+)
+(/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty
+Package: amsopn 1999/12/14 v2.01 operator names
+)
+\inf@bad=\count92
+LaTeX Info: Redefining \frac on input line 210.
+\uproot@=\count93
+\leftroot@=\count94
+LaTeX Info: Redefining \overline on input line 306.
+\classnum@=\count95
+\DOTSCASE@=\count96
+LaTeX Info: Redefining \ldots on input line 378.
+LaTeX Info: Redefining \dots on input line 381.
+LaTeX Info: Redefining \cdots on input line 466.
+\Mathstrutbox@=\box26
+\strutbox@=\box27
+\big@size=\dimen124
+LaTeX Font Info: Redeclaring font encoding OML on input line 566.
+LaTeX Font Info: Redeclaring font encoding OMS on input line 567.
+\macc@depth=\count97
+\c@MaxMatrixCols=\count98
+\dotsspace@=\muskip10
+\c@parentequation=\count99
+\dspbrk@lvl=\count100
+\tag@help=\toks17
+\row@=\count101
+\column@=\count102
+\maxfields@=\count103
+\andhelp@=\toks18
+\eqnshift@=\dimen125
+\alignsep@=\dimen126
+\tagshift@=\dimen127
+\tagwidth@=\dimen128
+\totwidth@=\dimen129
+\lineht@=\dimen130
+\@envbody=\toks19
+\multlinegap=\skip45
+\multlinetaggap=\skip46
+\mathdisplay@stack=\toks20
+LaTeX Info: Redefining \[ on input line 2665.
+LaTeX Info: Redefining \] on input line 2666.
+)
+(/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amssymb.sty
+Package: amssymb 2013/01/14 v3.01 AMS font symbols
+)
+(/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip.sty
+Package: parskip 2001/04/09 non-zero parskip adjustments
+)
+(/usr/share/texlive/texmf-dist/tex/latex/natbib/natbib.sty
+Package: natbib 2010/09/13 8.31b (PWD, AO)
+\bibhang=\skip47
+\bibsep=\skip48
+LaTeX Info: Redefining \cite on input line 694.
+\c@NAT@ctr=\count104
+)
+(/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref.sty
+Package: hyperref 2012/11/06 v6.83m Hypertext links for LaTeX
+
+(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-hyperref.sty
+Package: hobsub-hyperref 2012/05/28 v1.13 Bundle oberdiek, subset hyperref (HO)
+
+
+(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-generic.sty
+Package: hobsub-generic 2012/05/28 v1.13 Bundle oberdiek, subset generic (HO)
+Package: hobsub 2012/05/28 v1.13 Construct package bundles (HO)
+Package hobsub Info: Skipping package `infwarerr' (already loaded).
+Package hobsub Info: Skipping package `ltxcmds' (already loaded).
+Package: ifluatex 2010/03/01 v1.3 Provides the ifluatex switch (HO)
+Package ifluatex Info: LuaTeX not detected.
+Package: ifvtex 2010/03/01 v1.5 Detect VTeX and its facilities (HO)
+Package ifvtex Info: VTeX not detected.
+Package: intcalc 2007/09/27 v1.1 Expandable calculations with integers (HO)
+Package: ifpdf 2011/01/30 v2.3 Provides the ifpdf switch (HO)
+Package ifpdf Info: pdfTeX in PDF mode is detected.
+Package: etexcmds 2011/02/16 v1.5 Avoid name clashes with e-TeX commands (HO)
+Package etexcmds Info: Could not find \expanded.
+(etexcmds) That can mean that you are not using pdfTeX 1.50 or
+(etexcmds) that some package has redefined \expanded.
+(etexcmds) In the latter case, load this package earlier.
+Package: kvsetkeys 2012/04/25 v1.16 Key value parser (HO)
+Package: kvdefinekeys 2011/04/07 v1.3 Define keys (HO)
+Package: pdftexcmds 2011/11/29 v0.20 Utility functions of pdfTeX for LuaTeX (HO
+)
+Package pdftexcmds Info: LuaTeX not detected.
+Package pdftexcmds Info: \pdf@primitive is available.
+Package pdftexcmds Info: \pdf@ifprimitive is available.
+Package pdftexcmds Info: \pdfdraftmode found.
+Package: pdfescape 2011/11/25 v1.13 Implements pdfTeX's escape features (HO)
+Package: bigintcalc 2012/04/08 v1.3 Expandable calculations on big integers (HO
+)
+Package: bitset 2011/01/30 v1.1 Handle bit-vector datatype (HO)
+Package: uniquecounter 2011/01/30 v1.2 Provide unlimited unique counter (HO)
+)
+Package hobsub Info: Skipping package `hobsub' (already loaded).
+Package: letltxmacro 2010/09/02 v1.4 Let assignment for LaTeX macros (HO)
+Package: hopatch 2012/05/28 v1.2 Wrapper for package hooks (HO)
+Package: xcolor-patch 2011/01/30 xcolor patch
+Package: atveryend 2011/06/30 v1.8 Hooks at the very end of document (HO)
+Package atveryend Info: \enddocument detected (standard20110627).
+Package: atbegshi 2011/10/05 v1.16 At begin shipout hook (HO)
+Package: refcount 2011/10/16 v3.4 Data extraction from label references (HO)
+Package: hycolor 2011/01/30 v1.7 Color options for hyperref/bookmark (HO)
+)
+(/usr/share/texlive/texmf-dist/tex/generic/ifxetex/ifxetex.sty
+Package: ifxetex 2010/09/12 v0.6 Provides ifxetex conditional
+)
+(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/auxhook.sty
+Package: auxhook 2011/03/04 v1.3 Hooks for auxiliary files (HO)
+)
+(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/kvoptions.sty
+Package: kvoptions 2011/06/30 v3.11 Key value format for package options (HO)
+)
+\@linkdim=\dimen131
+\Hy@linkcounter=\count105
+\Hy@pagecounter=\count106
+
+(/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def
+File: pd1enc.def 2012/11/06 v6.83m Hyperref: PDFDocEncoding definition (HO)
+)
+\Hy@SavedSpaceFactor=\count107
+
+(/usr/share/texlive/texmf-dist/tex/latex/latexconfig/hyperref.cfg
+File: hyperref.cfg 2002/06/06 v1.2 hyperref configuration of TeXLive
+)
+Package hyperref Info: Hyper figures OFF on input line 4443.
+Package hyperref Info: Link nesting OFF on input line 4448.
+Package hyperref Info: Hyper index ON on input line 4451.
+Package hyperref Info: Plain pages OFF on input line 4458.
+Package hyperref Info: Backreferencing OFF on input line 4463.
+Package hyperref Info: Implicit mode ON; LaTeX internals redefined.
+Package hyperref Info: Bookmarks ON on input line 4688.
+\c@Hy@tempcnt=\count108
+
+(/usr/share/texlive/texmf-dist/tex/latex/url/url.sty
+\Urlmuskip=\muskip11
+Package: url 2013/09/16 ver 3.4 Verb mode for urls, etc.
+)
+LaTeX Info: Redefining \url on input line 5041.
+\XeTeXLinkMargin=\dimen132
+\Fld@menulength=\count109
+\Field@Width=\dimen133
+\Fld@charsize=\dimen134
+Package hyperref Info: Hyper figures OFF on input line 6295.
+Package hyperref Info: Link nesting OFF on input line 6300.
+Package hyperref Info: Hyper index ON on input line 6303.
+Package hyperref Info: backreferencing OFF on input line 6310.
+Package hyperref Info: Link coloring OFF on input line 6315.
+Package hyperref Info: Link coloring with OCG OFF on input line 6320.
+Package hyperref Info: PDF/A mode OFF on input line 6325.
+LaTeX Info: Redefining \ref on input line 6365.
+LaTeX Info: Redefining \pageref on input line 6369.
+\Hy@abspage=\count110
+\c@Item=\count111
+\c@Hfootnote=\count112
+)
+
+Package hyperref Message: Driver (autodetected): hpdftex.
+
+(/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def
+File: hpdftex.def 2012/11/06 v6.83m Hyperref driver for pdfTeX
+\Fld@listcount=\count113
+\c@bookmark@seq@number=\count114
+
+(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/rerunfilecheck.sty
+Package: rerunfilecheck 2011/04/15 v1.7 Rerun checks for auxiliary files (HO)
+Package uniquecounter Info: New unique counter `rerunfilecheck' on input line 2
+82.
+)
+\Hy@SectionHShift=\skip49
+)
+(/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty
+Package: fontenc 2005/09/27 v1.99g Standard LaTeX package
+
+(/usr/share/texlive/texmf-dist/tex/latex/base/t1enc.def
+File: t1enc.def 2005/09/27 v1.99g Standard LaTeX file
+LaTeX Font Info: Redeclaring font encoding T1 on input line 43.
+))
+(/usr/share/texlive/texmf-dist/tex/latex/ae/ae.sty
+Package: ae 2001/02/12 1.3 Almost European Computer Modern
+
+(/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty
+Package: fontenc 2005/09/27 v1.99g Standard LaTeX package
+
+(/usr/share/texlive/texmf-dist/tex/latex/base/t1enc.def
+File: t1enc.def 2005/09/27 v1.99g Standard LaTeX file
+LaTeX Font Info: Redeclaring font encoding T1 on input line 43.
+)
+LaTeX Font Info: Try loading font information for T1+aer on input line 100.
+
+(/usr/share/texlive/texmf-dist/tex/latex/ae/t1aer.fd
+File: t1aer.fd 1997/11/16 Font definitions for T1/aer.
+)))
+(/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty
+Package: fancyvrb 2008/02/07
+
+Style option: `fancyvrb' v2.7a, with DG/SPQR fixes, and firstline=lastline fix
+<2008/02/07> (tvz)
+\FV@CodeLineNo=\count115
+\FV@InFile=\read1
+\FV@TabBox=\box28
+\c@FancyVerbLine=\count116
+\FV@StepNumber=\count117
+\FV@OutFile=\write3
+)
+(/usr/share/texlive/texmf-dist/tex/latex/upquote/upquote.sty
+Package: upquote 2012/04/19 v1.3 upright-quote and grave-accent glyphs in verba
+tim
+
+(/usr/share/texlive/texmf-dist/tex/latex/base/textcomp.sty
+Package: textcomp 2005/09/27 v1.99g Standard LaTeX package
+Package textcomp Info: Sub-encoding information:
+(textcomp) 5 = only ISO-Adobe without \textcurrency
+(textcomp) 4 = 5 + \texteuro
+(textcomp) 3 = 4 + \textohm
+(textcomp) 2 = 3 + \textestimated + \textcurrency
+(textcomp) 1 = TS1 - \textcircled - \t
+(textcomp) 0 = TS1 (full)
+(textcomp) Font families with sub-encoding setting implement
+(textcomp) only a restricted character set as indicated.
+(textcomp) Family '?' is the default used for unknown fonts.
+(textcomp) See the documentation for details.
+Package textcomp Info: Setting ? sub-encoding to TS1/1 on input line 71.
+
+(/usr/share/texlive/texmf-dist/tex/latex/base/ts1enc.def
+File: ts1enc.def 2001/06/05 v3.0e (jk/car/fm) Standard LaTeX file
+)
+LaTeX Info: Redefining \oldstylenums on input line 266.
+Package textcomp Info: Setting cmr sub-encoding to TS1/0 on input line 281.
+Package textcomp Info: Setting cmss sub-encoding to TS1/0 on input line 282.
+Package textcomp Info: Setting cmtt sub-encoding to TS1/0 on input line 283.
+Package textcomp Info: Setting cmvtt sub-encoding to TS1/0 on input line 284.
+Package textcomp Info: Setting cmbr sub-encoding to TS1/0 on input line 285.
+Package textcomp Info: Setting cmtl sub-encoding to TS1/0 on input line 286.
+Package textcomp Info: Setting ccr sub-encoding to TS1/0 on input line 287.
+Package textcomp Info: Setting ptm sub-encoding to TS1/4 on input line 288.
+Package textcomp Info: Setting pcr sub-encoding to TS1/4 on input line 289.
+Package textcomp Info: Setting phv sub-encoding to TS1/4 on input line 290.
+Package textcomp Info: Setting ppl sub-encoding to TS1/3 on input line 291.
+Package textcomp Info: Setting pag sub-encoding to TS1/4 on input line 292.
+Package textcomp Info: Setting pbk sub-encoding to TS1/4 on input line 293.
+Package textcomp Info: Setting pnc sub-encoding to TS1/4 on input line 294.
+Package textcomp Info: Setting pzc sub-encoding to TS1/4 on input line 295.
+Package textcomp Info: Setting bch sub-encoding to TS1/4 on input line 296.
+Package textcomp Info: Setting put sub-encoding to TS1/5 on input line 297.
+Package textcomp Info: Setting uag sub-encoding to TS1/5 on input line 298.
+Package textcomp Info: Setting ugq sub-encoding to TS1/5 on input line 299.
+Package textcomp Info: Setting ul8 sub-encoding to TS1/4 on input line 300.
+Package textcomp Info: Setting ul9 sub-encoding to TS1/4 on input line 301.
+Package textcomp Info: Setting augie sub-encoding to TS1/5 on input line 302.
+Package textcomp Info: Setting dayrom sub-encoding to TS1/3 on input line 303.
+Package textcomp Info: Setting dayroms sub-encoding to TS1/3 on input line 304.
+
+Package textcomp Info: Setting pxr sub-encoding to TS1/0 on input line 305.
+Package textcomp Info: Setting pxss sub-encoding to TS1/0 on input line 306.
+Package textcomp Info: Setting pxtt sub-encoding to TS1/0 on input line 307.
+Package textcomp Info: Setting txr sub-encoding to TS1/0 on input line 308.
+Package textcomp Info: Setting txss sub-encoding to TS1/0 on input line 309.
+Package textcomp Info: Setting txtt sub-encoding to TS1/0 on input line 310.
+Package textcomp Info: Setting lmr sub-encoding to TS1/0 on input line 311.
+Package textcomp Info: Setting lmdh sub-encoding to TS1/0 on input line 312.
+Package textcomp Info: Setting lmss sub-encoding to TS1/0 on input line 313.
+Package textcomp Info: Setting lmssq sub-encoding to TS1/0 on input line 314.
+Package textcomp Info: Setting lmvtt sub-encoding to TS1/0 on input line 315.
+Package textcomp Info: Setting qhv sub-encoding to TS1/0 on input line 316.
+Package textcomp Info: Setting qag sub-encoding to TS1/0 on input line 317.
+Package textcomp Info: Setting qbk sub-encoding to TS1/0 on input line 318.
+Package textcomp Info: Setting qcr sub-encoding to TS1/0 on input line 319.
+Package textcomp Info: Setting qcs sub-encoding to TS1/0 on input line 320.
+Package textcomp Info: Setting qpl sub-encoding to TS1/0 on input line 321.
+Package textcomp Info: Setting qtm sub-encoding to TS1/0 on input line 322.
+Package textcomp Info: Setting qzc sub-encoding to TS1/0 on input line 323.
+Package textcomp Info: Setting qhvc sub-encoding to TS1/0 on input line 324.
+Package textcomp Info: Setting futs sub-encoding to TS1/4 on input line 325.
+Package textcomp Info: Setting futx sub-encoding to TS1/4 on input line 326.
+Package textcomp Info: Setting futj sub-encoding to TS1/4 on input line 327.
+Package textcomp Info: Setting hlh sub-encoding to TS1/3 on input line 328.
+Package textcomp Info: Setting hls sub-encoding to TS1/3 on input line 329.
+Package textcomp Info: Setting hlst sub-encoding to TS1/3 on input line 330.
+Package textcomp Info: Setting hlct sub-encoding to TS1/5 on input line 331.
+Package textcomp Info: Setting hlx sub-encoding to TS1/5 on input line 332.
+Package textcomp Info: Setting hlce sub-encoding to TS1/5 on input line 333.
+Package textcomp Info: Setting hlcn sub-encoding to TS1/5 on input line 334.
+Package textcomp Info: Setting hlcw sub-encoding to TS1/5 on input line 335.
+Package textcomp Info: Setting hlcf sub-encoding to TS1/5 on input line 336.
+Package textcomp Info: Setting pplx sub-encoding to TS1/3 on input line 337.
+Package textcomp Info: Setting pplj sub-encoding to TS1/3 on input line 338.
+Package textcomp Info: Setting ptmx sub-encoding to TS1/4 on input line 339.
+Package textcomp Info: Setting ptmj sub-encoding to TS1/4 on input line 340.
+)))
+(/usr/share/texlive/texmf-dist/tex/latex/relsize/relsize.sty
+Package: relsize 2013/03/29 ver 4.1
+)
+Package hyperref Info: Option `colorlinks' set `true' on input line 66.
+
+
+Package hyperref Warning: Option `hyperindex' has already been used,
+(hyperref) setting the option has no effect on input line 66.
+
+Package hyperref Info: Option `linktocpage' set `true' on input line 66.
+(./FOCUS_Z.aux)
+\openout1 = `FOCUS_Z.aux'.
+
+LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 68.
+LaTeX Font Info: ... okay on input line 68.
+LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 68.
+LaTeX Font Info: ... okay on input line 68.
+LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 68.
+LaTeX Font Info: ... okay on input line 68.
+LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 68.
+LaTeX Font Info: ... okay on input line 68.
+LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 68.
+LaTeX Font Info: ... okay on input line 68.
+LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 68.
+LaTeX Font Info: ... okay on input line 68.
+LaTeX Font Info: Checking defaults for PD1/pdf/m/n on input line 68.
+LaTeX Font Info: ... okay on input line 68.
+LaTeX Font Info: Checking defaults for TS1/cmr/m/n on input line 68.
+LaTeX Font Info: Try loading font information for TS1+cmr on input line 68.
+ (/usr/share/texlive/texmf-dist/tex/latex/base/ts1cmr.fd
+File: ts1cmr.fd 2014/09/29 v2.5h Standard LaTeX font definitions
+)
+LaTeX Font Info: ... okay on input line 68.
+
+(/usr/share/texlive/texmf-dist/tex/context/base/supp-pdf.mkii
+[Loading MPS to PDF converter (version 2006.09.02).]
+\scratchcounter=\count118
+\scratchdimen=\dimen135
+\scratchbox=\box29
+\nofMPsegments=\count119
+\nofMParguments=\count120
+\everyMPshowfont=\toks21
+\MPscratchCnt=\count121
+\MPscratchDim=\dimen136
+\MPnumerator=\count122
+\makeMPintoPDFobject=\count123
+\everyMPtoPDFconversion=\toks22
+) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/epstopdf-base.sty
+Package: epstopdf-base 2010/02/09 v2.5 Base part for package epstopdf
+
+(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/grfext.sty
+Package: grfext 2010/08/19 v1.1 Manage graphics extensions (HO)
+)
+Package grfext Info: Graphics extension search list:
+(grfext) [.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPE
+G,.JBIG2,.JB2,.eps]
+(grfext) \AppendGraphicsExtensions on input line 452.
+
+(/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg
+File: epstopdf-sys.cfg 2010/07/13 v1.3 Configuration of (r)epstopdf for TeX Liv
+e
+))
+\AtBeginShipoutBox=\box30
+Package hyperref Info: Link coloring ON on input line 68.
+
+(/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty
+Package: nameref 2012/10/27 v2.43 Cross-referencing by name of section
+
+(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/gettitlestring.sty
+Package: gettitlestring 2010/12/03 v1.4 Cleanup title references (HO)
+)
+\c@section@level=\count124
+)
+LaTeX Info: Redefining \ref on input line 68.
+LaTeX Info: Redefining \pageref on input line 68.
+LaTeX Info: Redefining \nameref on input line 68.
+
+(./FOCUS_Z.out) (./FOCUS_Z.out)
+\@outlinefile=\write4
+\openout4 = `FOCUS_Z.out'.
+
+LaTeX Font Info: Try loading font information for U+msa on input line 81.
+
+(/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsa.fd
+File: umsa.fd 2013/01/14 v3.01 AMS symbols A
+)
+LaTeX Font Info: Try loading font information for U+msb on input line 81.
+
+(/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsb.fd
+File: umsb.fd 2013/01/14 v3.01 AMS symbols B
+)
+LaTeX Font Info: Try loading font information for U+lasy on input line 81.
+
+(/usr/share/texlive/texmf-dist/tex/latex/base/ulasy.fd
+File: ulasy.fd 1998/08/17 v2.2e LaTeX symbol font definitions
+) [0
+
+{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}] (./FOCUS_Z.toc)
+\tf@toc=\write5
+\openout5 = `FOCUS_Z.toc'.
+
+Package color Info: Redefining color shadecolor on input line 96.
+LaTeX Font Info: Try loading font information for T1+aett on input line 97.
+
+(/usr/share/texlive/texmf-dist/tex/latex/ae/t1aett.fd
+File: t1aett.fd 1997/11/16 Font definitions for T1/aett.
+)
+
+LaTeX Font Warning: Font shape `T1/aett/bx/n' undefined
+(Font) using `T1/aett/m/n' instead on input line 98.
+
+[1
+
+]
+Package color Info: Redefining color shadecolor on input line 140.
+LaTeX Font Info: Try loading font information for TS1+aett on input line 147
+.
+ (/usr/share/R/share/texmf/tex/latex/ts1aett.fd
+File: ts1aett.fd
+)
+LaTeX Font Info: Try loading font information for TS1+cmtt on input line 147
+.
+
+(/usr/share/texlive/texmf-dist/tex/latex/base/ts1cmtt.fd
+File: ts1cmtt.fd 2014/09/29 v2.5h Standard LaTeX font definitions
+)
+LaTeX Font Info: Font shape `TS1/aett/m/n' in size <12> not available
+(Font) Font shape `TS1/cmtt/m/n' tried instead on input line 147.
+
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 147--147
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 150--150
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+<figure/FOCUS_2006_Z_fits_1-1.pdf, id=42, 505.89pt x 433.62pt>
+File: figure/FOCUS_2006_Z_fits_1-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_1-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_1-1.pdf used on input line 15
+5.
+(pdftex.def) Requested size: 460.72124pt x 394.91241pt.
+ [2] [3 <./figure/FOCUS_2006_Z_fits_1-1.pdf>]
+Package color Info: Redefining color shadecolor on input line 186.
+
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 194--194
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 197--197
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+<figure/FOCUS_2006_Z_fits_2-1.pdf, id=59, 505.89pt x 433.62pt>
+File: figure/FOCUS_2006_Z_fits_2-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_2-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_2-1.pdf used on input line 20
+2.
+(pdftex.def) Requested size: 460.72124pt x 394.91241pt.
+ [4] [5 <./figure/FOCUS_2006_Z_fits_2-1.pdf>]
+Package color Info: Redefining color shadecolor on input line 237.
+
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 244--244
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 247--247
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+<figure/FOCUS_2006_Z_fits_3-1.pdf, id=76, 505.89pt x 433.62pt>
+File: figure/FOCUS_2006_Z_fits_3-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_3-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_3-1.pdf used on input line 25
+2.
+(pdftex.def) Requested size: 460.72124pt x 394.91241pt.
+ [6] [7 <./figure/FOCUS_2006_Z_fits_3-1.pdf>]
+Package color Info: Redefining color shadecolor on input line 281.
+
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 289--289
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 292--292
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+<figure/FOCUS_2006_Z_fits_5-1.pdf, id=98, 505.89pt x 505.89pt>
+File: figure/FOCUS_2006_Z_fits_5-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_5-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_5-1.pdf used on input line 29
+7.
+(pdftex.def) Requested size: 460.72124pt x 460.73112pt.
+ [8]
+Package color Info: Redefining color shadecolor on input line 306.
+
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 316--316
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 319--319
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+
+Underfull \vbox (badness 10000) detected at line 325
+ []
+
+[9 <./figure/FOCUS_2006_Z_fits_5-1.pdf>]
+<figure/FOCUS_2006_Z_fits_6-1.pdf, id=114, 505.89pt x 578.16pt>
+File: figure/FOCUS_2006_Z_fits_6-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_6-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_6-1.pdf used on input line 32
+6.
+(pdftex.def) Requested size: 460.72124pt x 526.54988pt.
+ [10]
+Underfull \vbox (badness 3229) detected at line 364
+ []
+
+[11 <./figure/FOCUS_2006_Z_fits_6-1.pdf>]
+Package color Info: Redefining color shadecolor on input line 383.
+
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 392--392
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 395--395
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+[12] <figure/FOCUS_2006_Z_fits_7-1.pdf, id=136, 505.89pt x 578.16pt>
+File: figure/FOCUS_2006_Z_fits_7-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_7-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_7-1.pdf used on input line 40
+0.
+(pdftex.def) Requested size: 460.72124pt x 526.54988pt.
+ [13]
+Package color Info: Redefining color shadecolor on input line 415.
+ [14 <./figure/FOCUS_2006_Z_fits_7-1.pdf>]
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 423--423
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 426--426
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+<figure/FOCUS_2006_Z_fits_9-1.pdf, id=153, 505.89pt x 578.16pt>
+File: figure/FOCUS_2006_Z_fits_9-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_9-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_9-1.pdf used on input line 43
+1.
+(pdftex.def) Requested size: 460.72124pt x 526.54988pt.
+ [15]
+Package color Info: Redefining color shadecolor on input line 442.
+ [16 <./figure/FOCUS_2006_Z_fits_9-1.pdf>]
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 451--451
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 454--454
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+<figure/FOCUS_2006_Z_fits_10-1.pdf, id=169, 505.89pt x 578.16pt>
+File: figure/FOCUS_2006_Z_fits_10-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_10-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_10-1.pdf used on input line 4
+61.
+(pdftex.def) Requested size: 460.72124pt x 526.54988pt.
+ [17]
+Package color Info: Redefining color shadecolor on input line 470.
+
+Overfull \hbox (57.39793pt too wide) in paragraph at lines 479--479
+[]\T1/aett/bx/n/12 ## make[1]: warning: jobserver unavailable: using -j1. Add
+\TS1/cmtt/m/n/12 '\T1/aett/bx/n/12 +\TS1/cmtt/m/n/12 ' \T1/aett/bx/n/12 to pare
+nt make rule.[]
+ []
+
+
+Overfull \hbox (4.58922pt too wide) in paragraph at lines 482--482
+[]\T1/aett/m/it/12 ## Suc-cess-fully com-piled dif-fer-en-tial equa-tion model
+from auto-generated C
+ []
+
+
+Underfull \vbox (badness 3229) detected at line 488
+ []
+
+[18 <./figure/FOCUS_2006_Z_fits_10-1.pdf>]
+<figure/FOCUS_2006_Z_fits_11-1.pdf, id=186, 505.89pt x 578.16pt>
+File: figure/FOCUS_2006_Z_fits_11-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_11-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_11-1.pdf used on input line 4
+89.
+(pdftex.def) Requested size: 460.72124pt x 526.54988pt.
+ [19]
+Package color Info: Redefining color shadecolor on input line 499.
+
+Underfull \vbox (badness 3229) detected at line 508
+ []
+
+[20 <./figure/FOCUS_2006_Z_fits_11-1.pdf>]
+<figure/FOCUS_2006_Z_fits_11a-1.pdf, id=202, 505.89pt x 505.89pt>
+File: figure/FOCUS_2006_Z_fits_11a-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_11a-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_11a-1.pdf used on input line
+509.
+(pdftex.def) Requested size: 460.72124pt x 460.73112pt.
+Package color Info: Redefining color shadecolor on input line 521.
+ [21 <./figure/FOCUS_2006_Z_fits_11a-1.pdf>] <figure/FOCUS_2006_Z_fits_11b-1.pd
+f, id=214, 505.89pt x 505.89pt>
+File: figure/FOCUS_2006_Z_fits_11b-1.pdf Graphic file (type pdf)
+
+<use figure/FOCUS_2006_Z_fits_11b-1.pdf>
+Package pdftex.def Info: figure/FOCUS_2006_Z_fits_11b-1.pdf used on input line
+526.
+(pdftex.def) Requested size: 460.72124pt x 460.73112pt.
+Package color Info: Redefining color shadecolor on input line 533.
+ [22 <./figure/FOCUS_2006_Z_fits_11b-1.pdf>] (./FOCUS_Z.bbl)
+Package atveryend Info: Empty hook `BeforeClearDocument' on input line 565.
+ [23]
+Package atveryend Info: Empty hook `AfterLastShipout' on input line 565.
+ (./FOCUS_Z.aux)
+Package atveryend Info: Executing hook `AtVeryEndDocument' on input line 565.
+Package atveryend Info: Executing hook `AtEndAfterFileList' on input line 565.
+Package rerunfilecheck Info: File `FOCUS_Z.out' has not changed.
+(rerunfilecheck) Checksum: B13DB9712199BAA629673E11D2FD6F47;261.
+
+
+LaTeX Font Warning: Some font shapes were not available, defaults substituted.
+
+Package atveryend Info: Empty hook `AtVeryVeryEnd' on input line 565.
+ )
+Here is how much of TeX's memory you used:
+ 7809 strings out of 494895
+ 112616 string characters out of 6177381
+ 189876 words of memory out of 5000000
+ 10805 multiletter control sequences out of 15000+600000
+ 43056 words of font info for 107 fonts, out of 8000000 for 9000
+ 59 hyphenation exceptions out of 8191
+ 31i,8n,28p,354b,380s stack positions out of 10000i,500n,10000p,200000b,80000s
+ </home/jranke/.texmf-var/fonts/pk/ljfour/jknappen/ec/tctt1200.600pk></usr/sh
+are/texlive/texmf-dist/fonts/type1/public/amsfonts/cm/cmbx12.pfb></usr/share/te
+xlive/texmf-dist/fonts/type1/public/amsfonts/cm/cmitt10.pfb></usr/share/texlive
+/texmf-dist/fonts/type1/public/amsfonts/cm/cmmi12.pfb></usr/share/texlive/texmf
+-dist/fonts/type1/public/amsfonts/cm/cmr10.pfb></usr/share/texlive/texmf-dist/f
+onts/type1/public/amsfonts/cm/cmr12.pfb></usr/share/texlive/texmf-dist/fonts/ty
+pe1/public/amsfonts/cm/cmr17.pfb></usr/share/texlive/texmf-dist/fonts/type1/pub
+lic/amsfonts/cm/cmr7.pfb></usr/share/texlive/texmf-dist/fonts/type1/public/amsf
+onts/cm/cmr8.pfb></usr/share/texlive/texmf-dist/fonts/type1/public/amsfonts/cm/
+cmti12.pfb></usr/share/texlive/texmf-dist/fonts/type1/public/amsfonts/cm/cmtt10
+.pfb></usr/share/texlive/texmf-dist/fonts/type1/public/amsfonts/cm/cmtt12.pfb>
+Output written on FOCUS_Z.pdf (24 pages, 241995 bytes).
+PDF statistics:
+ 281 PDF objects out of 1000 (max. 8388607)
+ 218 compressed objects within 3 object streams
+ 33 named destinations out of 1000 (max. 500000)
+ 88 words of extra memory for PDF output out of 10000 (max. 10000000)
+
diff --git a/docs/articles/FOCUS_Z.out b/docs/articles/FOCUS_Z.out
new file mode 100644
index 00000000..61a86d0f
--- /dev/null
+++ b/docs/articles/FOCUS_Z.out
@@ -0,0 +1,4 @@
+\BOOKMARK [1][-]{section.1}{The data}{}% 1
+\BOOKMARK [1][-]{section.2}{Parent compound and one metabolite}{}% 2
+\BOOKMARK [1][-]{section.3}{Including metabolites Z2 and Z3}{}% 3
+\BOOKMARK [1][-]{section.4}{Using the SFORB model for parent and metabolites}{}% 4
diff --git a/docs/articles/FOCUS_Z.pdf b/docs/articles/FOCUS_Z.pdf
new file mode 100644
index 00000000..bc37c873
--- /dev/null
+++ b/docs/articles/FOCUS_Z.pdf
Binary files differ
diff --git a/docs/articles/FOCUS_Z.tex b/docs/articles/FOCUS_Z.tex
new file mode 100644
index 00000000..f1886acd
--- /dev/null
+++ b/docs/articles/FOCUS_Z.tex
@@ -0,0 +1,566 @@
+%\VignetteIndexEntry{Example evaluation of FOCUS dataset Z}
+%\VignetteEngine{knitr::knitr}
+\documentclass[12pt,a4paper]{article}\usepackage[]{graphicx}\usepackage[]{color}
+%% maxwidth is the original width if it is less than linewidth
+%% otherwise use linewidth (to make sure the graphics do not exceed the margin)
+\makeatletter
+\def\maxwidth{ %
+ \ifdim\Gin@nat@width>\linewidth
+ \linewidth
+ \else
+ \Gin@nat@width
+ \fi
+}
+\makeatother
+
+\definecolor{fgcolor}{rgb}{0.345, 0.345, 0.345}
+\newcommand{\hlnum}[1]{\textcolor[rgb]{0.686,0.059,0.569}{#1}}%
+\newcommand{\hlstr}[1]{\textcolor[rgb]{0.192,0.494,0.8}{#1}}%
+\newcommand{\hlcom}[1]{\textcolor[rgb]{0.678,0.584,0.686}{\textit{#1}}}%
+\newcommand{\hlopt}[1]{\textcolor[rgb]{0,0,0}{#1}}%
+\newcommand{\hlstd}[1]{\textcolor[rgb]{0.345,0.345,0.345}{#1}}%
+\newcommand{\hlkwa}[1]{\textcolor[rgb]{0.161,0.373,0.58}{\textbf{#1}}}%
+\newcommand{\hlkwb}[1]{\textcolor[rgb]{0.69,0.353,0.396}{#1}}%
+\newcommand{\hlkwc}[1]{\textcolor[rgb]{0.333,0.667,0.333}{#1}}%
+\newcommand{\hlkwd}[1]{\textcolor[rgb]{0.737,0.353,0.396}{\textbf{#1}}}%
+\let\hlipl\hlkwb
+
+\usepackage{framed}
+\makeatletter
+\newenvironment{kframe}{%
+ \def\at@end@of@kframe{}%
+ \ifinner\ifhmode%
+ \def\at@end@of@kframe{\end{minipage}}%
+ \begin{minipage}{\columnwidth}%
+ \fi\fi%
+ \def\FrameCommand##1{\hskip\@totalleftmargin \hskip-\fboxsep
+ \colorbox{shadecolor}{##1}\hskip-\fboxsep
+ % There is no \\@totalrightmargin, so:
+ \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
+ \MakeFramed {\advance\hsize-\width
+ \@totalleftmargin\z@ \linewidth\hsize
+ \@setminipage}}%
+ {\par\unskip\endMakeFramed%
+ \at@end@of@kframe}
+\makeatother
+
+\definecolor{shadecolor}{rgb}{.97, .97, .97}
+\definecolor{messagecolor}{rgb}{0, 0, 0}
+\definecolor{warningcolor}{rgb}{1, 0, 1}
+\definecolor{errorcolor}{rgb}{1, 0, 0}
+\newenvironment{knitrout}{}{} % an empty environment to be redefined in TeX
+
+\usepackage{alltt}
+\usepackage{a4wide}
+\input{header}
+\hypersetup{
+ pdftitle = {Example evaluation of FOCUS dataset Z},
+ pdfsubject = {Manuscript},
+ pdfauthor = {Johannes Ranke},
+ colorlinks = {true},
+ linkcolor = {blue},
+ citecolor = {blue},
+ urlcolor = {red},
+ hyperindex = {true},
+ linktocpage = {true},
+}
+\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
+\begin{document}
+
+
+
+\title{Example evaluation of FOCUS dataset Z}
+\author{\textbf{Johannes Ranke} \\[0.5cm]
+%EndAName
+Wissenschaftlicher Berater\\
+Kronacher Str. 8, 79639 Grenzach-Wyhlen, Germany\\[0.5cm]
+and\\[0.5cm]
+University of Bremen\\
+}
+\maketitle
+
+\thispagestyle{empty} \setcounter{page}{0}
+
+\clearpage
+
+\tableofcontents
+
+\textbf{Key words}: Kinetics, FOCUS, nonlinear optimisation
+
+\section{The data}
+
+The following code defines the example dataset from Appendix 7 to the FOCUS kinetics
+report \citep{FOCUSkinetics2011}, p.350.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlkwd{require}\hlstd{(mkin)}
+\end{alltt}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Loading required package: mkin}}
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Loading required package: minpack.lm}}
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Loading required package: rootSolve}}
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Loading required package: inline}}
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Loading required package: methods}}
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Loading required package: parallel}}\begin{alltt}
+\hlstd{LOD} \hlkwb{=} \hlnum{0.5}
+\hlstd{FOCUS_2006_Z} \hlkwb{=} \hlkwd{data.frame}\hlstd{(}
+ \hlkwc{t} \hlstd{=} \hlkwd{c}\hlstd{(}\hlnum{0}\hlstd{,} \hlnum{0.04}\hlstd{,} \hlnum{0.125}\hlstd{,} \hlnum{0.29}\hlstd{,} \hlnum{0.54}\hlstd{,} \hlnum{1}\hlstd{,} \hlnum{2}\hlstd{,} \hlnum{3}\hlstd{,} \hlnum{4}\hlstd{,} \hlnum{7}\hlstd{,} \hlnum{10}\hlstd{,} \hlnum{14}\hlstd{,} \hlnum{21}\hlstd{,}
+ \hlnum{42}\hlstd{,} \hlnum{61}\hlstd{,} \hlnum{96}\hlstd{,} \hlnum{124}\hlstd{),}
+ \hlkwc{Z0} \hlstd{=} \hlkwd{c}\hlstd{(}\hlnum{100}\hlstd{,} \hlnum{81.7}\hlstd{,} \hlnum{70.4}\hlstd{,} \hlnum{51.1}\hlstd{,} \hlnum{41.2}\hlstd{,} \hlnum{6.6}\hlstd{,} \hlnum{4.6}\hlstd{,} \hlnum{3.9}\hlstd{,} \hlnum{4.6}\hlstd{,} \hlnum{4.3}\hlstd{,} \hlnum{6.8}\hlstd{,}
+ \hlnum{2.9}\hlstd{,} \hlnum{3.5}\hlstd{,} \hlnum{5.3}\hlstd{,} \hlnum{4.4}\hlstd{,} \hlnum{1.2}\hlstd{,} \hlnum{0.7}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{c}\hlstd{(}\hlnum{0}\hlstd{,} \hlnum{18.3}\hlstd{,} \hlnum{29.6}\hlstd{,} \hlnum{46.3}\hlstd{,} \hlnum{55.1}\hlstd{,} \hlnum{65.7}\hlstd{,} \hlnum{39.1}\hlstd{,} \hlnum{36}\hlstd{,} \hlnum{15.3}\hlstd{,} \hlnum{5.6}\hlstd{,} \hlnum{1.1}\hlstd{,}
+ \hlnum{1.6}\hlstd{,} \hlnum{0.6}\hlstd{,} \hlnum{0.5} \hlopt{*} \hlstd{LOD,} \hlnum{NA}\hlstd{,} \hlnum{NA}\hlstd{,} \hlnum{NA}\hlstd{),}
+ \hlkwc{Z2} \hlstd{=} \hlkwd{c}\hlstd{(}\hlnum{0}\hlstd{,} \hlnum{NA}\hlstd{,} \hlnum{0.5} \hlopt{*} \hlstd{LOD,} \hlnum{2.6}\hlstd{,} \hlnum{3.8}\hlstd{,} \hlnum{15.3}\hlstd{,} \hlnum{37.2}\hlstd{,} \hlnum{31.7}\hlstd{,} \hlnum{35.6}\hlstd{,} \hlnum{14.5}\hlstd{,}
+ \hlnum{0.8}\hlstd{,} \hlnum{2.1}\hlstd{,} \hlnum{1.9}\hlstd{,} \hlnum{0.5} \hlopt{*} \hlstd{LOD,} \hlnum{NA}\hlstd{,} \hlnum{NA}\hlstd{,} \hlnum{NA}\hlstd{),}
+ \hlkwc{Z3} \hlstd{=} \hlkwd{c}\hlstd{(}\hlnum{0}\hlstd{,} \hlnum{NA}\hlstd{,} \hlnum{NA}\hlstd{,} \hlnum{NA}\hlstd{,} \hlnum{NA}\hlstd{,} \hlnum{0.5} \hlopt{*} \hlstd{LOD,} \hlnum{9.2}\hlstd{,} \hlnum{13.1}\hlstd{,} \hlnum{22.3}\hlstd{,} \hlnum{28.4}\hlstd{,} \hlnum{32.5}\hlstd{,}
+ \hlnum{25.2}\hlstd{,} \hlnum{17.2}\hlstd{,} \hlnum{4.8}\hlstd{,} \hlnum{4.5}\hlstd{,} \hlnum{2.8}\hlstd{,} \hlnum{4.4}\hlstd{))}
+
+\hlstd{FOCUS_2006_Z_mkin} \hlkwb{<-} \hlkwd{mkin_wide_to_long}\hlstd{(FOCUS_2006_Z)}
+\end{alltt}
+\end{kframe}
+\end{knitrout}
+
+\section{Parent compound and one metabolite}
+
+The next step is to set up the models used for the kinetic analysis. As the
+simultaneous fit of parent and the first metabolite is usually straightforward,
+Step 1 (SFO for parent only) is skipped here. We start with the model 2a,
+with formation and decline of metabolite Z1 and the pathway from parent
+directly to sink included (default in mkin).
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.2a} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z1"}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{))}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.2a} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.2a, FOCUS_2006_Z_mkin,} \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.2a)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_1-1}
+\begin{kframe}\begin{alltt}
+\hlkwd{summary}\hlstd{(m.Z.2a,} \hlkwc{data} \hlstd{=} \hlnum{FALSE}\hlstd{)}\hlopt{$}\hlstd{bpar}
+\end{alltt}
+\begin{verbatim}
+## Estimate se_notrans t value Pr(>t)
+## Z0_0 9.701488e+01 3.55313691 2.730401e+01 1.679214e-21
+## k_Z0_sink 1.281376e-11 0.22689470 5.647447e-11 5.000000e-01
+## k_Z0_Z1 2.236006e+00 0.16507604 1.354531e+01 7.396594e-14
+## k_Z1_sink 4.821248e-01 0.06585369 7.321150e+00 3.552015e-08
+## Lower Upper
+## Z0_0 91.4058170 102.6239462
+## k_Z0_sink 0.0000000 Inf
+## k_Z0_Z1 1.8419826 2.7143172
+## k_Z1_sink 0.4005856 0.5802613
+\end{verbatim}
+\end{kframe}
+\end{knitrout}
+
+As obvious from the parameter summary (the \texttt{bpar} component of the
+summary), the kinetic rate constant from parent compound Z to sink
+is negligible. Accordingly, the exact magnitude of the fitted parameter
+\texttt{log k\_Z0\_sink} is ill-defined and the covariance matrix is not
+returned (not shown, would be visible in the complete summary).
+This suggests, in agreement with the analysis in the FOCUS kinetics report, to
+simplify the model by removing the pathway to sink.
+
+A similar result can be obtained when formation fractions are used in the model
+formulation:
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.2a.ff} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z1"}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{),}
+ \hlkwc{use_of_ff} \hlstd{=} \hlstr{"max"}\hlstd{)}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.2a.ff} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.2a.ff, FOCUS_2006_Z_mkin,} \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.2a.ff)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_2-1}
+\begin{kframe}\begin{alltt}
+\hlkwd{summary}\hlstd{(m.Z.2a.ff,} \hlkwc{data} \hlstd{=} \hlnum{FALSE}\hlstd{)}\hlopt{$}\hlstd{bpar}
+\end{alltt}
+\begin{verbatim}
+## Estimate se_notrans t value Pr(>t) Lower
+## Z0_0 97.0148812 3.55314944 27.303912 1.679369e-21 91.3287912
+## k_Z0 2.2360064 0.21684747 10.311425 3.661846e-11 1.8052909
+## k_Z1 0.4821248 0.06585372 7.321147 3.552045e-08 0.3996826
+## f_Z0_to_Z1 1.0000000 0.10147342 9.854798 9.707056e-11 0.0000000
+## Upper
+## Z0_0 102.7009713
+## k_Z0 2.7694843
+## k_Z1 0.5815722
+## f_Z0_to_Z1 1.0000000
+\end{verbatim}
+\end{kframe}
+\end{knitrout}
+
+Here, the ilr transformed formation fraction fitted in the model takes a very
+large value, and the backtransformed formation fraction from parent Z to Z1 is
+practically unity. Again, the covariance matrix is not returned as the model is
+overparameterised.
+
+The simplified model is obtained by setting the list component \texttt{sink} to
+\texttt{FALSE}.\footnote{If the model formulation without formation fractions
+is used, the same effect can be obtained by fixing the parameter \texttt{k\_Z\_sink}
+to a value of zero.}
+
+In the following, we use the parameterisation with formation fractions in order
+to be able to compare with the results in the FOCUS guidance, and as it
+makes it easier to use parameters obtained in a previous fit when adding a further
+metabolite.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.3} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z1"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{),} \hlkwc{use_of_ff} \hlstd{=} \hlstr{"max"}\hlstd{)}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.3} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.3, FOCUS_2006_Z_mkin,} \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.3)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_3-1}
+\begin{kframe}\begin{alltt}
+\hlkwd{summary}\hlstd{(m.Z.3,} \hlkwc{data} \hlstd{=} \hlnum{FALSE}\hlstd{)}\hlopt{$}\hlstd{bpar}
+\end{alltt}
+\begin{verbatim}
+## Estimate se_notrans t value Pr(>t) Lower
+## Z0_0 97.0148815 2.68177093 36.17568 2.363587e-25 91.5215237
+## k_Z0 2.2360064 0.14686110 15.22531 2.246514e-15 1.9545310
+## k_Z1 0.4821248 0.04268712 11.29439 3.068581e-12 0.4021552
+## Upper
+## Z0_0 102.5082392
+## k_Z0 2.5580177
+## k_Z1 0.5779966
+\end{verbatim}
+\end{kframe}
+\end{knitrout}
+
+As there is only one transformation product for Z0 and no pathway
+to sink, the formation fraction is internally fixed to unity.
+
+\section{Including metabolites Z2 and Z3}
+
+As suggested in the FOCUS report, the pathway to sink was removed for metabolite Z1 as
+well in the next step. While this step appears questionable on the basis of the above results, it
+is followed here for the purpose of comparison. Also, in the FOCUS report, it is
+assumed that there is additional empirical evidence that Z1 quickly and exclusively
+hydrolyses to Z2.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.5} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z1"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z2"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z2} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{),} \hlkwc{use_of_ff} \hlstd{=} \hlstr{"max"}\hlstd{)}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.5} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.5, FOCUS_2006_Z_mkin,} \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.5)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_5-1}
+
+\end{knitrout}
+
+Finally, metabolite Z3 is added to the model. We use the optimised
+differential equation parameter values from the previous fit in order to
+accelerate the optimization.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.FOCUS} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z1"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z2"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z2} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z3"}\hlstd{),}
+ \hlkwc{Z3} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{),}
+ \hlkwc{use_of_ff} \hlstd{=} \hlstr{"max"}\hlstd{)}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.FOCUS} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.FOCUS, FOCUS_2006_Z_mkin,}
+ \hlkwc{parms.ini} \hlstd{= m.Z.5}\hlopt{$}\hlstd{bparms.ode,}
+ \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.FOCUS)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_6-1}
+\begin{kframe}\begin{alltt}
+\hlkwd{summary}\hlstd{(m.Z.FOCUS,} \hlkwc{data} \hlstd{=} \hlnum{FALSE}\hlstd{)}\hlopt{$}\hlstd{bpar}
+\end{alltt}
+\begin{verbatim}
+## Estimate se_notrans t value Pr(>t) Lower
+## Z0_0 96.83849566 2.05886133 47.034977 5.583742e-44 92.70517559
+## k_Z0 2.21540897 0.11813046 18.753919 7.744034e-25 1.99051134
+## k_Z1 0.47829896 0.02928763 16.331089 3.333376e-22 0.42297603
+## k_Z2 0.45161653 0.04421268 10.214638 3.110936e-14 0.37103495
+## k_Z3 0.05869343 0.01429485 4.105914 7.285393e-05 0.03599566
+## f_Z2_to_Z3 0.47150952 0.05705233 8.264510 2.809889e-11 0.36038193
+## Upper
+## Z0_0 100.97181573
+## k_Z0 2.46571661
+## k_Z1 0.54085782
+## k_Z2 0.54969886
+## k_Z3 0.09570371
+## f_Z2_to_Z3 0.58553462
+\end{verbatim}
+\begin{alltt}
+\hlkwd{endpoints}\hlstd{(m.Z.FOCUS)}
+\end{alltt}
+\begin{verbatim}
+## $ff
+## Z2_Z3 Z2_sink
+## 0.4715095 0.5284905
+##
+## $SFORB
+## logical(0)
+##
+## $distimes
+## DT50 DT90
+## Z0 0.3128755 1.039350
+## Z1 1.4491923 4.814113
+## Z2 1.5348136 5.098540
+## Z3 11.8096217 39.230714
+\end{verbatim}
+\end{kframe}
+\end{knitrout}
+
+This fit corresponds to the final result chosen in Appendix 7 of the FOCUS
+report. Confidence intervals returned by mkin are based on internally
+transformed parameters, however.
+
+\section{Using the SFORB model for parent and metabolites}
+
+As the FOCUS report states, there is a certain tailing of the time course of metabolite
+Z3. Also, the time course of the parent compound is not fitted very well using the
+SFO model, as residues at a certain low level remain.
+
+Therefore, an additional model is offered here, using the single first-order
+reversible binding (SFORB) model for metabolite Z3. As expected, the $\chi^2$
+error level is lower for metabolite Z3 using this model and the graphical
+fit for Z3 is improved. However, the covariance matrix is not returned.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.mkin.1} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z1"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z2"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z2} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z3"}\hlstd{),}
+ \hlkwc{Z3} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFORB"}\hlstd{))}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.mkin.1} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.mkin.1, FOCUS_2006_Z_mkin,} \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.mkin.1)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_7-1}
+\begin{kframe}\begin{alltt}
+\hlkwd{summary}\hlstd{(m.Z.mkin.1,} \hlkwc{data} \hlstd{=} \hlnum{FALSE}\hlstd{)}\hlopt{$}\hlstd{cov.unscaled}
+\end{alltt}
+\begin{verbatim}
+## NULL
+\end{verbatim}
+\end{kframe}
+\end{knitrout}
+
+Therefore, a further stepwise model building is performed starting from the
+stage of parent and two metabolites, starting from the assumption that the model
+fit for the parent compound can be improved by using the SFORB model.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.mkin.3} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFORB"}\hlstd{,} \hlstr{"Z1"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z2"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z2} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{))}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.mkin.3} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.mkin.3, FOCUS_2006_Z_mkin,} \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.mkin.3)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_9-1}
+
+\end{knitrout}
+
+This results in a much better representation of the behaviour of the parent
+compound Z0.
+
+Finally, Z3 is added as well. These models appear overparameterised (no
+covariance matrix returned) if the sink for Z1 is left in the models.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.mkin.4} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFORB"}\hlstd{,} \hlstr{"Z1"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z2"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z2} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z3"}\hlstd{),}
+ \hlkwc{Z3} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{))}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.mkin.4} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.mkin.4, FOCUS_2006_Z_mkin,}
+ \hlkwc{parms.ini} \hlstd{= m.Z.mkin.3}\hlopt{$}\hlstd{bparms.ode,}
+ \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.mkin.4)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_10-1}
+
+\end{knitrout}
+
+The error level of the fit, but especially of metabolite Z3, can be improved if
+the SFORB model is chosen for this metabolite, as this model is capable of
+representing the tailing of the metabolite decline phase.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{Z.mkin.5} \hlkwb{<-} \hlkwd{mkinmod}\hlstd{(}\hlkwc{Z0} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFORB"}\hlstd{,} \hlstr{"Z1"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z1} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z2"}\hlstd{,} \hlkwc{sink} \hlstd{=} \hlnum{FALSE}\hlstd{),}
+ \hlkwc{Z2} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFO"}\hlstd{,} \hlstr{"Z3"}\hlstd{),}
+ \hlkwc{Z3} \hlstd{=} \hlkwd{mkinsub}\hlstd{(}\hlstr{"SFORB"}\hlstd{))}
+\end{alltt}
+\begin{verbatim}
+## make[1]: warning: jobserver unavailable: using -j1. Add '+' to parent make rule.
+\end{verbatim}
+
+
+{\ttfamily\noindent\itshape\color{messagecolor}{\#\# Successfully compiled differential equation model from auto-generated C code.}}\begin{alltt}
+\hlstd{m.Z.mkin.5} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.mkin.5, FOCUS_2006_Z_mkin,}
+ \hlkwc{parms.ini} \hlstd{= m.Z.mkin.4}\hlopt{$}\hlstd{bparms.ode[}\hlnum{1}\hlopt{:}\hlnum{4}\hlstd{],}
+ \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.mkin.5)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_11-1}
+
+\end{knitrout}
+
+The summary view of the backtransformed parameters shows that we get no
+confidence intervals due to overparameterisation. As the optimized
+\texttt{k\_Z3\_bound\_free} is excessively small, it seems reasonable to fix it to
+zero.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlstd{m.Z.mkin.5a} \hlkwb{<-} \hlkwd{mkinfit}\hlstd{(Z.mkin.5, FOCUS_2006_Z_mkin,}
+ \hlkwc{parms.ini} \hlstd{=} \hlkwd{c}\hlstd{(m.Z.mkin.5}\hlopt{$}\hlstd{bparms.ode[}\hlnum{1}\hlopt{:}\hlnum{7}\hlstd{],}
+ \hlkwc{k_Z3_bound_free} \hlstd{=} \hlnum{0}\hlstd{),}
+ \hlkwc{fixed_parms} \hlstd{=} \hlstr{"k_Z3_bound_free"}\hlstd{,}
+ \hlkwc{quiet} \hlstd{=} \hlnum{TRUE}\hlstd{)}
+\hlkwd{plot_sep}\hlstd{(m.Z.mkin.5a)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_11a-1}
+
+\end{knitrout}
+
+As expected, the residual plots for Z0 and Z3 are more random than in the case of the
+all SFO model for which they were shown above. In conclusion, the model
+\texttt{Z.mkin.5a} is proposed as the best-fit model for the dataset from
+Appendix 7 of the FOCUS report.
+
+A graphical representation of the confidence intervals can finally be obtained.
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlkwd{mkinparplot}\hlstd{(m.Z.mkin.5a)}
+\end{alltt}
+\end{kframe}
+\includegraphics[width=\maxwidth]{figure/FOCUS_2006_Z_fits_11b-1}
+
+\end{knitrout}
+
+The endpoints obtained with this model are
+
+\begin{knitrout}
+\definecolor{shadecolor}{rgb}{0.969, 0.969, 0.969}\color{fgcolor}\begin{kframe}
+\begin{alltt}
+\hlkwd{endpoints}\hlstd{(m.Z.mkin.5a)}
+\end{alltt}
+\begin{verbatim}
+## $ff
+## Z0_free_Z1 Z1_Z2 Z2_sink Z2_Z3_free Z3_free_sink
+## 1.0000000 1.0000000 0.4634431 0.5365569 1.0000000
+##
+## $SFORB
+## Z0_b1 Z0_b2 Z3_b1 Z3_b2
+## 2.447138640 0.007512589 0.080007099 0.000000000
+##
+## $distimes
+## DT50 DT90 DT50_Z0_b1 DT50_Z0_b2 DT50_Z3_b1 DT50_Z3_b2
+## Z0 0.3042972 1.184811 0.283248 92.26476 NA NA
+## Z1 1.5147787 5.031986 NA NA NA NA
+## Z2 1.6413857 5.452565 NA NA NA NA
+## Z3 NA NA NA NA 8.663571 Inf
+\end{verbatim}
+\end{kframe}
+\end{knitrout}
+
+It is clear the degradation rate of Z3 towards the end of the experiment
+is very low as DT50\_Z3\_b2 (the second Eigenvalue of the system of two differential
+equations representing the SFORB system for Z3, corresponding to the slower rate
+constant of the DFOP model) is reported to be infinity. However, this appears
+to be a feature of the data.
+
+\bibliographystyle{plainnat}
+\bibliography{references}
+
+\end{document}
+% vim: set foldmethod=syntax:
diff --git a/docs/articles/FOCUS_Z.toc b/docs/articles/FOCUS_Z.toc
new file mode 100644
index 00000000..ebb3b24a
--- /dev/null
+++ b/docs/articles/FOCUS_Z.toc
@@ -0,0 +1,4 @@
+\contentsline {section}{\numberline {1}The data}{1}{section.1}
+\contentsline {section}{\numberline {2}Parent compound and one metabolite}{2}{section.2}
+\contentsline {section}{\numberline {3}Including metabolites Z2 and Z3}{8}{section.3}
+\contentsline {section}{\numberline {4}Using the SFORB model for parent and metabolites}{12}{section.4}
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.RData b/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.RData
new file mode 100644
index 00000000..53e2a7d5
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdb
new file mode 100644
index 00000000..a6cdae6f
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdx
new file mode 100644
index 00000000..a07dfb62
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_10_ad34939f1c4da097e64c6add505f564d.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.RData b/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.RData
new file mode 100644
index 00000000..7fe16ba7
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdb
new file mode 100644
index 00000000..1a64b007
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdx
new file mode 100644
index 00000000..86d9cf65
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11_9a3c490a93568b80d56e768bd4d45f20.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.RData b/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.RData
new file mode 100644
index 00000000..bc15e9f0
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdb
new file mode 100644
index 00000000..b4d0ea88
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdx
new file mode 100644
index 00000000..78c9c03f
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11a_de0f5d38d53d39ab3bf4487eaf6f6bfe.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.RData b/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.RData
new file mode 100644
index 00000000..87f2545c
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdb
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11b_659cb7280818c6f1fe7ac209dfe2b150.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.RData b/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.RData
new file mode 100644
index 00000000..711d340c
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdb
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdb
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdx
new file mode 100644
index 00000000..4a053a44
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_11b_endpoints_63bd41a9e7a7db8d50672d1d2818a3de.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.RData b/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.RData
new file mode 100644
index 00000000..d6860a12
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdb
new file mode 100644
index 00000000..48ee604b
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdx
new file mode 100644
index 00000000..61edd6ba
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_1_632387249aeb91d63b5958d33dba1ca2.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.RData b/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.RData
new file mode 100644
index 00000000..080fead7
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdb
new file mode 100644
index 00000000..72cacd80
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdx
new file mode 100644
index 00000000..a0b9c984
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_2_3ad73869115f92c555719677ea29ac80.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.RData b/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.RData
new file mode 100644
index 00000000..44eac630
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdb
new file mode 100644
index 00000000..65b5dcc0
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdx
new file mode 100644
index 00000000..a5b74eb7
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_3_fc3af4746f8762d3e69b54efed402074.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.RData b/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.RData
new file mode 100644
index 00000000..219b64bc
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdb
new file mode 100644
index 00000000..dfea644d
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdx
new file mode 100644
index 00000000..428269a0
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_5_03ef5522bde971daafe1f7a8305fecc2.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.RData b/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.RData
new file mode 100644
index 00000000..1ac664a9
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdb
new file mode 100644
index 00000000..b729b5e3
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdx
new file mode 100644
index 00000000..a5554fc3
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_6_cf2ea2b55b5bd1a719a397d1d14a9b1f.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.RData b/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.RData
new file mode 100644
index 00000000..79d8608a
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdb
new file mode 100644
index 00000000..a355ffa6
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdx
new file mode 100644
index 00000000..cd8fe227
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_7_8ed2205e23e7632fdcfd418445aca562.rdx
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.RData b/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.RData
new file mode 100644
index 00000000..4866d4d9
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.RData
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdb b/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdb
new file mode 100644
index 00000000..c1b8b1c1
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdb
Binary files differ
diff --git a/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdx b/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdx
new file mode 100644
index 00000000..747c01e0
--- /dev/null
+++ b/docs/articles/cache/FOCUS_2006_Z_fits_9_c9d06bd14747fc380b2418122f60bd56.rdx
Binary files differ
diff --git a/docs/articles/cache/__packages b/docs/articles/cache/__packages
new file mode 100644
index 00000000..72bad839
--- /dev/null
+++ b/docs/articles/cache/__packages
@@ -0,0 +1,6 @@
+base
+knitr
+minpack.lm
+rootSolve
+inline
+mkin
diff --git a/docs/articles/compiled_models.R b/docs/articles/compiled_models.R
new file mode 100644
index 00000000..4f544b0d
--- /dev/null
+++ b/docs/articles/compiled_models.R
@@ -0,0 +1,42 @@
+## ----benchmark_SFO_SFO, fig.height = 3-----------------------------------
+library("microbenchmark")
+library("ggplot2")
+mb.1 <- microbenchmark(
+ "deSolve, not compiled" = mkinfit(SFO_SFO, FOCUS_2006_D,
+ solution_type = "deSolve",
+ use_compiled = FALSE, quiet = TRUE),
+ "Eigenvalue based" = mkinfit(SFO_SFO, FOCUS_2006_D,
+ solution_type = "eigen", quiet = TRUE),
+ "deSolve, compiled" = mkinfit(SFO_SFO, FOCUS_2006_D,
+ solution_type = "deSolve", quiet = TRUE),
+ times = 3, control = list(warmup = 0))
+
+smb.1 <- summary(mb.1)
+print(mb.1)
+autoplot(mb.1)
+
+## ------------------------------------------------------------------------
+rownames(smb.1) <- smb.1$expr
+smb.1["median"]/smb.1["deSolve, compiled", "median"]
+
+## ----benchmark_FOMC_SFO, fig.height = 3----------------------------------
+FOMC_SFO <- mkinmod(
+ parent = mkinsub("FOMC", "m1"),
+ m1 = mkinsub( "SFO"))
+
+mb.2 <- microbenchmark(
+ "deSolve, not compiled" = mkinfit(FOMC_SFO, FOCUS_2006_D,
+ use_compiled = FALSE, quiet = TRUE),
+ "deSolve, compiled" = mkinfit(FOMC_SFO, FOCUS_2006_D, quiet = TRUE),
+ times = 3, control = list(warmup = 0))
+smb.2 <- summary(mb.2)
+print(mb.2)
+smb.2["median"]/smb.2["deSolve, compiled", "median"]
+autoplot(mb.2)
+
+## ----sessionInfo, echo = FALSE-------------------------------------------
+cat(capture.output(sessionInfo())[1:3], sep = "\n")
+if(!inherits(try(cpuinfo <- readLines("/proc/cpuinfo")), "try-error")) {
+ cat(gsub("model name\t: ", "CPU model: ", cpuinfo[grep("model name", cpuinfo)[1]]))
+}
+
diff --git a/docs/articles/compiled_models.html b/docs/articles/compiled_models.html
new file mode 100644
index 00000000..e02b9cf3
--- /dev/null
+++ b/docs/articles/compiled_models.html
@@ -0,0 +1,156 @@
+<!DOCTYPE html>
+<!-- Generated by pkgdown: do not edit by hand --><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Performance benefit by using compiled model definitions in mkin &bull; mkin</title><!-- jquery --><script src="https://code.jquery.com/jquery-3.1.0.min.js" integrity="sha384-nrOSfDHtoPMzJHjVTdCopGqIqeYETSXhZDFyniQ8ZHcVy08QesyHcnOUpMpqnmWq" crossorigin="anonymous"></script><!-- Bootstrap --><link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous"><script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script><!-- Font Awesome icons --><link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" integrity="sha384-T8Gy5hrqNKT+hzMclPo118YTQO6cYprQmhrYwIiQ/3axmI1hQomh7Ud2hPOy8SP1" crossorigin="anonymous"><!-- pkgdown --><link href="../pkgdown.css" rel="stylesheet"><script src="../jquery.sticky-kit.min.js"></script><script src="../pkgdown.js"></script><!-- mathjax --><script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script><!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]--></head><body>
+ <div class="container template-vignette">
+ <header><div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="../index.html">mkin</a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav"><li>
+ <a href="../index.html">Home</a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul><ul class="nav navbar-nav navbar-right"><li>
+ <a href="https://github.com/jranke/mkin">
+ <span class="fa fa-github fa-lg"></span>
+
+ </a>
+</li>
+ </ul></div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+ </header><div class="row">
+ <div class="col-md-9">
+ <div class="page-header toc-ignore">
+ <h1>Performance benefit by using compiled model definitions in mkin</h1>
+ <h4 class="author">Johannes Ranke</h4>
+
+ <h4 class="date">2016-10-26</h4>
+ </div>
+
+
+
+<div class="contents">
+<div id="benchmark-for-a-model-that-can-also-be-solved-with-eigenvalues" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#benchmark-for-a-model-that-can-also-be-solved-with-eigenvalues" class="anchor"> </a></body></html>Benchmark for a model that can also be solved with Eigenvalues</h2>
+<p>This evaluation is taken from the example section of mkinfit. When using an mkin version equal to or greater than 0.9-36 and a C compiler (gcc) is available, you will see a message that the model is being compiled from autogenerated C code when defining a model using mkinmod. The <code><a href="../reference/mkinmod.html">mkinmod()</a></code> function checks for presence of the gcc compiler using</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">Sys.which</span>(<span class="st">"gcc"</span>)</code></pre></div>
+<pre><code>## gcc
+## "/usr/bin/gcc"</code></pre>
+<p>First, we build a simple degradation model for a parent compound with one metabolite.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">library</span>(<span class="st">"mkin"</span>)
+SFO_SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinmod.html">mkinmod</a></span>(
+ <span class="dt">parent =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"SFO"</span>, <span class="st">"m1"</span>),
+ <span class="dt">m1 =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"SFO"</span>))</code></pre></div>
+<pre><code>## Successfully compiled differential equation model from auto-generated C code.</code></pre>
+<p>We can compare the performance of the Eigenvalue based solution against the compiled version and the R implementation of the differential equations using the microbenchmark package.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">library</span>(<span class="st">"microbenchmark"</span>)
+<span class="kw">library</span>(<span class="st">"ggplot2"</span>)
+mb<span class="fl">.1</span> &lt;-<span class="st"> </span><span class="kw">microbenchmark</span>(
+ <span class="st">"deSolve, not compiled"</span> =<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(SFO_SFO, FOCUS_2006_D,
+ <span class="dt">solution_type =</span> <span class="st">"deSolve"</span>,
+ <span class="dt">use_compiled =</span> <span class="ot">FALSE</span>, <span class="dt">quiet =</span> <span class="ot">TRUE</span>),
+ <span class="st">"Eigenvalue based"</span> =<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(SFO_SFO, FOCUS_2006_D,
+ <span class="dt">solution_type =</span> <span class="st">"eigen"</span>, <span class="dt">quiet =</span> <span class="ot">TRUE</span>),
+ <span class="st">"deSolve, compiled"</span> =<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(SFO_SFO, FOCUS_2006_D,
+ <span class="dt">solution_type =</span> <span class="st">"deSolve"</span>, <span class="dt">quiet =</span> <span class="ot">TRUE</span>),
+ <span class="dt">times =</span> <span class="dv">3</span>, <span class="dt">control =</span> <span class="kw">list</span>(<span class="dt">warmup =</span> <span class="dv">0</span>))</code></pre></div>
+<pre><code>## Warning in microbenchmark(`deSolve, not compiled` = mkinfit(SFO_SFO,
+## FOCUS_2006_D, : Could not measure overhead. Your clock might lack
+## precision.</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">smb<span class="fl">.1</span> &lt;-<span class="st"> </span><span class="kw">summary</span>(mb<span class="fl">.1</span>)
+<span class="kw">print</span>(mb<span class="fl">.1</span>)</code></pre></div>
+<pre><code>## Unit: milliseconds
+## expr min lq mean median uq
+## deSolve, not compiled 6298.7342 6308.6792 6343.9668 6318.6243 6366.5831
+## Eigenvalue based 871.7379 880.7757 903.5267 889.8135 919.4211
+## deSolve, compiled 724.9025 730.6729 732.9837 736.4432 737.0243
+## max neval cld
+## 6414.5420 3 c
+## 949.0287 3 b
+## 737.6054 3 a</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">autoplot</span>(mb<span class="fl">.1</span>)</code></pre></div>
+<p><img src="compiled_models_files/figure-html/benchmark_SFO_SFO-1.png" width="672"></p>
+<p>We see that using the compiled model is by a factor of 8.6 faster than using the R version with the default ode solver, and it is even faster than the Eigenvalue based solution implemented in R which does not need iterative solution of the ODEs:</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">rownames</span>(smb<span class="fl">.1</span>) &lt;-<span class="st"> </span>smb<span class="fl">.1</span>$expr
+smb<span class="fl">.1</span>[<span class="st">"median"</span>]/smb<span class="fl">.1</span>[<span class="st">"deSolve, compiled"</span>, <span class="st">"median"</span>]</code></pre></div>
+<pre><code>## median
+## deSolve, not compiled 8.579920
+## Eigenvalue based 1.208258
+## deSolve, compiled 1.000000</code></pre>
+</div>
+<div id="benchmark-for-a-model-that-can-not-be-solved-with-eigenvalues" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#benchmark-for-a-model-that-can-not-be-solved-with-eigenvalues" class="anchor"> </a></body></html>Benchmark for a model that can not be solved with Eigenvalues</h2>
+<p>This evaluation is also taken from the example section of mkinfit.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">FOMC_SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinmod.html">mkinmod</a></span>(
+ <span class="dt">parent =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"FOMC"</span>, <span class="st">"m1"</span>),
+ <span class="dt">m1 =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>( <span class="st">"SFO"</span>))</code></pre></div>
+<pre><code>## Successfully compiled differential equation model from auto-generated C code.</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">mb<span class="fl">.2</span> &lt;-<span class="st"> </span><span class="kw">microbenchmark</span>(
+ <span class="st">"deSolve, not compiled"</span> =<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(FOMC_SFO, FOCUS_2006_D,
+ <span class="dt">use_compiled =</span> <span class="ot">FALSE</span>, <span class="dt">quiet =</span> <span class="ot">TRUE</span>),
+ <span class="st">"deSolve, compiled"</span> =<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(FOMC_SFO, FOCUS_2006_D, <span class="dt">quiet =</span> <span class="ot">TRUE</span>),
+ <span class="dt">times =</span> <span class="dv">3</span>, <span class="dt">control =</span> <span class="kw">list</span>(<span class="dt">warmup =</span> <span class="dv">0</span>))</code></pre></div>
+<pre><code>## Warning in microbenchmark(`deSolve, not compiled` = mkinfit(FOMC_SFO,
+## FOCUS_2006_D, : Could not measure overhead. Your clock might lack
+## precision.</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">smb<span class="fl">.2</span> &lt;-<span class="st"> </span><span class="kw">summary</span>(mb<span class="fl">.2</span>)
+<span class="kw">print</span>(mb<span class="fl">.2</span>)</code></pre></div>
+<pre><code>## Unit: seconds
+## expr min lq mean median uq
+## deSolve, not compiled 13.265212 13.330161 13.412053 13.395109 13.485473
+## deSolve, compiled 1.322466 1.326851 1.364827 1.331236 1.386007
+## max neval cld
+## 13.575837 3 b
+## 1.440779 3 a</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r">smb<span class="fl">.2</span>[<span class="st">"median"</span>]/smb<span class="fl">.2</span>[<span class="st">"deSolve, compiled"</span>, <span class="st">"median"</span>]</code></pre></div>
+<pre><code>## median
+## 1 NA
+## 2 NA</code></pre>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">autoplot</span>(mb<span class="fl">.2</span>)</code></pre></div>
+<p><img src="compiled_models_files/figure-html/benchmark_FOMC_SFO-1.png" width="672"></p>
+<p>Here we get a performance benefit of a factor of 10.1 using the version of the differential equation model compiled from C code!</p>
+<p>This vignette was built with mkin 0.9.44.9000 on</p>
+<pre><code>## R version 3.3.1 (2016-06-21)
+## Platform: x86_64-pc-linux-gnu (64-bit)
+## Running under: Debian GNU/Linux 8 (jessie)</code></pre>
+<pre><code>## CPU model: Intel(R) Core(TM) i7-4710MQ CPU @ 2.50GHz</code></pre>
+</div>
+</div>
+ </div>
+
+ <div class="col-md-3 hidden-xs hidden-sm" id="sidebar">
+ <div id="tocnav">
+ <h2>Contents</h2>
+ <ul class="nav nav-pills nav-stacked"><li><a href="#benchmark-for-a-model-that-can-also-be-solved-with-eigenvalues">Benchmark for a model that can also be solved with Eigenvalues</a></li>
+ <li><a href="#benchmark-for-a-model-that-can-not-be-solved-with-eigenvalues">Benchmark for a model that can not be solved with Eigenvalues</a></li>
+ </ul></div>
+ </div>
+
+</div>
+
+
+ <footer><div class="copyright">
+ <p>Developed by Johannes Ranke, Eurofins Regulatory AG.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="http://hadley.github.io/pkgdown/">pkgdown</a>.</p>
+</div>
+
+ </footer></div>
+
+ </body></html>
diff --git a/docs/articles/compiled_models_files/figure-html/benchmark_FOMC_SFO-1.png b/docs/articles/compiled_models_files/figure-html/benchmark_FOMC_SFO-1.png
new file mode 100644
index 00000000..bba259d6
--- /dev/null
+++ b/docs/articles/compiled_models_files/figure-html/benchmark_FOMC_SFO-1.png
Binary files differ
diff --git a/docs/articles/compiled_models_files/figure-html/benchmark_SFO_SFO-1.png b/docs/articles/compiled_models_files/figure-html/benchmark_SFO_SFO-1.png
new file mode 100644
index 00000000..6b732075
--- /dev/null
+++ b/docs/articles/compiled_models_files/figure-html/benchmark_SFO_SFO-1.png
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_1-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_1-1.pdf
new file mode 100644
index 00000000..f2bb6c87
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_1-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_10-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_10-1.pdf
new file mode 100644
index 00000000..7fbe61ce
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_10-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_11-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_11-1.pdf
new file mode 100644
index 00000000..70067288
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_11-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_11a-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_11a-1.pdf
new file mode 100644
index 00000000..f5569149
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_11a-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_11b-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_11b-1.pdf
new file mode 100644
index 00000000..1cfcf140
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_11b-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_2-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_2-1.pdf
new file mode 100644
index 00000000..0eae0fb7
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_2-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_3-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_3-1.pdf
new file mode 100644
index 00000000..0071dab6
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_3-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_5-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_5-1.pdf
new file mode 100644
index 00000000..093be7dd
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_5-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_6-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_6-1.pdf
new file mode 100644
index 00000000..c27fc978
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_6-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_7-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_7-1.pdf
new file mode 100644
index 00000000..dc07202b
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_7-1.pdf
Binary files differ
diff --git a/docs/articles/figure/FOCUS_2006_Z_fits_9-1.pdf b/docs/articles/figure/FOCUS_2006_Z_fits_9-1.pdf
new file mode 100644
index 00000000..1580ad3b
--- /dev/null
+++ b/docs/articles/figure/FOCUS_2006_Z_fits_9-1.pdf
Binary files differ
diff --git a/docs/articles/header.tex b/docs/articles/header.tex
new file mode 100644
index 00000000..b8644ae2
--- /dev/null
+++ b/docs/articles/header.tex
@@ -0,0 +1,22 @@
+\usepackage{booktabs}
+\usepackage{amsfonts}
+\usepackage{latexsym}
+\usepackage{amsmath}
+\usepackage{amssymb}
+\usepackage{graphicx}
+\usepackage{parskip}
+\usepackage[round]{natbib}
+\usepackage{amstext}
+\usepackage{hyperref}
+
+\newcommand{\Rpackage}[1]{{\normalfont\fontseries{b}\selectfont #1}}
+\newcommand{\Robject}[1]{\texttt{#1}}
+\newcommand{\Rclass}[1]{\textit{#1}}
+\newcommand{\Rcmd}[1]{\texttt{#1}}
+
+\newcommand{\RR}{\textsf{R}}
+
+\RequirePackage[T1]{fontenc}
+\RequirePackage{graphicx,ae,fancyvrb}
+\IfFileExists{upquote.sty}{\RequirePackage{upquote}}{}
+\usepackage{relsize}
diff --git a/docs/articles/index.html b/docs/articles/index.html
new file mode 100644
index 00000000..9994716d
--- /dev/null
+++ b/docs/articles/index.html
@@ -0,0 +1,107 @@
+<!-- Generated by pkgdown: do not edit by hand -->
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<title>Articles • mkin</title>
+
+<!-- jquery -->
+<script src="https://code.jquery.com/jquery-3.1.0.min.js" integrity="sha384-nrOSfDHtoPMzJHjVTdCopGqIqeYETSXhZDFyniQ8ZHcVy08QesyHcnOUpMpqnmWq" crossorigin="anonymous"></script>
+<!-- Bootstrap -->
+
+<link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
+
+<!-- Font Awesome icons -->
+<link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" integrity="sha384-T8Gy5hrqNKT+hzMclPo118YTQO6cYprQmhrYwIiQ/3axmI1hQomh7Ud2hPOy8SP1" crossorigin="anonymous">
+
+
+<!-- pkgdown -->
+<link href="../pkgdown.css" rel="stylesheet">
+<script src="../jquery.sticky-kit.min.js"></script>
+<script src="../pkgdown.js"></script>
+
+<!-- mathjax -->
+<script src='https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML'></script>
+
+<!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]-->
+ </head>
+
+ <body>
+ <div class="container template-vignette-index">
+ <header>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="../index.html">mkin</a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="../index.html">Home</a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul>
+
+ <ul class="nav navbar-nav navbar-right">
+ <li>
+ <a href="https://github.com/jranke/mkin">
+ <span class="fa fa-github fa-lg"></span>
+
+ </a>
+</li>
+ </ul>
+ </div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+ </header>
+
+ <div class="page-header">
+ <h1>Vignette reference <small>version&nbsp;0.9.44.9000</small></h1>
+</div>
+
+<div class="row">
+ <div class="col-md-9">
+ <div class="section ">
+ <h3>All vignettes</h3>
+ <p class="section-desc"></p>
+
+ <ul>
+ <li><a href="compiled_models.html">Performance benefit by using compiled model definitions in mkin</a></li>
+ <li><a href="FOCUS_D.html">Example evaluation of FOCUS Example Dataset D</a></li>
+ <li><a href="FOCUS_L.html">Example evaluation of FOCUS Laboratory Data L1 to L3</a></li>
+ <li><a href="mkin.html">mkin - Kinetic evaluation of chemical degradation data</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <footer>
+ <div class="copyright">
+ <p>Developed by Johannes Ranke, Eurofins Regulatory AG.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="http://hadley.github.io/pkgdown/">pkgdown</a>.</p>
+</div>
+
+ </footer>
+ </div>
+
+ </body>
+</html>
diff --git a/docs/articles/mkin.R b/docs/articles/mkin.R
new file mode 100644
index 00000000..175bd33b
--- /dev/null
+++ b/docs/articles/mkin.R
@@ -0,0 +1,22 @@
+## ---- echo = TRUE, cache = TRUE, fig = TRUE, fig.width = 8, fig.height = 7----
+require(mkin)
+m_SFO_SFO_SFO <- mkinmod(parent = mkinsub("SFO", "M1"),
+ M1 = mkinsub("SFO", "M2"),
+ M2 = mkinsub("SFO"),
+ use_of_ff = "max", quiet = TRUE)
+
+sampling_times = c(0, 1, 3, 7, 14, 28, 60, 90, 120)
+
+d_SFO_SFO_SFO <- mkinpredict(m_SFO_SFO_SFO,
+ c(k_parent = 0.03,
+ f_parent_to_M1 = 0.5, k_M1 = log(2)/100,
+ f_M1_to_M2 = 0.9, k_M2 = log(2)/50),
+ c(parent = 100, M1 = 0, M2 = 0),
+ sampling_times)
+
+d_SFO_SFO_SFO_err <- add_err(d_SFO_SFO_SFO, function(x) 3, n = 1, seed = 123456789 )
+
+f_SFO_SFO_SFO <- mkinfit(m_SFO_SFO_SFO, d_SFO_SFO_SFO_err[[1]], quiet = TRUE)
+
+plot_sep(f_SFO_SFO_SFO, lpos = c("topright", "bottomright", "bottomright"))
+
diff --git a/docs/articles/mkin.html b/docs/articles/mkin.html
new file mode 100644
index 00000000..74d8ccca
--- /dev/null
+++ b/docs/articles/mkin.html
@@ -0,0 +1,181 @@
+<!DOCTYPE html>
+<!-- Generated by pkgdown: do not edit by hand --><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>mkin - Kinetic evaluation of chemical degradation data &bull; mkin</title><!-- jquery --><script src="https://code.jquery.com/jquery-3.1.0.min.js" integrity="sha384-nrOSfDHtoPMzJHjVTdCopGqIqeYETSXhZDFyniQ8ZHcVy08QesyHcnOUpMpqnmWq" crossorigin="anonymous"></script><!-- Bootstrap --><link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous"><script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script><!-- Font Awesome icons --><link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" integrity="sha384-T8Gy5hrqNKT+hzMclPo118YTQO6cYprQmhrYwIiQ/3axmI1hQomh7Ud2hPOy8SP1" crossorigin="anonymous"><!-- pkgdown --><link href="../pkgdown.css" rel="stylesheet"><script src="../jquery.sticky-kit.min.js"></script><script src="../pkgdown.js"></script><!-- mathjax --><script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script><!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]--></head><body>
+ <div class="container template-vignette">
+ <header><div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="../index.html">mkin</a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav"><li>
+ <a href="../index.html">Home</a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul><ul class="nav navbar-nav navbar-right"><li>
+ <a href="https://github.com/jranke/mkin">
+ <span class="fa fa-github fa-lg"></span>
+
+ </a>
+</li>
+ </ul></div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+ </header><div class="row">
+ <div class="col-md-9">
+ <div class="page-header toc-ignore">
+ <h1>mkin - Kinetic evaluation of chemical degradation data</h1>
+ <h4 class="author">Johannes Ranke</h4>
+
+ <h4 class="date">2016-10-26</h4>
+ </div>
+
+
+
+<div class="contents">
+<p><a href="http://www.jrwb.de">Wissenschaftlicher Berater, Kronacher Str. 8, 79639 Grenzach-Wyhlen, Germany</a><br><a href="http://chem.uft.uni-bremen.de/ranke">Privatdozent at the University of Bremen</a></p>
+<div id="abstract" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#abstract" class="anchor"> </a></body></html>Abstract</h1>
+<p>In the regulatory evaluation of chemical substances like plant protection products (pesticides), biocides and other chemicals, degradation data play an important role. For the evaluation of pesticide degradation experiments, detailed guidance has been developed, based on nonlinear optimisation. The <code>R</code> add-on package <code>mkin</code> <span class="citation">(Ranke 2016)</span> implements fitting some of the models recommended in this guidance from within R and calculates some statistical measures for data series within one or more compartments, for parent and metabolites.</p>
+<div class="sourceCode"><pre class="sourceCode r"><code class="sourceCode r"><span class="kw">require</span>(mkin)
+m_SFO_SFO_SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinmod.html">mkinmod</a></span>(<span class="dt">parent =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"SFO"</span>, <span class="st">"M1"</span>),
+ <span class="dt">M1 =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"SFO"</span>, <span class="st">"M2"</span>),
+ <span class="dt">M2 =</span> <span class="kw"><a href="../reference/mkinsub.html">mkinsub</a></span>(<span class="st">"SFO"</span>),
+ <span class="dt">use_of_ff =</span> <span class="st">"max"</span>, <span class="dt">quiet =</span> <span class="ot">TRUE</span>)
+
+sampling_times =<span class="st"> </span><span class="kw">c</span>(<span class="dv">0</span>, <span class="dv">1</span>, <span class="dv">3</span>, <span class="dv">7</span>, <span class="dv">14</span>, <span class="dv">28</span>, <span class="dv">60</span>, <span class="dv">90</span>, <span class="dv">120</span>)
+
+d_SFO_SFO_SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinpredict.html">mkinpredict</a></span>(m_SFO_SFO_SFO,
+ <span class="kw">c</span>(<span class="dt">k_parent =</span> <span class="fl">0.03</span>,
+ <span class="dt">f_parent_to_M1 =</span> <span class="fl">0.5</span>, <span class="dt">k_M1 =</span> <span class="kw">log</span>(<span class="dv">2</span>)/<span class="dv">100</span>,
+ <span class="dt">f_M1_to_M2 =</span> <span class="fl">0.9</span>, <span class="dt">k_M2 =</span> <span class="kw">log</span>(<span class="dv">2</span>)/<span class="dv">50</span>),
+ <span class="kw">c</span>(<span class="dt">parent =</span> <span class="dv">100</span>, <span class="dt">M1 =</span> <span class="dv">0</span>, <span class="dt">M2 =</span> <span class="dv">0</span>),
+ sampling_times)
+
+d_SFO_SFO_SFO_err &lt;-<span class="st"> </span><span class="kw"><a href="../reference/add_err.html">add_err</a></span>(d_SFO_SFO_SFO, function(x) <span class="dv">3</span>, <span class="dt">n =</span> <span class="dv">1</span>, <span class="dt">seed =</span> <span class="dv">123456789</span> )
+
+f_SFO_SFO_SFO &lt;-<span class="st"> </span><span class="kw"><a href="../reference/mkinfit.html">mkinfit</a></span>(m_SFO_SFO_SFO, d_SFO_SFO_SFO_err[[<span class="dv">1</span>]], <span class="dt">quiet =</span> <span class="ot">TRUE</span>)
+
+<span class="kw"><a href="../reference/plot.mkinfit.html">plot_sep</a></span>(f_SFO_SFO_SFO, <span class="dt">lpos =</span> <span class="kw">c</span>(<span class="st">"topright"</span>, <span class="st">"bottomright"</span>, <span class="st">"bottomright"</span>))</code></pre></div>
+<p><img src="mkin_files/figure-html/unnamed-chunk-2-1.png" width="768"></p>
+</div>
+<div id="background" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#background" class="anchor"> </a></body></html>Background</h1>
+<p>Many approaches are possible regarding the evaluation of chemical degradation data.</p>
+<p>The now deprecated <code>kinfit</code> package <span class="citation">(Ranke 2015)</span> in <code>R</code> <span class="citation">(R Development Core Team 2016)</span> implements the approach recommended in the kinetics report provided by the FOrum for Co-ordination of pesticide fate models and their USe <span class="citation">(FOCUS Work Group on Degradation Kinetics 2006; 2014)</span> for simple data series for one parent compound in one compartment.</p>
+<p>The <code>mkin</code> package <span class="citation">(Ranke 2016)</span> extends this approach to data series with transformation products, commonly termed metabolites, and to more than one compartment. It is also possible to include back reactions, so equilibrium reactions and equilibrium partitioning can be specified, although this oftentimes leads to an overparameterisation of the model.</p>
+<p>When the first <code>mkin</code> code was published in 2010, the most commonly used tools for fitting more complex kinetic degradation models to experimental data were KinGUI <span class="citation">(Sch&auml;fer et al. 2007)</span>, a MATLAB based tool with a graphical user interface that was specifically tailored to the task and included some output as proposed by the FOCUS Kinetics Workgroup, and ModelMaker, a general purpose compartment based tool providing infrastructure for fitting dynamic simulation models based on differential equations to data.</p>
+<p>The code was first uploaded to the BerliOS platform. When this was taken down, the version control history was imported into the R-Forge site, where the code is still mirrored today (see <em>e.g.</em> <a href="http://cgit.jrwb.de/mkin/commit/?id=30cbb4092f6d2d3beff5800603374a0d009ad770">the initial commit on 11 May 2010</a>).</p>
+<p>At that time, the R package <code>FME</code> (Flexible Modelling Environment) <span class="citation">(Soetaert and Petzoldt 2010)</span> was already available, and provided a good basis for developing a package specifically tailored to the task. The remaining challenge was to make it as easy as possible for the users (including the author of this vignette) to specify the system of differential equations and to include the output requested by the FOCUS guidance, such as the relative standard deviation that has to be assumed for the residuals, such that the <span class="math inline">\(\chi^2\)</span> goodness-of-fit test as defined by the FOCUS kinetics workgroup would pass using an significance level <span class="math inline">\(\alpha\)</span> of 0.05.</p>
+<p>Also, <code>mkin</code> introduced using analytical solutions for parent only kinetics for improved optimization speed. Later, Eigenvalue based solutions were introduced to <code>mkin</code> for the case of linear differential equations (<em>i.e.</em> where the FOMC or DFOP models were not used for the parent compound), greatly improving the optimization speed for these cases.</p>
+<p>The possibility to specify back-reactions and a biphasic model (SFORB) for metabolites were present in <code>mkin</code> from the very beginning.</p>
+<div id="derived-software-tools" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#derived-software-tools" class="anchor"> </a></body></html>Derived software tools</h2>
+<p>Soon after the publication of <code>mkin</code>, two derived tools were published, namely KinGUII (available from Bayer Crop Science) and CAKE (commissioned to Tessella by Syngenta), which added a graphical user interface (GUI), and added fitting by iteratively reweighted least squares (IRLS) and characterisation of likely parameter distributions by Markov Chain Monte Carlo (MCMC) sampling.</p>
+<p>CAKE focuses on a smooth use experience, sacrificing some flexibility in the model definition, originally allowing only two primary metabolites in parallel. The current version 3.2 of CAKE release in March 2016 uses a basic scheme for up to six metabolites in a flexible arrangement, but does not support back-reactions (non-instantaneous equilibria) or biphasic kinetics for metabolites.</p>
+<p>KinGUI offers an even more flexible widget for specifying complex kinetic models. Back-reactions (non-instanteneous equilibria) were supported early on, but until 2014, only simple first-order models could be specified for transformation products. Starting with KinGUII version 2.1, biphasic modelling of metabolites was also available in KinGUII.</p>
+<p>A further graphical user interface (GUI) that has recently been brought to a decent degree of maturity is the browser based GUI named <code>gmkin</code>. Please see its <a href="http://kinfit.r-forge.r-project.org/gmkin_static">documentation page</a> and <a href="http://kinfit.r-forge.r-project.org/gmkin_static/vignettes/gmkin_manual.html">manual</a> for further information.</p>
+</div>
+<div id="recent-developments" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#recent-developments" class="anchor"> </a></body></html>Recent developments</h2>
+<p>Currently (June 2016), the main features available in <code>mkin</code> which are not present in KinGUII or CAKE, are the speed increase by using compiled code when a compiler is present, parallel model fitting on multicore machines using the <code>mmkin</code> function, and the estimation of parameter confidence intervals based on transformed parameters. These are explained in more detail below.</p>
+</div>
+</div>
+<div id="internal-parameter-transformations" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#internal-parameter-transformations" class="anchor"> </a></body></html>Internal parameter transformations</h1>
+<p>For rate constants, the log transformation is used, as proposed by Bates and Watts <span class="citation">(1988, 77, 149)</span>. Approximate intervals are constructed for the transformed rate constants <span class="citation">(compare Bates and Watts 1988, 135)</span>, <em>i.e.</em> for their logarithms. Confidence intervals for the rate constants are then obtained using the appropriate backtransformation using the exponential function.</p>
+<p>In the first version of <code>mkin</code> allowing for specifying models using formation fractions, a home-made reparameterisation was used in order to ensure that the sum of formation fractions would not exceed unity.</p>
+<p>This method is still used in the current version of KinGUII (v2.1 from April 2014), with a modification that allows for fixing the pathway to sink to zero. CAKE uses penalties in the objective function in order to enforce this constraint.</p>
+<p>In 2012, an alternative reparameterisation of the formation fractions was proposed together with Ren&eacute; Lehmann <span class="citation">(Ranke and Lehmann 2012)</span>, based on isometric logratio transformation (ILR). The aim was to improve the validity of the linear approximation of the objective function during the parameter estimation procedure as well as in the subsequent calculation of parameter confidence intervals.</p>
+<div id="confidence-intervals-based-on-transformed-parameters" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#confidence-intervals-based-on-transformed-parameters" class="anchor"> </a></body></html>Confidence intervals based on transformed parameters</h2>
+<p>In the first attempt at providing improved parameter confidence intervals introduced to <code>mkin</code> in 2013, confidence intervals obtained from FME on the transformed parameters were simply all backtransformed one by one to yield asymetric confidence intervals for the backtransformed parameters.</p>
+<p>However, while there is a 1:1 relation between the rate constants in the model and the transformed parameters fitted in the model, the parameters obtained by the isometric logratio transformation are calculated from the set of formation fractions that quantify the paths to each of the compounds formed from a specific parent compound, and no such 1:1 relation exists.</p>
+<p>Therefore, parameter confidence intervals for formation fractions obtained with this method only appear valid for the case of a single transformation product, where only one formation fraction is to be estimated, directly corresponding to one component of the ilr transformed parameter.</p>
+<p>The confidence intervals obtained by backtransformation for the cases where a 1:1 relation between transformed and original parameter exist are considered by the author of this vignette to be more accurate than those obtained using a re-estimation of the Hessian matrix after backtransformation, as implemented in the FME package.</p>
+</div>
+<div id="parameter-t-test-based-on-untransformed-parameters" class="section level2">
+<h2 class="hasAnchor"><html><body><a href="#parameter-t-test-based-on-untransformed-parameters" class="anchor"> </a></body></html>Parameter t-test based on untransformed parameters</h2>
+<p>The standard output of many nonlinear regression software packages includes the results from a test for significant difference from zero for all parameters. Such a test is also recommended to check the validity of rate constants in the FOCUS guidance <span class="citation">(FOCUS Work Group on Degradation Kinetics 2014, 96ff)</span>.</p>
+<p>It has been argued that the precondition for this test, <em>i.e.</em> normal distribution of the estimator for the parameters, is not fulfilled in the case of nonlinear regression <span class="citation">(Ranke and Lehmann 2015)</span>. However, this test is commonly used by industry, consultants and national authorities in order to decide on the reliability of parameter estimates, based on the FOCUS guidance mentioned above. Therefore, the results of this one-sided t-test are included in the summary output from <code>mkin</code>.</p>
+<p>As it is not reasonable to test for significant difference of the transformed parameters (<em>e.g.</em> <span class="math inline">\(log(k)\)</span>) from zero, the t-test is calculated based on the model definition before parameter transformation, <em>i.e.</em> in a similar way as in packages that do not apply such an internal parameter transformation. A note is included in the <code>mkin</code> output, pointing to the fact that the t-test is based on the unjustified assumption of normal distribution of the parameter estimators.</p>
+</div>
+</div>
+<div id="references" class="section level1">
+<h1 class="hasAnchor"><html><body><a href="#references" class="anchor"> </a></body></html>References</h1>
+<!-- vim: set foldmethod=syntax: -->
+<div id="refs" class="references">
+<div id="ref-bates1988">
+<p>Bates, D., and D. Watts. 1988. <em>Nonlinear Regression and Its Applications</em>. Wiley-Interscience.</p>
+</div>
+<div id="ref-FOCUS2006">
+<p>FOCUS Work Group on Degradation Kinetics. 2006. <em>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</em>. <a href="http://focus.jrc.ec.europa.eu/dk" class="uri">http://focus.jrc.ec.europa.eu/dk</a>.</p>
+</div>
+<div id="ref-FOCUSkinetics2014">
+<p>&mdash;&mdash;&mdash;. 2014. <em>Generic Guidance for Estimating Persistence and Degradation Kinetics from Environmental Fate Studies on Pesticides in Eu Registration</em>. 1.1 ed. <a href="http://focus.jrc.ec.europa.eu/dk" class="uri">http://focus.jrc.ec.europa.eu/dk</a>.</p>
+</div>
+<div id="ref-rcore2016">
+<p>R Development Core Team. 2016. <em>R: A Language and Environment for Statistical Computing</em>. Vienna, Austria: R Foundation for Statistical Computing. <a href="http://www.R-project.org" class="uri">http://www.R-project.org</a>.</p>
+</div>
+<div id="ref-pkg:kinfit">
+<p>Ranke, J. 2015. <em>&lsquo;Kinfit&lsquo;: Routines for Fitting Simple Kinetic Models to Chemical Degradation Data</em>. <a href="http://CRAN.R-project.org/package=kinfit" class="uri">http://CRAN.R-project.org/package=kinfit</a>.</p>
+</div>
+<div id="ref-pkg:mkin">
+<p>&mdash;&mdash;&mdash;. 2016. <em>&lsquo;Mkin&lsquo;: Kinetic Evaluation of Chemical Degradation Data</em>. <a href="http://CRAN.R-project.org/package=mkin" class="uri">http://CRAN.R-project.org/package=mkin</a>.</p>
+</div>
+<div id="ref-ranke2012">
+<p>Ranke, J., and R. Lehmann. 2012. &ldquo;Parameter Reliability in Kinetic Evaluation of Environmental Metabolism Data - Assessment and the Influence of Model Specification.&rdquo; In <em>SETAC World 20-24 May</em>. Berlin.</p>
+</div>
+<div id="ref-ranke2015">
+<p>&mdash;&mdash;&mdash;. 2015. &ldquo;To T-Test or Not to T-Test, That Is the Question.&rdquo; In <em>XV Symposium on Pesticide Chemistry 2-4 September 2015</em>. Piacenza. <a href="http://chem.uft.uni-bremen.de/ranke/posters/piacenza_2015.pdf" class="uri">http://chem.uft.uni-bremen.de/ranke/posters/piacenza_2015.pdf</a>.</p>
+</div>
+<div id="ref-schaefer2007">
+<p>Sch&auml;fer, D., B. Mikolasch, P. Rainbird, and B. Harvey. 2007. &ldquo;KinGUI: A New Kinetic Software Tool for Evaluations According to FOCUS Degradation Kinetics.&rdquo; In <em>Proceedings of the Xiii Symposium Pesticide Chemistry</em>, edited by Del Re A. A. M., Capri E., Fragoulis G., and Trevisan M., 916&ndash;23. Piacenza.</p>
+</div>
+<div id="ref-soetaert2010">
+<p>Soetaert, Karline, and Thomas Petzoldt. 2010. &ldquo;Inverse Modelling, Sensitivity and Monte Carlo Analysis in R Using Package FME.&rdquo; <em>Journal of Statistical Software</em> 33 (3): 1&ndash;28. <a href="http://www.jstatsoft.org/v33/i03/" class="uri">http://www.jstatsoft.org/v33/i03/</a>.</p>
+</div>
+</div>
+</div>
+</div>
+ </div>
+
+ <div class="col-md-3 hidden-xs hidden-sm" id="sidebar">
+ <div id="tocnav">
+ <h2>Contents</h2>
+ <ul class="nav nav-pills nav-stacked"><li><a href="#abstract">Abstract</a></li>
+ <li><a href="#background">Background</a><ul class="nav nav-pills nav-stacked"><li><a href="#derived-software-tools">Derived software tools</a></li>
+ <li><a href="#recent-developments">Recent developments</a></li>
+ </ul></li>
+ <li><a href="#internal-parameter-transformations">Internal parameter transformations</a><ul class="nav nav-pills nav-stacked"><li><a href="#confidence-intervals-based-on-transformed-parameters">Confidence intervals based on transformed parameters</a></li>
+ <li><a href="#parameter-t-test-based-on-untransformed-parameters">Parameter t-test based on untransformed parameters</a></li>
+ </ul></li>
+ <li><a href="#references">References</a></li>
+ </ul></div>
+ </div>
+
+</div>
+
+
+ <footer><div class="copyright">
+ <p>Developed by Johannes Ranke, Eurofins Regulatory AG.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="http://hadley.github.io/pkgdown/">pkgdown</a>.</p>
+</div>
+
+ </footer></div>
+
+ </body></html>
diff --git a/docs/articles/mkin_cache/html/__packages b/docs/articles/mkin_cache/html/__packages
new file mode 100644
index 00000000..c8b1e877
--- /dev/null
+++ b/docs/articles/mkin_cache/html/__packages
@@ -0,0 +1,8 @@
+base
+knitr
+minpack.lm
+rootSolve
+inline
+mkin
+microbenchmark
+ggplot2
diff --git a/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.RData b/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.RData
new file mode 100644
index 00000000..8fd3567d
--- /dev/null
+++ b/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.RData
Binary files differ
diff --git a/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdb b/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdb
new file mode 100644
index 00000000..7f4d6c92
--- /dev/null
+++ b/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdb
Binary files differ
diff --git a/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdx b/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdx
new file mode 100644
index 00000000..7f5f16b7
--- /dev/null
+++ b/docs/articles/mkin_cache/html/unnamed-chunk-2_f17bce9fa804585d9877abdce3dac24a.rdx
Binary files differ
diff --git a/docs/articles/mkin_files/figure-html/unnamed-chunk-2-1.png b/docs/articles/mkin_files/figure-html/unnamed-chunk-2-1.png
new file mode 100644
index 00000000..d34e3805
--- /dev/null
+++ b/docs/articles/mkin_files/figure-html/unnamed-chunk-2-1.png
Binary files differ
diff --git a/docs/articles/mkin_vignettes.css b/docs/articles/mkin_vignettes.css
new file mode 100644
index 00000000..3bd91ab1
--- /dev/null
+++ b/docs/articles/mkin_vignettes.css
@@ -0,0 +1,16 @@
+/* Thanks to Steve Powell for http://rpubs.com/stevepowell99/floating-css */
+#TOC {
+ position: fixed;
+ left: 0;
+ top: 0;
+ width: 200px;
+ height: 100%;
+ overflow:auto;
+}
+
+body {
+ max-width: 800px;
+ margin: auto;
+ margin-left:210px;
+ line-height: 20px;
+}
diff --git a/docs/articles/references.bib b/docs/articles/references.bib
new file mode 100644
index 00000000..da51602f
--- /dev/null
+++ b/docs/articles/references.bib
@@ -0,0 +1,112 @@
+% This file was originally created with JabRef 2.7b.
+% Encoding: ISO8859_1
+
+@BOOK{bates1988,
+ title = {Nonlinear regression and its applications},
+ publisher = {Wiley-Interscience},
+ year = {1988},
+ author = {D. Bates and D. Watts}
+}
+
+@MANUAL{FOCUSkinetics2011,
+ title = {Generic guidance for estimating persistence and degradation kinetics
+ from environmental fate studies on pesticides in EU registration},
+ author = {{FOCUS Work Group on Degradation Kinetics}},
+ edition = {1.0},
+ month = {November},
+ year = {2011},
+ file = {FOCUS kinetics 2011 Generic guidance:/home/ranke/dok/orgs/focus/FOCUSkineticsvc_1_0_Nov23.pdf:PDF},
+ url = {http://focus.jrc.ec.europa.eu/dk}
+}
+
+@MANUAL{FOCUSkinetics2014,
+ title = {Generic guidance for estimating persistence and degradation kinetics
+ from environmental fate studies on pesticides in EU registration},
+ author = {{FOCUS Work Group on Degradation Kinetics}},
+ edition = {1.1},
+ month = {December},
+ year = {2014},
+ file = {FOCUS kinetics 2011 Generic guidance:/home/ranke/dok/orgs/focus/FOCUSkineticsvc_1_0_Nov23.pdf:PDF},
+ url = {http://focus.jrc.ec.europa.eu/dk}
+}
+
+@MANUAL{FOCUS2006,
+ title = {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},
+ author = {{FOCUS Work Group on Degradation Kinetics}},
+ year = {2006},
+ note = {EC Document Reference Sanco/10058/2005 version 2.0},
+ url = {http://focus.jrc.ec.europa.eu/dk}
+}
+
+@MANUAL{rcore2016,
+ title = {\textsf{R}: A Language and Environment for Statistical Computing},
+ author = {{R Development Core Team}},
+ organization = {R Foundation for Statistical Computing},
+ address = {Vienna, Austria},
+ year = {2016},
+ note = {{ISBN} 3-900051-07-0},
+ url = {http://www.R-project.org}
+}
+
+@MANUAL{pkg:kinfit,
+ title = {`kinfit`: {R}outines for fitting simple kinetic models to chemical
+ degradation data},
+ author = {J. Ranke},
+ year = {2015},
+ url = {http://CRAN.R-project.org/package=kinfit}
+}
+
+@MANUAL{pkg:mkin,
+ title = {`mkin`: {K}inetic evaluation of chemical degradation data},
+ author = {J. Ranke},
+ year = {2016},
+ url = {http://CRAN.R-project.org/package=mkin}
+}
+
+@Inproceedings{ schaefer2007,
+ title = {{KinGUI}: a new kinetic software tool for evaluations according to {FOCUS} degradation kinetics},
+ author = {D. Sch\"{a}fer and B. Mikolasch and P. Rainbird and B. Harvey},
+ booktitle = {Proceedings of the XIII Symposium Pesticide Chemistry},
+ editor = {Del Re A. A. M. and Capri E. and Fragoulis G. and Trevisan M.},
+ year = {2007},
+ address = {Piacenza},
+ pages = {916--923}
+}
+
+@ARTICLE{soetaert2010,
+ author = {Karline Soetaert and Thomas Petzoldt},
+ title = {Inverse Modelling, Sensitivity and Monte Carlo Analysis in {R} Using
+ Package {FME}},
+ journal = {Journal of Statistical Software},
+ year = {2010},
+ volume = {33},
+ pages = {1--28},
+ number = {3},
+ url = {http://www.jstatsoft.org/v33/i03/}
+}
+
+@Inproceedings{ ranke2012,
+ title = {Parameter reliability in kinetic evaluation of environmental metabolism data - Assessment and the influence of model specification},
+ author = {J. Ranke and R. Lehmann},
+ booktitle = {SETAC World 20-24 May},
+ year = {2012},
+ address = {Berlin}
+}
+@Inproceedings{ ranke2015,
+ title = {To t-test or not to t-test, that is the question},
+ author = {J. Ranke and R. Lehmann},
+ booktitle = {XV Symposium on Pesticide Chemistry 2-4 September 2015},
+ year = {2015},
+ address = {Piacenza},
+ url = {http://chem.uft.uni-bremen.de/ranke/posters/piacenza_2015.pdf}
+}
+@Techreport{ranke2014,
+ title = {{Prüfung und Validierung von Modellierungssoftware als Alternative zu
+ ModelMaker 4.0}},
+ author = {J. Ranke},
+ year = 2014,
+ institution = {Umweltbundesamt},
+ volume = {Projektnummer 27452}
+}

Contact - Imprint