Block course: Sustainable Software Development
Scientific Software Development
Scientific Software Center, Heidelberg University
In this course, you will learn how to develop scientific software in a way that enables reproducible research and sustainable software. Sustainable scientific software leaves room for further, subsequent implementations and method development, and saves time and effort in the long run; in addition to adhering to good scientific practice through making results reproducible. This course is aimed at researchers, doctoral and master students who develop scientific software to carry out their research. The course will contain four units spanning four weeks, and consist of both an asynchronous and a synchronous part.
Total effort: Approximately 30 hours.
Date/Duration: Sessions will take place in six sessions during two weeks in March 2022: Specifically, on 1/3/22, 2/3/22, 3/3/22, 8/3/22,9/3/22,10/3/22, from 10:00 AM to 1:00 PM. Please note that there is also an asynchronous part to the course, which you can work on at a time of your choice, but which should be completed before the first/before the subsequent session for a better learning experience.
You will be able to obtain a certificate of participation. Basic prior programming knowledge is a requirement, but the emphasis lies on basic; ideally in python as the examples will be based on python. A laptop/PC with camera, microphone and speakers is required.
1. Introduction to git: Using GitHub
- Creating a new repository
- Branching and pull requests
- Code review and merging
In this unit, we will work on jupyter notebooks.
2. Clean coding as a team: Adhere to guidelines and common coding principles
- Technical debt and clean coding
- Style guides
- Linting and performance of code
- More on git: “Clean” repositories
You will work with your team and agree on a set of common standards and principles.
3. Think before you code: Planning your programming project
- The programming paradigm
- Planning a piece of software: Demonstrations
You and your team will design your software.
- A good documentation
- Write documentation like a pro with sphinx (doxygen)
The documentation tools for your software will be set up and structured.
5. Testing, testing, testing …
- Types of tests
- Unittest and pytest
- Test-driven development
We will continue our work on the programming project.
6. Continuous integration: GitHub actions
- Run your tests and linter automatically through GitHub actions
- Build and publish your documentation on readthedocs
- Publish your python module as a package
We will set up github actions and you will learn how to publish python modules.
Content of each unit
- An introduction to new topics and concepts (1h)
- Individual work on the new concepts (1h)
- A coding demonstration (1h)
- Tasks to be solved as teams of 2-3 developers (2h)
You will need python3, git, and numpy/seaborn/pandas/jupyter for the course.