plot_power_contour

Draw a filled contour plot of assurance for a chosen metric,
as a function of two effect grid columns and sample size.

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_power_contour function

<dl><dt>power_results</dt>
<dd>Output from a <code>brms_inla_power</code> function.</dd>
<dt>power_metric</dt>
<dd>Which metric to plot: "direction", "threshold", or "rope".</dd>
<dt>x_effect</dt>
<dd>Name of effect grid column for x-axis (default = first effect).</dd>
<dt>y_effect</dt>
<dd>Name of effect grid column for y-axis (default = "n").</dd>
<dt>facet_by</dt>
<dd>Optional effect grid column(s) to facet by.</dd>
<dt>power_threshold</dt>
<dd>Optional contour line for assurance (default 0.8).</dd>
<dt>show_threshold_line</dt>
<dd>Logical; add a red contour at <code>power_threshold</code>.</dd>
<dt>title, subtitle</dt>
<dd>Optional plot labels.</dd></dl>

Arguments

Draw a filled contour plot of assurance for a chosen metric,
as a function of two effect grid columns and sample size. — plot_power_contour

<dl>

<dt>power_results</dt>
<dd>Output from a <code>brms_inla_power</code> function.</dd>


<dt>power_metric</dt>
<dd>Which metric to plot: "direction", "threshold", or "rope".</dd>


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


<dt>y_effect</dt>
<dd>Name of effect grid column for y-axis (default = "n").</dd>


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


<dt>power_threshold</dt>
<dd>Optional contour line for assurance (default 0.8).</dd>


<dt>show_threshold_line</dt>
<dd>Logical; add a red contour at <code>power_threshold</code>.</dd>


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

</dl>

plot_power_contour: Draw a filled contour plot of assurance for a chosen metric, as a function of two effect grid columns and sample size.

Description

Usage

Value

Arguments