Published October 14, 2019 | Version v1
Journal article Open

Creating and sharing reproducible research code the workflowr way

  • 1. University of Chicago

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)

Additional details

Identifiers

DOI
10.12688/f1000research.20843.1
Other
oai:uchicago.tind.io:5693

Funding

Gordon and Betty Moore Foundation
4559

UChicago Information

Division(s)
Biological Sciences Division, Physical Sciences Division
Department(s)
Human Genetics, Statistics