To complete this course, you will need to attend the Microsoft Teams session. You should do this using the Microsoft Teams app, signed into your Imperial account, if you have one. You should have a working microphone and camera.
This course will take place in an ICT computer room and so laptops are not required but you may bring one if you wish.
This course can be studied independently at your own pace. Make sure you have completed the pre-course instructions described above. Once your GitHub account is set up and registered with GitHub Education, open a Codespace as described below. You can then work your way through the jupyter notebooks in the the order they are numbered. Make sure to experiment with the tools and complete the exercises to gain experience of using the tools yourself.
The course materials are stored in this Github repository. You may review them before the course if you want to, but you don't have to.
During the course you will need to be able toview the course materials and run the codes in the repository. The easiest way to run the course materials in a GitHub Codespace (instructions below), which can be done on a computer room computer for a face to face session, or your own laptop. This requires no setup in advance past the pre-course instructions above.
Alternatively, you may download the course materials on to your own computer, install Visual Studio Code and install the following extensions within VS Code:
You will also need to donwload a version of MPICH suitable for your operating system. You will also need to install the following Python packages:
- ipykernel
- numpy
- matplotlib
- mpi4py
- pandas
These packages are specified in the requirements.txt file which you could use to install the packages if you're familiar with how to use this kind of file.
This course is designed to run inside of a Codespace. A Codespace is a development environment hosted by GitHub directly from a repository. To use this, you will need to be signed into a GitHub account. To open the Codespace, click the green Code button at the top right of the repository. Make sure you're in the Codespaces tab and click the Create New Codespace on Master button. This will create a Codespace of your own. This will take a minute or so to initialise. You may be asked to reload the page. If so, do reload the page. If the Codespace seems to get stuck loading, reloading the page can often fix the problem.
Once your Codespace has initialised, it will remain associated with your GitHub account for around a month, when it will expire. Your Codespace will be given a name like "fuzzy-barnacle" so you can identify it. To reopen it on a future occasion, click the Code button again, then select the Codespace, click Open, then Open in Browser.
In this course, you might want to change the number of cores the Codespace uses to experiment with using different numbers of cores. To do this, you will need to close the Codespace, then click the three dots, next to the Codespace name, click "Change machine type" and select the number of cores you want to use.
To download the content of the files within the Codespace, open the Files tab on the left, select the files, right click and click Download button. Alternatively, if you're familiar with GitHub, you can open the source control tab on the left, you can commit and push changes. This will fork the repository with your changes. Either of these options will allow you to keep a copy of the course notes with your solutions to the exercises, etc.