https://github.com/bvreede/workshop-computational-reproducibility

Material for the workshop 'Best Practices for Writing Reproducible Code'

https://github.com/bvreede/workshop-computational-reproducibility

Repository

Material for the workshop 'Best Practices for Writing Reproducible Code'

https://github.com/bvreede/workshop-computational-reproducibility/blob/master/

# Best Practices for Writing Reproducible Code

_If you are looking at a GitHub README, please note that the slides are best viewed [via GitHub pages](https://utrechtuniversity.github.io/workshop-computational-reproducibility/)._

Ensuring your research is reproducible can be a difficult task. Scripting your analysis is a start, but this in and of itself is no guarantee that you, or someone else, can faithfully repeat your work at a later stage. In this workshop, we will help you not only to make your work reproducible, but also to increase the efficiency of your workflow. We do this by teaching you a few good programming habits: how to set up a good project structure, how to code and comment well, and how to document your code so that it can be used by others. We will furthermore introduce you to Git and GitHub, which are essential tools in managing and publishing code. Reproducibility requires extra effort, but we will focus on teaching you skills that will save you much more time in the long run than they cost to implement.

## Preparation

If you are attending this workshop, you can prepare a few things so we can hit the ground running!
We have [more details on this page](preparations).


## Course materials

### Slides
1. [Introduction](slides/slides_introduction.html)
1. [Project setup and version control](slides/slides_project-setup.html)
1. [Code quality](slides/slides_code-quality.html)
1. [Project documentation](slides/slides_documentation.html)
1. [Accessibility & Reproducibility](slides/slides_reproducibility.html)


### Exercises
1. [Project setup & version control with git](exercises/project-setup.md)
1. [Code quality](exercises/code-quality.md) 
1. [Project documentation](exercises/documentation.md) 
1. [Accessibility & reproducibility](exercises/reproducibility.md) 


## Schedule

### Day 1

| Time  | Activity |
|-------:|----------|
| 9:00 | Welcome & introduction ([slides](slides/slides_introduction.html))| 
| 9:30 | [Project setup & version control with git](exercises/project-setup.md) |
| 10:45 | Questions & discussion |
| _11:00_ | _Break_ |
| 11:15 | [Code quality](exercises/code-quality.md)  |
| 12:45 | Questions & discussion |
| _13:00_ | _End_ |


### Day 2

| Time  | Activity |
|-------:|----------|
| 9:00 | Code quality discussion | 
| 9:15 | [Documentation](exercises/documentation.md)  |
| 10:45 | Questions & discussion |
| _11:00_ | _Break_ |
| 11:15 | [Accessibility & reproducibility](exercises/reproducibility.md)  |
| 12:15 | [Reproduction of projects](slides/slides_reproducibility.html#18) |
| _13:00_ | _End_ |


## External resources, recommended reading, and developer inspiration

- [Software Development Guide by the Netherlands eScience Center](https://guide.esciencecenter.nl/)
- [The Turing Way: a guide to reproducible data science by the Turing Institute](https://the-turing-way.netlify.app/welcome)
- [Software Carpentry lessons](https://github.com/swcarpentry/swcarpentry)
- [Pro GIT](https://www.git-scm.com/book/en/v2)
- [Good Enough Practices in Scientific Computing](https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005510)


## License

All workshop material is licensed under a [Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/). [View the license here](https://github.com/UtrechtUniversity/workshop-computational-reproducibility/blob/master/LICENSE.md).


## History and acknowledgements

This course was developed at Utrecht University, supported by the [Open Science Community Utrecht (OSCU)](https://openscience-utrecht.com) and [Research Data Management (RDM) support](https://www.uu.nl/en/research/research-data-management).

Workshop development is being coordinated by [Barbara Vreede](https://github.com/bvreede), and the course received contributions from (in alphabetical order):
[Armel Lefebvre](https://github.com/armell) |
[Bianca Kramer](https://github.com/bmkramer)
| [Cedric Thieulot](https://github.com/cedrict)
| [Erik van Sebille](https://github.com/erikvansebille)
| [Jeroen Bosman](https://github.com/JeroenBosman)
| [Jeroen Ooms](https://github.com/jeroen)
| [Jonathan de Bruin](https://github.com/J535D165)
| [Lukas van de Wiel](https://github.com/hooiberg)
| [Mateusz Kuzak](https://twitter.com/matkuzak)
| [Menno Fraters](https://github.com/MFraters)
| [Neha Moopen](https://github.com/nehamoopen)
| [Philippe Delandmeter](https://github.com/delandmeterp)
| [Renato Alves](https://github.com/unode)

Owner

GitHub Events