Difference between revisions of "Reproducible Research"

Jump to: navigation, search
Line 18: Line 18:
* '''Globals.''' Create '''globals''' (or global macros) for the root folder and all project folders. '''Globals''' should only be specified in the '''master do-file''' and can be used '''standardizing coefficients''' for the data set that will be used for [[Data Analysis|analysis]].
* '''Globals.''' Create '''globals''' (or global macros) for the root folder and all project folders. '''Globals''' should only be specified in the '''master do-file''' and can be used '''standardizing coefficients''' for the data set that will be used for [[Data Analysis|analysis]].
* '''Shell script.''' If you use different languages or software in the same project, consider using a '''shell script''',  which ensure that other users run the different languages or software in the correct order.
* '''Shell script.''' If you use different languages or software in the same project, consider using a '''shell script''',  which ensure that other users run the different languages or software in the correct order.
* '''Comments.''' Include '''comments''' (using <code>*</code>) in your code frequently to explain what a line or group of commands is doing and why. For example, if the code drops observations or changes values, explain why this was necessary using comments. This ensures that the code is also easy to understand, and ensures that research is also [[Research Ethics#Research Transparency|transparent]].
* '''Comments.''' Include '''comments''' (using <code>*</code>) in your code frequently to explain what a line or group of commands is doing and why. For example, if the code drops observations or changes values, explain why this was necessary using comments. This ensures that the code is also easy to understand, and that research is [[Research Ethics#Research Transparency|transparent]].
 
=== Software ===
=== Software ===
[[Getting started with GitHub | Git]] is a free version-control software. Users can store files in Git Repositories, most commonly on [https://github.com/ GitHub]. Within repositories, users can track changes to code in different programming languages and create messages explaining [[Data Documentation | why changes were made]]. Sharing Git repositories makes code publicly available and allows other researchers to read and replicate your code. To learn how to use GitHub, refer to GitHub Services’ [https://services.github.com/on-demand/intro-to-github/ introductory training] and [https://guides.github.com/ GitHub Guides’] tutorials. [http://jupyter.org/ Jupyter Notebook] is another platform for code-sharing on which researchers can create and share code in different programming languages, including Python, R, Julia, and Scala.
[[Getting started with GitHub | Git]] is a free version-control software. Users can store files in Git Repositories, most commonly on [https://github.com/ GitHub]. Within repositories, users can track changes to code in different programming languages and create messages explaining [[Data Documentation | why changes were made]]. Sharing Git repositories makes code publicly available and allows other researchers to read and replicate your code. To learn how to use GitHub, refer to GitHub Services’ [https://services.github.com/on-demand/intro-to-github/ introductory training] and [https://guides.github.com/ GitHub Guides’] tutorials. [http://jupyter.org/ Jupyter Notebook] is another platform for code-sharing on which researchers can create and share code in different programming languages, including Python, R, Julia, and Scala.

Revision as of 16:57, 24 April 2020

Reproducible research is the system of documenting and publishing results from a given research study. At the very least, reproducibility allows other researchers to analyze the same data to get the same results as the original study, which strengthens the conclusions of the original study. Reproducible research is based on the idea that the path to research findings is just as important as the findings themselves.

Read First

Replication and Reproducibilty

Replication is a process where different researchers conduct the same study independently in different samples and find similar conclusions. It adds more validity to the conclusions of an empirical study. However, in most field experiments, the research team cannot create the same conditions for replication. Different populations can respond differently to the same treatment, and replication is often too expensive. In such cases, the researchers should still try to achieve reproducibility. There are four key elements of reproducible research - code publication, data publication, data documentation, and output reproducibility.

Code Publication

Code publication is the first key element of reproducible research. Sometimes academic journals ask for reproducible code along with the actual academic paper. Even if they don't, it is good academic citizenship to share codes and data with others. The research team should ensure that external researchers have access to, and can execute the same code and data that was used during the original impact evaluation.

Guidelines

With careful coding, use of master do-files, and adherence to coding best practices the same data and code will yield the same results for any given person. Follow these guidelines when publishing the code:

  • Master do-files. The master do-file should set the Stata seed and version to allow replicable sampling and randomization. By nature, the master do-file will run project do-files in a pre-specified order, which strengthens reproducibility. The master do-file can also be used to list assumptions of a study and list all data sets that are used in the study.
  • Packages and settings. Install all necessary commands and packages in your master do-file itself. Specify all settings and sort observations frequently to minimize errors.
  • Globals. Create globals (or global macros) for the root folder and all project folders. Globals should only be specified in the master do-file and can be used standardizing coefficients for the data set that will be used for analysis.
  • Shell script. If you use different languages or software in the same project, consider using a shell script, which ensure that other users run the different languages or software in the correct order.
  • Comments. Include comments (using *) in your code frequently to explain what a line or group of commands is doing and why. For example, if the code drops observations or changes values, explain why this was necessary using comments. This ensures that the code is also easy to understand, and that research is transparent.

Software

Git is a free version-control software. Users can store files in Git Repositories, most commonly on GitHub. Within repositories, users can track changes to code in different programming languages and create messages explaining why changes were made. Sharing Git repositories makes code publicly available and allows other researchers to read and replicate your code. To learn how to use GitHub, refer to GitHub Services’ introductory training and GitHub Guides’ tutorials. Jupyter Notebook is another platform for code-sharing on which researchers can create and share code in different programming languages, including Python, R, Julia, and Scala.

Data Publication

To execute code, reproducible research requires that researchers publish their data. Ideally, researchers can provide adequate data for others to reproduce all steps in their code from cleaning to analysis. However, this is not always feasible when the data contains personally identifiable or confidential information.

Data Documentation

Data documentation outlines all aspects of the data work that may affect or inform the analysis and results. For reproducibility and transparency, it is important to document all aspects of the data work that may affect or inform the analysis and results. Accordingly, during data collection, data cleaning, variable construction, and data analysis, compile data work documentation in code comments and, ideally, in one consolidated file or folder. The structure of this file or folder will vary from one project to another.

Note that when you submit codes for code review or deposit data in the microdata catalog, the reviewers will revise your data documentation. While they may provide feedback, remember that positive comments on your data documentation do not guarantee no problems, since reviewers cannot ask about issues unknown to them. For more details, see Data Documentation.

Output Reproducibility

GitHub repositories allow researchers to track changes to the code in different programming languages, create messages explaining the changes, make code publicly available and allow other researchers to read and replicate your code.

Dynamic documents allow researchers to write papers and reports that automatically import or display results. This reduces the amount of manual work involved between analyzing data and publishing the output of this analysis, so there's less room for error and manipulation.

Different software allows for different degrees of automatization. R Markdown, for example, allows users to write, text, and code simultaneously, running analyses in different programming languages and printing results in the final document along with the text. Stata 15 allows users to dyndoc to create similar documents; the output is a file, usually a PDF, that contains text, tables and graphs. With this kind of document, whenever a researcher updates data or changes the analysis, he/she only needs to run one file to generate a new final paper or report. No copy-pasting or manual changes are necessary, which improves reproducibility.

LaTeX is another widely used tool in the scientific community. It is a type-setting system that allows users to reference code outputs such as tables and graphs in order to easily update them in a text document. After you analyze the data in your preferred software, you can export the results into TeX format – R's stargazer is commonly used for this, and Stata has different options such as esttab and outreg2. The TeX code writes a LaTex document that uploads these outputs. Whenever results are updated, simply recompile the LaTeX document with the press of a button in order to integrate the new graphs and tables. Should you wish to use TeX collaboratively, Overleaf is a web-based platform that facilitates TeX collaboration, and Jupyter Notebook can create dynamic documents in HTML, LaTeX and other formats.

Additional Resources