1. Home
  2. Getting Started
  3. Creating your first experiment in Jupyter Hub
  1. Home
  2. Technical Guides
  3. Jupyter Hub
  4. Creating your first experiment in Jupyter Hub

Creating your first experiment in Jupyter Hub

The easiest way to create experiments on FABRIC is using JupyterHub. You can create your private JupyterHub environment by logging into the FABRIC portal and clicking Links->JupyterHub

Click Links->JupyterHub

The FABRIC JupyterHub uses your institutional ID and password to authenticate you as a FABRIC user.

Click “Sign in with CILogon.

Login with your institutional ID and password.

When you login for the first time, a private JuypyterHub environment will be built for you.

Wait for your private environment to build.

Your JupyterHub environment is a private container that includes a file system where you can store your FABRIC experiment notebooks. By default, FABRIC includes a set of example notebooks that demonstrate the use of the FABRIC Python API.

Open the jupyter-examples folder.

In the example folder there is a table of contents notebook labeled “start-here”.

Open the start-here notebook.

The “start-here” notebook includes links to several examples. Follow the suggested flow of notebooks to explore FABRIC’s various features. Be sure to run the ‘Configure Environment’ notebook first to set up your container configuration – SSH keys, SSH configuration file, FABlib configuration file. Then choose the “Hello, FABRIC” example notebook.

Open the Hello, FABRIC notebook.

When you open the “Hello, FABRIC” notebook you will see an example that uses the FABRIC Python API. In order to run the example and start your first slice you need to repeatedly click the Jupyter play button. Each click will run one cell of the notebook. Run all of the cells you will have executed your first FABRIC experiment.

Hit the play button to execute each step of the notebook.

Updated on July 10, 2023

Was this article helpful?

Related Articles

Having problems?
Try searching or asking questions in the FABRIC community forums!
Go to Forums

Leave a Comment