This vignette can be referred to by citing the package:


library(knitr)

knitr::opts_chunk$set(comment = ">")
options(knitr.kable.NA = "")
options(digits = 2)

if (!requireNamespace("rstanarm", quietly = TRUE)) {
  knitr::opts_chunk$set(eval = FALSE)
} else {
  library(rstanarm)
  library(bayestestR)
}

Why use the Bayesian Framework?

The Bayesian framework for statistics is quickly gaining in popularity among scientists, associated with the general shift towards open and honest science. Reasons to prefer this approach are:

In general, the frequentist approach has been associated with the focus on the null hypothesis testing, and the misuse of p-values has been shown to critically contribute to the reproducibility crisis in social and psychological sciences [@chambers2014instead; @szucs2016empirical]. There is an emerging consensus that the generalization of the Bayesian approach is one way of overcoming these issues [@benjamin2018redefine; @etz2016bayesian].

Once we agree that the Bayesian framework is the right way to go, you might wonder what exactly is this framework.

What's all the fuss about?

What is the Bayesian Framework?

Adopting the Bayesian framework is more of a shift in the paradigm than a change in the methodology. Indeed, all the common statistical procedures (t-tests, correlations, ANOVAs, regressions, etc.) can be achieved using the Bayesian framework. The key difference is that in the frequentist framework (the "classical" approach to statistics, with p and t values, as well as some weird degrees of freedom), the effects are fixed (but unknown) and data are random. In other words, it assumes that the unknown parameter has a unique value that we are trying to estimate/guess using our sample data. On the other hand, in the Bayesian framework, instead of estimating the "true effect", the probability of different effects given the observed data is computed, resulting in a distribution of possible values for the parameters, called the posterior distribution.

The uncertainty in Bayesian inference can be summarized, for instance, by the median of the distribution, as well as a range of values of the posterior distribution that includes the 95\% most probable values (the 95\% credible interval). Cum grano salis, these are considered the counterparts to the point-estimate and confidence interval in a frequentist framework. To illustrate the difference of interpretation, the Bayesian framework allows to say "given the observed data, the effect has 95\% probability of falling within this range", while the frequentist (less intuitive) alternative would be "when repeatedly computing confidence intervals from data of this sort, there is a 95\% probability that the effect falls within a given range". In essence, the Bayesian sampling algorithms (such as MCMC sampling) return a probability distribution (the posterior) of an effect that is compatible with the observed data. Thus, an effect can be described by characterizing its posterior distribution in relation to its centrality (point-estimates), uncertainty, as well as its existence and significance

In other words, putting the maths behind it aside for a moment, we can say that:

knitr::include_graphics("../man/figures/bayesianMaster.jpg")

Note: Altough the very purpose of this package is to advocate for the use of Bayesian statistics, please note that there are serious arguments supporting frequentist indices (see for instance this thread). As always, the world is not black and white (p \< .001).

So... how does it work?

A simple example

bayestestR installation

You can install bayestestR along with the whole easystats suite by running the following:

install.packages("remotes")
remotes::install_github("easystats/easystats")

Let's also install and load the rstanarm, that allows fitting Bayesian models, as well as bayestestR, to describe them.

install.packages("rstanarm")
library(rstanarm)

Traditional linear regression

Let's start by fitting a simple frequentist linear regression (the lm() function stands for linear model) between two numeric variables, Sepal.Length and Petal.Length from the famous iris dataset, included by default in R.

model <- lm(Sepal.Length ~ Petal.Length, data = iris)
summary(model)
model <- lm(Sepal.Length ~ Petal.Length, data = iris)
summary(model)

This analysis suggests that there is a statistically significant (whatever that means) and positive (with a coefficient of 0.41) linear relationship between the two variables.

Fitting and interpreting the frequentist models is so easy that it is obvious that people use it instead of the Bayesian framework... right?

Not anymore.

Bayesian linear regression

model <- stan_glm(Sepal.Length ~ Petal.Length, data = iris)
posteriors <- describe_posterior(model)
# for a nicer table
print_md(posteriors, digits = 2)
set.seed(333)
model <- stan_glm(Sepal.Length ~ Petal.Length, data = iris, refresh = 0)
posteriors <- describe_posterior(model)
# for a nicer table
print_md(posteriors, digits = 2)

That's it!

You just fitted a Bayesian version of the model by simply using the stan_glm() function instead of lm() and described the posterior distributions of the parameters!

The conclusion we draw, for this example, are very similar. The effect (the median of the effect's posterior distribution) is about 0.41, and it can be also be considered as significant in the Bayesian sense (more on that later).

So, ready to learn more?

Check out the next tutorial!

And, if you want even more, you can check out other articles describing all the functionality the package has to offer!

https://easystats.github.io/bayestestR/articles/

References



easystats/bayestestR documentation built on April 22, 2024, 10:20 p.m.