Chapter 2 Scoping
At this stage, you will define the scope of the reproduction by identifying the scientific claims and related display items that you will analyze in the remainder of the reproduction. For this exercise, we follow the a comparable definition of a claim as used in the SCORE project, a related initiative aimed at predicting replicability and reproducibility of research:
“A research claim is a single major finding from a published study, as well as details of the methods and results that support this finding. A research claim [may not be] equivalent to an entire article. Sometimes the claim as described in the abstract does not exactly match the claim that is tested. In this case, you should consider the research claim to be that which is described in the [results of the paper].”
A display item is a figure or table that presents the results described in the paper. Each display item contains several specifications.
When recording the Scoping section on the SSRP plataform, count all of the claims in the paper and provide a one sentence summary for the subset of claims that you will attempt to reproduce. Structure your summary as follows: “The paper tested the effect of X on Y for population P, using method F. The main results show an effect of magnitude E (specify units and standard errors)” or “The paper estimated the value of Y (estimated or predicted) for population P under dimensions X using method M. The main results presented an estimate of of magnitude E (specify units and standard errors).” Make sure to use the same units of measurement for all scientific claims that you will analyze as part of the reproduction.
Note: Once you progress past the Scoping stage on the SSRP, you will no longer be able to edit your responses in the Scoping stage, though you will be able to see them. This is because the content of later stages of the reproduction is dependent on the information you record at this stage of the reproduction.
2.1 Read and summarize the paper
Depending on your reproduction’s timeline, we recommend that you write a short (<1000 words) summary of the paper. Writing up such a summary will help you develop and demonstrate a wholesome understanding of the paper and its various components. In your summary, try to address the following:
- How many scientific claims can you identify in the paper?
- Would you classify the claims as causal, descriptive (e.g., estimating a population’s descriptive statistic), or something else?
- What is the population that is the focus of the paper as a whole?
- What is the population for which the estimates apply?
- What are the primary data sources used in the paper?
- What is the primary statistical or econometric method used to examine each claim?
- What is the author’s preferred specification (or yours, if the authors’ is unclear)?
- What are some possible robustness checks for the preferred specification?
- How many display items are there in the paper (tables, figures, and inline results)?
Draft the summary in a plain text editor and paste the text in the form.
2.2 Record a revised reproduction package
At the previous stage, you recorded the original reproduction package made available by the paper’s authors. Given that one of the main goals of the ACRe approach is to improve reproducibility, we recommend that you build an alternative reproduction package that will improve the reproducibility of specific display items or the paper as a whole. You can start by downloading the reproduction package (or forking, if on GitHub) and uploading a copy titled “Revised reproduction package for [Paper Citation, e.g. Smith et al. (2019)]” to a trusted repository. Examples of trusted repositories include Dataverse, openICPSR, Figshare, Dryad, Zenodo, Open Science Framework and others. We encourage you to also use version control software (e.g., Git) during your reproduction.
Trusted repositories have a file size limit (typically around 2gb). If you think that your reproduction package will exceed this limit please do the following:
- Separate your reproduction package in two: (1) data and (2) code and documentation.
- Post the second one in a trusted repository.
- For the data reproduction package identify all the files that are different
from the original reproduction package and upload only those. For example, suppose the original repro package has
data/clean_data/data_set1.dta. If you modify only the file
data_set1.dta, then upload a revised reproduction package that has the same folder structure but only the files that differ:
data/clean_data/data_set1.dta. If you want to make it even more clear you could add a readme file describing the modified files.
As you work through the next stages, you can modify the reproduction package and record your improvements on the SSRP. Keeping a record of such changes will help you document your assessments or communicate with the original authors, and it will also allow future reproducers to build on top of your work.
2.3 Record scope of the exercise
By now, you probably have a reasonably good understanding of the paper. You do not, however, need to spend any time reviewing the reproduction package in detail.
At this point, you should specify the parts of the paper that will be the main focus of your reproduction. Focus on specific estimates, represented by a unique combination of claim-display item-specification as represented in figure 0.1. Given the complexity of the SSRP approach, unless you are very familiar with the paper, we recommend starting with just one claim before moving onto second or third as part of a later reproduction.
Declare a specific estimate(s) to reproduce
Identify a scientific claim and its corresponding preferred specification and record its magnitude, standard error, and location in the paper (page, table #, and table row and column). If the authors did not explicitly choose a precise preferred estimate, you can choose one yourself. In addition to the preferred estimate, you can reproduce up to five estimates that correspond to the preferred estimate’s alternative specifications.
Declare possible robustness checks for main estimates (optional)
After reading the paper, you might wonder why the authors did not conduct a specific robustness test. If you think that such analysis could have been done within the same methodology and using the same data (e.g., by including or excluding a subset of the data like “high-school dropouts” or “women”), please specify a robustness test that you would like to conduct before starting the Assessment stage. Robustness checks in this stage are optional and can take the form of a short sentence describing at a high level what you (the reproducer) would like to explore in a later stage. In the robustness stage (after assessment and improvement) you will be able to describe in greater detail how you have modified the reproduction code.