Jupyter Notebooks

Connecting to JupyterHub

Jupyter defines it’s notebooks (“Jupyter Notebooks”) as an open-source web application that allows you to create and share documents that contain live code, equations, visualizations and narrative text. Uses include: data cleaning and transformation, numerical simulation, statistical modeling, data visualization, machine learning, and much more.

  1. To open a Jupyter notebook, go to the address of the cluster, below Crane will be used as an example, sign in using your hcc credentials (NOT your campus credentials).

  2. Select your preferred authentication method.

  3. Choose a job profile. Select “Noteboook via SLURM Job | Small (1 core, 4GB RAM, 8 hours)” for light tasks such as debugging or small-scale testing. Select the other options based on your computing needs. Note that a SLURM Job will save to your “work” directory.

Running Code

  1. Select the “New” dropdown menu and select the file type you want to create.

2. A new tab will open, where you can enter your code. Run your code by selecting the “play” icon.

Opening a Terminal

  1. From your user home page, select “terminal” from the “New” drop-down menu.
  2. A terminal opens in a new tab. You can enter Linux commands at the prompt.

Using Custom Packages

Many popular python and R packages are already installed and available within Jupyter Notebooks. However, it is possible to install custom packages to be used in notebooks by creating a custom Anaconda Environment. Detailed information on how to create such an environment can be found at Using an Anaconda Environment in a Jupyter Notebook on Crane.