Skip to contents

Plot Posterior Distributions for Model Comparison

Source: R/plot_posterior.R
plot_posterior.Rd

Visualizes posterior density distributions for selected parameters, allowing easy comparison between multiple models (e.g., Default vs. Custom priors) or inspection of a single model.

Usage

plot_posterior(
  models,
  parameter,
  col = NULL,
  lwd = 2,
  legend_pos = "topleft",
  density_args = list(),
  ...
)

Arguments

models

A because object or a named list of because objects. If a list is provided, the names are used for the legend. Example: list("Default" = fit1, "Custom" = fit2).

parameter

Character string. A regular expression or exact name of the parameter(s) to plot. Example: "beta", "^alpha", "beta_Y_X". Plots all matching parameters.

col

Optional vector of colors. Defaults to a standard palette (black, blue, red, etc.).

lwd

Line width (default = 2).

legend_pos

Legend position (default = "topleft"). Set to NULL to suppress.

density_args

List of additional arguments passed to stats::density(). Useful for handling boundary corrections (e.g., list(from=0) for truncated priors).

...

Additional arguments passed to plot().

Value

Invisible NULL. Produces a plot.

Examples

if (FALSE) { # \dontrun{
fit <- because(list(Y ~ X), data = my_data)
plot_posterior(fit, parameter = "beta_Y_X")
} # }