Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/epiverse-trace/serofoi
Estimates the Force-of-Infection of a given pathogen from population based sero-prevalence studies
https://github.com/epiverse-trace/serofoi
antibodies bayesian-methods epidemiology epiverse r r-package serological-surveys stan-language
Last synced: 2 months ago
JSON representation
Estimates the Force-of-Infection of a given pathogen from population based sero-prevalence studies
- Host: GitHub
- URL: https://github.com/epiverse-trace/serofoi
- Owner: epiverse-trace
- License: other
- Created: 2022-08-08T23:45:21.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-28T09:13:58.000Z (2 months ago)
- Last Synced: 2024-11-28T10:19:28.048Z (2 months ago)
- Topics: antibodies, bayesian-methods, epidemiology, epiverse, r, r-package, serological-surveys, stan-language
- Language: R
- Homepage: https://epiverse-trace.github.io/serofoi/
- Size: 14.8 MB
- Stars: 17
- Watchers: 4
- Forks: 4
- Open Issues: 29
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
---
output: github_document
editor_options:
markdown:
wrap: 72
bibliography: vignettes/references.bib
link-citations: true
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
```
## *serofoi*: force-of-infection from population based serosurveys with age-disaggregated data 
[](https://opensource.org/licenses/MIT)
[](https://github.com/epiverse-trace/serofoi/actions/workflows/R-CMD-check.yaml)
[](https://app.codecov.io/gh/epiverse-trace/serofoi/tree/dev/R?displayType=list)
[](https://www.reconverse.org/lifecycle.html#maturing)
***serofoi*** is an R package to estimate the *Force-of-Infection (FoI)* of a given pathogen from age-disaggregated population-based cross-sectional serosurveys, using a Bayesian framework. The package provides a set of features for assessing model fitting, convergence and visualisation.
***serofoi*** relies on the [`rstan`](https://mc-stan.org/users/interfaces/rstan) package, which provides an R interface for the Stan programming language for statistical Bayesian modelling. Particularly, ***serofoi*** relies on the use of a *Hamiltonian Monte Carlo (HMC)* algorithm implemented by *Stan for Markov chain Monte Carlo (MCMC)* sampling. The implemented methods are outlined in [@cucunubá2017] and [@carrera2020] (see [FoI Models](https://epiverse-trace.github.io/serofoi/articles/foi_models.html) for further details)
***serofoi*** is part of the [Epiverse Initiative](https://data.org/initiatives/epiverse/).
## Installation
You can install the **development version** of ***serofoi*** from [GitHub](https://github.com/) with:
``` r
if(!require("pak")) install.packages("pak")
pak::pak("epiverse-trace/serofoi")
```
## Quick start
```{r cleaning, include = FALSE, echo = TRUE}
library(serofoi)
```
***serofoi*** provides a minimal serosurvey dataset, `serodata`, that can be used to test out the package.
```{r ex, include = TRUE}
# Load example dataset chagas2012 included with the package
data(chagas2012)
head(chagas2012, 5)
```
The function `prepare_serodata` will prepare the entry data for the use of the modelling module; this function computes the sample size, the years of birth and the binomial confidence interval for each age group in the provided dataset. A visualisation of the prepared seroprevalence data can be obtained using the function plot_seroprev:
```{r data_test, include = TRUE, out.fig.height="30%", out.width="50%", fig.align="center", message=FALSE, warning=FALSE}
serodata_test <- prepare_serodata(chagas2012)
plot_seroprev(serodata_test, size_text = 15)
```
### Contributions
Contributors to the project include:
- [Zulma M. Cucunubá](https://github.com/zmcucunuba) (author,
maintainer)
- [Nicolás Torres](https://github.com/ntorresd) (author)
- [Ben Lambert](https://ben-lambert.com/about/) (author)
- [Pierre Nouvellet](https://github.com/pnouvellet) (author)
- [Geraldine Gómez](https://github.com/megamezl) (contributor)
- [Jaime A. Pavlich-Mariscal](https://github.com/jpavlich) (contributor)
- [Miguel Gamez](https://github.com/megamezl) (contributor)
- [Hugo Gruson](https://github.com/Bisaloo) (contributor)
- [David Santiago Quevedo](https://github.com/davidsantiagoquevedo) (contributor)
- [Everlyn Kamau](https://github.com/ekamau) (contributor)
- [Richard Creswell](https://github.com/rccreswell) (contributor)
- [Sumali Bajaj](https://github.com/sumalibajaj) (contributor)
## Package vignettes
More details on how to use ***serofoi*** can be found in the
[online documentation](https://epiverse-trace.github.io/serofoi/) as package vignettes, under
[**Get Started**](https://epiverse-trace.github.io/serofoi/articles/serofoi.html),
[**An Introduction to FoI Models**](https://epiverse-trace.github.io/serofoi/articles/foi_models.html) and
[**Real-life Use Cases for serofoi**](https://epiverse-trace.github.io/serofoi/articles/use_cases.html)
## Help
To report a bug please open an
[issue](https://github.com/epiverse-trace/serofoi/issues).
## Contribute
Contributions to ***serofoi*** are welcomed. Please follow the
[package contributing guide](https://github.com/epiverse-trace/serofoi/blob/main/.github/CONTRIBUTING.md).
## Code of conduct
Please note that the ***serofoi*** project is released with a
[Contributor Code of Conduct](https://github.com/epiverse-trace/.github/blob/main/CODE_OF_CONDUCT.md).
By contributing to this project, you agree to abide by its terms.
## References