pyvista.examples.downloads.download_owl

Contents

pyvista.examples.downloads.download_owl#

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

Download a scan of an owl statue 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 24 thousand cells is now returned. Previously, a high-resolution version with 2.4 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_owl()
>>> cpos = [
...     (-315.18, -402.21, 230.71),
...     (6.06, -1.74, 101.48),
...     (0.108, 0.226, 0.968),
... ]
>>> mesh.plot(cpos=cpos)
../../../_images/pyvista-examples-downloads-download_owl-1_00_00.png

Return the statistics of the dataset.

>>> mesh
PolyData (...)
  N Cells:    24407
  N Points:   12442
  N Strips:   0
  X Bounds:   -5.834e+01, 7.048e+01
  Y Bounds:   -7.005e+01, 6.657e+01
  Z Bounds:   1.814e+00, 2.013e+02
  N Arrays:   0

See also

Owl Dataset

See this dataset in the Dataset Gallery for more info.