Creating and sharing reproducible research code the workflowr way

F1000Res. 2019 Oct 14:8:1749. doi: 10.12688/f1000research.20843.1. eCollection 2019.

Abstract

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.

Keywords: R; interactive programming; literate programming; open science; reproducibility; version control; workflow.

Publication types

  • Research Support, Non-U.S. Gov't

MeSH terms

  • Information Dissemination*
  • Reproducibility of Results
  • Software*
  • Workflow*

Grants and funding

This work was supported by the Gordon and Betty Moore Foundation [4559].