plot#

DataSet.plot(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, use_ipyvtk=None, jupyter_backend=None, return_viewer=False, return_cpos=False, jupyter_kwargs=None, theme=None, hidden_line_removal=None, anti_aliasing=None, zoom=None, border=None, border_color='k', border_width=2.0, ssao=False, **kwargs)#

Plot a PyVista, numpy, or vtk object.

Parameters:
var_itempyvista.DataSet, vtk, or numpy object

PyVista, VTK, or numpy object to be plotted.

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, optional

Opens window in full screen. When enabled, ignores window_size. Defaults to active theme setting in pyvista.global_theme.full_screen.

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, optional

Allows user to pan and move figure. Defaults to pyvista.global_theme.interactive.

cposlist, optional

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

window_sizelist, optional

Window size in pixels. Defaults to global theme pyvista.global_theme.window_size.

show_boundsbool, optional

Shows mesh bounds when True. Default False.

show_axesbool, optional

Shows a vtk axes widget. If None, enabled according to pyvista.global_theme.axes.show.

notebookbool, optional

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

backgroundcolor_like, optional

Color of the background.

textstr, optional

Adds text at the bottom of the plot.

return_imgbool, optional

Returns numpy array of the last image rendered.

eye_dome_lightingbool, optional

Enables eye dome lighting.

volumebool, optional

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

parallel_projectionbool, optional

Enable parallel projection.

use_ipyvtkbool, optional

Deprecated. Instead, set the backend either globally with pyvista.set_jupyter_backend('ipyvtklink') or with backend='ipyvtklink'.

jupyter_backendstr, optional

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

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

  • 'static' : Display a static figure.

  • 'ipygany' : Show a ipygany widget

  • 'panel' : Show a panel widget.

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

return_viewerbool, optional

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

return_cposbool, optional

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.themes.DefaultTheme, optional

Plot-specific theme.

hidden_line_removalbool, optional

Wireframe geometry will be drawn using hidden line removal if the rendering engine supports it. See Plotter.enable_hidden_line_removal. Defaults to the theme setting pyvista.global_theme.hidden_line_removal.

anti_aliasingbool, optional

Enable or disable anti-aliasing. Defaults to the theme setting pyvista.global_theme.anti_aliasing.

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, optional

Draw a border around each render window. Default False.

border_colorcolor_like, optional

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, optional

Width of the border in pixels when enabled.

ssaobool, optional

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

**kwargsoptional keyword arguments

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.

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-DataSet-plot-1_00_00.png

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

>>> import numpy as np
>>> grid = pv.UniformGrid(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-DataSet-plot-1_01_00.png