/madrat

R package | May All Data be Reproducible and Transparent (MADRaT)

Primary LanguageROtherNOASSERTION

May All Data be Reproducible and Transparent (MADRaT) *

R package madrat, version 3.11.2

CRAN status DOI R build status codecov r-universe

Purpose and Functionality

Provides a framework which should improve reproducibility and transparency in data processing. It provides functionality such as automatic meta data creation and management, rudimentary quality management, data caching, work-flow management and data aggregation. * The title is a wish not a promise. By no means we expect this package to deliver everything what is needed to achieve full reproducibility and transparency, but we believe that it supports efforts in this direction.

Installation

For installation of the most recent package version an additional repository has to be added in R:

options(repos = c(CRAN = "@CRAN@", pik = "https://rse.pik-potsdam.de/r/packages"))

The additional repository can be made available permanently by adding the line above to a file called .Rprofile stored in the home folder of your system (Sys.glob("~") in R returns the home directory).

After that the most recent version of the package can be installed using install.packages:

install.packages("madrat")

Package updates can be installed using update.packages (make sure that the additional repository has been added before running that command):

update.packages()

Tutorial

The package comes with vignettes describing the basic functionality of the package and how to use it. You can load them with the following command (the package needs to be installed):

vignette("madrat-caching") # Data caching in madrat
vignette("madrat-puc")     # Portable unagreggated collections (PUCs) in MADRaT
vignette("madrat")         # Data preparation with madrat

Questions / Problems

In case of questions / problems please contact Jan Philipp Dietrich dietrich@pik-potsdam.de.

Citation

To cite package madrat in publications use:

Dietrich J, Baumstark L, Wirth S, Giannousakis A, Rodrigues R, Bodirsky B, Leip D, Kreidenweis U, Klein D, Sauer P (2024). madrat: May All Data be Reproducible and Transparent (MADRaT). doi:10.5281/zenodo.1115490 https://doi.org/10.5281/zenodo.1115490, R package version 3.11.2, https://github.com/pik-piam/madrat.

A BibTeX entry for LaTeX users is

@Manual{,
 title = {madrat: May All Data be Reproducible and Transparent (MADRaT)},
 author = {Jan Philipp Dietrich and Lavinia Baumstark and Stephen Wirth and Anastasis Giannousakis and Renato Rodrigues and Benjamin Leon Bodirsky and Debbora Leip and Ulrich Kreidenweis and David Klein and Pascal Sauer},
 year = {2024},
 note = {R package version 3.11.2},
 url = {https://github.com/pik-piam/madrat},
 doi = {10.5281/zenodo.1115490},
}