Reproducible Research using R
The goal of this textbook is to provide readers with foundational knowledge and practical skills in quantitative text analysis using the R programming language. By the end of this textbook, readers will be able to identify, interpret and evaluate data analysis procedures and results to support research questions within language science. Additionally, readers will gain experience in designing and implementing research projects that involve processing and analyzing textual data employing modern programming strategies. This textbook aims to instill a strong sense of reproducible research practices, which are critical for promoting transparency, verification, and sharing of research findings.
This textbook is geared towards advanced undergraduates, graduate students, and researchers looking to expand their methodological toolbox. It assumes no prior knowledge of programming or quantitative methods and prioritizes practical application and intuitive understanding over technical details.
This textbook is currently under development.
The book cannot be built based on the GitHub repository as the data files are not included in the repository for licensing reasons. However, the book can be built from the source files provided in the book/
directory shared via Google Drive link.
To ensure that you can build the book from source, please follow the following steps:
- Download the
book
directory from the Google Drive shared link. - Install Docker Desktop on your system (note the macOS and Windows configurations).
- Pull the
francojc/manuscript:latest
image from Docker Hub. - Create a container from the image by running the image and setting the following configurations:
- Port: 8787:8787
- Volume: <path/to/the/shared/book/>:/home/rstudio/book/
- PASSWORD:
- ROOT: true
- Open RStudio in your browser (http://localhost:8787) and login with username
rstudio
and the password you set. - Create a new project in RStudio, and select the book directory.
- Install these two packages manually at the R console:
install.packages(c("renv", "pak"))
- Run
renv::restore()
to install the necessary packages.- This will take some time, so be patient.
- Run
pak::sysreqs_check_installed()
to check if all system dependencies are installed. If not, install them by runningpak::sysreqs_fix_installed()
. - Build the book by clicking the "Render" button in the RStudio IDE with any
*.qmd
file open.