pyvista.core.utilities.features.perlin_noise

perlin_noise(

amplitude,

freq: Sequence[float],

phase: Sequence[float],

)

Perlin ノイズを実装する暗黙の関数を返します．

Uses vtkPerlinNoise and computes a Perlin noise field as an implicit function. vtkPerlinNoise is a concrete implementation of vtkImplicitFunction. Perlin noise, originally described by Ken Perlin, is a non-periodic and continuous noise function useful for modeling real-world objects.

ノイズパターンの振幅と周波数は調整可能です．このPerlinノイズの実装は，Graphics Gems IIのGreg Wardのバージョンから密接に派生したものです．

パラメータ:

amplitudefloat

ノイズ関数の振幅．

振幅 amplitude は負になることがある．ノイズ関数は -|Amplitude| と |Amplitude| の間でランダムに変化します．したがって，値の範囲は 2*|Amplitude| と大きくなっています．初期振幅は1です．

freqsequence[float]

ノイズ関数の周波数，または物理的なスケール（高いほど細かいスケール）．

周波数は，軸ごとに調整することも，全軸で同じにすることも可能です．

phasesequence[float]

ノイズ関数の位相を設定／返します．

このパラメータは，空間内でノイズ関数をシフトさせるために使用することができます（おそらく，別のスケールのノイズパターンとのビートを避けるため）．位相は約単位ごとに繰り返す傾向があるので，0.5の位相は半周期のシフトとなります．

戻り値:

vtkPerlinNoise

Instance of vtkPerlinNoise to a Perlin noise field as an implicit function. Use with sample_function().

参考

サンプル関数:2DでのPerlinノイズ

サンプル関数:3DでのPerlinノイズ

例

振幅0.1，全軸の周波数1，全軸の位相0，Perlinノイズ関数を作成します．

>>> import pyvista as pv
>>> noise = pv.perlin_noise(0.1, (1, 1, 1), (0, 0, 0))

構造格子上でPerlinノイズをサンプリングし，それをプロットする．

>>> grid = pv.sample_function(noise, bounds=[0, 5, 0, 5, 0, 5])
>>> grid.plot()

スタティックシーン

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