prereg providesR Markdown templates thatfacilitates authoring preregistrations of scientific studies in PDFformat.
If you experience any problems or have suggestions for improvements,pleaseopen anissue.
Setup
Software requirements
prereg depends on additional software, namely,
If you work withRStudio(1.1.453 or later) pandoc should already be installed, otherwise referto theinstallationinstructions for your operating system.
Setting up a TeXdistribution
prereg can be used with common TeX distributions,such asMikTeX on Windows,MacTeX on Mac, orTeX Live on Linux.
If you mainly use TeX to render R Markdown documents, we stronglyrecommend using theTinyTexdistribution. It is lightweight and automatically installs missing LaTeXpackages and can be installed from within R with .
if(!"tinytex"%in%rownames(installed.packages()))install.packages("tinytex")tinytex::install_tinytex()Install prereg
You can install the stable version ofprereg fromCRAN
install.packages("prereg")or the development version from this GitHub repository (you may haveto install theremotes package first).
if(!"remotes"%in%rownames(installed.packages()))install.packages("remotes")remotes::install_github("crsh/prereg")Create a preregistrationdocument
Once you have installed theprereg you can selectthe templates when creating a new R Markdown file through the RStudiomenus.
Example
prereg produces a clean form-like document.
The template file contains comments that provide further details onhow to fill in the form but are invisible in the final PDF document.
Using prereg without RStudio
If you want to useprereg without RStudio you canuse thermarkdown::render function to createpreregistration documents:
# Create new COS preregistration challenge R Markdown filermarkdown::draft("my_preregistration.Rmd" ,"cos_prereg" ,package ="prereg" ,create_dir =FALSE ,edit =FALSE)# Render documentrmarkdown::render("my_preregistration.Rmd")Uploading yourpreregistration
After knitting your preregistration to a PDF file using this package,you may upload this protocol to a trustworthy repository to completeyour preregistration. Possible repositories for this are:
- Preregistration inPsychology: A preregistration platform provided by the LeibnizInstitute for Psychology (ZPID) which focuses on psychologicalresearch
- Open Science Framework: Aninterdisciplinary platform provided by the Center for Open Science wherepreregistrations as well as other materials and data can beuploaded
Package dependencies
Acknowledgments
The preregistration templates collected in this package weredeveloped by others (cited below and in the template documentation). Weare grateful for their permission to use their material in thispackage.
Bosnjak, M., Fiebach, C. J., Mellor, D., Mueller, S., O’Connor, D.B., Oswald, F. L., & Sokol-Chang, R. I. (2021). A template forpreregistration of quantitative research in psychology: Report of thejoint psychological societies preregistration task force.AmericanPsychologist. doi: 10.1037/amp0000879
Brandt, M. J., IJzerman, H., Dijksterhuis, A., Farach, F. J., Geller,J., Giner-Sorolla, R., … van ’t Veer, A. (2014). The Replication Recipe:What makes for a convincing replication?Journal of ExperimentalSocial Psychology, 50, 217–224.https://doi.org/10.1016/j.jesp.2013.10.005
Crüwell, S. & Evans, N. J. (2021). Preregistration in diversecontexts: a preregistration template for the application of cognitivemodels.Royal Society Open Science. 8:210155https://doi.org/10.1016/j.jesp.2013.10.005
Flannery, J. E. (2020, October 22). fMRI Preregistration Template.Retrieved fromhttps://osf.io/6juft
van ’t Veer, A. E., & Giner-Sorolla, R. (2016). Pre-registrationin social psychology—A discussion and suggested template.Journal ofExperimental Social Psychology, 67, 2–12.https://doi.org/10.1016/j.jesp.2016.03.004
[8]ページ先頭