pyvista.PolyDataFilters.ribbon

PolyDataFilters.ribbon(width=None, scalars=None, angle=0.0, factor=2.0, normal=None, tcoords=False, preference='points', progress_bar=False)

このデータセットに線分のリボンを作成します．

注釈

入力データセットに行がない場合，出力は空の pyvista.PolyData メッシュになります．

パラメータ:

widthfloat, optional

リボンの "半分の" 幅を設定します．幅を変更できる場合は，これが最小幅になります．デフォルトは長さの10%です．

scalarsstr, optional

リボンの幅を変更するために使用するスカラー配列の文字列名．これはスカラー配列が指定されている場合にのみ使用されます．

anglefloat, optional

線の法線からのリボンのオフセット角度の角度．デフォルトは0.0です．

factorfloat, optional

リボンの最大幅を最小幅の倍数で設定します．デフォルトは2.0です．

normalsequence[float], optional

デフォルトとして使用する標準．

tcoordsbool, str, optional

True の場合，リボンに沿ってテクスチャ座標を生成します．これは， 'length' または 'normalized' でテクスチャ座標を生成するように指定することもできます．

preferencestr, optional

スカラー配列を名前で検索する際のフィールドの設定．

progress_barbool, default: False

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

戻り値:

pyvista.PolyData

リボンのメッシュ． 入力データセットに線がない場合は空です．

例

線分をリボンに変換してプロットします．

>>> import numpy as np
>>> import pyvista as pv
>>> n = 1000
>>> theta = np.linspace(-10 * np.pi, 10 * np.pi, n)
>>> z = np.linspace(-2, 2, n)
>>> r = z**2 + 1
>>> x = r * np.sin(theta)
>>> y = r * np.cos(theta)
>>> points = np.column_stack((x, y, z))
>>> pdata = pv.PolyData(points)
>>> pdata.lines = np.hstack((n, range(n)))
>>> pdata['distance'] = range(n)
>>> ribbon = pdata.ribbon(width=0.2)
>>> ribbon.plot(show_scalar_bar=False)