NEWS

---

mgm 1.2-14 (2023-09-05)

• When setting the argument binarySign=TRUE, now also the signs of higher-order (i.e., 3-way and higher) interactions involving binary variables and continuous variables are reported in the output

mgm 1.2-13 (2022-07-07)

• Fixed bug: in EBIC calculations, the standard deviation in the likelihood function was set equal to 1. Now it is set to the standard deviation of the residual as it should be.
• Use inherits(X, "??") instead of class(X)="??" throughout, since this seems to be required by CRAN now

mgm 1.2-12 (2021-06-03)

• Removed dependency on matrixcalc package which as been archived
• Improved mvar() input checks

mgm 1.2-11 (2021-02-02)

• Fixed bug: switch off thresholding when using using internal function Reg2Graph() in condition()
• Extend condition() to Poisson variables
• Fixed bug: The processing of certain custom moderation models created an error
• Fixed bug: In plotRes() negative moderation effects of binary variables were positive even when binarySign=TRUE

mgm 1.2-10 (2020-06-27)

• Added a simulated example data set to illustrate estimating group differences using moderation
• Fixed problems in computing binary signs created by R 4.0.0
• Added colorblind color scheme to pairwise output

mgm 1.2-9 (2020-04-20)

• Fixed bug in bwSelect() + tvmgm() when specifying k manually

mgm 1.2-8

• Fixed bug in computing predictions for Poisson variables
• Fixed bug that only printed 10 pairwise interactions in plotRes() for MNMs
• resample(): removed seed as an argument; now seeds are randomly drawn; for MGM objects, seeds are resampled until the MGM can be estimated on each of the bootstrap samples; the final seeds are provided in the output
• Fixed bug in Reg2Graph()/mgm(): moderators were not shown in the output when specified as a matrix
• Fixed bug in tvmvarsampler()
• Fixed bug: Adapted condition() to custom moderator input in mgm()

mgm 1.2-7 (2019-09-05)

• Fixed bug in bootstrap scheme for time-varying VAR models
• Provide optional output of chains of Gibbs sampler from mgmsampler()
• New function condition() allows to condition on values of a set of variables. The main motivation for this function is to make 3-way interactions / moderation more accessible.
• mgm() now allows one to specify custom sets of moderation effects via the "moderators" argument
• Fixed bug in bwSelect in combination with mgm() opjects
• Extended plotRes() to moderated MGMs with only a single moderator variable

mgm 1.2-6 (2019-03-14)

• Fix aliasing of internal functions

mgm 1.2-5 (2019-01-07)

• Bug fix in resample()
• Improved input checks in mgmsampler()
• Bug fix in prediction with mvar() objects
• Allow for prediction with time-varying models in new data sets

mgm 1.2-4 (2018-07-07)

• Updated help files
• Added two example data sets for higher-order (moderated) MGMs

mgm 1.2-3 (2018-06-05)

• Bug fix in bwSelect()
• Added verbatim option in resample() to detect zero variance bootstrap samples
• Fixed warning due to R 3.4.0: "Recycling array of length 1 in vector-array arithmetic is deprecatd.Use c() or as.vector() instead."
• Bug fix: resampling did not work together with new mvar() arguments dayvar/beepvar since Version 1.2-2
• Added argument "moderators" to the mgm() function that allows to ...
• Change default: in earlier versions if overparameterize=TRUE, all thresholds (intercepts) of categorical variables were set to zero. From this version on this threshold is estimated. The thresholds of categoricals can still be set to zero with the new argument "thresholdCat"
• If scale=TRUE, now interaction terms (k>2 or moderation) are scaled after computing the design matrix to ensure that all predictors have the same mean and standard deviation, which avoids different penalization depending on the scaling of a predictor
• Add CES-D depression dataset taken from Fried et al. (2015) to example datasets
• Added function FactorGraph() that computes and plots a factor graph from stationary or time-varying MGMs. The factorgraph output has been removed from the mgm() and tvmgm() functions.
• Added support of showInteraction() to continuous 3-way interactions
• For all time-varying models the estimation points are now specified on the unit interval [0,1]; for tvmvar() models, 0 is associated with the first data point that is not trivially excluded due to the maximum lag

mgm 1.2-2 (2017-11-22)

• Add running time to output of resample() function
• Added a note and references on the normalizability of MGMs
• Added function plotRes() to plot summaries of sampling distributions resampled with the resample() function
• The consecutiveness of measurements in mvar() and tvmvar() models now can be specified alternatively to the consec argument with the arguments beepvar and dayvar. This is tailored to the typical time stamps of ecological momentary assessment (EMA) studies, where the consecutiveness is defined by the number of notification on a given day (beepvar) and the number of that given day (dayvar).
• New function showInteraction() retrieves details of interactions from mgm model objects
• The print method now also shows number of rows in the VAR design matrix compared to the number of rows of the original data matrix.
• All estimation functions require a matrix object as data input to avoid problems with properties of data.frame objects
• Corrected row-order in dataset "symptom_data"
• In mVAR models we use an adjusted sample size that is equal to the number of rows in the design matrix. The adjusted sample size can be smaller than nrow(data) - max(lags) if measurements are not consecutive, or if non-uniform weighting is used. In earlier versions the sample size was only adjusted for non-uniform weighting. The adjusted sample size is used in the additional thresholding of parameter estimates (see ?mgm or ?mvar).
• Added function resample() that fits any model class to a specified number of bootstrap samples and provides the bootstrapped sampling distribution in an array. For time series data, the block bootstrap is used, where the number of blocks can be specified.

mgm 1.2-1 (2017-06-20)

• Added consec argument to predict.mgm(), which allows prediction for VAR models in time series with unequal time intervals by excluding time points that are not preceded by enough measurements (see ?mvar)

mgm 1.2-0 (2017-05-26)

• The whole package has been rewritten from scratch to reduce susceptibility to bugs and to allow new features
• Every function now has many input checks and associated informative error messages
• Major syntax changes: mgmfit() -> mgm(), var.mgm() -> mvar(), tv.mgmfit() -> tvmgm() and tv_var.mgm() -> tvmvar()
• The names of function arguments are now consistent across the package and therefore had to be changed considerably
• There is no more missing argument in the estimation functions
• All estimation functions allow to search a sequence of the (alpha) elastic net paramter, using the EBIC or cross-validation; so far alpha was fixed to 1
• mgm() and tvmgm() now presents all paramters involved in higher (than pairwise) order interactions in the output; this includes a factor-graph representation that is easy to visualize
• The d parameter for the largest order of interaction in the neighborhood of a given node has been replaced with the k parameter, the largest order of interaction in the whole graph. Note that d = k - 1
• All estimation functions allow the standard parameterization for categorical variables, but also an overparameterization. This is necessary to correctly identify higher order interactions between categorical variables.
• The sampling functions mgmsampler() and tvmgmsampler() were extended to k-order MGMs (before only pairwise / k = 2)
• mvar() and tvmvar() now allow the specification of any number of lags
• The new functions mvarsampler() and tvmvarsampler() now allow to sample from mVAR models any number of lags
• There is no more function provided for resampling. Instead, we provide an interface with the bootnet package.
• The function bwSelect() allows the selection of an optimal bandwidth parameter for timer-varying MGM or mVAR models using cross-validation
• predict.mgm() now allows two different ways to predict from time-varying models, see ?predict.mgm
• Fixed bug in mgmsampler() that was present in binary-Gaussian graphs
• Fixed bug in predict.mgm() which caused the prediction of incorrect category labels in some situations
• Fixed bug in mgm() which did not use the weight-argument in case of lambdaSel = 'CV'
• Default for argument lambdaSel changed from 'EBIC' to 'CV'

mgm 1.1-7 (2016-10-20)

• The predict() function now returns the predicted probabilities in addition to the predicted category for categorical variables
• Added a message for all estimation functions indicating where edge weights (if defined) can be found: fitobject$signs
• Added a startup message with a link to report bugs
• The predict() function now computes predicted values and a prediction error for each variable in the graph
• The print() function now returns a small summary of the model type when printing a mgm object
• Added subsampling scheme to evaluate edge-stability for non-time-varying models (MGM and mixed VAR)
• Added summary() & plot() for the bootstrap object to summarize edge-stability
• Added argument 'binary.sign': If binary.sign=TRUE, the sign of the interactions of all binary variables coded (0,1) with other binary variables and continuous variables will be returned in the sign matrix fit$signs