pyvista.Plotter.add_lines

Plotter.add_lines(

lines: NumpyArray[float],

color: ColorLike = 'w',

width: float = 5,

label: str | None = None,

name: str | None = None,

connected: bool = False,

) → Actor

プロッティングオブジェクトに線分を追加します．

パラメータ:

linesnp.ndarray

線分セグメントを表すポイント．たとえば，2つの線分セグメントは次のように表されます: np.array([[0, 1, 0], [1, 0, 0], [1, 1, 0], [2, 0, 0]])

colorColorLike, default: 'w'

文字列，RGBリスト，または16進カラー文字列．例:

• color='white'

• color='w'

• color=[1.0, 1.0, 1.0]

• color='#FFFFFF'

widthfloat, default: 5

線の太さ．

labelstr, default: None

pyvista.Plotter.add_legend() でシーンに凡例を追加するときに使用する文字列ラベル．

namestr, default: None

簡単に更新できるように，追加したアクターの名前．この名前のアクターがレンダリングウィンドウに既に存在する場合は，新しいアクターに置き換えられます．

connectedbool, default: False

線分は，一連の 接続された 線分を表す点として扱います．例えば，2本の線分がつながっている場合， np.array([[0, 0, 0], [1, 0, 0], [1, 1, 0]]) として表されます．もし False ならば， lines には 偶 数の点を渡さなければならず，線分は接続されている必要はありません．

戻り値:

pyvista.Actor

ラインアクター．

例

2本の線をプロットします．

>>> import numpy as np
>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> points = np.array([[0, 1, 0], [1, 0, 0], [1, 1, 0], [2, 0, 0]])
>>> actor = pl.add_lines(points, color='purple', width=3)
>>> pl.camera_position = 'xy'
>>> pl.show()

スタティックシーン

インタラクティブなシーン

connected=True で線を追加すると，一連のつながった線分が追加されます．

>>> pl = pv.Plotter()
>>> points = np.array([[0, 1, 0], [1, 0, 0], [1, 1, 0], [2, 0, 0]])
>>> actor = pl.add_lines(points, color='purple', width=3, connected=True)
>>> pl.camera_position = 'xy'
>>> pl.show()

スタティックシーン

インタラクティブなシーン