create_axes_marker

create_axes_marker(

label_color=None,

x_color=None,

y_color=None,

z_color=None,

xlabel='X',

ylabel='Y',

zlabel='Z',

labels_off: bool = False,

line_width=2,

cone_radius=0.4,

shaft_length=0.8,

tip_length=0.2,

ambient=0.5,

label_size=(0.25, 0.1),

) → vtkAxesActor

Create an axis actor.

Parameters:

label_colorColorLike, optional

Color of the label text.

x_colorColorLike, optional

Color of the x-axis text.

y_colorColorLike, optional

Color of the y-axis text.

z_colorColorLike, optional

Color of the z-axis text.

xlabelstr, default: “X”

Text used for the x-axis.

ylabelstr, default: “Y”

Text used for the y-axis.

zlabelstr, default: “Z”

Text used for the z-axis.

labels_offbool, default: False

Enable or disable the text labels for the axes.

line_widthfloat, default: 2

The width of the marker lines.

cone_radiusfloat, default: 0.4

The radius of the axes arrow tips.

shaft_lengthfloat, default: 0.8

The length of the axes arrow shafts.

tip_lengthfloat, default: 0.2

Length of the tip.

ambientfloat, default: 0.5

The ambient of the axes arrows. Value should be between 0 and 1.

label_sizesequence[float], default: (0.25, 0.1)

The width and height of the axes label actors. Values should be between 0 and 1. For example (0.2, 0.1).

Returns:

vtkAxesActor

Axes actor.

Examples

Download Python source code | Download Jupyter notebook

Create the default axes marker.

>>> import pyvista as pv
>>> marker = pv.create_axes_marker()
>>> pl = pv.Plotter()
>>> _ = pl.add_actor(marker)
>>> pl.show()

Static Scene

Interactive Scene

Create an axes marker at the origin with custom colors and axis labels.

>>> import pyvista as pv
>>> marker = pv.create_axes_marker(
...     line_width=4,
...     ambient=0.0,
...     x_color='#378df0',
...     y_color='#ab2e5d',
...     z_color='#f7fb9a',
...     xlabel='X Axis',
...     ylabel='Y Axis',
...     zlabel='Z Axis',
...     label_size=(0.1, 0.1),
... )
>>> pl = pv.Plotter()
>>> _ = pl.add_actor(marker)
>>> pl.show()

Static Scene

Interactive Scene