Random

The Random operation generates pseudo-random values in either integer or floating-point mode with a configurable range. It includes a gate input for conditional execution.

Min equal to Max makes every draw that one value, and the Editor marks both fields with an info mark.

Inputs

Port	Type	Required	Description
> (Gate)	Any	No	When connected, a false or Nil value stops the path. See Gate Inputs.

Outputs

Port	Type	Default	Description
Out	Integer or Float	Nil	Generated random value. Type follows the Mode picker (Property-driven).

Properties

Name	Type	Default	Description
Mode	StackedDataSet	Integer	Selects the generation mode and range:
Integer			Uniform integer distribution over [Min, Max].
Min	Integer	0	Lower bound (inclusive).
Max	Integer	100	Upper bound (inclusive).
Float			Uniform real distribution over [Min, Max).
Min	Float	0.0	Lower bound (inclusive).
Max	Float	1.0	Upper bound (exclusive).
On Error	Combo	Stop this branch	Per-op On Error verb (Stop this branch / Continue with the last value / Continue with the fallback). See the Error Handling guide.

State on Reload

The last output is preserved across restarts. RNG state is not preserved; a new seed is applied on each start. Saved output is discarded if the configured mode (Integer or Float) changed.

---

How It Works

1. Gate check — If a Gate Input is connected, evaluate it. A false or Nil value stops the execution path; the output keeps its previous value.

2. Generate — Based on the selected mode:

   • Integer: Uniform integer distribution over [Min, Max]. Bounds are swapped if entered in reverse.
   • Float: Uniform real distribution over [Min, Max). When Min == Max, the exact value is returned.

3. Output — The generated value is emitted on Out.

---

Examples

Data format

All inputs and outputs use MessagePack internally. The examples below show values in JSON notation for readability.

Integer Mode

Mode: Integer   Min: 1   Max: 6

Out: a random integer in [1, 6], e.g. 4

Float Mode

Mode: Float   Min: 0.0   Max: 1.0

Out: a random double in [0.0, 1.0), e.g. 0.7312

Gate Blocked

Gate: false

Generation is skipped. Output retains its previous value.

---

Use Cases

• Simulating sensor data or random events during development.
• Generating random delays or jitter values.
• Producing test data for downstream operations.

---

Limitations

• RNG state is not preserved across restarts; sequences are not reproducible after a reload.
• Only uniform distributions are supported (integer or float).