pyvista.Renderer.add_axes#

Renderer.add_axes(interactive=None, line_width=2, color=None, x_color=None, y_color=None, z_color=None, xlabel='X', ylabel='Y', zlabel='Z', labels_off=False, box=None, box_args=None, viewport=(0, 0, 0.2, 0.2), **kwargs)[ソース]#

左下隅にインタラクティブ軸ウィジェットを追加します.

パラメータ:
interactivebool, optional

この方向ウィジェットをユーザが移動できるようにします.

line_widthint, default: 2

マーカーラインの幅.

colorColorLike, optional

ラベルの色.

x_colorColorLike, optional

x軸の矢印に使用する色. デフォルトはテーマ軸パラメータ.

y_colorColorLike, optional

y軸の矢印に使用する色. デフォルトはテーマ軸パラメータ.

z_colorColorLike, optional

z軸の矢印に使用する色. デフォルトはテーマ軸パラメータ.

xlabelstr, default: "X"

x軸に使用するテキスト.

ylabelstr, default: "Y"

y軸に使用するテキスト.

zlabelstr, default: "Z"

z軸に使用するテキスト.

labels_offbool, default: false

軸のテキストラベルを有効または無効にします.

boxbool, optional

ボックス方向マーカーを表示します. box_args で調整してください.詳細は pyvista.create_axes_orientation_box() を参照してください.

box_argsdict, optional

box=True の場合のオリエンテーションボックスウィジェットのパラメータです. pyvista.create_axes_orientation_box() のパラメータを参照してください.

viewportsequence[float], default: (0, 0, 0.2, 0.2)

ウィジェットのビューポート (xstart, ystart, xend, yend) です.

**kwargsdict, optional

オリエンテーションマーカーウィジェットのパラメータを渡すのに使用されます. pyvista.create_axes_marker() のパラメータを参照してください.

戻り値:
vtk.vtkAxesActor

軸アクター.

ラベルのない,太い線で軸を表示します.

>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(pv.Box(), show_edges=True)
>>> _ = pl.add_axes(line_width=5, labels_off=True)
>>> pl.show()
../../../_images/pyvista-Renderer-add_axes-1_00_00.png

デフォルトの矢印の代わりに,軸の向きのウィジェットを使用します.

>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(pv.Sphere())
>>> _ = pl.add_axes(box=True)
>>> pl.show()
../../../_images/pyvista-Renderer-add_axes-1_01_00.png

軸マーカのパラメータをさらに細かく指定します.

>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(pv.Box(), show_edges=True)
>>> _ = pl.add_axes(
...     line_width=5,
...     cone_radius=0.6,
...     shaft_length=0.7,
...     tip_length=0.3,
...     ambient=0.5,
...     label_size=(0.4, 0.16),
... )
>>> pl.show()
../../../_images/pyvista-Renderer-add_axes-1_02_00.png