RoBMA (version 4.0.0)

update.brma: Update a brma Fit

Description

Extends an existing fitted brma object by additional MCMC samples, updates study labels, and optionally recomputes cached fit-dependent quantities.

Usage

# S3 method for brma
update(
  object,
  formula. = NULL,
  ...,
  sample_extend = NULL,
  slab = NULL,
  autofit_control = NULL,
  convergence_checks = NULL,
  recompute = c("all", "drop"),
  parallel = NULL,
  cores = NULL,
  silent = NULL,
  seed = NULL,
  evaluate = TRUE
)

Value

The updated brma object.

Arguments

object

a fitted brma object.

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, and marglik values already stored in object should 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.

seed

optional seed used before extending.

evaluate

unsupported; included for compatibility with update.

Details

Extending a fit adds posterior samples only. It does not rerun adaptation or burn-in. Prior, data, and model-structure updates are intentionally not supported by this method.

Examples

if (FALSE) {
fit <- update(fit, sample_extend = 1000)
fit <- update(fit, slab = paste("Study", seq_len(nobs(fit))))
}