//localhost:1313/how-to/index.html Purpose Provide task-oriented recipes for common DSAMbayes operational workflows. Each guide starts from a user objective, gives minimal reproducible steps, and includes expected output artefacts and quick verification checks. Audience Users who know the concepts but need execution steps. Engineers debugging run and artefact issues. Pages Guide Objective Run from YAML Execute a complete runner workflow and verify staged outputs Interpret Diagnostics Read and act on diagnostics gate results Compare Runs Compare multiple runs and select a candidate model Debug Run Failures Diagnose and resolve common runner failure modes Hugo en-gb //localhost:1313/how-to/run-from-yaml/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/how-to/run-from-yaml/index.html Objective Execute a complete DSAMbayes model run from a YAML configuration file and verify the staged output artefacts. Prerequisites DSAMbayes installed locally (see Install and Setup). A YAML config file (see Config Schema for structure). Data file(s) referenced by the config are accessible. Steps 1. Set up the environment mkdir -p .Rlib .cache export R_LIBS_USER="$PWD/.Rlib" export XDG_CACHE_HOME="$PWD/.cache" 2. Validate the configuration (dry run) Rscript scripts/dsambayes.R validate --config config/my_config.yaml Expected outcome: //localhost:1313/how-to/interpret-diagnostics/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/how-to/interpret-diagnostics/index.html Objective Read and act on the diagnostics report produced by a DSAMbayes runner execution, understanding which checks matter most and what remediation steps to take. Prerequisites A completed runner run execution with artefacts under 40_diagnostics/. Familiarity with Diagnostics Gates definitions. Steps 1. Open the diagnostics report cat results/<run_dir>/40_diagnostics/diagnostics_report.csv Each row is one diagnostic check. The key columns are: //localhost:1313/how-to/compare-runs/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/how-to/compare-runs/index.html Objective Compare multiple DSAMbayes runner executions and select a candidate model for reporting or decision-making, using predictive scoring and diagnostic summaries. Prerequisites Two or more completed runner run executions (MCMC fit method). Artefacts under 50_model_selection/ for each run (LOO summary, ELPD outputs). Familiarity with Diagnostics Gates and Model Selection Plots. Steps 1. Collect run directories Identify the run directories to compare: //localhost:1313/how-to/debug-run-failures/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/how-to/debug-run-failures/index.html Objective Diagnose and resolve the most common failure modes encountered when running DSAMbayes via the YAML/CLI runner. Prerequisites A failed runner execution (non-zero exit code or missing artefacts). Access to the terminal output or log from the failed run. Familiarity with CLI Usage and Config Schema. Triage by failure stage Stage 0: Config resolution failures Symptoms: runner exits immediately after validate or at the start of run; no run directory created or only 00_run_metadata/ is present.