Post provided by Natalie Cooper and Pen-Yuan Hsing
The way we do science is changing — data are getting bigger, analyses are getting more complex, and governments, funding agencies and the scientific method itself demand more transparency and accountability in research. One way to deal with these changes is to make our research more reproducible, especially our code.
Although most of us now write code to perform our analyses, it’s often not very reproducible. We’ve all come back to a piece of work we haven’t looked at for a while and had no idea what our code was doing or which of the many “final_analysis” scripts truly was the final analysis! Unfortunately, the number of tools for reproducibility and all the jargon can leave new users feeling overwhelmed, with no idea how to start making their code more reproducible. So, we’ve put together the Guide to Reproducible Code in Ecology and Evolution to help.
The Guide to Reproducible Code covers all the basic tools and information you’ll need to start making your code more reproducible. We focus on R and Python, but many of the tips apply to any programming language. Anna Krystalli introduces some ways to organise files on your computer and to document your workflows. Laura Graham writes about how to make your code more reproducible and readable. François Michonneau explains how to write reproducible reports. Tamora James breaks down the basics of version control. Finally, Mike Croucher describes how to archive your code. We’ve also included a selection of helpful tips from other scientists.
True reproducibility is really hard. But don’t let this put you off. We wouldn’t expect anyone to follow all of the advice in this booklet at once. Instead, challenge yourself to add one more aspect to each of your projects. Remember, partially reproducible research is much better than completely non-reproducible research.
The full Guide to Reproducible Code in Ecology and Evolution, like all of the BES Guides to Better Science, is freely available to everyone.
This blog post is taken from the introduction to the BES Guide to Better Science and was written by Natalie Cooper and Pen-Yuan Hsing. Minor changes have been made, but these do not change the content.