The package is intended to facilitate the use of research compendiums for data analysis in the R environment. Standard research compendiums provide a easily recognizable means for organizing digital materials, allowing other researchers to inspect, reproduce, and build upon that research.
Unlike other R packages for creating research compendiums
(e.g. vertical,
rrtools), sketchy isn’t
wedded to a particular folder structure. Currently the package provides
14 alternative structures (see object compendiums) and allows users to
modify or input their own structures.
To install the latest developmental version from github you will need the R package remotes:
# From github
remotes::install_github("maRce10/sketchy")
# load package
library(sketchy)Compendiums can be set up with the function make_compendium(). The
function creates the folder/subfolder structure and prints a diagram of
the skeleton in the console:
path = tempdir()
# load data
data(compendiums)
make_compendium(name = "proyect_x", path = path, format = "basic")
## Creating directories ...
## proyect_x
## │
## ├── data/
## │ ├── processed/ # modified/rearranged data
## │ └── raw/ # original data
## ├── manuscript/ # manuscript/poster figures
## ├── output/ # all non-data products of data analysis
## └── scripts/ # code
## Done.
(in these examples the compendiums are created in a temporary directory, change ‘path’ to create it in a different directory)
We can use folder structures from other sources. For instance, in this example we use the structured suggested by Wilson et al. (2017):
make_compendium(name = "proyect_z", path = path, format = "large_compendium")
## Creating directories ...
## proyect_z
## │
## ├── analysis/ # Data, scripts, RMarkdown reports and Makefile
## │ ├── data/ # Raw data in open formats, not changed once created
## │ └── scripts/ # R code used to analyse and visualise data
## ├── man/ # Auto-generated documentation for the custom R functions
## ├── R/ # Custom R functions used repeatedly throughout the project
## └── tests/ # Unit tests of R functions to ensure they perform as expected
## Done.
When creating a compendium that includes a “manuscript” folder the package adds a “manuscript_template.Rmd” file for facilitating paper writing within the compendium itself.
We can check all compendium structure available as follows:
for (i in 1:length(compendiums)) {
print("---------------", quote = FALSE)
print(names(compendiums)[i], quote = FALSE)
print_skeleton(folders = compendiums[[i]]$skeleton)
}
## [1] ---------------
## [1] basic
## .
## │
## ├── data/
## │ ├── processed/
## │ └── raw/
## ├── manuscript/
## ├── output/
## └── scripts/
## [1] ---------------
## [1] figures
## .
## │
## ├── data/
## │ ├── processed/
## │ └── raw/
## ├── manuscript/
## ├── output/
## │ └── figures/
## │ ├── exploratory/
## │ └── final/
## └── scripts/
## [1] ---------------
## [1] project_template
## .
## │
## ├── cache/
## ├── config/
## ├── data/
## ├── diagnostics/
## ├── docs/
## ├── graphs/
## ├── lib/
## ├── logs/
## ├── munge/
## ├── profiling/
## ├── reports/
## ├── src/
## └── tests/
## [1] ---------------
## [1] pakillo
## .
## │
## ├── analyses/
## ├── data/
## ├── data-raw/
## ├── docs/
## ├── inst/
## ├── man/
## ├── manuscript/
## ├── R/
## └── tests/
## [1] ---------------
## [1] boettiger
## .
## │
## ├── man/
## ├── R/
## ├── tests/
## └── vignettes/
## [1] ---------------
## [1] wilson
## .
## │
## ├── data/
## ├── doc/
## ├── requirements/
## ├── results/
## └── src/
## [1] ---------------
## [1] small_compendium
## .
## │
## ├── analysis/
## └── data/
## [1] ---------------
## [1] medium_compendium
## .
## │
## ├── analysis/
## ├── data/
## ├── man/
## └── R/
## [1] ---------------
## [1] large_compendium
## .
## │
## ├── analysis/
## │ ├── data/
## │ └── scripts/
## ├── man/
## ├── R/
## └── tests/
## [1] ---------------
## [1] vertical
## .
## │
## ├── data/
## ├── data-raw/
## ├── docs/
## ├── experiments/
## ├── man/
## ├── manuscripts/
## ├── model/
## ├── posters/
## ├── R/
## ├── slides/
## └── vignettes/
## [1] ---------------
## [1] rrtools
## .
## │
## ├── analysis/
## ├── data/
## ├── figures/
## ├── paper/
## └── templates/
## [1] ---------------
## [1] rdir
## .
## │
## ├── code/
## │ ├── processed/
## │ └── raw/
## ├── data/
## │ ├── clean/
## │ └── raw/
## ├── figures/
## │ ├── exploratory/
## │ └── final/
## └── text/
## ├── final/
## └── notes/
## [1] ---------------
## [1] workflowr
## .
## │
## ├── analysis/
## ├── code/
## ├── data/
## ├── docs/
## └── output/
## [1] ---------------
## [1] sketchy
## .
## │
## ├── data/
## │ ├── processed/
## │ └── raw/
## ├── manuscript/
## ├── output/
## └── scripts/Please cite sketchy as follows:
Araya-Salas, M., Willink, B., Arriaga, A. (2020), sketchy: research compendiums for data analysis in R. R package version 1.0.0.
-
Alston, J., & Rick, J. (2020). A Beginner’s Guide to Conducting Reproducible Research.
-
Marwick, B., Boettiger, C., & Mullen, L. (2018). Packaging Data Analytical Work Reproducibly Using R (and Friends). American Statistician, 72(1), 80–88.
-
Wilson G, Bryan J, Cranston K, Kitzes J, Nederbragt L. & Teal, T. K.. 2017. Good enough practices in scientific computing. PLOS Computational Biology 13(6): e1005510.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent