pyvista.examples.downloads.download_bird_bath

pyvista.examples.downloads.download_bird_bath#

download_bird_bath(load=True, *, high_resolution=False)[source]#

Download a scan of a bird bath created by Ivan Nikolov.

The dataset was downloaded from GGG-BenchmarkSfM: Dataset for Benchmarking Close-range SfM Software Performance under Varying Capturing Conditions

Original datasets are under the CC BY 4.0 license.

For more details, see Ivan Nikolov Datasets

Changed in version 0.45: A decimated version of this dataset with 35 thousand cells is now returned. Previously, a high-resolution version with 3.5 million cells was returned. Use high_resolution=True for the high-resolution version.

Parameters:
loadbool, default: True

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

high_resolutionbool, default: False

Set this to True to return a high-resolution version of this dataset. By default, a decimated version is returned with 99% reduction.

Added in version 0.45.

Returns:
pyvista.PolyData | str

DataSet or filename depending on load.

Examples

Download and plot the dataset.

>>> from pyvista import examples
>>> mesh = examples.download_bird_bath()
>>> mesh.plot()
../../../_images/pyvista-examples-downloads-download_bird_bath-1_00_00.png

Return the statistics of the dataset.

>>> mesh
PolyData (...)
  N Cells:    35079
  N Points:   18796
  N Strips:   0
  X Bounds:   -1.600e+02, 1.482e+02
  Y Bounds:   -1.522e+02, 1.547e+02
  Z Bounds:   -5.491e-01, 1.408e+02
  N Arrays:   0

See also

Bird Bath Dataset

See this dataset in the Dataset Gallery for more info.