JASA Reproducibility Guide

Logo

Reproducibility guide for authors and reviewers publishing in the Journal of the American Statistical Association (JASA).

View the Project on GitHub jasa-acs/repro-guide

The JASA Reproducibility Guide

As of September 2021, all invited revisions to JASA (both Applications & Case Studies and Theory & Methods) for manuscripts whose initial submission was on or after September 1, 2021, must include code, data, and the workflow to reproduce the work presented. We encourage but do not require that initial submissions include the code, data, and workflow.

Submissions before September 2021 to JASA Applications & Case Studies (but not Theory & Methods) should have included these materials upon initial submission, but submission upon invited revision is acceptable.

These web pages provide guidance on reproducibility for authors and reviewers in JASA.

Guidance for authors

  1. In preparing your materials, please see our guidelines for authors.
  2. Authors must fill out the ACC form, documenting the reproducibility of their work.
  3. We strongly encourage the use of a Git repository for code and workflow materials (but not large datasets) hosted on a site such as GitHub, GitLab, or BitBucket. If desired, authors might choose to keep the repository private until the time of publication. We provide an optional template repository as an example on which you can base your repository. If using a repository, we strongly recommend that the main README.md of the repository provide an overview of how to carry out the analyses presented in their manuscript.
  4. When submitting your supplementary materials, please submit the PDF of the ACC form as a separate file in addition to any supplementary material files not directly related to reproducibility (e.g., additional figures/tables, proofs). In addition, if you are submitting reproducibility materials as part of the supplemental materials (instead of, or in addition to, using a repository as discussed above), please submit all reproducibility materials as a single zip file (which we suggest naming as reproducibility_materials.zip). Please use a clear directory/folder structure within the zip file to organize your reproducibility materials (perhaps mimicking the structure suggested in our template repository).
  5. Feel free to look at previously published articles for example reproducible materials. All reproducibility materials for published articles in Applications & Case Studies (those submitted as of September 2016) are available at https://github.com/jasa-acs. We particularly recommend the reproducibility materials in the following articles:

JASA Reproducibility Award

The JASA reproducibility award recognizes outstanding computational reproducibility efforts in the statistical field. It was established in 2023, with the inaugural winners recognized at the 2023 Joint Statistical Meetings (JSM). All manuscripts accepted into JASA in a calendar year are eligible for the award, which will be awarded at the JSM the following year.

Guidance for reproducibility reviewers

While an associate editor may ask one of the reviewers to review a given manuscript for reproducibility, in most cases one of the JASA associate editors for reproducibility (AER) is asked to carry out this review (by selecting the generic ‘reviewer for reproducibility’ in the review system.

  1. Please see our guidelines for reviewers when reviewing a manuscript for reproducibility.
  2. We ask that reproducibility reviewers consider these review criteria and ideally explicitly fill out a review form (simply create a document with the headers as given in that link) and include the completed form as an attachment with your review.

General resources on reproducibility

Various journals are now requiring or strongly encouraging authors to provide code and data to reproduce their work. In addition, many researchers have written guidance on best practices for reproducibility. These are just a few of the many resources you may find online.

  1. Guidance from a group of reproducibility (aka ‘data’) editors of social science journals.
  2. The American Economic Association requires code and data for all submissions to the AEA journals. Here is guidance from the AEA data editor.

Help

Please contact the Associate Editors for Reproducibility at jasa.app.cs.aer@gmail.com with any questions about the guidelines for authors or for reviewers, or if you are interested in learning more about our reproducibility initiative.