Workshop Introduction

This website provides supporting materials for the workshop Containers for Computational Reproducibility which is part of the Population and Social Data Science Summer Incubator Program 2024 organized by the Max Planck Institute for Demographic Research in Rostock, Germany. This tutorial is licensed under CC0.

To participate in the workshop, we recommend that you have a GitHub account and a Docker Hub account. You may also want to install Docker on your computer (for Windows, macOS or Linux). For macOS we also highly recommend the free version of OrbStack as a complete and lightweight Docker Desktop replacement.

Expected learning outcomes

  • Able to explain the concept of containers and their role in computational reproducibility and discuss further reproducibility challenges

  • Able to create a GitHub repository that can be executed in the cloud using Binder

  • Able to create a Docker container with RStudio and R of a specific version and with specific archived R packages

What to do in the workshop

The tasks that you can do in the workshop depend on your skill level with GitHub and command line (terminal), as well as what you want to achieve.

Your current skills What you will learn Tutorial to follow
You have a GitHub account, familiar with concepts of forking a repository and can edit code locally (e.g. in RStudio or VSCode) or online on GitHub Make your research project results accessible to everyone, while ensuring reproducibility. 1. Make your own repository reproducible in Binder
You are familiar with basic command line (terminal) commands such as git clone, cd, mkdir or not afraid to try them out. Create containers for your everyday work on local computer or in high-performance cluster. 2. Build your own Docker container image and run it (locally or in the academic cluster)