Random

Library: Memory

Introduced: 2.3.0

Appearance:

Behavior

This component iterates through a pseudorandom sequence of numbers, which steps forward to the following number in the sequence each time the clock is triggered while the component is enabled. Technically speaking, the algorithm used to compute the pseudorandom sequence is a linear congruential generator: Starting from a seed r₀, the following number r₁ is the number

r₁ = (25,214,903,917 r₀ + 11) mod 2⁴⁸

The next value r₂ is computed from r₁ using the same computation, and so forth. This sequence is of 48-bit numbers; the value seen from the component is the low-order bits as configured by its Data Bits attribute, after first throwing out the lower 12 bits of the current seed.

Besides the clock input, the component also includes an enable input, which leads the clock input to be ignored when enable is 0, and the reset input, which resets the component's value asynchronously to the initial seed r₀.

The initial seed is user-configurable. If it is configured at 0 (which is the default), then the seed is based on the current time; when instructed to reset through the reset input, the component computes a new seed based on the new current time.

Pins

East edge, labeled Q (output, bit width matches Data Bits attribute): Outputs the value currently stored by the component.
West edge, top pin, labeled with a triangle (input, bit width 1): Clock: At the instant that this is triggered as specified by the Trigger attribute, the component steps to the following number in its sequence.
West edge, bottom pin (input, bit width 1): Enable: The component is enabled when this input is disconnected or 1; but if it is 0, then the clock input is ignored.
South edge (input, bit width 1): Reset: When this is 1, the pseudorandom sequence asynchronously resets to the initial seed. (If seed is 0, this new seed should be different from the initial seed used previously.)

Attributes

When the component is selected or being added, Alt-0 through Alt-9 alter its Data Bits attribute.

Data Bits: The bit width of the value emitted by the component.
Seed: The starting value used for the pseudorandom sequence. If this is 0 (the default), then the starting value is based on the time that the random sequence began.
Trigger: Configures how the clock input is interpreted. The value rising edge indicates that the component should update its value at the instant when the clock rises from 0 to 1. The falling edge value indicates that it should update at the instant the clock falls from 1 to 0.
Label: The text within the label associated with the component.
Label Font: The font with which to render the label.

Poke Tool Behavior

None.

Text Tool Behavior

Allows the label associated with the component to be edited.

Back to Library Reference