R build status

The goal of analysispkg is to work out a structure for complex analyses-as-package.


Two ways to get the code:

If you just want to browse the or use the final results in another project, you can install the development version of analysispkg from Github with:


If you want to re-run or modify the analysis, you must or download or clone the repository.

Running the Analysis

To re-run the analysis, open the analysispkg project. The package functions and dependencies must be loaded.

To ensure you have all dependencies:


To load package functions:


And re-run the analysis plan using:


Goals & Features

The analysispkg structure has the following high level goals:

1) Facilitate re-use of analysis results by other projects,

2) Support iterative change and improvement during development.

3) Reproducible and transparent analysis results,

Features that support these goals:

Re-usability: * Final results are exported as datasets so they can be used in other projects by installing and loading the package. This is accomplished by including them as binary data in /data.

Iterative Development: * The entire analysis is run with make.R and can be easily re-run during development (or by cloning the repository) using {drake} for caching and inter-dependency management.

Reproducibility and transparency: * Input data are stored in /data-raw or acquired externally

Outstanding Questions:

How to Get Here:

1) usethis::create_package("yourpkgname") # from containing folder (or if you are already going, usethis::use_description() to pkg-ify)

2) Verify using roxygen2 to document

3) Add packages, e.g., usethis::use_package

4) Add drake infrastructure

5) Document package, exported data, and functions usethis::use_package_doc()

6) Add Github Actions basic infrastructure Modify it to be appropriate to analysis pkg use.

jameelalsalam/analysispkg documentation built on June 18, 2020, 12:15 a.m.