pyvista.DataSetFilters.glyph

DataSetFilters.glyph(

orient: bool | str = True,

scale: bool | str = True,

factor: float = 1.0,

geom: _vtk.vtkDataSet | DataSet | Sequence[_vtk.vtkDataSet | DataSet] | None = None,

indices: VectorLike[int] | None = None,

tolerance: float | None = None,

absolute: bool = False,

clamping: bool = False,

rng: VectorLike[float] | None = None,

color_mode: Literal['scale', 'scalar', 'vector'] = 'scale',

progress_bar: bool = False,

)

入力データセットに(グリフと呼ばれる)ジオメトリ表示をコピーします．

グリフは，入力ベクトルに沿って配向されてもよく，スカラーデータまたはベクトルの大きさに従ってスケーリングされてもよいです．スカラーまたはベクトルの大きさに基づいて選択するグリフのテーブルを渡すこともできます． orient および scale に使用される配列は，両方が点データまたは両方がセルデータでなければなりません．

パラメータ:

orientbool | str, default: True

True の場合，グリフを方向付けるためにアクティブなベクトル配列を使用する．stringの場合は，グリフの向きを設定するために使用するベクトル配列です．False にすると，グリフの向きを変えません．

scalebool | str | sequence[float], default: True

True の場合，グリフを方向付けるためにアクティブなスカラーを使用する．stringの場合は，グリフのスケールを設定するために使用するスケール配列です．False にすると，グリフのスケールを変えません．

factorfloat, default: 1.0

スケーリング配列に適用されるスケール係数です．

geomvtk.vtkDataSet か python:tuple(vtk.vtkDataSet), オプション

記号に使用するジオメトリ．見つからない場合は，矢印記号が使用されます．シーケンスの場合，内部のデータセットは，スカラーまたはベクトルに基づいて選択するジオメトリのテーブルを定義します．この場合，同じ長さの数のシーケンスは indices として渡されなければなりません．範囲の値( rng を参照)はテーブルの検索に影響します．

注釈

The reference direction is relative to (1, 0, 0) on the provided geometry. That is, the provided geometry will be rotated from (1, 0, 0) to the direction of the orient vector at each point.

indicessequence[float], optional

geom がシーケンスの場合，ルックアップのためにテーブルの各グリフのインデックスを指定します．指定する場合は， geom と同じ長さにする必要があります．指定しない場合は，デフォルト値の range(len(geom)) が使用されます．インデックスは，スカラー範囲( rng を参照)で解釈されます． geom の長さが1の場合は無視されます．

tolerancefloat, optional

公差を境界ボックスの長さの分数で指定してください．float値は0から1の間です．デフォルトはNoneです．absolute が True の場合，公差は絶対距離になります． None の場合，前処理ステップとしてマージするポイントは無効になります．

absolutebool, default: False

tolerance が絶対距離か分数かをコントロールします．

clampingbool, default: False

範囲指定する "scalar" 値のクランプのオンとオフを切り替えます．

rngsequence[float], optional

スカラー値が指定された場合にフィルタが考慮する値の範囲を設定します．

color_modestr, optional, default: 'scale'

If 'scale' , color the glyphs by scale. If 'scalar' , color the glyphs by scalar. If 'vector' , color the glyphs by vector.

Added in version 0.44.

progress_barbool, default: False

進行状況を示す進行状況バーを表示します．

戻り値:

pyvista.PolyData

セルの中心または点にあるグリフ．

例

ベクトルによって方向付けられ，スカラーによってスケールされた矢印を作成します．係数パラメータを使用して，矢印のサイズを小さくします．

>>> import pyvista as pv
>>> from pyvista import examples
>>> mesh = examples.load_random_hills()
>>> arrows = mesh.glyph(scale='Normals', orient='Normals', tolerance=0.05)
>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(arrows, color='black')
>>> actor = pl.add_mesh(
...     mesh,
...     scalars='Elevation',
...     cmap='terrain',
...     show_scalar_bar=False,
... )
>>> pl.show()

スタティックシーン

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

このフィルターを使用したその他の例については， 字形のプロット (ベクトルかPolyData) と 字形表 を参照してください．