From de94e31d2e12460fcbd277c09729d5f8d337ebb4 Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Wed, 22 Jul 2015 15:39:39 +0200 Subject: Reformat NEWS.md, start new entry It is not necessary to use capitals in the headings, as they are now typeset as HTML on CRAN and github. --- NEWS.md | 80 ++++++++++++++++++++++++++++++++++------------------------------- 1 file changed, 42 insertions(+), 38 deletions(-) diff --git a/NEWS.md b/NEWS.md index 385e63ef..00e2b637 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,42 +1,46 @@ # NEWS for package 'mkin' -## CHANGES in mkin VERSION 0.9-40 (2015-07-21) +## mkin 0.9-40.9000 -### BUG FIXES + + +## mkin 0.9-40 (2015-07-21) + +### Bug fixes - `endpoints()`: For DFOP and SFORB models, where `optimize()` is used, make use of the fact that the DT50 must be between DT50_k1 and DT50_k2 (DFOP) or DT50_b1 and DT50_b2 (SFORB), as `optimize()` sometimes did not find the minimum. Likewise for finding DT90 values. Also fit on the log scale to make the function more efficient. -### INTERNAL CHANGES +### Internal changes - `DESCRIPTION`, `NAMESPACE`, `R/*.R`: Import (from) stats, graphics and methods packages, and qualify some function calls for non-base packages installed with R to avoid NOTES made by R CMD check --as-cran with upcoming R versions. -## CHANGES in mkin VERSION 0.9-39 (2015-06-26) +## mkin 0.9-39 (2015-06-26) -### MAJOR CHANGES +### Major changes - New function `mmkin()`: This function takes a character vector of model shorthand names, or alternatively a list of mkinmod models, as well as a list of dataset as main arguments. It returns a matrix of mkinfit objects, with a row for each model and a column for each dataset. A subsetting method with single brackets is available. Fitting the models in parallel using the `parallel` package is supported. - New function `plot.mmkin()`: Plots single-row or single-column `mmkin` objects including residual plots. -### BUG FIXES +### Bug fixes - `mkinparplot()`: Fix the x axis scaling for rate constants and formation fractions that got confused by the introduction of the t-values of transformed parameters. -## CHANGES in mkin VERSION 0.9-38 (2015-06-24) +## mkin 0.9-38 (2015-06-24) -### MINOR CHANGES +### Minor changes - `vignettes/compiled_models.html`: Show the performance improvement factor actually obtained when building the vignette, as well as mkin version, some system info and the CPU model used for building the vignette. - `GNUMakefile`,`vignettes/*`: Clean up vignette generation and include table of contents in HTML vignettes. -### BUG FIXES +### Bug fixes - `mkinmod()`: When generating the C code for the derivatives, only declare the time variable when it is needed and remove the '-W-no-unused-variable' compiler flag as the C compiler used in the CRAN checks on Solaris does not know it. -## CHANGES in mkin VERSION 0.9-36 (2015-06-21) +## mkin 0.9-36 (2015-06-21) -### MAJOR CHANGES +### Major changes - `summary.mkinfit()`: A one-sided t-test for significant difference of untransformed parameters from zero is now always shown, based on the assumption of normal distribution for estimators of all untransformed parameters. Use with caution, as this assumption is unrealistic e.g. for rate constants in these nonlinear kinetic models. @@ -46,17 +50,17 @@ - `mkinfit()`: Set the default `solution_type` to `deSolve` when a compiled version of the model is present, except when an analytical solution is possible. -### MINOR CHANGES +### Minor changes - Added a simple showcase vignette with an evaluation of FOCUS example dataset D -## CHANGES in mkin VERSION 0.9-35 (2015-05-15) +## mkin 0.9-35 (2015-05-15) -### MAJOR CHANGES +### Major changes - Switch from RUnit to testthat for testing -### BUG FIXES +### Bug fixes - `mkinparplot()`: Avoid warnings that occurred when not all confidence intervals were available in the summary of the fit @@ -66,7 +70,7 @@ - `mkinparplot()`: Avoid warning in R CMD check about undeclared global variable `Lower` -### NEW FEATURES +### New features - `mkinfit()`: Report successful termination when quiet = FALSE. This is helpful for more difficult problems fitted with reweight.method = obs, as no progress is often indicated during the reweighting. @@ -76,9 +80,9 @@ - Add tests based on these datasets -## CHANGES in mkin VERSION 0.9-34 (2014-11-22) +## mkin 0.9-34 (2014-11-22) -### NEW FEATURES +### New features - Add the convenience function `mkinsub()` for creating the lists used in `mkinmod()` @@ -86,21 +90,21 @@ - Switch to using the Port algorithm (using a model/trust region approach) per default. While needing more iterations than the Levenberg-Marquardt algorithm previously used per default, it is less sensitive to starting parameters. -### MINOR CHANGES +### Minor changes - The formatting of differential equations in the summary was further improved - Always include 0 on y axis when plotting during the fit -## CHANGES in mkin VERSION 0.9-33 (2014-10-22) +## mkin 0.9-33 (2014-10-22) -### NEW FEATURES +### New features - The initial value (state.ini) for the observed variable with the highest observed residue is set to 100 in case it has no time zero observation and `state.ini = "auto"` - A basic unit test for `mkinerrmin()` was written -### BUG FIXES +### Bug fixes - `mkinfit()`: The internally fitted parameter for `g` was named `g_ilr` even when `transform_fractions=FALSE` @@ -110,7 +114,7 @@ - `plot.mkinfit()`: Avoid a warning message about only using the first component of ylim that occurred when ylim was specified explicitly -### MINOR CHANGES +### Minor changes - The formatting of differential equations in the summary was improved by wrapping overly long lines @@ -120,9 +124,9 @@ - `mkinfit()`: Avoid a warning that occurred when summarising a fit that was performed with maxitmodFit = 0 as done in gmkin for configuring new fits. -## CHANGES in mkin VERSION 0.9-32 (2014-07-24) +## mkin 0.9-32 (2014-07-24) -### NEW FEATURES +### New features - The number of degrees of freedom is difficult to define in the case of ilr transformation of formation fractions. Now for each source compartment the number of ilr parameters (=number of optimised parameters) is divided by the number of pathways to metabolites (=number of affected data series) which leads to fractional degrees of freedom in some cases. @@ -136,7 +140,7 @@ - mkinfit gives a warning when the fit does not converge (does not apply to SANN method). This warning is included in the summary. -### BUG FIXES +### Bug fixes - Avoid plotting an artifical 0 residual at time zero in `mkinresplot` @@ -148,7 +152,7 @@ - No warning was given when the fit did not converge when a method other than the default Levenberg-Marquardt method `Marq` was used. -### MINOR CHANGES +### Minor changes - Vignettes were rebuilt to reflect the changes in the summary method. @@ -156,25 +160,25 @@ - Algorithm `Newton` was excluded because of its different way to specify the maximum number of iterations and because it does not appear to provide additional benefits. -## CHANGES in mkin VERSION 0.9-31 (2014-07-14) +## mkin 0.9-31 (2014-07-14) -### BUG FIXES +### Bug fixes - The internal renaming of optimised parameters in Version 0.9-30 led to errors in the determination of the degrees of freedom for the chi2 error level calulations in `mkinerrmin()` used by the summary function. -## CHANGES in mkin VERSION 0.9-30 (2014-07-11) +## mkin 0.9-30 (2014-07-11) -### NEW FEATURES +### New features - It is now possible to use formation fractions in combination with turning off the sink in `mkinmod()`. -### MAJOR CHANGES +### Major changes - The original and the transformed parameters now have different names (e.g. `k_parent` and `log_k_parent`. They also differ in how many they are when we have formation fractions but no pathway to sink. - The order of some of the information blocks in `print.summary.mkinfit.R()` has been ordered in a more logical way. -### MINOR CHANGES +### Minor changes - The vignette FOCUS_Z has been simplified to use formation fractions with turning off the sink, and slightly amended to use the new versions of DT50 values calculated since mkin 0.9-29. @@ -188,7 +192,7 @@ - Some more checks were introduced to `mkinfit()`, leading to warnings or stopping execution if unsupported combinations of methods and parameters are requested. -## CHANGES in mkin VERSION 0.9-29 (2014-06-27) +## mkin 0.9-29 (2014-06-27) - R/mkinresplot.R: Make it possible to specify `xlim` @@ -196,7 +200,7 @@ - R/endpoints.R, man/endpoints.Rd: Calculate additional (pseudo)-DT50 values for FOMC, DFOP, HS and SFORB. Avoid calculation of formation fractions from rate constants when they are directly fitted -## CHANGES in mkin VERSION 0.9-28 (2014-05-20) +## mkin 0.9-28 (2014-05-20) - Do not backtransform confidence intervals for formation fractions if more than one compound is formed, as such parameters only define the pathways as a set @@ -204,7 +208,7 @@ - Correct 'isotropic' into 'isometric' for the ilr transformation -## CHANGES in mkin VERSION 0.9-27 (2014-05-10) +## mkin 0.9-27 (2014-05-10) - Fork the GUI into a separate package [gmkin](http://github.com/jranke/gmkin) @@ -240,7 +244,7 @@ - Add gmkin workspace datasets FOCUS_2006_gmkin and FOCUS_2006_Z_gmkin -## CHANGES in mkin VERSION 0.9-24 (2013-11-06) +## mkin 0.9-24 (2013-11-06) - Bugfix re-enabling the fixing of any combination of initial values for state variables @@ -248,7 +252,7 @@ - Backtransform fixed ODE parameters for the summary -## CHANGES in mkin VERSION 0.9-22 (2013-10-26) +## mkin 0.9-22 (2013-10-26) - Get rid of the optimisation step in `mkinerrmin` - this was unnecessary. Thanks to KinGUII for the inspiration - actually this is equation 6-2 in FOCUS kinetics p. 91 that I had overlooked originally -- cgit v1.2.1