update.brma: Update a brma Fit

In RoBMA: Robust Bayesian Meta-Analyses

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 class '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
)

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.

Value

The updated brma object.

Examples

## Not run: 
fit <- update(fit, sample_extend = 1000)
fit <- update(fit, slab = paste("Study", seq_len(nobs(fit))))

## End(Not run)

RoBMA documentation built on May 7, 2026, 5:08 p.m.