This tutorial is intended to be executed in a Web browser without installing any software. To this end, this repository comes with a prebuild GitHub Codespaces configuration. Launch a Codespaces environment by clicking the banner "Open in GitHub Codespaces" and start evaluating the Jupyter notebooks (by placing the cursor into a code cell and pressing Ctrl+Enter
or Shift+Enter
). When prompted for a Python kernel, select
Python 3.10.13 ~/python/current/bin/python3
Some familiarity with Python is helpful, but not essential. If you are new to Python, you sould be able to learn quite a bit just by clicking through the notebooks.
Notebooks for the workshop on Open Scientific Computing can be found in the "ScientificComputing" folder.
In addition to running in the browser, you can also use VS Code. Start VS Code and then use Ctrl+Shift P to bring up the Command Palette. Select "Codespaces: Create New Codespace", then chose this repository. The code will still be running in the cloud, but you my find VS Code a better environment.
You are welcome to clone this repository and set up your local environment. Notice that a few settings are specific to the Codespaces configuration and will need adjusting in a custom environment. We recommend you review environment.yml
for Python package dependencies, and the files in .devcontainer
for additional dependencies.
Enjoy and let us know what you think about these workshop materials! Please help us improve it by reporting issues or submitting pull requests!