pyvista.plot#

plot(
var_item,
off_screen=None,
full_screen=None,
screenshot=None,
interactive=True,
cpos=None,
window_size=None,
show_bounds=False,
show_axes=None,
notebook=None,
background=None,
text='',
return_img=False,
eye_dome_lighting=False,
volume=False,
parallel_projection=False,
jupyter_backend=None,
return_viewer=False,
return_cpos=False,
jupyter_kwargs=None,
theme=None,
anti_aliasing=None,
zoom=None,
border=False,
border_color='k',
border_width=2.0,
ssao=False,
**kwargs,
)[source]#

Plot a PyVista, numpy, or vtk object.

Parameters:
var_itempyvista.DataSet

See Plotter.add_mesh for all supported types.

off_screenbool, optional

Plots off screen when True. Helpful for saving screenshots without a window popping up. Defaults to the global setting pyvista.OFF_SCREEN.

full_screenbool, default: pyvista.plotting.themes.Theme.full_screen

Opens window in full screen. When enabled, ignores window_size.

screenshotstr or bool, optional

Saves screenshot to file when enabled. See: Plotter.screenshot(). Default False.

When True, takes screenshot and returns numpy array of image.

interactivebool, default: pyvista.plotting.themes.Theme.interactive

Allows user to pan and move figure.

cposlist, optional

List of camera position, focal point, and view up.

window_sizesequence, default: pyvista.plotting.themes.Theme.window_size

Window size in pixels.

show_boundsbool, default: False

Shows mesh bounds when True.

show_axesbool, default: pyvista.plotting.themes._AxesConfig.show

Shows a vtk axes widget.

notebookbool, default: pyvista.plotting.themes.Theme.notebook

When True, the resulting plot is placed inline a jupyter notebook. Assumes a jupyter console is active.

backgroundColorLike, default: pyvista.plotting.themes.Theme.background

Color of the background.

textstr, optional

Adds text at the bottom of the plot.

return_imgbool, default: False

Returns numpy array of the last image rendered.

eye_dome_lightingbool, optional

Enables eye dome lighting.

volumebool, default: False

Use the Plotter.add_volume() method for volume rendering.

parallel_projectionbool, default: False

Enable parallel projection.

jupyter_backendstr, default: pyvista.plotting.themes.Theme.jupyter_backend

Jupyter notebook plotting backend to use. One of the following:

  • 'none' : Do not display in the notebook.

  • 'static' : Display a static figure.

  • 'trame' : Display using trame.

This can also be set globally with pyvista.set_jupyter_backend().

return_viewerbool, default: False

Return the jupyterlab viewer, scene, or display object when plotting with jupyter notebook.

return_cposbool, default: False

Return the last camera position from the render window when enabled. Defaults to value in theme settings.

jupyter_kwargsdict, optional

Keyword arguments for the Jupyter notebook plotting backend.

themepyvista.plotting.themes.Theme, optional

Plot-specific theme.

anti_aliasingstr | bool, default: pyvista.plotting.themes.Theme.anti_aliasing

Enable or disable anti-aliasing. If True, uses "msaa". If False, disables anti_aliasing. If a string, should be either "fxaa" or "ssaa".

zoomfloat, str, optional

Camera zoom. Either 'tight' or a float. A value greater than 1 is a zoom-in, a value less than 1 is a zoom-out. Must be greater than 0.

borderbool, default: False

Draw a border around each render window.

border_colorColorLike, default: “k”

Either a string, rgb list, or hex color string. For example:

  • color='white'

  • color='w'

  • color=[1.0, 1.0, 1.0]

  • color='#FFFFFF'

border_widthfloat, default: 2.0

Width of the border in pixels when enabled.

ssaobool, optional

Enable surface space ambient occlusion (SSAO). See Plotter.enable_ssao() for more details.

**kwargsdict, optional

See pyvista.Plotter.add_mesh() for additional options.

Returns:
cposlist

List of camera position, focal point, and view up. Returned only when return_cpos=True or set in the default global or plot theme. Not returned when in a jupyter notebook and return_viewer=True.

imagenp.ndarray

Numpy array of the last image when either return_img=True or screenshot=True is set. Not returned when in a jupyter notebook with return_viewer=True. Optionally contains alpha values. Sized:

  • [Window height x Window width x 3] if the theme sets transparent_background=False.

  • [Window height x Window width x 4] if the theme sets transparent_background=True.

widgetipywidgets.Widget

IPython widget when return_viewer=True.

Examples

Plot a simple sphere while showing its edges.

>>> import pyvista as pv
>>> mesh = pv.Sphere()
>>> mesh.plot(show_edges=True)
../../../_images/pyvista-plot-1_00_00.png

Plot a volume mesh. Color by distance from the center of the ImageData. Note volume=True is passed.

>>> import numpy as np
>>> grid = pv.ImageData(
...     dimensions=(32, 32, 32), spacing=(0.5, 0.5, 0.5)
... )
>>> grid['data'] = np.linalg.norm(grid.center - grid.points, axis=1)
>>> grid['data'] = np.abs(grid['data'] - grid['data'].max()) ** 3
>>> grid.plot(volume=True)
../../../_images/pyvista-plot-1_01_00.png