codespace_instructions.md

Instructions for getting setup with codespaces for the Subsetting short course:

Note: The Codespace image might take a while to build, so make sure you do these steps ahead of the workshop.

1. Follow the instructions here to create a Hydrogen account and get a PIN.
2. Follow the GitHub documentation to create a personal GitHub account.
3. Browse to the course repo.
4. Click on the "Code" green button and then select "Create codespace on main". The codespace will launch in a new tab. This step can take up to 15-20 minutes when the codespace is building for the first time. When you subsequently launch the codespace, it will start up much faster.
5. Once the codespace completes building, navigate to the subsettools folder and click on the definte_subset.ipynb notebook.
6. Run the notebook. You will need your Hydrogen email and PIN. When prompted to select a kernel for the Jupyter notebook, click on "Python Environments" and then select the Virtual Environment.
7. Make sure the notebook runs successfully without errors.
8. Congratulations, you're all setup!