pyvista.AxesGeometrySource#

class AxesGeometrySource( *, shaft_type: GeometryTypes | pyvista.DataSet = 'cylinder', shaft_radius: float = 0.025, shaft_length: float | VectorLike[float] = 0.8, tip_type: GeometryTypes | pyvista.DataSet = 'cone', tip_radius: float = 0.1, tip_length: float | VectorLike[float] = 0.2, symmetric: bool = False, symmetric_bounds: bool = False, )[source]#

Create axes geometry source.

Source for generating fully 3-dimensional axes shaft and tip geometry.

By default, the shafts are cylinders and the tips are cones, though other geometries such as spheres and cubes are also supported. The use of an arbitrary dataset for the shafts and/or tips is also supported.

Unlike pyvista.AxesActor, the output from this source is a pyvista.MultiBlock, not an actor, and does not support colors or labels. The generated axes are “true-to-scale” by default, i.e. a shaft with a radius of 0.1 will truly have a radius of 0.1, and the axes may be oriented arbitrarily in space (this is not the case for pyvista.AxesActor).

Parameters:

shaft_typestr | pyvista.DataSet, default: ‘cylinder’

Shaft type for all axes. Can be any of the following:

'cylinder'
'sphere'
'hemisphere'
'cone'
'pyramid'
'cube'
'octahedron'

Alternatively, any arbitrary 3-dimensional pyvista.DataSet may be specified. In this case, the dataset must be oriented such that it “points” in the positive z direction.

shaft_radiusfloat, default: 0.025

Radius of the axes shafts.

shaft_lengthfloat | VectorLike[float], default: 0.8

Length of the shaft for each axis.

tip_typestr | pyvista.DataSet, default: ‘cone’

Tip type for all axes. Can be any of the following:

'cylinder'
'sphere'
'hemisphere'
'cone'
'pyramid'
'cube'
'octahedron'

Alternatively, any arbitrary 3-dimensional pyvista.DataSet may be specified. In this case, the dataset must be oriented such that it “points” in the positive z direction.

tip_radiusfloat, default: 0.1

Radius of the axes tips.

tip_lengthfloat | VectorLike[float], default: 0.2

Length of the tip for each axis.

symmetricbool, default: False

Mirror the axes such that they extend to negative values.

symmetric_boundsbool, default: False

Make the bounds of the axes symmetric. This option is similar to symmetric, except only the bounds are made to be symmetric, not the actual geometry. Has no effect if symmetric is True.

Methods

AxesGeometrySource.update()

Update the output of the source.

Attributes

`AxesGeometrySource.output`	Get the output of the source.
`AxesGeometrySource.shaft_length`	Length of the shaft for each axis.
`AxesGeometrySource.shaft_radius`	Radius of the axes shafts.
`AxesGeometrySource.shaft_type`	Shaft type for all axes.
`AxesGeometrySource.symmetric`	Mirror the axes such that they extend to negative values.
`AxesGeometrySource.symmetric_bounds`	Enable or disable symmetry in the axes bounds.
`AxesGeometrySource.tip_length`	Length of the tip for each axis.
`AxesGeometrySource.tip_radius`	Radius of the axes tips.
`AxesGeometrySource.tip_type`	Tip type for all axes.