fit-method-diagnostic_summary: Sampler diagnostic summaries and warnings

In stan-dev/cmdstanr: R Interface to 'CmdStan'

Sampler diagnostic summaries and warnings

Description

Warnings and summaries of sampler diagnostics. To instead get the underlying values of the sampler diagnostics for each iteration and chain use the $sampler_diagnostics() method.

Currently parameter-specific diagnostics like R-hat and effective sample size are not handled by this method. Those diagnostics are provided via the $summary() method (using posterior::summarize_draws()).

Usage

diagnostic_summary(
  diagnostics = c("divergences", "treedepth", "ebfmi"),
  quiet = FALSE
)

Arguments

diagnostics	(character vector) One or more diagnostics to check. The currently supported diagnostics are ⁠"divergences⁠, "treedepth", and ⁠"ebfmi⁠. The default is to check all of them.
quiet	(logical) Should warning messages about the diagnostics be suppressed? The default is FALSE, in which case warning messages are printed in addition to returning the values of the diagnostics.

Value

A list with as many named elements as diagnostics selected. The possible elements and their values are:

• "num_divergent": A vector of the number of divergences per chain.

• "num_max_treedepth": A vector of the number of times max_treedepth was hit per chain.

• "ebfmi": A vector of E-BFMI values per chain.

See Also

CmdStanMCMC and the $sampler_diagnostics() method

Examples

## Not run: 
fit <- cmdstanr_example("schools")
fit$diagnostic_summary()
fit$diagnostic_summary(quiet = TRUE)

## End(Not run)

stan-dev/cmdstanr documentation built on May 1, 2024, 7:17 a.m.