NEWS

merTools 0.6.2 (2024-02-08)

Maintenance release to fix minor issues with function documentation
Fix #130 by avoiding conflict with vcov in the merDeriv package
Upgrade package test infrastructure to 3e testthat specification

merTools 0.6.1 (2023-03-20)

Maintenance release to keep package listed on CRAN
Fix a small bug where parallel code path is run twice (#126)
Update plotting functions to avoid deprecated aes_string() calls (#127)
Fix (#115) in description
Speed up PI using @bbolker pull request (#120)
Updated package maintainer contact information

merTools 0.5.2 (2020-06-23)

Streamline vignette building to be precompiled and move tests to limit burden on CRAN check
Switch dependency from broom to broom.mixed because of upstream package reorganization

merTools 0.5.1

Bug fixes

Fixed an issue where averageObs could not be calculated when model weights were specified in the original model (closes #110)

merTools 0.5.0 (2019-05-13)

New Features

subBoot now works with glmerMod objects as well
reMargins a new function that allows the user to marginalize the prediction over breaks in the distribution of random effect distributions, see ?reMargins and the new reMargins vignette (closes #73)

Bug fixes

Fixed an issue where known convergence errors were issuing warnings and causing the test suite to not work
Fixed an issue where models with a random slope, no intercept, and no fixed term were unable to be predicted (#101)
Fixed an issue with shinyMer not working with substantive fixed effects (#93)

merTools 0.4.2

New Features

Parallel fitting of merModLists is now supported using the future.apply package and the future_lapply functions, optionally
Reduced package installation surface by eliminating unnecessary packages in the Suggests field

Bug fixes

Fixed a bug (#94) where predictInterval() would return a data.frame of the wrong dimensions when predicting a single row of observations for a glm
Fixed a bug (#96) related to rstanarm dependencies in the package vignette
Switched from dontrun to donttest for long-running examples (CRAN compliance)
Fixed and made more clear the generics applying to merModList objects (#92)

merTools 0.4.1 (2018-06-05)

New Features

Standard errors reported by merModList functions now apply the Rubin correction for multiple imputation

Bug fixes

Contribution by Alex Whitworth (@alexWhitworth) adding error checking to plotting functions
The vignettes have been shortened and unit tests reorganized to facilitate Travis-CI builds and reduce CRAN build burden

merTools 0.4.0

New Features

Added vignette on using multilevel models with multiply imputed data
Added fixef and ranef generics for merModList objects
Added fastdisp generic for merModList
Added summary generic for merModList
Added print generic for merModList
Documented all generics for merModList including examples and a new imputation vignette
Added modelInfo generic for merMod objects that provides simple summary stats about a whole model

Bug Fixes

Fix bug that returned NaN for std.error of a multiply imputed merModList when calling modelRandEffStats
Fixed bug in REimpact where some column names in newdata would prevent the prediction intervals from being computed correctly. Users will now be warned.
Fixed bug in wiggle where documentation incorrectly stated the arguments to the function and the documentation did not describe function correctly

merTools 0.3.1

Update the readme.rmd to package graphics with the R package, per CRAN

merTools 0.3.0 (2016-12-12)

Improve handling of formulas. If the original merMod has functions specified in the formula, the draw and wiggle functions will check for this and attempt to respect these variable transformations. Where this is not possible a warning will be issued. Most common transformations are respected as long as the the original variable is passed untransformed to the model.
Change the calculations of the residual variance. Previously residual variance was used to inflate both the variance around the fixed parameters and around the predicted values themselves. This was incorrect and resulted in overly conservative estimates. Now the residual variance is appropriately only used around the final predictions
Rebuilt the readme.md to include new information about new features
New option for predictInterval that allows the user to return the full interval, the fixed component, the random component, or the fixed and each random component separately for each observation
Fixed a bug with slope+intercept random terms that caused a miscalculation of the random component
Add comparison to rstanarm to the Vignette
Make expectedRank output more tidy like and allow function to calculate expected rank for all terms at once
- Note, this breaks the API by changing the names of the columns in the output of this function
Remove tests that test for timing to avoid issues with R-devel JIT compiler
Remove plyr and replace with dplyr
Fix issue #62 varList will now throw an error if == is used instead of =
Fix issue #54 predictInterval did not included random effects in calculations when newdata had more than 1000 rows and/or user specified parallel=TRUE. Note: fix was to disable the .paropts option for predictInterval ... user can still specify for temporary backward compatibility but this should be either removed or fixed in the permanent solution.
Fix issue #53 about problems with predictInterval when only specific levels of a grouping factor are in newdata with the colon specification of interactions
Fix issue #52 ICC wrong calculations ... we just needed to square the standard deviations that we pulled

merTools 0.2.1 (2016-03-30)

Fix dependency on lme4 to ensure compatibility with latest changes.

merTools 0.2

Bug fixes

Coerce dplyr tbl and tbl_df objects to data.frames when they are passed to predictInterval and issue a warning
Try to coerce other data types passed to newdata in predictInterval before failing if coercion is unsuccessful
Numeric stabilization of unit tests by including seed values for random tests
Fix handling of models with nested random effect terms (GitHub #47)
Fix vignette images

New Functionality

Substantial performance enhancement for predictInterval which includes better handling of large numbers of parameters and simulations, performance tweaks for added speed (~10x), and parallel backend support (currently not optimized)
Add support for probit models and limited support for other glmm link functions, with warning (still do not know how to handle sigma parameter for these)
Add ability for user-specified seed for reproducibility
Add support for blmer objects from the blme package
Add a merModList object for lists of merMod objects fitted to subsets of a dataset, useful for imputation or for working with extremely large datasets
Add a print method for merModList to mimic output of summary.merMod
Add a VarCorr method for merModList
Add new package data to demonstrate replication from selected published texts on multilevel modeling using different software (1982 High School and Beyond Survey data)

Other changes

Changed the default n.sims for the predictInterval function from 100 to 1,000 to give better coverage and reflect performance increase
Changed the default for level in predictInterval to be 0.8 instead of 0.95 to reflect that 0.95 prediction intervals are more conservative than most users need

Future changes

For the next release (1.0) we are considering a permanent switch to C++ RMVN sampler courtesy of Giri Gopalan 's excellent FastGP

merTools 0.1

Initial release

New Functions

Provides predictInterval to allow prediction intervals from glmer and lmer objects
Provides FEsim and REsim to extract distributions of model parameters
Provides shinyMer an interactive shiny application for exploring lmer and glmer models
Provides expectedRank function to interpret the ordering of effects
Provides REimpact to simulate the impact of grouping factors on the outcome
Provides draw function to allow user to explore a specific observation
Provides wiggle function for user to build a simulated set of counterfactual cases to explore