JupyterLab Basics¶
JupyterLab is the standard user interface. In the following only its essential functions are briefly introduced. A detailed documentation is available at https://jupyterlab.readthedocs.io.
Menu bar¶
The menu bar at the upper edge of JupyterLab has higher-level menus that display the actions available in JupyterLab along with their shortcut keys. The default menus are:
- File: Actions related to files and directories
- Edit: Actions related to editing documents and other activities
- View: actions that change the appearance of JupyterLab
- Run: Actions to execute code in various activities like notebooks and code consoles
- Kernel: Actions to manage kernels that are separate processes for executing code
- Tabs: a list of open documents and activities in the Dock Panel
- Settings: general settings and an editor for advanced settings
- Help: a list of help links to JupyterLab and the kernel
Left sidebar¶
In the left sidebar there are foldable tabs. The most relevant ones are:
- File browser: Switch to directories and open files with left mouse button, context menu with right mouse button
- Running kernels: Overview of running kernels
- Command overview
- Tab Overview
- Lmod software selection: Search and load/unload Lmod software modules
Workspaces
By default workspaces are not shown. If you want to display a workspaces in the file browser a link in your home directory has to be created via the folowing command: ln -s $(ws_find WORKSPACE_NAME) WORKSPACE_NAME
Main working area¶
The main working area in JupyterLab allows to arrange, resize and divide documents (notebooks, text files, etc.) and other activities (terminals, code consoles, etc.) in tabs. By holding down the left mouse button, the tabs can be grabbed and repositioned.
In a new JupyterLab session the Launcher tab is opened first. It contains buttons for starting new notebooks, code consoles and other functions. When a notebook is open, a new Launcher tab can be started by pressing the plus symbol in the file browser tab of the left sidebar, by calling File > New Launcher in the upper menu bar or by the key combination Ctrl+Shift+L.
Classic Notebook¶
The classic Jupyter Notebook user interface offers only one open Jupyter Notebook or terminal per browser tab. From the JupyterLab user interface the classic display can be reached in the menu bar under Help > Launch Classic Notebook. Clicking on the JupyterHub logo in the upper left corner will take you back to the JupyterLab interface.
Selection of software modules¶
Für die Auswahl der benötigten Lmod Softwaremodule steht in der linken Seitenleiste der entsprechender Tab Softwares zur Verfügung. Durch Eingabe im Suchfeld kann die Liste der verfügbaren Module eingegrenzt werden. Das gewünschte Modul wird über den Load Knopf geladen. In der Liste mit den geladenen Modulen können diese mit dem Unload Knopf entfernt werden.
For the selection of the required Lmod software modules, the corresponding tab Softwares is available in the left sidebar. By entering in the search field, the list of available modules can be narrowed down. The desired module is loaded via the Load button. Modules can be unloaded by pressing the Unload button.
Please note
For already opened Jupyter notebooks, newly loaded software modules will only become active after restarting the kernel (Kernel > Restart Kernel in the top menu bar). Terminals must be closed and reopened.
Log out¶
You can log out from a running Jupyter session by calling File > Log Out in the upper menu bar.
Attention
Please note that your interactive session continues to run in the background! This puts a strain on your computing time quota on HoreKa, for example.
As long as the interactive session is running, you can re-enter it at any time. Depending on the duration of your absence, it may be necessary to re-enter your one-time password and possibly KIT password.
If you want to end the interactive session before it has reached its runtime, you can do so via the Hub Control Panel. Under File > Hub Control Panel in the upper menu bar, it is opened in a new browser tab. By pressing the Stop My Server button the session will be terminated. You can now log out using the Logout button in the upper right corner or start a new session directly using the Start My Server button, for example with a changed resource selection.