A complete declarative description of the computational environment is often missing when researchers share their materials. Without such description, software obsolescence and missing system components can jeopardize computational reproducibility in the future, even when data and computer code are available. The R package rang is a complete solution for generating the declarative description for other researchers to automatically reconstruct the computational environment at a specific time point. The reconstruction process, based on Docker, has been tested for R code as old as 2001. The declarative description generated by rang satisfies the definition of a reproducible research compendium and can be shared as such. In this contribution, we show how rang can be used to make otherwise unexecutable code, spanning from fields such as computational social science and bioinformatics, executable again. We also provide instructions on how to use rang to construct reproducible and shareable research compendia of current research. The package is currently available from CRAN (https://cran.r-project.org/web/packages/rang/index.html) and GitHub (https://github.com/chainsawriot/rang).
翻译:摘要:研究人员在分享其研究材料时,往往缺少对计算环境的完整声明性描述。若无此类描述,即便数据和计算机代码可用,软件过时及系统组件缺失也可能危及未来的计算可再现性。R包rang是一个完整的解决方案,用于生成声明性描述,使其他研究者能自动重构特定时间点的计算环境。基于Docker的重构过程已通过测试,可支持最早至2001年的R代码。rang生成的声明性描述满足可再现研究纲要的定义,并可作为此类纲要共享。本文展示了rang如何使原本无法执行的代码(涵盖计算社会科学和生物信息学等领域)重新可执行,并提供使用rang构建当前研究的可再现、可共享研究纲要的指引。该包目前可从CRAN(https://cran.r-project.org/web/packages/rang/index.html)及GitHub(https://github.com/chainsawriot/rang)获取。