Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Jupyter notebooks for reproducible research


Hopefully this will be green.... Build Status

This repository contains the materials for the Jupyter notebooks for reproducible research workshop given at the Second RSE conference (7-8th September 2017).

Critically, we will  introduce two technologies recently developed as part of the EU OpenDreamKit project, nbval and nbdime, which bring unit testing and version control to the Jupyter notebook ecosystem. By doing so we aim to encourage others to adopt best development practices leading to more reproducible, replicable, and reliable computational results.

Leading by example

Since this workshop is centered around establishing best practices for reproducible research it is completely self contained and should be easily adapted/extended for future workshops. Feel free to raise issues if you see it fit.

A suitable environment is provided in the form of a Docker container (Dockerfile provided in the repo):

The slides are built using reveal.js and can be served locally following the instructions shown here. Since the slides are served using GitHub Pages, these can be found in the gh-pages branch of this repository.

Alternatively the web-hosted version of the slides can be found in the following sites:


The creative material of this workshop (including the presentation slides as well as the images from external sources used in the presentation) are licensed under CC BY 4.0

nbval and nbdime are open source projects developed as part of the European funded project OpenDreamKit project.

The code as well as the license terms of both packages can be found at:

The scripts and jupyter notebook contained in this repository are distributed under the 3-Clause BSD license.


Note: as mentioned above, the required packages for this workshop are provided in the form of a Docker container. Should you opt not to use this container you need to ensure you have the following installed in your computer in a virtualenv or Conda environment:

  • Python 3.5
  • git
  • jupyter notebooks
  • pip
  • pandas
  • seaborn

Also you will need to have a terminal (Git Bash or CygWin are recommended for Windows users).

Attendees of the RSE conference 2017

We will have some hands-on bits as well as discussion slots in this workshop, for this purpose we have set an Etherpad at

Getting started with the workshop materials

By now you should have a the RSE conference Virtual Machine already set in your personal laptop, which includes all the materials for this workshop.

You now need to follow these notes to prepare for this tutorial.