Skip to main content

A JupyterLab extension to explore and visualize HDF5 file contents.

Project description


Github Actions Status PyPI version Binder


jupyterlab-h5web is a JupyterLab extension to explore and visualize HDF5 file contents, using the web-based viewer h5web. h5web supports the NeXus format.

See Usage for more details.


  • JupyterLab 4

See the table below for earlier JupyterLab versions

Compatibility table

JupyterLab 2 JupyterLab 3 JupyterLab 4
Extension version range 0.0.1 - 0.3.0 1.0.0 - 8.0.0 10.0.0 - ...


With pip

pip install jupyterlab_h5web

To enable support for additional filters such as blosc or bitshuffle:

pip install jupyterlab_h5web[full]

This will install hdf5plugin in addition to the extension.

With conda

conda install -c conda-forge jupyterlab-h5web


This extension enables opening HDF5 files in a JupyterLab tab and exploring HDF5 files in Jupyter notebooks.

In JupyterLab

You can double-click on an HDF5 file or right-click Open with -> h5web to launch a tab.

This tab is composed of a sidebar, where you can explore the structure of the HDF5 file, and of a main area where the visualization of the selected entity takes place. This visualization is controlled by the upper-right button that can toggle between:

  • Display: visualize datasets using Line, Heatmap or Matrix visualizations.
  • Inspect: show the metadata and attributes of any entity

In Jupyter notebooks

To open a HDF5 file with H5Web, use the H5Web widget in a notebook cell:

from jupyterlab_h5web import H5Web

H5Web('<path to the HDF5 file>')

The cell height can be resized with the handle at the bottom-right.

An example is provided in example.ipynb.

Supported file formats

jupyter-h5web detects HDF5 files based on their file extensions. The viewer works for the following extensions:

  • "Classic" HDF5: .h5, .hdf5
  • NeXus: .nexus, .nx, .nxs
  • CXI: .cxi
  • NetCDF4: .nc, .nc4

For other types of files, you can change the extension to one of the supported extensions or, if it is widespread, open an issue to discuss its support.




If the following instructions do not solve your issue, you can open an issue on GitHub.

Check the server extension

If you are seeing the frontend extension but it is not working, check that jupyterlab_h5web is installed and enabled.

It should be listed when running:

jupyter serverextension list

If jupyterlab_h5web does not appear or is disabled, try to enable it:

jupyter serverextension enable jupyterlab_h5web

Check the frontend extension

If jupyterlab_h5web is installed and enabled but you are not seeing the frontend, check the frontend is installed:

jupyter labextension list


pip uninstall jupyterlab_h5web

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jupyterlab_h5web-11.0.0.tar.gz (471.5 kB view hashes)

Uploaded source

Built Distribution

jupyterlab_h5web-11.0.0-py3-none-any.whl (746.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page