plot_decision_assurance_curve

Plots the assurance (proportion of simulation runs meeting a
posterior probability decision rule) versus an effect grid variable,
for a given metric ("direction", "threshold", or "rope") at a fixed
decision probability threshold p_star.

Provides tools for Bayesian power analysis and assurance calculations using the statistical frameworks of 'brms' and 'INLA'. Includes simulation-based approaches, support for multiple decision rules (direction, threshold, ROPE), sequential designs, and visualisation helpers. Methods are based on Kruschke (2014, ISBN:9780124058880) "Doing Bayesian Data Analysis: A Tutorial with R, JAGS, and Stan", O'Hagan & Stevens (2001) <doi:10.1177/0272989X0102100307> "Bayesian Assessment of Sample Size for Clinical Trials of Cost-Effectiveness", Kruschke (2018) <doi:10.1177/2515245918771304> "Rejecting or Accepting Parameter Values in Bayesian Estimation", Rue et al. (2009) <doi:10.1111/j.1467-9868.2008.00700.x> "Approximate Bayesian inference for latent Gaussian models by using integrated nested Laplace approximations", and Bürkner (2017) <doi:10.18637/jss.v080.i01> "brms: An R Package for Bayesian Multilevel Models using Stan".

Tony Myers

powerbrmsINLA

Bayesian Power Analysis Using 'brms' and 'INLA'

plot_decision_assurance_curve function

<dl><dt>power_results</dt>
<dd>A list returned by <code>brms_inla_power*</code>.</dd>
<dt>metric</dt>
<dd>Decision metric: "direction", "threshold", or "rope".</dd>
<dt>p_star</dt>
<dd>Numeric decision threshold in (0,1).</dd>
<dt>x_effect</dt>
<dd>Name of effect grid column for x-axis (default: first grid column).</dd>
<dt>facet_by</dt>
<dd>Optional effect grid column(s) to facet by.</dd>
<dt>effect_filters</dt>
<dd>Optional named list for filtering rows, e.g. list(treatment=0).</dd>
<dt>effect_weights</dt>
<dd>Optional named numeric vector of weights for selected x_effect values.</dd>
<dt>title, subtitle</dt>
<dd>Optional plot labels.</dd></dl>

Arguments

Plot Decision Assurance Curve (Multi-Effect Grid Friendly) — plot_decision_assurance_curve

<dl>

<dt>power_results</dt>
<dd>A list returned by <code>brms_inla_power*</code>.</dd>


<dt>metric</dt>
<dd>Decision metric: "direction", "threshold", or "rope".</dd>


<dt>p_star</dt>
<dd>Numeric decision threshold in (0,1).</dd>


<dt>x_effect</dt>
<dd>Name of effect grid column for x-axis (default: first grid column).</dd>


<dt>facet_by</dt>
<dd>Optional effect grid column(s) to facet by.</dd>


<dt>effect_filters</dt>
<dd>Optional named list for filtering rows, e.g. list(treatment=0).</dd>


<dt>effect_weights</dt>
<dd>Optional named numeric vector of weights for selected x_effect values.</dd>


<dt>title, subtitle</dt>
<dd>Optional plot labels.</dd>

</dl>

plot_decision_assurance_curve: Plot Decision Assurance Curve (Multi-Effect Grid Friendly)

Description

Usage

Value

Arguments