This template Git repository contains a folder structure, template documents, and best practice suggestions for conducting geographic research with a reproducible research compendium. The main readme.md contains information about the research study.
The Template_LICENSE file provides the BSD 3-Clause license for using this template. To cite the template, please use template_reference.bib or:
Kedron, P., & Holler, J. (2023). Template for Reproducible and Replicable Research in Human-Environment and Geographical Sciences. https://doi.org/10.17605/OSF.IO/W29MQ
The folder structure presented here can be used to:
An overview of the folder structure of this repository is provided below. The readme.md file contained in each folder provides details about the purpose of that folder and suggestions on its use.
The authors should maintain the data/data_metadata.csv file to list all raw and derived data, the procedure/procedure_metadata.csv file with an ordered list of all procedures and/or code, and the results/results_metadata.csv folder with a list of all figures, tables, and other media produced by the research.
The docs/report/ folder contains templates to facilitate 1) the pre-registration of research plans, and 2) report the complete details of original, reproduction, or replication studies.
<Study Name>
|- docs/ # study documentation
| +- report/ # reproduction plan, reproduction report
| +- manuscript/ # manuscript components
| +- presentation/ # presentation materials
|
|- data # study data
| - raw/ # raw data, should not be altered
| +- public/ # public data with version control
| +- private/ # private data with no version control
| +- derived/ # derived data
| +- public/ # public data with version control
| +- private/ # private data with no version control
| +- scratch/ # temporary files that can be safely deleted or lost
| +- metadata/ # documentation of metadata
|
|-procedure
| +- environment/ # details of the computational environment
| +- code/ # any programmatic code, clearly named and commented
| +- protocols/ # any non-computational protocols
|
|- results # all output from workflows and analyses
| +- figures/ # graphs, likely designated for manuscript
| +- tables/ # tables, likely designated for manuscript
| +- other/ # diagrams, images, and other non-graph graphics
|
|- readme.md # description of the study
|- template_readme.md # description of repository design and references
|- LICENSE # intellectual property license, ideally open source
|- Template_LICENSE # BSD 3-Clause license for this template
|- CITATION.cff # preferred citation for the research
|- .gitignore # files to ignore from git tracking
Every research project is different. This repository is designed to serve as a flexible guide capable of structuring work completed throughout the lifecycle of different types of research projects. No matter the project type, a few key suggested practices when using this repository include:
data/raw folder. Do not alter that file during data analysis.data/derived folder.data/scratch folder. Files in this folder should be able to be deleted without negatively impacting the project.Makefile or Rmarkdown file that documents computational work in executable form and/or clear comments and instructions in the header of each procedure and code file and good descriptions in the procedure_metadata.csvprocedure\environment folder.The structure of this repository closely follows the excellent rr-init repository, which in turn follows Nobel (2009). We have also incorporated structural ideas from Gandrud (2015) and Camerer et al. (2016, 2018).
A pre-registration template for studies involving geographic analyses. This template is modelled on similar templates developed by the Open Science Framework (OSF), AsPredicted, the prereg package, and Van den Akker et al. (2019). The OSF template is our most direct source. This template can be used to transparently plan and pre-register original geographic research. Cite the OSF preregistration template and the licenses
A template to facilitate the documentation and reporting of reproductions and replications of original geographic research. Stylistically, this template follows the ReScience article template, but also draws inspiration from Camerer et al. (2016, 2018). Following Camerer et al., we suggest using the template to first document and share the procedures of the planned reproduction/replication before re-analysis begins. After the reproduction/replication is complete, we suggest then completing the template and sharing the report alongside the originally published planning document.
Other examples of registered replication reports are available from the Reproducibilty Project, registered replication projects published by the Association of Psychological Science, and ReScienceC and X. Users may also be interested in the Transparency and Openess Promotion (TOP) Guidelines, the replication policy of the Royal Society, or this example web-based reproducibility workflow for species distribution models which the authors converted into a web-based report generator.