pyvista.DataSetFilters.warp_by_scalar#

DataSetFilters.warp_by_scalar(scalars=None, factor=1.0, normal=None, inplace=False, progress_bar=False, **kwargs)[ソース]#

データセットのポイントをポイントデータスカラー配列の値でワープします．

これにより，スカラー量にスケール係数を掛けた値だけポイント法線に沿ってポイントを移動することで，ポイント座標が修正されます．

パラメータ:
scalarsstr, optional

ワープに使用するスカラーの名前．デフォルトは現在アクティブなスカラーです．

factorfloat, default: 1.0

スケーリングエフェクトを大きくするためのスケーリング係数．エイリアス scale_factor も受け付けます-存在する場合， factor を上書きします．

normalsequence, optional

ユーザが法線を指定します．指定した場合，データ法線は無視され，指定した法線を使用してワープが投影されます．

inplacebool, default: False

True の場合，与えられたデータセットのポイントが更新されます．

progress_barbool, default: False

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

**kwargsdict, optional

factor の代わりに， scale_factor を受け取ります．

戻り値:
pyvista.DataSet

ワープしたデータセット． リターンタイプは入力と一致します．

例

まず，ワープしていないメッシュをプロットします．

>>> from pyvista import examples
>>> mesh = examples.download_st_helens()
>>> mesh.plot(cmap='gist_earth', show_scalar_bar=False)
../../../_images/pyvista-DataSetFilters-warp_by_scalar-1_00_00.png

次に， 'Elevation' スカラーを使ってメッシュをワープさせます．

>>> warped = mesh.warp_by_scalar('Elevation')
>>> warped.plot(cmap='gist_earth', show_scalar_bar=False)
../../../_images/pyvista-DataSetFilters-warp_by_scalar-1_01_00.png

このフィルターを使用したその他の例については， 表面の法線を計算します を参照してください．