Site icon R-bloggers

Minimal reproducible examples

[This article was first published on Hyndsight » R, and kindly contributed to R-bloggers]. (You can report issue about the content on this page here)
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

I occasionally get emails from people thinking they have found a bug in one of my R packages, and I usually have to reply asking them to provide a minimal reproducible example (MRE). This post is to provide instructions on how to create a MRE.

Bug reports on github, not email

First, if you think there is a bug, please don’t send me emails. Instead, use the bug-reporting facility on github. All eight of my R packages that are on CRAN have pre-release versions on github. If you think there is a bug, just add an “issue” to the github repository and it will get looked at provided it is reproducible.

Creating an MRE

An MRE is intended to reproduce an error using the smallest amount of code. It saves package developers time in wading through messy code that is not relevant to the apparent bug.

It should consist of a single R script file that can be run without error. The file should contain the following three sections:

  1. Packages to be loaded.
  2. The shortest amount of code that reproduces the problem.

    Please get rid of anything that is unnecessary.

    Try to use one of the built-in datasets if possible.

    But if you need to include some data, then use dput() so the data can be included as part of the same text file. For example, if you have a time series y, it can be included in your code by running dput(y), copying the output, and then in the text file type y < - then paste. In most cases, you do not need to include all of your data, just a small subset that will allow the problem to be reproduced.

    If you randomly generate some data, use set.seed() for reproducibility.

    Please spend time adding comments so I can understand your code quickly.

  3. The output of sessionInfo() as a comment.

    Then I can immediately see what versions of packages you are using, and your R environment.

To check that your code is reproducible, try running it in a fresh R session.

Adding your code to a bug report

Copy and paste your MRE into gist.github.com, set the language to R, and choose “Create secret Gist”. Copy the URL.

Then go to the github repository for the package, create a new issue, explain the problem in a few words and paste the URL to your MRE.

What not to do


This post was based heavily on answers to this question on StackOverflow.

To leave a comment for the author, please follow the link and comment on their blog: Hyndsight » R.

R-bloggers.com offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.