Purpose

Random is the stochastic control source. It generates random control values in five modes — stepped sample-hold, smoothly interpolated random, a bounded random walk, logistic chaos, and dice rolls — with a choice of distributions and a seed, so a run is repeatable when you want it to be. It is a control-signal operator, not audio DSP.

Use

Set Rate for how often new values arrive, pick Mode and Distribution, and wire the value output into the parameter to modulate. Min and Max bound the range, Slew softens the steps, and Correlation makes each new value lean toward the previous one for gentler movement.

Inputs and outputs

• Input 0: rate — control stream that scales the rate. Optional.
• Input 1: phase — external phase input. Optional.
• Input 2: trigger — draws a new value on a rising edge. Optional.
• Input 3: gate — gates the generator. Optional.
• Output 0: value — the random control signal.
• Output 1: phase — position within the current step.
• Output 2: cycle — running step count.
• Output 3: pulse — fires on each new value.
• Output 4: active — whether the generator is running.

Controls

• Rate — new values per second.
• Min and Max — output range.
• Slew — output smoothing time in seconds.
• Correlation — how strongly each value depends on the last, from independent to a slow drift.
• Mode — sample_hold, smooth, walk, logistic, or dice.
• Distribution — uniform, normal, triangular, or exponential.
• Overflow — what happens at the range edges: clamp, wrap, or reflect.
• Seed — repeatable sequence selection.

Notes

• The generator is deterministic: the same Seed and settings produce the same sequence run to run.
• walk with reflect overflow is the classic drunk walk that never leaves the range.
• Wire a trigger source into trigger to draw values on musical events instead of a fixed rate.

Ports

Inputs

• rate row
  control_f32_v1
• phase row
  control_f32_v1
• trigger row
  control_f32_v1
• gate row
  control_f32_v1

Outputs

• value row
  control_f32_v1
• phase row
  control_f32_v1
• cycle row
  control_f32_v1
• pulse row
  control_f32_v1
• active row
  control_f32_v1

Parameters

Rate (Rate) Float op('random').par.Rate

Default:

2

Range:

0 to 1000

Min (Min) Float op('random').par.Min

Default:

0

Range:

-100000 to 100000

Max (Max) Float op('random').par.Max

Default:

1

Range:

-100000 to 100000

Slew (Slew) Float op('random').par.Slew

Default:

0

Range:

0 to 60

Correlation (Correlation) Float op('random').par.Correlation

Default:

0

Range:

0 to 0.999

Mode (Mode) Menu op('random').par.Mode

Default:

0

Options:

sample_hold, smooth, walk, logistic, dice

Distribution (Distribution) Menu op('random').par.Distribution

Default:

0

Options:

uniform, normal, triangular, exponential

Overflow (Overflow) Menu op('random').par.Overflow

Default:

0

Options:

clamp, wrap, reflect

Seed (Seed) Int op('random').par.Seed

Default:

1

Range:

0 to 16777215