pyvista.Plotter.add_axes

Plotter.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()

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

>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(pv.Sphere())
>>> _ = pl.add_axes(box=True)
>>> pl.show()

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

>>> 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()