Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 4 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (18.5%) to scientific vocabulary
Keywords
Keywords from Contributors
Repository
Organize your project into a research website
Basic Info
- Host: GitHub
- Owner: workflowr
- License: other
- Language: R
- Default Branch: main
- Homepage: https://workflowr.github.io/workflowr
- Size: 3.3 MB
Statistics
- Stars: 867
- Watchers: 29
- Forks: 106
- Open Issues: 41
- Releases: 29
Topics
Metadata Files
README.md
workflowr: organized + reproducible + shareable data science in R
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 explore reproducible research projects facilitated by workflowr, browse the projects registered at workflowr.io. 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.
Features
- Organized
- Provides a project template with organized subdirectories
- Mixes code and results with R Markdown
- Uses Git to version both source code and results
- Reproducible
- Displays the code version used to create each result
- Runs each analysis in an isolated R session
- Records the session information of each analysis
- Sets the same seed for random number generation for each analysis
- Shareable
- Creates a website to present your research results
- Documents how to host your website for free via GitHub Pages or GitLab Pages
- Creates links to past versions of results
To see a workflowr website in action, see this video demonstration.
For related tools, see r-project-workflows.
Installation
- Install R
* (Recommended) Install [RStudio][rstudio]
* (Optional) Install [pandoc][] ([Instructions][pandoc-install])
* (Optional) Install [Git][git]
Quick start
``` library("workflowr")
Configure Git (only need to do once per computer)
wflowgitconfig(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") ```
Next steps:
Read the full Getting started vignette to learn how to share your results online. Alternatively, you could read the Reproducible research workshop vignette. It covers the same steps, but includes example code and data to demonstrate some of workflowr's reproducibility features
Read the customization vignette for ideas on how to customize your research website
Read the migrating vignette for how to integrate workflowr into your existing project
Attribution
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. For proper attribution, please cite our manuscript that describes the software:
Blischak JD, Carbonetto P, and Stephens M. Creating and sharing reproducible research code the workflowr way [version 1; peer review: 3 approved]. F1000Research 2019, 8:1749 (https://doi.org/10.12688/f1000research.20843.1)
To obtain a BibTeX entry, please run citation("workflowr"). Note that
F1000Research publishes not only the original version but also any revisions. To
check for the latest version, please go to the paper's URL.
Contributing
We welcome community contributions, especially improvements to documentation. To get started, please read the contributing guidelines. Also, please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Owner
- Name: workflowr
- Login: workflowr
- Kind: organization
- Website: https://workflowr.github.io/workflowr/
- Repositories: 3
- Profile: https://github.com/workflowr
A Framework for Reproducible and Collaborative Data Science
GitHub Events
Total
- Create event: 5
- Release event: 1
- Issues event: 7
- Watch event: 34
- Delete event: 3
- Issue comment event: 12
- Push event: 25
- Pull request review event: 1
- Fork event: 1
Last Year
- Create event: 5
- Release event: 1
- Issues event: 7
- Watch event: 34
- Delete event: 3
- Issue comment event: 12
- Push event: 25
- Pull request review event: 1
- Fork event: 1
Committers
Last synced: 9 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| John Blischak | j****k@g****m | 1,146 |
| Peter Carbonetto | p****o@g****m | 43 |
| Jiaxiang Li | a****g@f****m | 21 |
| Zaynaib Giwa | z****g@g****m | 10 |
| Giorgio Comai | g@g****u | 6 |
| Wouter van Amsterdam | w****m@g****m | 3 |
| Pierre Formont | p****t@o****o | 2 |
| Anh N Tran | t****9@g****m | 2 |
| James Lamb | j****0@g****m | 2 |
| Michael Kane | k****s@g****m | 2 |
| Yihui Xie | x****e@y****e | 2 |
| edavidaja | e****a@g****m | 2 |
| Ania Tassinari | a****z@g****m | 1 |
| Ethan White | e****n@w****g | 1 |
| Jim Hester | j****r@g****m | 1 |
| Josh Johnson | j****7@g****m | 1 |
| Luke Zappia | l****i | 1 |
| Sydney | s****e@g****m | 1 |
| Tim Trice | t****e@g****m | 1 |
| olivroy | 5****y | 1 |
| sdsadfaf | 2****7 | 1 |
| Steve Peak | s****e@c****o | 1 |
| warmdev | w****v | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 94
- Total pull requests: 16
- Average time to close issues: about 2 months
- Average time to close pull requests: about 2 months
- Total issue authors: 53
- Total pull request authors: 11
- Average comments per issue: 5.6
- Average comments per pull request: 2.56
- Merged pull requests: 15
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 5
- Pull requests: 0
- Average time to close issues: 14 days
- Average time to close pull requests: N/A
- Issue authors: 3
- Pull request authors: 0
- Average comments per issue: 3.6
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- jdblischak (7)
- rgayler (6)
- ogorodriguez (6)
- pcarbo (5)
- xiangzhu (5)
- LearnUseZone (5)
- Jo-Schie (3)
- jennysjaarda (3)
- tkcaccia (3)
- antass (2)
- kieran-mace (2)
- stephens999 (2)
- lazappi (2)
- christianholland (2)
- pat-s (2)
Pull Request Authors
- zaynaib (3)
- yihui (2)
- jameslamb (2)
- anhtr (2)
- jimhester (1)
- jakejh (1)
- warmdev (1)
- skpurdue (1)
- giocomai (1)
- wyq977 (1)
- olivroy (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 3
-
Total downloads:
- cran 924 last-month
- Total docker downloads: 42,160
-
Total dependent packages: 1
(may contain duplicates) -
Total dependent repositories: 7
(may contain duplicates) - Total versions: 51
- Total maintainers: 1
proxy.golang.org: github.com/workflowr/workflowr
- Documentation: https://pkg.go.dev/github.com/workflowr/workflowr#section-documentation
- License: other
-
Latest release: v1.7.2
published 7 months ago
Rankings
cran.r-project.org: workflowr
A Framework for Reproducible and Collaborative Data Science
- Homepage: https://workflowr.github.io/workflowr/
- Documentation: http://cran.r-project.org/web/packages/workflowr/workflowr.pdf
- License: MIT + file LICENSE
-
Latest release: 1.7.2
published 6 months ago
Rankings
Maintainers (1)
conda-forge.org: r-workflowr
- Homepage: https://github.com/workflowr/workflowr
- License: MIT
-
Latest release: 1.7.0
published about 4 years ago
Rankings
Dependencies
- R >= 3.3.0 depends
- callr >= 3.7.0 imports
- fs >= 1.2.7 imports
- getPass * imports
- git2r >= 0.26.0 imports
- glue * imports
- httpuv >= 1.2.2 imports
- httr * imports
- knitr >= 1.29 imports
- rmarkdown >= 1.18 imports
- rprojroot >= 1.2 imports
- rstudioapi >= 0.6 imports
- stringr >= 1.3.0 imports
- tools * imports
- utils * imports
- whisker >= 0.3 imports
- xfun * imports
- yaml * imports
- clipr >= 0.7.0 suggests
- covr * suggests
- miniUI >= 0.1.1 suggests
- reticulate >= 1.15 suggests
- sessioninfo * suggests
- shiny >= 0.14 suggests
- spelling >= 2.0 suggests
- testthat >= 2.0.0 suggests
- withr >= 2.0.0 suggests
- actions/checkout v2 composite
- actions/checkout v2 composite
- JamesIves/github-pages-deploy-action v4 composite
- actions/checkout v2 composite