JupyterHub Guide

All your Python notebooks run on our class JupyterHub at jupyter.mrchen.org. This guide covers everything you need to get started.

Logging In¶

1. Go to jupyter.mrchen.org

2. Enter the username and password provided in class

3. Click Sign in — your personal server will start automatically

Finding Your Notebooks¶

After logging in, you’ll see the JupyterLab file browser on the left.

• shared/ — Class materials organised by module (PM1–PM7). These are read-only.

• Your home folder — Your personal workspace. Copy notebooks here to edit them.

To start working on a module:

1. Navigate to shared/PM1_Foundations/ (or whichever module you’re on)

2. Right-click the notebook file (e.g. PM1_Foundations.ipynb) and select Copy

3. Navigate to your home folder and Paste

4. Open your copy and start working

Running Code¶

• Click on a code cell and press Shift + Enter to run it

• The output appears directly below the cell

• Work through cells from top to bottom — later cells depend on earlier ones

• If something goes wrong, try Kernel → Restart Kernel and Run All Cells

Saving Your Work¶

• Your work saves automatically, but you can also press Ctrl + S (or Cmd + S on Mac)

• Your files are stored on the server — you can access them from any device by logging in

• To download a notebook to your computer: File → Download

Tips¶

• Don’t edit files in shared/ — always copy to your home folder first. Shared files may be updated by Mr Chen and your changes would be overwritten.

• Restart the kernel if your code seems stuck or variables have unexpected values.

• Read error messages carefully — Python error messages tell you the line number and what went wrong. Start from the bottom of the error and work up.