The workflowr R package helps researchers organize their analyses in a way that promotes effective project management, reproducibility, collaboration, and sharing of results. Workflowr combines literate programming (knitr and rmarkdown) and version control (Git, via git2r) to generate a website containing time-stamped, versioned, and documented results. Any R user can quickly and easily adopt workflowr.
For more details, see the online documentation. For an example, see the Divvy data exploration project. To keep up-to-date with the latest workflowr developments, please join the workflowr-announce mailing list (low-volume, read-only). For bugs reports, feature requests, and questions, please open an Issue.
For those with existing workflowr projects (pre-1.0.0), see
?wflow_update if you’re interested in updating your project to use the latest features. If you like your current project the way it is, you can continue to use workflowr as you have been by getting the latest bug fixes from workflowrBeta.
To see a workflowr website in action, see this video demonstration.
For related tools, see r-project-workflows.
library("workflowr") # Configure Git (only need to do once per computer) wflow_git_config(user.name = "Full Name", user.email = "email@domain") # Start a new workflowr project wflow_start("myproject") # Build the site wflow_build() # Customize your site! # 1. Edit the R Markdown files in analysis/ # 2. Edit the theme and layout in analysis/_site.yml # 3. Add new or copy existing R Markdown files to analysis/ # Preview your changes wflow_build() # Publish the site, i.e. version the source code and HTML results wflow_publish("analysis/*", "Start my new project")
Workflowr was developed, and is maintained, by John Blischak, a postdoctoral researcher in the laboratory of Matthew Stephens at The University of Chicago. He is funded by a grant from the Gordon and Betty Moore Foundation to MS. Peter Carbonetto and Matthew Stephens are co-authors.
We are very thankful to workflowr contributors for helping improve the package. We are also grateful for workflowr users for testing the package and providing feedback—thanks especially to Lei Sun, Xiang Zhu, Wei Wang, and other members (past and present) of the Stephens lab.
The workflowr package uses many great open source packages. Especially critical for this project are the R packages git2r, knitr, and rmarkdown. Please see the vignette How the workflowr package works to learn about the software that makes workflowr possible.
Workflowr is available under the MIT license. Please run
citation("workflowr") for proper attribution.