Chapter 4. Using the Jupyter application

Procedure

1. Click File New Notebook.

2. If prompted, select a kernel for your 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 click Open.

   The file is displayed in the File Browser.

Procedure

1. Copy the HTTPS URL for the Git repository.

   • On GitHub, click ⤓ Code HTTPS and click the Clipboard button.
   • On GitLab, click Clone and click the Clipboard button 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.
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.

   • On GitHub, click ⤓ Code HTTPS and click the Clipboard button.
   • On GitLab, click Clone and click the Clipboard button 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>

   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.

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 notebook:

   !pip list

2. Run the cell.

Procedure

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

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

2. Rename the text file to requirements.txt.

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

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

   altair

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

   altair==4.1.0

   Note

   Red Hat recommends specifying exact package versions to enhance the stability of your notebook server 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 using a notebook cell.

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

      !pip install -r requirements.txt

   2. Run the cell by pressing Shift and Enter.
   Important

   This command installs the package on your notebook server, but you must still run the import directive in a code cell to use the package in your code.

   import altair