From 524a8bba89b95840b4e9215c403947a8bb76d7b2 Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Mon, 30 Nov 2020 16:05:10 +0100 Subject: Complete rebuild of static docs of dev version --- docs/dev/articles/FOCUS_D.html | 12 +- docs/dev/articles/FOCUS_L.html | 44 +-- docs/dev/articles/mkin.html | 2 +- docs/dev/articles/twa.html | 2 +- docs/dev/articles/web_only/FOCUS_Z.html | 76 ++--- docs/dev/articles/web_only/NAFTA_examples.html | 2 +- docs/dev/articles/web_only/benchmarks.html | 48 +-- docs/dev/articles/web_only/compiled_models.html | 28 +- docs/dev/pkgdown.yml | 2 +- docs/dev/reference/CAKE_export.html | 41 +-- docs/dev/reference/D24_2014.html | 8 +- docs/dev/reference/FOCUS_2006_DFOP_ref_A_to_B.html | 13 +- docs/dev/reference/FOCUS_2006_FOMC_ref_A_to_F.html | 13 +- docs/dev/reference/FOCUS_2006_HS_ref_A_to_F.html | 13 +- docs/dev/reference/FOCUS_2006_SFO_ref_A_to_F.html | 13 +- docs/dev/reference/FOCUS_2006_datasets.html | 23 +- docs/dev/reference/NAFTA_SOP_2015-1.png | Bin 41379 -> 64838 bytes docs/dev/reference/NAFTA_SOP_2015.html | 37 +-- docs/dev/reference/NAFTA_SOP_Attachment-1.png | Bin 42204 -> 66148 bytes docs/dev/reference/NAFTA_SOP_Attachment.html | 37 +-- docs/dev/reference/Rplot001.png | Bin 14324 -> 14180 bytes docs/dev/reference/Rplot002.png | Bin 56035 -> 13753 bytes docs/dev/reference/Rplot003.png | Bin 55725 -> 28735 bytes docs/dev/reference/Rplot004.png | Bin 57095 -> 49269 bytes docs/dev/reference/Rplot008.png | Bin 11762 -> 0 bytes docs/dev/reference/Rplot009.png | Bin 21414 -> 0 bytes docs/dev/reference/Rplot010.png | Bin 5643 -> 0 bytes docs/dev/reference/Rplot011.png | Bin 26192 -> 0 bytes docs/dev/reference/Rplot012.png | Bin 23686 -> 0 bytes docs/dev/reference/Rplot013.png | Bin 23097 -> 0 bytes docs/dev/reference/Rplot014.png | Bin 18299 -> 0 bytes docs/dev/reference/Rplot015.png | Bin 23097 -> 0 bytes docs/dev/reference/add_err.html | 2 +- docs/dev/reference/aw.html | 29 +- docs/dev/reference/confint.mkinfit.html | 14 +- docs/dev/reference/create_deg_func.html | 20 +- docs/dev/reference/dot-plot_mixed.html | 203 ------------- docs/dev/reference/experimental_data_for_UBA.html | 28 +- docs/dev/reference/loftest-1.png | Bin 27354 -> 41288 bytes docs/dev/reference/loftest-2.png | Bin 27721 -> 40668 bytes docs/dev/reference/loftest-3.png | Bin 78754 -> 78452 bytes docs/dev/reference/loftest-4.png | Bin 76899 -> 76132 bytes docs/dev/reference/loftest-5.png | Bin 75806 -> 74691 bytes docs/dev/reference/loftest.html | 88 +++--- docs/dev/reference/logLik.mkinfit.html | 6 +- docs/dev/reference/logistic.solution.html | 2 +- docs/dev/reference/lrtest.mkinfit.html | 32 +- docs/dev/reference/mccall81_245T.html | 4 +- docs/dev/reference/mkin_long_to_wide.html | 16 +- docs/dev/reference/mkin_wide_to_long.html | 18 +- docs/dev/reference/mkinerrmin.html | 28 +- docs/dev/reference/mkinerrplot.html | 4 +- docs/dev/reference/mkinfit.html | 30 +- docs/dev/reference/mkinmod.html | 91 +++--- docs/dev/reference/mkinparplot.html | 8 +- docs/dev/reference/mkinplot.html | 13 +- docs/dev/reference/mkinpredict.html | 8 +- docs/dev/reference/mkinresplot.html | 4 +- docs/dev/reference/mkinsub.html | 234 -------------- docs/dev/reference/mmkin.html | 20 +- docs/dev/reference/nlme-2.png | Bin 89236 -> 89493 bytes docs/dev/reference/nlme.html | 7 +- docs/dev/reference/nlme.mmkin-1.png | Bin 119655 -> 122068 bytes docs/dev/reference/nlme.mmkin-2.png | Bin 159253 -> 160690 bytes docs/dev/reference/nlme.mmkin-3.png | Bin 158883 -> 161800 bytes docs/dev/reference/nlme.mmkin-4.png | Bin 162990 -> 0 bytes docs/dev/reference/nlme.mmkin-5.png | Bin 81513 -> 0 bytes docs/dev/reference/nlme.mmkin-6.png | Bin 80989 -> 0 bytes docs/dev/reference/nlme.mmkin-7.png | Bin 81584 -> 0 bytes docs/dev/reference/nlme.mmkin.html | 184 +++++------ docs/dev/reference/nobs.mkinfit.html | 10 +- docs/dev/reference/plot.mixed.mmkin-2.png | Bin 164488 -> 163684 bytes docs/dev/reference/plot.mixed.mmkin.html | 10 +- docs/dev/reference/plot.mkinfit.html | 6 +- docs/dev/reference/plot.nafta.html | 13 +- docs/dev/reference/plot.nlme.mmkin-1.png | Bin 86076 -> 0 bytes docs/dev/reference/plot.nlme.mmkin-2.png | Bin 164488 -> 0 bytes docs/dev/reference/plot.nlme.mmkin.html | 302 ------------------ docs/dev/reference/plot.saem.mmkin-1.png | Bin 86076 -> 0 bytes docs/dev/reference/plot.saem.mmkin-2.png | Bin 164014 -> 0 bytes docs/dev/reference/plot.saem.mmkin.html | 308 ------------------- docs/dev/reference/plot_mixed-1.png | Bin 86076 -> 0 bytes docs/dev/reference/plot_mixed-2.png | Bin 164488 -> 0 bytes docs/dev/reference/plot_mixed-3.png | Bin 164014 -> 0 bytes docs/dev/reference/plot_mixed.html | 336 --------------------- docs/dev/reference/print.mkinds.html | 194 ------------ docs/dev/reference/print.mkinmod.html | 217 ------------- docs/dev/reference/residuals.mkinfit.html | 20 +- docs/dev/reference/saem.html | 52 ++-- docs/dev/reference/saemix-1.png | Bin 46062 -> 0 bytes docs/dev/reference/saemix-10.png | Bin 17011 -> 0 bytes docs/dev/reference/saemix-11.png | Bin 64787 -> 0 bytes docs/dev/reference/saemix-12.png | Bin 59464 -> 0 bytes docs/dev/reference/saemix-13.png | Bin 7742 -> 0 bytes docs/dev/reference/saemix-2.png | Bin 47804 -> 0 bytes docs/dev/reference/saemix-3.png | Bin 40694 -> 0 bytes docs/dev/reference/saemix-4.png | Bin 38144 -> 0 bytes docs/dev/reference/saemix-5.png | Bin 39988 -> 0 bytes docs/dev/reference/saemix-6.png | Bin 39720 -> 0 bytes docs/dev/reference/saemix-7.png | Bin 7742 -> 0 bytes docs/dev/reference/saemix-8.png | Bin 35501 -> 0 bytes docs/dev/reference/saemix-9.png | Bin 7742 -> 0 bytes docs/dev/reference/schaefer07_complex_case-1.png | Bin 67741 -> 67659 bytes docs/dev/reference/schaefer07_complex_case.html | 42 +-- docs/dev/reference/summary.mkinfit.html | 8 +- docs/dev/reference/summary.nlme.mmkin.html | 230 +++++++------- docs/dev/reference/summary.saem.mmkin-1.png | Bin 7742 -> 0 bytes docs/dev/reference/summary.saem.mmkin.html | 14 +- .../reference/synthetic_data_for_UBA_2014-1.png | Bin 70430 -> 70005 bytes .../dev/reference/synthetic_data_for_UBA_2014.html | 224 +++++++------- docs/dev/reference/test_data_from_UBA_2014-1.png | Bin 59294 -> 59592 bytes docs/dev/reference/test_data_from_UBA_2014-2.png | Bin 78194 -> 76645 bytes docs/dev/reference/test_data_from_UBA_2014.html | 76 +++-- docs/dev/reference/transform_odeparms.html | 8 +- docs/dev/reference/update.mkinfit-1.png | Bin 28678 -> 43366 bytes docs/dev/reference/update.mkinfit-2.png | Bin 28541 -> 44304 bytes docs/dev/reference/update.mkinfit.html | 24 +- 117 files changed, 949 insertions(+), 2652 deletions(-) delete mode 100644 docs/dev/reference/Rplot008.png delete mode 100644 docs/dev/reference/Rplot009.png delete mode 100644 docs/dev/reference/Rplot010.png delete mode 100644 docs/dev/reference/Rplot011.png delete mode 100644 docs/dev/reference/Rplot012.png delete mode 100644 docs/dev/reference/Rplot013.png delete mode 100644 docs/dev/reference/Rplot014.png delete mode 100644 docs/dev/reference/Rplot015.png delete mode 100644 docs/dev/reference/dot-plot_mixed.html delete mode 100644 docs/dev/reference/mkinsub.html delete mode 100644 docs/dev/reference/nlme.mmkin-4.png delete mode 100644 docs/dev/reference/nlme.mmkin-5.png delete mode 100644 docs/dev/reference/nlme.mmkin-6.png delete mode 100644 docs/dev/reference/nlme.mmkin-7.png delete mode 100644 docs/dev/reference/plot.nlme.mmkin-1.png delete mode 100644 docs/dev/reference/plot.nlme.mmkin-2.png delete mode 100644 docs/dev/reference/plot.nlme.mmkin.html delete mode 100644 docs/dev/reference/plot.saem.mmkin-1.png delete mode 100644 docs/dev/reference/plot.saem.mmkin-2.png delete mode 100644 docs/dev/reference/plot.saem.mmkin.html delete mode 100644 docs/dev/reference/plot_mixed-1.png delete mode 100644 docs/dev/reference/plot_mixed-2.png delete mode 100644 docs/dev/reference/plot_mixed-3.png delete mode 100644 docs/dev/reference/plot_mixed.html delete mode 100644 docs/dev/reference/print.mkinds.html delete mode 100644 docs/dev/reference/print.mkinmod.html delete mode 100644 docs/dev/reference/saemix-1.png delete mode 100644 docs/dev/reference/saemix-10.png delete mode 100644 docs/dev/reference/saemix-11.png delete mode 100644 docs/dev/reference/saemix-12.png delete mode 100644 docs/dev/reference/saemix-13.png delete mode 100644 docs/dev/reference/saemix-2.png delete mode 100644 docs/dev/reference/saemix-3.png delete mode 100644 docs/dev/reference/saemix-4.png delete mode 100644 docs/dev/reference/saemix-5.png delete mode 100644 docs/dev/reference/saemix-6.png delete mode 100644 docs/dev/reference/saemix-7.png delete mode 100644 docs/dev/reference/saemix-8.png delete mode 100644 docs/dev/reference/saemix-9.png delete mode 100644 docs/dev/reference/summary.saem.mmkin-1.png (limited to 'docs') diff --git a/docs/dev/articles/FOCUS_D.html b/docs/dev/articles/FOCUS_D.html index e526b3a7..dd86f677 100644 --- a/docs/dev/articles/FOCUS_D.html +++ b/docs/dev/articles/FOCUS_D.html @@ -102,7 +102,7 @@

Example evaluation of FOCUS Example Dataset D

Johannes Ranke

-

2020-11-19

+

2020-11-30

Source: vignettes/FOCUS_D.rmd @@ -163,8 +163,8 @@

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.

The call to mkinmod returns a degradation model. The differential equations represented in R code can be found in the character vector $diffs of the mkinmod object. If a C compiler (gcc) is installed and functional, the differential equation model will be compiled from auto-generated C code.

-SFO_SFO <- mkinmod(parent = mkinsub("SFO", "m1"), m1 = mkinsub("SFO"))
-
## Successfully compiled differential equation model from auto-generated C code.
+SFO_SFO <- mkinmod(parent = mkinsub("SFO", "m1"), m1 = mkinsub("SFO")) +
## Temporary DLL for differentials generated and loaded
 print(SFO_SFO$diffs)
##                                                    parent 
@@ -189,8 +189,8 @@
 summary(fit)
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:06 2020 
-## Date of summary: Thu Nov 19 15:00:06 2020 
+## Date of fit:     Mon Nov 30 16:01:50 2020 
+## Date of summary: Mon Nov 30 16:01:50 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - k_parent * parent
@@ -198,7 +198,7 @@
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 401 model solutions performed in 0.188 s
+## Fitted using 401 model solutions performed in 0.161 s
 ## 
 ## Error model: Constant variance 
 ## 
diff --git a/docs/dev/articles/FOCUS_L.html b/docs/dev/articles/FOCUS_L.html
index 1fbe5c76..2695db5e 100644
--- a/docs/dev/articles/FOCUS_L.html
+++ b/docs/dev/articles/FOCUS_L.html
@@ -102,7 +102,7 @@
       

Example evaluation of FOCUS Laboratory Data L1 to L3

Johannes Ranke

-

2020-11-19

+

2020-11-30

Source: vignettes/FOCUS_L.rmd @@ -130,15 +130,15 @@ summary(m.L1.SFO)
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:09 2020 
-## Date of summary: Thu Nov 19 15:00:09 2020 
+## Date of fit:     Mon Nov 30 16:01:52 2020 
+## Date of summary: Mon Nov 30 16:01:52 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - k_parent * parent
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 133 model solutions performed in 0.034 s
+## Fitted using 133 model solutions performed in 0.032 s
 ## 
 ## Error model: Constant variance 
 ## 
@@ -236,15 +236,15 @@
 ## doubtful
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:09 2020 
-## Date of summary: Thu Nov 19 15:00:09 2020 
+## Date of fit:     Mon Nov 30 16:01:53 2020 
+## Date of summary: Mon Nov 30 16:01:53 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - (alpha/beta) * 1/((time/beta) + 1) * parent
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 380 model solutions performed in 0.085 s
+## Fitted using 380 model solutions performed in 0.087 s
 ## 
 ## Error model: Constant variance 
 ## 
@@ -348,15 +348,15 @@
 summary(m.L2.FOMC, data = FALSE)
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:10 2020 
-## Date of summary: Thu Nov 19 15:00:10 2020 
+## Date of fit:     Mon Nov 30 16:01:54 2020 
+## Date of summary: Mon Nov 30 16:01:54 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - (alpha/beta) * 1/((time/beta) + 1) * parent
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 239 model solutions performed in 0.051 s
+## Fitted using 239 model solutions performed in 0.05 s
 ## 
 ## Error model: Constant variance 
 ## 
@@ -429,8 +429,8 @@
 summary(m.L2.DFOP, data = FALSE)
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:10 2020 
-## Date of summary: Thu Nov 19 15:00:10 2020 
+## Date of fit:     Mon Nov 30 16:01:54 2020 
+## Date of summary: Mon Nov 30 16:01:54 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - ((k1 * g * exp(-k1 * time) + k2 * (1 - g) * exp(-k2 *
@@ -439,7 +439,7 @@
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 581 model solutions performed in 0.138 s
+## Fitted using 581 model solutions performed in 0.136 s
 ## 
 ## Error model: Constant variance 
 ## 
@@ -535,8 +535,8 @@
 summary(mm.L3[["DFOP", 1]])
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:11 2020 
-## Date of summary: Thu Nov 19 15:00:11 2020 
+## Date of fit:     Mon Nov 30 16:01:55 2020 
+## Date of summary: Mon Nov 30 16:01:55 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - ((k1 * g * exp(-k1 * time) + k2 * (1 - g) * exp(-k2 *
@@ -545,7 +545,7 @@
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 376 model solutions performed in 0.083 s
+## Fitted using 376 model solutions performed in 0.081 s
 ## 
 ## Error model: Constant variance 
 ## 
@@ -648,15 +648,15 @@
 summary(mm.L4[["SFO", 1]], data = FALSE)
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:12 2020 
-## Date of summary: Thu Nov 19 15:00:12 2020 
+## Date of fit:     Mon Nov 30 16:01:55 2020 
+## Date of summary: Mon Nov 30 16:01:55 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - k_parent * parent
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 142 model solutions performed in 0.031 s
+## Fitted using 142 model solutions performed in 0.03 s
 ## 
 ## Error model: Constant variance 
 ## 
@@ -713,15 +713,15 @@
 summary(mm.L4[["FOMC", 1]], data = FALSE)
## mkin version used for fitting:    0.9.50.4 
 ## R version used for fitting:       4.0.3 
-## Date of fit:     Thu Nov 19 15:00:12 2020 
-## Date of summary: Thu Nov 19 15:00:12 2020 
+## Date of fit:     Mon Nov 30 16:01:55 2020 
+## Date of summary: Mon Nov 30 16:01:56 2020 
 ## 
 ## Equations:
 ## d_parent/dt = - (alpha/beta) * 1/((time/beta) + 1) * parent
 ## 
 ## Model predictions using solution type analytical 
 ## 
-## Fitted using 224 model solutions performed in 0.05 s
+## Fitted using 224 model solutions performed in 0.045 s
 ## 
 ## Error model: Constant variance 
 ## 
diff --git a/docs/dev/articles/mkin.html b/docs/dev/articles/mkin.html
index 75e53bbd..2de8b9f0 100644
--- a/docs/dev/articles/mkin.html
+++ b/docs/dev/articles/mkin.html
@@ -102,7 +102,7 @@
       

Introduction to mkin

Johannes Ranke

-

2020-11-27

+

2020-11-30

Source: vignettes/mkin.rmd diff --git a/docs/dev/articles/twa.html b/docs/dev/articles/twa.html index d778b773..42ed6fa5 100644 --- a/docs/dev/articles/twa.html +++ b/docs/dev/articles/twa.html @@ -102,7 +102,7 @@

Calculation of time weighted average concentrations with mkin

Johannes Ranke

-

2020-11-19

+

2020-11-30

Source: vignettes/twa.rmd diff --git a/docs/dev/articles/web_only/FOCUS_Z.html b/docs/dev/articles/web_only/FOCUS_Z.html index 4cfe6c31..15c41eb7 100644 --- a/docs/dev/articles/web_only/FOCUS_Z.html +++ b/docs/dev/articles/web_only/FOCUS_Z.html @@ -102,7 +102,7 @@

Example evaluation of FOCUS dataset Z

Johannes Ranke

-

2020-11-19

+

2020-11-30

Source: vignettes/web_only/FOCUS_Z.rmd @@ -138,9 +138,9 @@ Parent 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).

-Z.2a <- mkinmod(Z0 = mkinsub("SFO", "Z1"),
-                Z1 = mkinsub("SFO"))
-
## Successfully compiled differential equation model from auto-generated C code.
+Z.2a <- mkinmod(Z0 = mkinsub("SFO", "Z1"), + Z1 = mkinsub("SFO"))
+
## Temporary DLL for differentials generated and loaded
 m.Z.2a <- mkinfit(Z.2a, FOCUS_2006_Z_mkin, quiet = TRUE)
## Warning in mkinfit(Z.2a, FOCUS_2006_Z_mkin, quiet = TRUE): Observations with
@@ -159,10 +159,10 @@
 

As obvious from the parameter summary (the component of the summary), the kinetic rate constant from parent compound Z to sink is very small and the t-test for this parameter suggests that it is not significantly different from zero. 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:

-Z.2a.ff <- mkinmod(Z0 = mkinsub("SFO", "Z1"),
-                   Z1 = mkinsub("SFO"),
+Z.2a.ff <- mkinmod(Z0 = mkinsub("SFO", "Z1"),
+                   Z1 = mkinsub("SFO"),
                    use_of_ff = "max")
-
## Successfully compiled differential equation model from auto-generated C code.
+
## Temporary DLL for differentials generated and loaded
 m.Z.2a.ff <- mkinfit(Z.2a.ff, FOCUS_2006_Z_mkin, quiet = TRUE)
## Warning in mkinfit(Z.2a.ff, FOCUS_2006_Z_mkin, quiet = TRUE): Observations with
@@ -182,9 +182,9 @@
 

A simplified model is obtained by removing the pathway to the sink.

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.

-Z.3 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
-               Z1 = mkinsub("SFO"), use_of_ff = "max")
-
## Successfully compiled differential equation model from auto-generated C code.
+Z.3 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE), + Z1 = mkinsub("SFO"), use_of_ff = "max")
+
## Temporary DLL for differentials generated and loaded
 m.Z.3 <- mkinfit(Z.3, FOCUS_2006_Z_mkin, quiet = TRUE)
## Warning in mkinfit(Z.3, FOCUS_2006_Z_mkin, quiet = TRUE): Observations with
@@ -206,10 +206,10 @@
 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.

-Z.5 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
-               Z1 = mkinsub("SFO", "Z2", sink = FALSE),
-               Z2 = mkinsub("SFO"), use_of_ff = "max")
-
## Successfully compiled differential equation model from auto-generated C code.
+Z.5 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE), + Z1 = mkinsub("SFO", "Z2", sink = FALSE), + Z2 = mkinsub("SFO"), use_of_ff = "max")
+
## Temporary DLL for differentials generated and loaded
 m.Z.5 <- mkinfit(Z.5, FOCUS_2006_Z_mkin, quiet = TRUE)
## Warning in mkinfit(Z.5, FOCUS_2006_Z_mkin, quiet = TRUE): Observations with
@@ -219,12 +219,12 @@
 

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.

-Z.FOCUS <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
-                   Z1 = mkinsub("SFO", "Z2", sink = FALSE),
-                   Z2 = mkinsub("SFO", "Z3"),
-                   Z3 = mkinsub("SFO"),
+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")
-
## Successfully compiled differential equation model from auto-generated C code.
+
## Temporary DLL for differentials generated and loaded
 m.Z.FOCUS <- mkinfit(Z.FOCUS, FOCUS_2006_Z_mkin,
                      parms.ini = m.Z.5$bparms.ode,
@@ -266,11 +266,11 @@
 

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.

-Z.mkin.1 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE),
-                    Z1 = mkinsub("SFO", "Z2", sink = FALSE),
-                    Z2 = mkinsub("SFO", "Z3"),
-                    Z3 = mkinsub("SFORB"))
-
## Successfully compiled differential equation model from auto-generated C code.
+Z.mkin.1 <- mkinmod(Z0 = mkinsub("SFO", "Z1", sink = FALSE), + Z1 = mkinsub("SFO", "Z2", sink = FALSE), + Z2 = mkinsub("SFO", "Z3"), + Z3 = mkinsub("SFORB"))
+
## Temporary DLL for differentials generated and loaded
 m.Z.mkin.1 <- mkinfit(Z.mkin.1, FOCUS_2006_Z_mkin, quiet = TRUE)
## Warning in mkinfit(Z.mkin.1, FOCUS_2006_Z_mkin, quiet = TRUE): Observations with
@@ -283,10 +283,10 @@
 
## NULL

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.

-Z.mkin.3 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
-                    Z1 = mkinsub("SFO", "Z2", sink = FALSE),
-                    Z2 = mkinsub("SFO"))
-
## Successfully compiled differential equation model from auto-generated C code.
+Z.mkin.3 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE), + Z1 = mkinsub("SFO", "Z2", sink = FALSE), + Z2 = mkinsub("SFO"))
+
## Temporary DLL for differentials generated and loaded
 m.Z.mkin.3 <- mkinfit(Z.mkin.3, FOCUS_2006_Z_mkin, quiet = TRUE)
## Warning in mkinfit(Z.mkin.3, FOCUS_2006_Z_mkin, quiet = TRUE): Observations with
@@ -297,11 +297,11 @@
 

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.

-Z.mkin.4 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
-                    Z1 = mkinsub("SFO", "Z2", sink = FALSE),
-                    Z2 = mkinsub("SFO", "Z3"),
-                    Z3 = mkinsub("SFO"))
-
## Successfully compiled differential equation model from auto-generated C code.
+Z.mkin.4 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE), + Z1 = mkinsub("SFO", "Z2", sink = FALSE), + Z2 = mkinsub("SFO", "Z3"), + Z3 = mkinsub("SFO"))
+
## Temporary DLL for differentials generated and loaded
 m.Z.mkin.4 <- mkinfit(Z.mkin.4, FOCUS_2006_Z_mkin,
                       parms.ini = m.Z.mkin.3$bparms.ode,
@@ -313,11 +313,11 @@
 

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.

-Z.mkin.5 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE),
-                    Z1 = mkinsub("SFO", "Z2", sink = FALSE),
-                    Z2 = mkinsub("SFO", "Z3"),
-                    Z3 = mkinsub("SFORB"))
-
## Successfully compiled differential equation model from auto-generated C code.
+Z.mkin.5 <- mkinmod(Z0 = mkinsub("SFORB", "Z1", sink = FALSE), + Z1 = mkinsub("SFO", "Z2", sink = FALSE), + Z2 = mkinsub("SFO", "Z3"), + Z3 = mkinsub("SFORB"))
+
## Temporary DLL for differentials generated and loaded
 m.Z.mkin.5 <- mkinfit(Z.mkin.5, FOCUS_2006_Z_mkin,
                       parms.ini = m.Z.mkin.4$bparms.ode[1:4],
diff --git a/docs/dev/articles/web_only/NAFTA_examples.html b/docs/dev/articles/web_only/NAFTA_examples.html
index c3192b37..fca15672 100644
--- a/docs/dev/articles/web_only/NAFTA_examples.html
+++ b/docs/dev/articles/web_only/NAFTA_examples.html
@@ -102,7 +102,7 @@
       

Evaluation of example datasets from Attachment 1 to the US EPA SOP for the NAFTA guidance

Johannes Ranke

-

2020-11-19

+

2020-11-30

Source: vignettes/web_only/NAFTA_examples.rmd diff --git a/docs/dev/articles/web_only/benchmarks.html b/docs/dev/articles/web_only/benchmarks.html index ff70847e..8e157c0f 100644 --- a/docs/dev/articles/web_only/benchmarks.html +++ b/docs/dev/articles/web_only/benchmarks.html @@ -102,7 +102,7 @@

Benchmark timings for mkin

Johannes Ranke

-

2020-11-19

+

2020-11-30

Source: vignettes/web_only/benchmarks.rmd @@ -127,14 +127,14 @@

One metabolite:

 SFO_SFO <- mkinmod(
-  parent = mkinsub("SFO", "m1"),
-  m1 = mkinsub("SFO"))
+  parent = mkinsub("SFO", "m1"),
+  m1 = mkinsub("SFO"))
 FOMC_SFO <- mkinmod(
-  parent = mkinsub("FOMC", "m1"),
-  m1 = mkinsub("SFO"))
+  parent = mkinsub("FOMC", "m1"),
+  m1 = mkinsub("SFO"))
 DFOP_SFO <- mkinmod(
-  parent = mkinsub("FOMC", "m1"),
-  m1 = mkinsub("SFO"))
+  parent = mkinsub("FOMC", "m1"),
+  m1 = mkinsub("SFO"))
 t3 <- system.time(mmkin_bench(list(SFO_SFO, FOMC_SFO, DFOP_SFO), list(FOCUS_D)))[["elapsed"]]
 t4 <- system.time(mmkin_bench(list(SFO_SFO, FOMC_SFO, DFOP_SFO), list(FOCUS_D),
     error_model = "tc"))[["elapsed"]]
@@ -148,14 +148,14 @@ error_model = "obs"))[["elapsed"]]

Two metabolites, synthetic data:

-m_synth_SFO_lin <- mkinmod(parent = mkinsub("SFO", "M1"),
-                           M1 = mkinsub("SFO", "M2"),
-                           M2 = mkinsub("SFO"),
+m_synth_SFO_lin <- mkinmod(parent = mkinsub("SFO", "M1"),
+                           M1 = mkinsub("SFO", "M2"),
+                           M2 = mkinsub("SFO"),
                            use_of_ff = "max", quiet = TRUE)
 
-m_synth_DFOP_par <- mkinmod(parent = mkinsub("DFOP", c("M1", "M2")),
-                           M1 = mkinsub("SFO"),
-                           M2 = mkinsub("SFO"),
+m_synth_DFOP_par <- mkinmod(parent = mkinsub("DFOP", c("M1", "M2")),
+                           M1 = mkinsub("SFO"),
+                           M2 = mkinsub("SFO"),
                            use_of_ff = "max", quiet = TRUE)
 
 SFO_lin_a <- synthetic_data_for_UBA_2014[[1]]$data
@@ -232,8 +232,8 @@
 
 
 0.9.50.4
-1.702
-3.717
+1.786
+3.729
 
 
 
@@ -294,9 +294,9 @@
 
 
 0.9.50.4
-1.355
-7.015
-2.729
+1.397
+7.251
+2.810
 
 
 
@@ -381,12 +381,12 @@
 
 
 0.9.50.4
-0.759
-1.245
-1.436
-3.687
-1.886
-3.028
+0.783
+1.282
+1.486
+3.815
+1.958
+3.105
 
 
 
diff --git a/docs/dev/articles/web_only/compiled_models.html b/docs/dev/articles/web_only/compiled_models.html
index 3d1c7fcd..a444f4bc 100644
--- a/docs/dev/articles/web_only/compiled_models.html
+++ b/docs/dev/articles/web_only/compiled_models.html
@@ -102,7 +102,7 @@
       

Performance benefit by using compiled model definitions in mkin

Johannes Ranke

-

2020-11-19

+

2020-11-30

Source: vignettes/web_only/compiled_models.rmd @@ -134,9 +134,9 @@
 library("mkin", quietly = TRUE)
 SFO_SFO <- mkinmod(
-  parent = mkinsub("SFO", "m1"),
-  m1 = mkinsub("SFO"))
-
## Successfully compiled differential equation model from auto-generated C code.
+ parent = mkinsub("SFO", "m1"), + m1 = mkinsub("SFO"))
+
## Temporary DLL for differentials generated and loaded
 FOCUS_D <- subset(FOCUS_2006_D, value != 0)

We can compare the performance of the Eigenvalue based solution against the compiled version and the R implementation of the differential equations using the benchmark package. In the output of below code, the warnings about zero being removed from the FOCUS D dataset are suppressed. Since mkin version 0.9.49.11, an analytical solution is also implemented, which is included in the tests below.

@@ -160,10 +160,10 @@ print("R package rbenchmark is not available") }
##                    test replications relative elapsed
-## 4            analytical            1    1.000   0.186
-## 3     deSolve, compiled            1    1.742   0.324
-## 2      Eigenvalue based            1    2.048   0.381
-## 1 deSolve, not compiled            1   42.532   7.911
+## 4 analytical 1 1.000 0.187 +## 3 deSolve, compiled 1 1.807 0.338 +## 2 Eigenvalue based 1 2.032 0.380 +## 1 deSolve, not compiled 1 43.048 8.050

We see that using the compiled model is by more than a factor of 10 faster than using deSolve without compiled code.

@@ -173,8 +173,8 @@
 if (require(rbenchmark)) {
   FOMC_SFO <- mkinmod(
-    parent = mkinsub("FOMC", "m1"),
-    m1 = mkinsub( "SFO"))
+    parent = mkinsub("FOMC", "m1"),
+    m1 = mkinsub( "SFO"))
 
   b.2 <- benchmark(
     "deSolve, not compiled" = mkinfit(FOMC_SFO, FOCUS_D,
@@ -188,11 +188,11 @@
   factor_FOMC_SFO <- NA
   print("R package benchmark is not available")
 }
-
## Successfully compiled differential equation model from auto-generated C code.
+
## Temporary DLL for differentials generated and loaded
##                    test replications relative elapsed
-## 2     deSolve, compiled            1    1.000   0.465
-## 1 deSolve, not compiled            1   30.852  14.346
-

Here we get a performance benefit of a factor of 31 using the version of the differential equation model compiled from C code!

+## 2 deSolve, compiled 1 1.000 0.483 +## 1 deSolve, not compiled 1 29.969 14.475
+

Here we get a performance benefit of a factor of 30 using the version of the differential equation model compiled from C code!

This vignette was built with mkin 0.9.50.4 on

## R version 4.0.3 (2020-10-10)
 ## Platform: x86_64-pc-linux-gnu (64-bit)
diff --git a/docs/dev/pkgdown.yml b/docs/dev/pkgdown.yml
index f8ab4012..b3db5e23 100644
--- a/docs/dev/pkgdown.yml
+++ b/docs/dev/pkgdown.yml
@@ -10,7 +10,7 @@ articles:
   web_only/NAFTA_examples: NAFTA_examples.html
   web_only/benchmarks: benchmarks.html
   web_only/compiled_models: compiled_models.html
-last_built: 2020-11-27T20:47Z
+last_built: 2020-11-30T14:47Z
 urls:
   reference: https://pkgdown.jrwb.de/mkin/reference
   article: https://pkgdown.jrwb.de/mkin/articles
diff --git a/docs/dev/reference/CAKE_export.html b/docs/dev/reference/CAKE_export.html
index ce8a3444..d3f45bf0 100644
--- a/docs/dev/reference/CAKE_export.html
+++ b/docs/dev/reference/CAKE_export.html
@@ -73,7 +73,7 @@ specified as well." />
       
       
         mkin
-        0.9.50.3
+        0.9.50.4
       
     
@@ -121,7 +121,7 @@ specified as well." />