-
Notifications
You must be signed in to change notification settings - Fork 0
/
reproducibility.Rmd
49 lines (29 loc) · 2.55 KB
/
reproducibility.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
---
title: "Reproducibility"
author: "Jarrod"
date: 2020-04-15T21:13:14-05:00
categories: ["R"]
tags: ["reproducible", "YAML", "R", "Markdown"]
draft: true
---
```{r setup, include=FALSE}
knitr::opts_chunk$set(collapse = TRUE)
```
{{% openbox %}}
In this post I want to share some *best practices* for creating **reproducible** documents and workflows.
{{% /openbox %}}
## Reproducibility
I already made a case for [why reproducible research is important](/data-curation/2020/03/31/rationale/#transparency--reproducibility). So now lets define the term and see if we can't come up with a set of criteria that encompasses its meaning. *Reproducibility* ...
> {{% fa icon=quote-left size=1.25em %}} ... \[is a] set of procedures that permit the reader of a paper to see the entire processing trail from the raw data and code to figures and tables [^1]. {{% fa icon=quote-right size=1.25em %}}
Or according to the U.S. National Science Foundation (NSF)...
> {{% fa icon=quote-left size=1.25em %}} ... refers to the ability of a researcher to duplicate the results of a prior study using the same materials as were used by the original investigator [^2]. {{% fa icon=quote-right size=1.25em %}}
These are straightforward, yet broad, definitions. For example, we could apply these definitions to laboratoratoy techniques, field sampling methods, and so on. Rather than trying to cover all forms of reproducible research, lets focus on steps we can take to make the *data* portion of our science reproducible. Basically, we are ignoring *how* we got the data and instead focusing on *what* we did with the data. Some of the material presented here has been covered in previous lessons but I would like to capture all of these ideas in one place; so please pardon the repetition. These are *best practices* recommendations and it is up to you whether or not to implement them.
## Document
```{r, echo=FALSE}
blogdown::shortcode('edit', 'https://github.com/stri-con/data-curation/blob/master/content/post/reproducibility.Rmd')
```
```{r, echo=FALSE}
blogdown::shortcode('anchor')
```
[^1]: *from [What does research reproducibility mean?](https://doi.org/10.1126/scitranslmed.aaf5027) by Goodman, Fanelli & Ioannidis. Science Translational Medicine (2016) 8:341ps12*
[^2]: *from [Social, Behavioral, and Economic Sciences Perspectives on Robust and Reliable Science](https://www.nsf.gov/sbe/AC_Materials/SBE_Robust_and_Reliable_Research_Report.pdf) by Bollen, Cacioppo, Kaplan, Krosnick, & Olds. (2015) National Science Foundation, Arlington, VA, USA.*