Chapter 2. Working in JupyterLab

Procedure

1. Click File New Notebook.

2. If prompted, select a kernel for your Jupyter notebook from the list.

   If you want to use a kernel, click Select. If you do not want to use a kernel, click No Kernel.

Procedure

1. In the File Browser in the left sidebar of the JupyterLab interface, click Upload Files ( ).

2. Locate and select the notebook file and then click Open.

   The file is displayed in the File Browser.

Procedure

1. Copy the HTTPS URL for the Git repository.

   • In GitHub, click ⤓ Code HTTPS and then click the Copy URL to clipboard icon.
   • In GitLab, click Code and then click the Copy URL icon under Clone with HTTPS.

2. In the JupyterLab interface, click the Git Clone button ( ).

   You can also click Git Clone a repository in the menu, or click the Git icon ( ) and click the Clone a repository button.

   The Clone a repo dialog appears.

3. Enter the HTTPS URL of the repository that contains your notebook file.
4. Click CLONE.
5. If prompted, enter your username and password for the Git repository.

Procedure

1. Copy the HTTPS URL for the Git repository.

   • In GitHub, click ⤓ Code HTTPS and then click the Copy URL to clipboard icon.
   • In GitLab, click Code and then click the Copy URL icon under Clone with HTTPS.
2. In JupyterLab, click File New Terminal to open a terminal window.

3. Enter the git clone command:

   git clone <git-clone-URL>

   Copy to Clipboard

   Replace git-clone-URL> with the HTTPS URL, for example:

   [1234567890@jupyter-nb-jdoe ~]$ git clone https://github.com/example/myrepo.git
   Cloning into myrepo...
   remote: Enumerating objects: 11, done.
   remote: Counting objects: 100% (11/11), done.
   remote: Compressing objects: 100% (10/10), done.
   remote: Total 2821 (delta 1), reused 5 (delta 1), pack-reused 2810
   Receiving objects: 100% (2821/2821), 39.17 MiB | 23.89 MiB/s, done.
   Resolving deltas: 100% (1416/1416), done.

   Copy to Clipboard

Procedure

1. In the JupyterLab interface, click the Git button ( ).
2. Click the Pull latest changes button ( ).

Procedure

1. Click File Save All to save any unsaved changes.
2. Click the Git icon ( ) to open the Git pane in the JupyterLab interface.

3. Confirm that your changed files appear under Changed.

   If your changed files appear under Untracked, click Git Simple Staging to enable a simplified Git process.

4. Commit your changes.

   1. Ensure that all files under Changed have a blue checkmark beside them.
   2. In the Summary field, enter a brief description of the changes you made.
   3. Click Commit.
5. Click Git Push to Remote to push your changes to the remote repository.
6. When prompted, enter your Git credentials and click OK.

Procedure

1. Enter the following in a new cell in your Jupyter notebook:

   !pip list

   Copy to Clipboard
2. Run the cell.

Procedure

1. Create a new text file using one of the following methods:

   • Click + to open a new launcher and then click Text file.
   • Click File New Text File.

2. Rename the text file to requirements.txt.

   1. Right-click the name of the file and then click Rename Text. The Rename File dialog opens.
   2. Enter requirements.txt in the New Name field and then click Rename.

3. Add the packages to install to the requirements.txt file.

   altair

   Copy to Clipboard

   You can specify the exact version to install by using the == (equal to) operator, for example:

   altair==4.1.0

   Copy to Clipboard
   Note

   Red Hat recommends specifying exact package versions to enhance the stability of your workbench over time. New package versions can introduce undesirable or unexpected changes in your environment’s behavior.

   To install multiple packages at the same time, place each package on a separate line.

4. Install the packages in requirements.txt to your server by using a notebook cell.

   1. Create a new notebook cell and enter the following command:

      !pip install -r requirements.txt

      Copy to Clipboard
   2. Run the cell by pressing Shift and Enter.
   Important

   The pip install command installs the package on your workbench. However, you must run the import statement in a code cell to use the package in your code.

   import altair

   Copy to Clipboard