Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jeffreypullin/rater

R package to fit statistical models to repeated categorical rating data using Stan
https://github.com/jeffreypullin/rater

annotations bayesian bayesian-statistics r r-package stan

Last synced: 3 days ago
JSON representation

R package to fit statistical models to repeated categorical rating data using Stan

Awesome Lists containing this project

README

        

---
output: github_document
---

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE, fig.path = "man/figures/README-")
set.seed(1)
```

# rater

[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/rater)](https://cran.r-project.org/package=rater)
[![R-CMD-check](https://github.com/jeffreypullin/rater/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/jeffreypullin/rater/actions/workflows/R-CMD-check.yaml)
[![Coverage status](https://codecov.io/gh/jeffreypullin/rater/branch/master/graph/badge.svg)](https://app.codecov.io/gh/jeffreypullin/rater?branch=master)
![pkgdown](https://github.com/jeffreypullin/rater/workflows/pkgdown/badge.svg)

**rater** provides tools for fitting and interrogating statistical models of repeated categorical rating data. The package provides a simple interface to fit a selection of these models, with arbitrary prior parameters, using MCMC and optimisation provided by [Stan](https://mc-stan.org/). A selection of functions are also provided to plot parts of these models and extract key parameters.

## Example usage:

```{r fit-demo, message = FALSE, warning = FALSE, results = "hide"}
library(rater)

fit <- rater(anesthesia, "dawid_skene") # Sampling output suppressed.
```

Get the posterior mean of the "pi" parameter.

```{r extract-demo}
point_estimate(fit, "pi")
```

Plot the accuracy matrices of the raters.

```{r plot-demo}
plot(fit, "raters")
```

## Installation

**rater** requires the **rstan** package to fit models. Detailed instructions to install **rstan** can be found [here](https://github.com/stan-dev/rstan/wiki/RStan-Getting-Started)

### CRAN

Install **rater** from CRAN with:

```{r cran-installation, eval = FALSE}
install.packages("rater")
```

### Development

To install the development version of **rater** from GitHub run:

```{r dev-installation, eval = FALSE}
# install.packages("remotes")
remotes::install_github("jeffreypullin/rater")
```

#### Installation notes:

- When installing from source, i.e. when installing the development version or installing from CRAN on Linux, the **Stan** models in the package will be compiled - this will lead to an install time of few minutes. Please be patient - this compilation means that **no** compilation is required when using the package

- During compilation many warnings may be displayed in the terminal; these are harmless but impossible to suppress.