## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:53 2025
-## Date of summary: Thu Feb 13 15:49:53 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:24 2025
+## Date of summary: Mon May 12 21:54:24 2025 ## ## Equations:## d_parent/dt = - k_parent * parent
@@ -196,7 +196,7 @@ the mkinparplot function.
## ## Model predictions using solution type analytical ##
-## Fitted using 401 model solutions performed in 0.053 s
+## Fitted using 401 model solutions performed in 0.054 s## ## Error model: Constant variance ##
diff --git a/docs/articles/FOCUS_L.html b/docs/articles/FOCUS_L.html
index 30092709..85d82a27 100644
--- a/docs/articles/FOCUS_L.html
+++ b/docs/articles/FOCUS_L.html
@@ -20,7 +20,7 @@
mkin
- 1.2.9
+ 1.2.10
@@ -84,7 +84,7 @@
Ranke
## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:54 2025
-## Date of summary: Thu Feb 13 15:49:54 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:26 2025
+## Date of summary: Mon May 12 21:54:26 2025 ## ## Equations:## d_parent/dt = - k_parent * parent
@@ -225,17 +225,17 @@ error level is checked.
## Warning in sqrt(diag(covar)): NaNs produced
## Warning in cov2cor(ans$covar): diag(V) had non-positive or NA entries; the## non-finite result may be dubious
-
## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:55 2025
-## Date of summary: Thu Feb 13 15:49:55 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:26 2025
+## Date of summary: Mon May 12 21:54:26 2025 ## ## Equations:## d_parent/dt = - (alpha/beta) * 1/((time/beta) + 1) * parent## ## Model predictions using solution type analytical ##
-## Fitted using 342 model solutions performed in 0.023 s
+## Fitted using 342 model solutions performed in 0.024 s## ## Error model: Constant variance ##
@@ -383,10 +383,10 @@ error level is checked.
## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:55 2025
-## Date of summary: Thu Feb 13 15:49:55 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:26 2025
+## Date of summary: Mon May 12 21:54:26 2025 ## ## Equations:## d_parent/dt = - (alpha/beta) * 1/((time/beta) + 1) * parent
@@ -470,10 +470,10 @@ error level.
## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:55 2025
-## Date of summary: Thu Feb 13 15:49:55 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:27 2025
+## Date of summary: Mon May 12 21:54:27 2025 ## ## Equations:## d_parent/dt = - ((k1 * g * exp(-k1 * time) + k2 * (1 - g) * exp(-k2 *
@@ -593,10 +593,10 @@ using square brackets for indexing which will result in the use of the
summary and plot functions working on mkinfit objects.
## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:56 2025
-## Date of summary: Thu Feb 13 15:49:56 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:27 2025
+## Date of summary: Mon May 12 21:54:27 2025 ## ## Equations:## d_parent/dt = - ((k1 * g * exp(-k1 * time) + k2 * (1 - g) * exp(-k2 *
@@ -723,17 +723,17 @@ test passes is slightly lower for the FOMC model. However, the
difference appears negligible.
## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:56 2025
-## Date of summary: Thu Feb 13 15:49:56 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:27 2025
+## Date of summary: Mon May 12 21:54:28 2025 ## ## Equations:## d_parent/dt = - k_parent * parent## ## Model predictions using solution type analytical ##
-## Fitted using 142 model solutions performed in 0.009 s
+## Fitted using 142 model solutions performed in 0.01 s## ## Error model: Constant variance ##
@@ -788,17 +788,17 @@ difference appears negligible.
## parent 106 352
## mkin version used for fitting: 1.2.9
-## R version used for fitting: 4.4.2
-## Date of fit: Thu Feb 13 15:49:56 2025
-## Date of summary: Thu Feb 13 15:49:56 2025
+
## mkin version used for fitting: 1.2.10
+## R version used for fitting: 4.5.0
+## Date of fit: Mon May 12 21:54:27 2025
+## Date of summary: Mon May 12 21:54:28 2025 ## ## 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.013 s
+## Fitted using 224 model solutions performed in 0.014 s## ## Error model: Constant variance ##
diff --git a/docs/articles/index.html b/docs/articles/index.html
index b1b9f39a..5883e462 100644
--- a/docs/articles/index.html
+++ b/docs/articles/index.html
@@ -7,7 +7,7 @@
mkin
- 1.2.9
+ 1.2.10
diff --git a/docs/articles/mkin.html b/docs/articles/mkin.html
index fcf37ee4..10239ccb 100644
--- a/docs/articles/mkin.html
+++ b/docs/articles/mkin.html
@@ -1,5 +1,18 @@
-Short introduction to mkin • mkin
+
+
+
+
+
+
+Short introduction to mkin • mkin
+
+
+
+
+
+
+
Skip to contents
@@ -7,7 +20,7 @@
mkin
- 1.2.9
+ 1.2.10
@@ -15,10 +28,12 @@
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
@@ -86,38 +107,40 @@ nonlinear optimisation. The R add-on package
this guidance from within R and calculates some statistical measures for
data series within one or more compartments, for parent and
metabolites.
-
library("mkin", quietly =TRUE)
-# Define the kinetic model
-m_SFO_SFO_SFO <-mkinmod(parent =mkinsub("SFO", "M1"),
-M1 =mkinsub("SFO", "M2"),
-M2 =mkinsub("SFO"),
-use_of_ff ="max", quiet =TRUE)
-
-
-# Produce model predictions using some arbitrary parameters
-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)
-
-# Generate a dataset by adding normally distributed errors with
-# standard deviation 3, for two replicates at each sampling time
-d_SFO_SFO_SFO_err <-add_err(d_SFO_SFO_SFO, reps =2,
-sdfunc =function(x) 3,
-n =1, seed =123456789 )
-
-# Fit the model to the dataset
-f_SFO_SFO_SFO <-mkinfit(m_SFO_SFO_SFO, d_SFO_SFO_SFO_err[[1]], quiet =TRUE)
-
-# Plot the results separately for parent and metabolites
-plot_sep(f_SFO_SFO_SFO, lpos =c("topright", "bottomright", "bottomright"))
-
+
+library("mkin", quietly =TRUE)
+# Define the kinetic model
+m_SFO_SFO_SFO<-mkinmod(parent =mkinsub("SFO", "M1"),
+ M1 =mkinsub("SFO", "M2"),
+ M2 =mkinsub("SFO"),
+ use_of_ff ="max", quiet =TRUE)
+
+
+# Produce model predictions using some arbitrary parameters
+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)
+
+# Generate a dataset by adding normally distributed errors with
+# standard deviation 3, for two replicates at each sampling time
+d_SFO_SFO_SFO_err<-add_err(d_SFO_SFO_SFO, reps =2,
+ sdfunc =function(x)3,
+ n =1, seed =123456789)
+
+# Fit the model to the dataset
+f_SFO_SFO_SFO<-mkinfit(m_SFO_SFO_SFO, d_SFO_SFO_SFO_err[[1]], quiet =TRUE)
+
+# Plot the results separately for parent and metabolites
+plot_sep(f_SFO_SFO_SFO, lpos =c("topright", "bottomright", "bottomright"))
+
-
-
Background
+
+
Background
+
The mkin package (J. Ranke
2021) implements the approach to degradation kinetics recommended
in the kinetics report provided by the FOrum for Co-ordination of
@@ -138,8 +161,7 @@ purpose compartment based tool providing infrastructure for fitting
dynamic simulation models based on differential equations to data.
At that time, the R package FME (Flexible Modelling
@@ -162,8 +184,9 @@ times.
The possibility to specify back-reactions and a biphasic model
(SFORB) for metabolites were present in mkin from the very
beginning.
-
-
Derived software tools
+
+
Derived software tools
+
Soon after the publication of mkin, two derived tools
were published, namely KinGUII (developed at Bayer Crop Science) and
CAKE (commissioned to Tessella by Syngenta), which added a graphical
@@ -184,50 +207,44 @@ be specified for transformation products. Starting with KinGUII version
KinGUII.
A further graphical user interface (GUI) that has recently been
brought to a decent degree of maturity is the browser based GUI named
-gmkin. Please see its documentation page and manual
+gmkin. Please see its documentation page and manual
for further information.
A comparison of scope, usability and numerical results obtained with
-these tools has been recently been published by Johannes Ranke, Wöltjen, and Meinecke
+these tools has been recently been published by Johannes Ranke, Wöltjen, and Meinecke
(2018).
-
-
Unique features
+
+
Unique features
+
Currently, the main unique features available in mkin
are
The iteratively reweighted least squares fitting of different
variances for each variable as introduced by Gao
-et al. (2011) has been available in mkin since version
-0.9-22. With release
+et al. (2011) has been available in mkin since version
+0.9-22. With release
0.9.49.5, the IRLS algorithm has been complemented by direct or
step-wise maximisation of the likelihood function, which makes it
possible not only to fit the variance by variable error model but also a
-two-component
+two-component
error model inspired by error models developed in analytical
chemistry (Johannes Ranke and Meinecke
2019).
-
-
Internal parameter transformations
+
+
Internal parameter transformations
+
For rate constants, the log transformation is used, as proposed by
Bates and Watts (1988, 77, 149).
Approximate intervals are constructed for the transformed rate constants
@@ -252,9 +269,9 @@ well as in the subsequent calculation of parameter confidence intervals.
In the current version of mkin, a logit transformation is used for
parameters that are bound between 0 and 1, such as the g parameter of
the DFOP model.
-
-
Confidence intervals based on transformed parameters
+
+
Confidence intervals based on transformed parameters
+
In the first attempt at providing improved parameter confidence
intervals introduced to mkin in 2013, confidence intervals
obtained from FME on the transformed parameters were simply all
@@ -276,14 +293,13 @@ 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.
-
-
Parameter t-test based on untransformed parameters
+
+
Parameter t-test based on untransformed parameters
+
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 (FOCUS Work Group on Degradation Kinetics 2014,
+validity of rate constants in the FOCUS guidance (FOCUS Work Group on Degradation Kinetics 2014,
96ff).
It has been argued that the precondition for this test, i.e.
normal distribution of the estimator for the parameters, is not
@@ -304,8 +320,9 @@ t-test is based on the unjustified assumption of normal distribution of
the parameter estimators.
Schäfer, D., B. Mikolasch, P. Rainbird, and B. Harvey. 2007.
@@ -374,13 +384,13 @@ Piacenza.
Soetaert, Karline, and Thomas Petzoldt. 2010. “Inverse Modelling,
Sensitivity and Monte Carlo Analysis in R Using Package
FME.”Journal of Statistical Software 33
-(3): 1–28. https://doi.org/10.18637/jss.v033.i03.
+(3): 1–28. https://doi.org/10.18637/jss.v033.i03.