This vignette can be referred to by citing the package:

- Makowski, D., Ben-Shachar, M. S., & Lüdecke, D. (2019).
*bayestestR: Describing Effects and their Uncertainty, Existence and Significance within the Bayesian Framework*. Journal of Open Source Software, 4(40), 1541. https://doi.org/10.21105/joss.01541 - Makowski, D., Ben-Shachar, M. S., Chen, S. H. A., & Lüdecke, D. (2019).
*Indices of Effect Existence and Significance in the Bayesian Framework*. Frontiers in Psychology 2019;10:2767. 10.3389/fpsyg.2019.02767

The **Probability of Direction (pd)** is an index of **effect existence**, ranging from 50% to 100%, representing the certainty with which an effect goes in a particular direction (*i.e.*, is positive or negative).

Beyond its **simplicity of interpretation, understanding and computation**, this index also presents other interesting properties:

- It is
**independent from the model**: It is solely based on the posterior distributions and does not require any additional information from the data or the model. - It is
**robust**to the scale of both the response variable and the predictors. - It is strongly correlated with the frequentist
, and can thus be used to draw parallels and give some reference to readers non-familiar with Bayesian statistics.*p*-value

However, this index is not relevant to assess the magnitude and importance of an effect (the meaning of “significance”), which is better achieved through other indices such as the ROPE percentage. In fact, indices of significance and existence are totally independent. You can have an effect with a *pd* of **99.99%**, for which the whole posterior distribution is concentrated within the `[0.0001, 0.0002]`

range. In this case, the effect is **positive with a high certainty**, but also **not significant** (*i.e.*, very small).

Indices of effect existence, such as the *pd*, are particularly useful in exploratory research or clinical studies, for which the focus is to make sure that the effect of interest is not in the opposite direction (for clinical studies, that a treatment is not harmful). However, once the effect’s direction is confirmed, the focus should shift toward its significance, including a precise estimation of its magnitude, relevance and importance.

In most cases, it seems that the *pd* has a direct correspondence with the frequentist **one-sided p-value** through the formula: \[p_{one-sided} =
1-p_d\] Similarly, the

But if it’s like thep-value, it must be bad because thep-value is bad [insert reference to the reproducibility crisis].

In fact, this aspect of the reproducibility crisis might have been misunderstood. Indeed, it is not that the *p*-value is an intrinsically bad or wrong. Instead, it is its **misuse**, **misunderstanding** and **misinterpretation** that fuels the decay of the situation. For instance, the fact that the **pd** is highly correlated with the *p*-value suggests that the latter is more an index of effect *existence* than *significance* (*i.e.*, “worth of interest”). The Bayesian version, the **pd**, has an intuitive meaning and makes obvious the fact that **all thresholds are arbitrary**. Additionally, the **mathematical and interpretative transparency** of the **pd**, and its reconceptualisation as an index of effect existence, offers a valuable insight into the characterization of Bayesian results. Moreover, its concomitant proximity with the frequentist *p*-value makes it a perfect metric to ease the transition of psychological research into the adoption of the Bayesian framework.

The most **simple and direct** way to compute the **pd** is to 1) look at the median’s sign, 2) select the portion of the posterior of the same sign and 3) compute the percentage that this portion represents. This “simple” method is the most straightforward, but its precision is directly tied to the number of posterior draws.

The second approach relies on **density estimation**. It starts by estimating the density function (for which many methods are available), and then computing the **area under the curve** (AUC) of the density curve on the other side of 0. The density-based method could hypothetically be considered as more precise, but strongly depends on the method used to estimate the density function.

Let’s compare the 4 available methods, the **direct** method and 3 **density-based** methods differing by their density estimation algorithm (see `estimate_density`

).

Let’s start by testing the proximity and similarity of the results obtained by different methods.

```
library(bayestestR)
library(logspline)
library(KernSmooth)
# Compute the correlations
<- data.frame()
data for (the_mean in runif(25, 0, 4)) {
for (the_sd in runif(25, 0.5, 4)) {
<- rnorm(100, the_mean, abs(the_sd))
x <- rbind(
data
data,data.frame(
"direct" = pd(x),
"kernel" = pd(x, method = "kernel"),
"logspline" = pd(x, method = "logspline"),
"KernSmooth" = pd(x, method = "KernSmooth")
)
)
}
}<- as.data.frame(sapply(data, as.numeric))
data
# Visualize the correlations
library(ggplot2)
library(GGally)
::ggpairs(data) +
GGallytheme_classic()
```

All methods give are highly correlated and give very similar results. That means that the method choice is not a drastic game changer and cannot be used to tweak the results too much.

To test the accuracy of each methods, we will start by computing the **direct pd** from a very dense distribution (with a large amount of observations). This will be our baseline, or “true”

```
<- data.frame()
data for (i in 1:25) {
<- runif(1, 0, 4)
the_mean <- abs(runif(1, 0.5, 4))
the_sd <- rnorm(100000, the_mean, the_sd)
parent_distribution <- pd(parent_distribution)
true_pd
for (j in 1:25) {
<- round(runif(1, 25, 5000))
sample_size <- sample(parent_distribution, sample_size)
subsample <- rbind(
data
data,data.frame(
"sample_size" = sample_size,
"true" = true_pd,
"direct" = pd(subsample) - true_pd,
"kernel" = pd(subsample, method = "kernel") - true_pd,
"logspline" = pd(subsample, method = "logspline") - true_pd,
"KernSmooth" = pd(subsample, method = "KernSmooth") - true_pd
)
)
}
}<- as.data.frame(sapply(data, as.numeric)) data
```

```
library(tidyr)
library(dplyr)
%>%
data ::gather(Method, Distance, -sample_size, -true) %>%
tidyrggplot(aes(x = sample_size, y = Distance, color = Method, fill = Method)) +
geom_point(alpha = 0.3, stroke = 0, shape = 16) +
geom_smooth(alpha = 0.2) +
geom_hline(yintercept = 0) +
theme_classic() +
xlab("\nDistribution Size")
```

The “Kernel” based density methods seems to consistently underestimate the *pd*. Interestingly, the “direct” method appears as being the more reliable, even in the case of small number of posterior draws.

`p = 0.000`

is coined as one of the term to avoid when reporting results (Lilienfeld et al., 2015), even if often displayed by statistical software. The rationale is that for every probability distribution, there is no value with a probability of exactly 0. There is always some infinitesimal probability associated with each data point, and the `p = 0.000`

returned by software is due to approximations related, among other, to finite memory hardware.

One could apply this rationale for the *pd*: since all data points have a non-null probability density, then the *pd* (a particular portion of the probability density) can *never* be 100%. While this is an entirely valid point, people using the *direct* method might argue that their *pd* is based on the posterior draws, rather than on the theoretical, hidden, true posterior distribution (which is only approximated by the posterior draws). These posterior draws represent a finite sample for which `pd = 100%`

is a valid statement.

Lilienfeld, S. O., Sauvigné, K. C., Lynn, S. J., Cautin, R. L., Latzman, R. D., & Waldman, I. D. (2015). Fifty psychological and psychiatric terms to avoid: A list of inaccurate, misleading, misused, ambiguous, and logically confused words and phrases. *Frontiers in Psychology*, *6*, 1100. https://doi.org/10.3389/fpsyg.2015.01100