set_jupyter_backend

set_jupyter_backend#

set_jupyter_backend(
backend: TypeAliasForwardRef('pyvista.JupyterBackendOptions') | str,
name=None,
**kwargs,
)[source]#

Set the plotting backend for a jupyter notebook.

Parameters:
backendstr

Jupyter backend to use when plotting. Must be one of the following:

  • 'static' : Display a single static image within the Jupyterlab environment. Still requires that a virtual framebuffer be set up when displaying on a headless server, but does not require any additional modules to be installed.

  • 'client' : Export/serialize the scene graph to be rendered with VTK.js client-side through trame. Requires trame and jupyter-server-proxy to be installed.

  • 'server': Render remotely and stream the resulting VTK images back to the client using trame. This replaces the 'ipyvtklink' backend with better performance. Supports the most VTK features, but suffers from minor lag due to remote rendering. Requires that a virtual framebuffer be set up when displaying on a headless server. Must have at least trame and jupyter-server-proxy installed for cloud/remote Jupyter instances. This mode is also aliased by 'trame'.

  • 'trame': The full Trame-based backend that combines both 'server' and 'client' into one backend. This requires a virtual frame buffer.

  • 'html' : Export/serialize the scene graph to be rendered with the Trame client backend but in a static HTML file.

  • 'none' : Do not display any plots within jupyterlab, instead display using dedicated VTK render windows. This will generate nothing on headless servers even with a virtual framebuffer.

Custom backends registered via register_jupyter_backend() are also accepted. Pass None to reset to auto-detection at display time.

namestr, optional

Unused.

Deprecated since version 0.49: This parameter has never had any effect and will be removed.

**kwargsdict, optional

Unused.

Deprecated since version 0.49: These parameters have never had any effect and will be removed.

Examples#

Download Python source code | Download Jupyter notebook

Enable the trame Trame backend.

>>> pv.set_jupyter_backend('trame')

Just show static images.

>>> pv.set_jupyter_backend('static')

Disable all plotting within JupyterLab and display using a standard desktop VTK render window.

>>> pv.set_jupyter_backend('none')

Reset to auto-detect the best available backend.

>>> pv.set_jupyter_backend(None)