Published October 14, 2019
| Version v1
Journal article
Open
Creating and sharing reproducible research code the workflowr way
Description
Making scientific analyses reproducible, well documented, and easily shareable is crucial to maximizing their impact and ensuring that others can build on them. However, accomplishing these goals is not easy, requiring careful attention to organization, workflow, and familiarity with tools that are not a regular part of every scientist's toolbox. We have developed an R package, workflowr, to help all scientists, regardless of background, overcome these challenges. Workflowr aims to instill a particular "workflow" — a sequence of steps to be repeated and integrated into research practice — that helps make projects more reproducible and accessible.This workflow integrates four key elements: (1) version control (via Git); (2) literate programming (via R Markdown); (3) automatic checks and safeguards that improve code reproducibility; and (4) sharing code and results via a browsable website. These features exploit powerful existing tools, whose mastery would take considerable study. However, the workflowr interface is simple enough that novice users can quickly enjoy its many benefits. By simply following the workflowr "workflow", R users can create projects whose results, figures, and development history are easily accessible on a static website — thereby conveniently shareable with collaborators by sending them a URL — and accompanied by source code and reproducibility safeguards. The workflowr R package is open source and available on CRAN, with full documentation and source code available at https://github.com/jdblischak/workflowr.
Data availability
All data underlying the results are available as part of the article and no additional source data are required.
Software available from: https://cran.r-project.org/package=workflowr
Source code available from: https://github.com/jdblischak/workflowr
Archived source code at time of publication: https://doi.org/10.5281/zenodo.3241801
Files
Creating-and-sharing-reproducible-research-code-the-workflowr-way.pdf
Files
(1.1 MB)
| Name | Size | Download all |
|---|---|---|
|
md5:7f11d651314f9b6893b9e70557af6f0c
|
1.1 MB | Preview Download |
Additional details
Identifiers
- DOI
- 10.12688/f1000research.20843.1
- Other
- oai:uchicago.tind.io:5693
Funding
- Gordon and Betty Moore Foundation
- 4559