DataObjectFilters.translate

DataObjectFilters.translate#

DataObjectFilters.translate(
xyz: VectorLike[float],
transform_all_input_vectors: bool = False,
inplace: bool = False,
) → _MeshType_co[source]#

Translate the mesh.

Note

See also the notes at transform() which is used by this filter under the hood.

Parameters:
xyzVectorLike[float]

A vector of three floats.

transform_all_input_vectorsbool, default: False

When True, all input vectors are transformed. Otherwise, only the points, normals, and active vectors are transformed.

inplacebool, default: False

Updates mesh in-place.

Returns:
outputDataSet | MultiBlock

Translated dataset. Return type matches input.

Examples#

Download Python source code | Download Jupyter notebook

Create a sphere and translate it by (2, 1, 2).

>>> import pyvista as pv
>>> mesh = pv.Sphere()
>>> mesh.center
(0.0, 0.0, 0.0)
>>> trans = mesh.translate((2, 1, 2), inplace=False)
>>> trans.center
(2.0, 1.0, 2.0)

See Also#

pyvista.Transform.translate

Concatenate a translation matrix with a transformation.