plot.BFF

Creates a Bayes factor function plot
of an BFF object. The BFF object needs to be specified
with <code>omega = NULL</code> or .

Bayes factors represent the ratio of probabilities assigned to data by competing scientific hypotheses. However, one drawback of Bayes factors is their dependence on prior specifications that define null and alternative hypotheses. Additionally, there are challenges in their computation. To address these issues, we define Bayes factor functions (BFFs) directly from common test statistics. BFFs express Bayes factors as a function of the prior densities used to define the alternative hypotheses. These prior densities are centered on standardized effects, which serve as indices for the BFF. Therefore, BFFs offer a summary of evidence in favor of alternative hypotheses that correspond to a range of scientifically interesting effect sizes. Such summaries remove the need for arbitrary thresholds to determine "statistical significance." BFFs are available in closed form and can be easily computed from z, t, chi-squared, and F statistics. They depend on hyperparameters "r" and "tau^2", which determine the shape and scale of the prior distributions defining the alternative hypotheses. Plots of BFFs versus effect size provide informative summaries of hypothesis tests that can be easily aggregated across studies.

Rachael Shudde

Bayes Factor Functions

František Bartoš

Saptati Datta

Riana Guha

Sandy Pramanik

Valen Johnson

plot.BFF function

<dl><dt>x</dt>
<dd>a BFF object</dd>
<dt>plot</dt>
<dd>whether plot should be generated.
Default to <code>TRUE</code>. If <code>FALSE</code> a data
frame with the support, prior ordinates, and
posterior ordinates is returned instead.</dd>
<dt>...</dt>
<dd>additional arguments to the plotting
function. These include:<dl>
 <dt>"title"</dt>
<dd>tile of the figure</dd></dl></dd> <dt>"xlab"</dt>
<dd>x-axis label of the figure</dd> <dt>"ylab"</dt>
<dd>y-axis label of the figure</dd> <dt>"add_segments"</dt>
<dd>whether effect size
 segments should be added to the figure. Available only
 for standardized effect sizes. Defaults to <code>TRUE</code></dd>
</dl>

Arguments

Plot Bayes Factor Function — plot.BFF

<dl>

<dt>x</dt>
<dd>a BFF object</dd>


<dt>plot</dt>
<dd>whether plot should be generated.
Default to <code>TRUE</code>. If <code>FALSE</code> a data
frame with the support, prior ordinates, and
posterior ordinates is returned instead.</dd>


<dt>...</dt>
<dd>additional arguments to the plotting
function. These include:<dl>
 <dt>"title"</dt>
<dd>tile of the figure</dd>

 <dt>"xlab"</dt>
<dd>x-axis label of the figure</dd>

 <dt>"ylab"</dt>
<dd>y-axis label of the figure</dd>

 <dt>"add_segments"</dt>
<dd>whether effect size
 segments should be added to the figure. Available only
 for standardized effect sizes. Defaults to <code>TRUE</code></dd>


</dl></dd>

</dl>

plot.BFF: Plot Bayes Factor Function

Description

Usage

Value

Arguments

See Also