Returns a fractal noise value for an input 3D position. This compound sums multiple frequencies of simplex noise to create a noise that has both fine scale and large scale perturbations.

Inputs

position

The input position to sample the noise at.

magnitude

This scales the output noise. Before being multiplied by magnitude the range of the noise is normally between -1.0 and 1.0, but may be greater if the ratio value is larger.

num_frequencies

This is the total number of noise frequencies to sum. Generally as this number increases there will be more detail or small scale noise. The value does not need to be an integer. If one slowly animates num_frequencies the finest scale noise will gradually fade in, rather than popping on at integer values.

frequency

This is the base frequency of the fractal noise. Higher values have finer detail.

ratio

This is the ratio of magnitude of each noise frequency to the previous. If it is the same as frequency_ratio then the magnitude of each noise will be the same relative to its scale. When this value is higher the small details are stronger.

frequency_ratio

This is the ratio of each noise frequency to the previous. At a value of 0.5 each additional frequency is double the previous (twice the detail). Lower values can provide a greater range of noise frequencies while needing a lower num_frequencies.

time

By connecting a varying output like time to this allows one to animate the noise smoothly over time. The noise is actually 4 dimensional and the time value is simply a 4th coordinate added to the 3D position input.

time_ratio

This is the ratio of how fast the different noise frequencies animate. If the value is 1.0 then the frequencies all animate the same relative to their scale. A value around 1.5 (when the frequency_ratio is 0.5) may look better for natural effects, like a turbulent fluid surface.

seed

This is a seed for the random values used.

Outputs

noise

This is the output float noise value computed by the noise compound. The general range is around -1.0 to 1.0 but may differ based on magnitude, ratio, and num_frequencies settings.