1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
.. _core-api-index:
Core API
========
The `Visualization Toolkit`_ (VTK), developed by Kitware_, has many mesh data
types that PyVista wraps.
This chapter is intended to describe these different mesh types and how we wrap
and implement each of those mesh types in VTK. This chapter also highlights
how all PyVista types have direct access to common VTK filters
(see :ref:`filters`).
.. _Visualization Toolkit: https://vtk.org
.. _Kitware: https://www.kitware.com
All PyVista meshes inherit from the DataSet type (see :ref:`dataset`).
PyVista has the following mesh types:
- :class:`pyvista.PointSet` is used to represent a set of points.
This is to provide an interface for datasets that explicitly use
"point" arrays to represent geometry. The :class:`pyvista.PointSet`
class is an extension of :vtk:`vtkPointSet`.
- :class:`pyvista.PolyData` consists of any 1D or 2D geometries to
construct vertices, lines, polygons, and triangles. We generally use
:class:`pyvista.PolyData` to construct scattered points and closed/open
surfaces (non-volumetric datasets). The :class:`pyvista.PolyData` class
is an extension of :vtk:`vtkPolyData`.
- A :class:`pyvista.UnstructuredGrid` is the most general dataset type
that can hold any 1D, 2D, or 3D cell geometries. You can think of this
as a 3D extension of :class:`pyvista.PolyData` that allows volumetric
cells to be present. It's fairly uncommon to explicitly make unstructured
grids but they are often the result of different processing routines that
might extract subsets of larger datasets. The :class:`pyvista.UnstructuredGrid`
class is an extension of :vtk:`vtkUnstructuredGrid`.
- A :class:`pyvista.StructuredGrid` is a regular lattice of points aligned
with internal coordinate axes such that the connectivity can be defined by
a grid ordering. These are commonly made from :func:`numpy.meshgrid`. The
cell types of structured grids must be 2D quads or 3D hexahedra. The
:class:`pyvista.StructuredGrid` class is an extension of :vtk:`vtkStructuredGrid`.
- A :class:`pyvista.RectilinearGrid` defines meshes with implicit geometries
along the axis directions that are rectangular and regular. The
:class:`pyvista.RectilinearGrid` class is an extension of :vtk:`vtkRectilinearGrid`.
- Image data, commonly referred to as uniform grids, and defined by the
:class:`pyvista.ImageData` class are meshes with implicit geometries where
cell sizes are uniformly assigned along each axis and the spatial reference
is built out from an origin point. The :class:`pyvista.ImageData` class is
an extension of :vtk:`vtkImageData`.
- :class:`pyvista.MultiBlock` datasets are containers to hold several VTK
datasets in one accessible and spatially referenced object. The
:class:`pyvista.MultiBlock` class is an extension of :vtk:`vtkMultiBlockDataSet`.
- :class:`pyvista.PartitionedDataSet` datasets are composite dataset to
encapsulates a dataset consisting of partitions. The :class:`pyvista.PartitionedDataSet`
class is an extension of :vtk:`vtkPartitionedDataSet`.
.. toctree::
:maxdepth: 2
objects
dataset
pointsets
grids
composite
filters
camera
lights
cells
helpers
misc
typing
partitioned
_validation
|
