Learn R Programming

May All Data be Reproducible and Transparent (MADRaT) *

R package madrat, version 3.15.6

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, Version: 3.15.6, https://github.com/pik-piam/madrat.

A BibTeX entry for LaTeX users is

@Misc{,
 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},
 doi = {10.5281/zenodo.1115490},
 date = {2024-12-19},
 year = {2024},
 url = {https://github.com/pik-piam/madrat},
 note = {Version: 3.15.6},
}

Copy Link

Version

Install

install.packages('madrat')

Monthly Downloads

318

Version

3.15.6

License

BSD_2_clause + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Jan Dietrich

Last Published

December 19th, 2024

Functions in madrat (3.15.6)

getMadratInfo

getMadratInfo
getISOlist

get official ISO list
getFlags

getFlags
madapply

madapply
functionCallString

functionCallString
getFromComment

getFromComment
madTempDir

madTempDir
fullEXAMPLE

fullExample
getMadratMessage

getMadratMessage
isWrapperActive

isWrapperActive
getLinkFunction

getLinkFunction
getDependencies

getDependencies
fingerprint

Tool: fingerprint
getConfig

getConfig
findBottlenecks

findBottlenecks
metadataGFZ

metadataGFZ
getLocation

getLocation
getMadratGraph

getMadratGraph
downloadSource

downloadSource
madlapply

madlapply
readSource

readSource
getSourceFolder

getSourceFolder
getSources

getSources
madratAttach

madratAttach / madratDetach
resetMadratMessages

resetMadratMessages
madrat-package

May All Data be Reproducible And Transparent (madrat) *
prepExtendedComment

prepExtendedComment
prepComment

prepComment
retrieveData

retrieveData
toolFillWithRegionAvg

Tool: FillWithRegionAvg
prepFunctionName

prepFunctionName
toolFillYears

toolFillYears
getMainfolder

getMainfolder
pucAggregate

pucAggregate
putMadratMessage

putMadratMessage
initializeConfig

initializeConfig
robustOrder

robustOrder, robustSort
getNonDefaultArguments

getNonDefaultArguments
redirectSource

redirectSource
redirect

redirect
toolTimeSpline

toolTimeSpline
readTau

Read Tau
withMadratLogging

Tool: withMadratLogging
toolXlargest

toolXlargest
redirectTau

redirectTau
installedMadratUniverse

installedMadratUniverse
toolAggregate

toolAggregate
toolTimeAverage

toolTimeAverage
toolISOhistorical

Tool: ISOhistorical
toolGetMapping

Tool: GetMapping
toolSubtypeSelect

Tool: SubtypeSelect
setConfig

setConfig
toolManualDownload

Tool: ManualDownload
toolCodeLabels

Tool: CodeLabels
regionscode

Tool: regionscode
vcat

Tool: Verbosity Cat
toolConditionalReplace

toolConditionalReplace
toolConvertMapping

Tool: ConvertMapping
toolNAreplace

Tool: NA replace
toolCountry2isocode

toolCountry2isocode
toolSplitSubtype

Tool: SplitSubtype
toolOrderCells

toolOrderCells
toolCountryFill

Tool: CountryFill
toolendmessage

Tool: End message
visualizeDependencies

visualizeDependencies
toolstartmessage

Tool: Start message
addMapping

addMapping
cacheArgumentsHash

Tool: cacheArgumentsHash
cacheCopy

cacheCopy
cacheCleanup

cacheCleanup
cachePut

Tool: cachePut
cacheGet

Tool: cacheGet
calcOutput

calcOutput
getCalculations

getCalculations
cacheName

Tool: cacheName
compareData

compareData
calcTauTotal

Calculate total tau
getCode

getCode
compareMadratOutputs

Compare a madrat function's output with and without your changes
cleanComment

cleanComment
convertTau

Convert Tau