Skip to contents

Plot model convergence of multiple modelling alternatives

Source: R/mod_convergence_plot_all.R
Convergence_Plot_All.Rd

This function generates and saves a series of diagnostic plots to assess the convergence of Hmsc models across multiple modelling alternatives. It checks model convergence using trace plots and Gelman-Rubin diagnostics for key model parameters.

Usage

convergence_plot_all(
  model_dir = NULL,
  n_omega = 1000L,
  n_cores = NULL,
  strategy = "multisession",
  margin_type = "histogram"
)

Arguments

model_dir

Character. Path to the root directory of the fitted model. The convergence outputs will be saved to the Model_Convergence_All subfolder.

n_omega

Integer. Number of species interactions sampled for Omega parameter diagnostics. Default: 1000L

n_cores

Integer. Number of CPU cores to use for parallel processing.

strategy

Character. The parallel processing strategy to use. Valid options are "sequential", "multisession" (default), "multicore", and "cluster". See future::plan() and ecokit::set_parallel() for details.

margin_type

Character. The type of marginal plot to add to the main plot. Valid options are "histogram" (default) or "density".

Value

The function does not return anything but saves a series of diagnostic plots in the specified path.

Author

Ahmed El-Gabbas