# Introduction to Bayesian Compositional Multilevel Modelling

Source:`vignettes/A-introduction.Rmd`

`A-introduction.Rmd`

The `multilevelcoda`

package implements Bayesian
multilevel models for compositional data in R, by combining the
principles of the two well-known analyses, Multilevel Modelling and
Compositional Data Analysis. Formula syntax is built using package brms
and is similar to package lme4, which allows for different modelling
options in a multilevel framework. The package also provides several
useful functions for post-hoc analyses and visualisation of final
results.

## Compositional Data Analysis

Compositional data analysis (CoDA) is an analysis of compositional and multivariate positive data. Compositional data are typically expressed in amount, e.g., percentage, proportion, and often sum up to a constant, usually 100% or one. These data are common in many fields: ecology (e.g., relative abundances of species), geography (e.g., proportions of land use), biochemistry (e.g., fatty acid proportions), nutritional epidemiology (e.g., intake of macronutrients like proteins, fats and carbohydrates), and time-use epidemiology (e.g., time spent in different sleep-wake behaviours during the 24-hour day).

## Multilevel Modelling for Compositional Data

Compositional data can be non-independent and repeated measures data. For example, sleep-wake behaviours are often measured across multiple time points (e.g., across several consecutive days).

Therefore, we often use multilevel models to include both fixed effects (regression coefficients that are identical for everyone) and random effects (regression coefficients that vary randomly for each person). In addition, we can also decompose these data into two sources of variability: between-person (differences between individuals) and within-person (differences within individuals).

In `multilevelcoda`

package, we implements Compositional
Multilevel Model to model compositional data in amultilevel framework.
`mulitlevelcoda`

includes functions to compute Isometric log
ratio (ILR) for between and within-person levels, fit Baysian multilevel
model, and conduct post-hoc analyses such as susbtitution models. See
below for vignettes: