download_lucy#

download_lucy(load=True)[source]#

Download the lucy angel mesh.

Original downloaded from the The Stanford 3D Scanning Repository and decimated to approximately 100k triangle.

Parameters
loadbool, optional

Load the dataset after downloading it when True. Set this to False and only the filename will be returned.

Returns
pyvista.PolyData or str

DataSet or filename depending on load.

Examples

Plot the Lucy Angel dataset with custom lighting.

>>> from pyvista import examples
>>> import pyvista
>>> dataset = examples.download_lucy()

Create a light at the “flame”

>>> flame_light = pyvista.Light(
...     color=[0.886, 0.345, 0.133],
...     position=[550,  140, 950],
...     intensity=1.5,
...     positional=True,
...     cone_angle=90,
...     attenuation_values=(0.001, 0.005, 0)
... )

Create a scene light

>>> scene_light = pyvista.Light(intensity=0.2)
>>> pl = pyvista.Plotter(lighting=None)
>>> _ = pl.add_mesh(dataset, smooth_shading=True)
>>> pl.add_light(flame_light)
>>> pl.add_light(scene_light)
>>> pl.background_color = 'k'
>>> pl.show()
../../../_images/pyvista-examples-downloads-download_lucy-1_00_00.png

See Jupyter Notebook Plotting for another example using this dataset.