1. Home
  2. Docs
  3. User Documentation openBIS 19.06.4
  4. Tools for Analysis of Data Stored in openBIS
  5. Jupyter Notebooks

Jupyter Notebooks

Jupyter notebooks are web applications that combine text, code and output (https://jupyter.org/). Jupyter supports over 40 programming languages.

Jupyter notebooks can be used to analyze data stored in openBIS.

It is possible to connect to a JupyterHub server and launch Jupyter notebooks directly from the openBIS interface. This feature is not available by default, but needs to be enabled and configured by a system admin. JupyterHub docker containers are available from our download page: openBIS download. Further documentation can be found here: JupyterHub for openBIS

 Jupyter notebooks can be launched from the main menu, under Utilities, as shown below.


To create a notebook, it is necessary to enter:

  1. The dataset(s) needed for the analysis
  2. The owner of the Jupyter notebook. Jupyter notebooks are saved back to openBIS as datasets, and these belong either to an Experiment/Collection or to an Object. The owner is the Experiment/Collection or Object where the notebook should be stored.
  3. The directory name. This is the name of the folder that will be created on the JupyterHub server.
  4. Notebook name. This is the name of the Jupyter notebook

Jupyter notebooks can also be opened from a Project, Experiment, Experimental Step choosing the corresponding option in the More drop down menu. When opening notebooks from an Experiment or Experimental Step, all connected datasets are automatically selected. 


Overview of Jupyter notebook opened from openBIS.

The Jupyter notebook opened from the openBIS interface contains some pre-filled cells. All cells need to be run. The information of two cells should be modified: Name of the dataset where the notebook will be stored and Notes (in red below).

Your script should be written in the section named “Process your data here”, that contains one empty cell (see below). Additional cells can be added.


After the analysis is done, the notebook can be saved back to openBIS, by running the last few cells which contain the information about where the notebook will be stored (as shown below).


A Jupyter extension plugin for openBIS is also available:Jupyter openBIS extension

This allows to use  even a local Jupyter installation and connect it to openBIS to download and upload data.