View source: R/FUN_boot_mmes.R
| boot_mmes | R Documentation |
Simulates new population random effects and responses and refits the native Laplace likelihood without calculating PEV or numerical-Hessian uncertainty. Supports parameter-recovery summaries and simulation-based comparisons of nested fixed-effect models.
boot_mmes(object, object2 = NULL, nsim = 199L, seed = NULL, maxit = 1000L)
object |
A converged native Laplace |
object2 |
Optional converged larger model differing only in strictly nested count fixed effects. Response rows, offsets, families, trials, zero designs and random covariance models must match. |
nsim |
Positive integer number of planned bootstrap datasets. |
seed |
Optional nonnegative integer seed. When supplied, the caller's random-number state is restored on exit. |
maxit |
Positive integer outer iteration limit for each refit. |
This is an opt-in post-fit calculation, not part of fitting. It uses the
stored retained designs, offsets, trials and native likelihood specifications,
so no evaluation of the original data expression or response formula is needed.
Grouped binomial simulations are converted from proportions back to counts.
Each refit starts at that model's fitted parameters and uses the stored mode
controls, acceleration choices and native likelihood. Scalar, ordinal and
mixed nominal outer derivatives are native analytic by default; stored
gradient="numeric" retains the central-difference reference.
Fits are sequential; no dependencies
or parallel workers are added. Output storage is subject to the generating
fit's execution$denseMemoryMB budget.
Single-model percentile intervals are descriptive bootstrap intervals on the stored optimizer scale: count coefficients, covariance descriptor coordinates, and log shape/dispersion or zero-logit coefficients. They are not automatically transformed to natural covariance parameters and are not studentized or bias-corrected. They use successful refits only and require separate coverage calibration, especially at boundaries.
Single-family ordinal models retain their declared category
labels and cutpoint policy for comparisons. Cutpoint draws use the first
location followed by log-positive successive gaps, not natural cutpoint
coordinates. Simulations use numeric codes internally; refits with an absent
declared category fail explicitly when cutpoints are estimated. Ordinal
comparisons may differ only by nested main-predictor fixed effects, not by
category labels or fixed thresholds.
Single-family multinomial fits use their joint softmax
likelihood in bootstrap refits. Simulated factor labels are mapped back to
the fitted internal reference coding; all declared categories remain in the
response schema even when a bootstrap sample omits one.
Categorical familym supports ordinal, nominal and scalar
responses jointly. Simulated original category codes are mapped to the fitted
nominal reference order and expanded predictor rows without changing the
random-effect structure. Comparisons retain identical trait/category schemas,
cutpoint policies, offsets, trials and random covariance structures; only
nested fixed terms may differ.
With two models, simulations come from the smaller model, drawing new random
effects rather than holding conditional modes fixed. The statistic is twice
the difference in approximate marginal log likelihood. If every replicate
succeeds, the p-value is (1+e)/(1+B), where e is the number of
bootstrap statistics at least as large as observed and B is
nsim. Monte Carlo uncertainty is reported separately. Use substantially
more than 199 replicates for precise tail probabilities.
Failures and nonconvergence are retained, not retried until success or
silently treated as non-rejections. If any replicate fails, p.value
is NA; p.value.bounds assigns all failures first as
non-exceedances and then as exceedances. These are failure-sensitivity
bounds, not confidence limits. Boundary replicates are retained and flagged.
A boundary generating fit produces a warning; this is not a general
variance-component boundary test, zero-inflation selection test, or a cure
for an unidentified generating model.
Parameter simulations condition on the fitted generating parameters. No numerical Hessian, PEV, or full fitted objects are produced for refits. The original fitted objects are not modified. Ordinary Gaussian LMM and PQL fitting paths are unchanged.
A list with estimates, optimizer-scale draws,
percentile intervals, successful and nsim counts,
and one row per planned replicate in diagnostics. Diagnostics include
convergence, likelihoods, score magnitude, rejected evaluations, boundaries,
warnings and errors. Comparisons also return statistic,
p.value, p.value.bounds and monteCarloSE.
mmes, simulate.mmes.glmm.laplace
## Not run:
boot <- boot_mmes(fit, nsim=999, seed=17)
boot$diagnostics
boot$percentile
test <- boot_mmes(smaller, larger, nsim=999, seed=17)
test$p.value
test$p.value.bounds
## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.