pyvista.Transform.rotate_z

pyvista.Transform.rotate_z#

Transform.rotate_z(
angle: float,
*,
point: VectorLike[float] | None = None,
multiply_mode: Literal['pre', 'post'] | None = None,
) → Transform[source]#

Compose a rotation about the z-axis.

Create a matrix for rotation about the z-axis and compose() it with the current transformation matrix according to pre-multiply or post-multiply semantics.

Internally, the matrix is stored in the matrix_list.

Parameters:
anglefloat

Angle in degrees to rotate about the z-axis.

pointVectorLike[float], optional

Point to rotate about. By default, the object’s point is used, but this can be overridden. If set, two additional transformations are composed and added to the matrix_list:

multiply_mode‘pre’ | ‘post’, optional

Multiplication mode to use when composing the matrix. By default, the object’s multiply_mode is used, but this can be overridden. Set this to 'pre' for pre-multiplication or 'post' for post-multiplication.

See also

as_rotation

Get this transform’s rotation component.

pyvista.DataObjectFilters.rotate_z

Rotate a mesh about the z-axis.

Examples

Compose a rotation about the z-axis.

>>> import pyvista as pv
>>> transform = pv.Transform().rotate_z(90)
>>> transform.matrix
array([[ 0., -1.,  0.,  0.],
       [ 1.,  0.,  0.,  0.],
       [ 0.,  0.,  1.,  0.],
       [ 0.,  0.,  0.,  1.]])

Compose a second rotation about the z-axis.

>>> _ = transform.rotate_z(45)

The result is a matrix that rotates about the z-axis by 135 degrees.

>>> transform.matrix
array([[-0.70710678, -0.70710678,  0.        ,  0.        ],
       [ 0.70710678, -0.70710678,  0.        ,  0.        ],
       [ 0.        ,  0.        ,  1.        ,  0.        ],
       [ 0.        ,  0.        ,  0.        ,  1.        ]])
Contents