Extends an existing fitted brma object by additional MCMC samples,
updates study labels, and optionally recomputes cached fit-dependent
quantities.
Arguments
- object
a fitted
brmaobject.- formula.
unsupported; included for compatibility with
update.- ...
unsupported additional arguments.
- sample_extend
integer. Number of additional samples per chain.
- slab
optional character vector of study labels. Updating labels does not refit or extend the model.
- autofit_control
list of autofit control settings. Values are merged with the existing settings before extending.
- convergence_checks
list of convergence check settings. Values are merged with the existing settings and used to re-check the fit.
- recompute
whether cached
loo,waic, andmarglikvalues already stored inobjectshould be recomputed after extension ("all") or dropped with a warning ("drop").- parallel
logical. Whether to extend chains in parallel.
- cores
integer. Number of cores to use when
parallel = TRUE.- silent
logical. Whether to suppress JAGS output during extension.
- evaluate
unsupported; included for compatibility with
update.
Details
Extending a fit preserves the fitted model and adds posterior samples. No
additional burn-in is requested. Rebuilding the compiled JAGS model, for
example after loading a saved fit, for parallel workers, or under runjags'
repeatable-method settings, can rerun adaptation before collecting those
samples. Retained selection caches store normalizer calculations, not JAGS
model pointers or sampler tuning. Prior, data, and model-structure updates are intentionally not
supported by this method. For brma.mv() objects, the stored V,
R, known-V backend, and marginalized random-effect metadata are
preserved because the fitted model structure is reused.
Extensions continue the random-number generator state stored by JAGS. They
cannot be restarted from a new seed without changing the meaning of chain
continuation, so update() has no seed argument.
Retained selection-normalizer caches are restored when compatible. Set
RoBMA.options(selection.cache_retain = TRUE) to retain the cache after
extension, or use remove_selection_cache() to remove saved cache entries.
Only explicitly stored selection-sensitivity diagnostics are refreshed after
chain extension, silently and using their stored simulation settings,
independently of recompute. Models without a stored comparison do not
compute one. Label-only updates retain the stored diagnostic. Use
selection_sensitivity_diagnostics() to inspect the refreshed result or error.
Named NULL elements in autofit_control and
convergence_checks explicitly disable or clear the corresponding
nullable setting. Omitted elements, a top-level NULL, and an empty
list() inherit the setting stored in object.