urn
Generate random numbers without duplicates
Description
Outputs random numbers and keeps track of each number that has been generated. When all numbers up to the maximum (set via an argument or the right inlet) have been output, a bang is send out the right outlet.
Arguments
size [number]
Sets the range of possible output values. Output values are 0 indexed. Changing this value will clear the internal array of used numbers.
seed [number]
Sets a seed state for the random values, so that randomized results will be predictable each time the code is run.
Inlets
trigger [bang]
A bang or number in the left inlet causes urn to output a number between 0 and one less than the value of the size attribute. Each number in the range can only be output once until the object is cleared.
size [number]
Sets the range of possible output values. Output values are 0 indexed. Changing this value will clear the internal array of used numbers.
Outlets
out [number]
The number chosen. This value will be between 0 and one less than the maximum value as determined by the size attribute.
bangout [bang]
Send a bang when every number in the range has been chosen.
Dynamic Attributes
These attributes can be modified in the code during execution using the set object
autoclear [bool] (default: false)
When enabled the urn object will automatically clear itself once all numbers in the range have been used.
clear [bang]
Clear the list of already chosen numbers. Note that this does not reset the object to the original seed state.
norepeat [bool] (default: false)
When enabled, the first number generated at the start of a new series (after the clear message) will never match the final number of the previous series.
seed [number]
Sets a seed state for the random values, so that randomized results will be predictable each time the code is run.
size [number]
Sets the range of possible output values. Output values are 0 indexed. Changing this value will clear the internal array of used numbers.
trigger [bang]
A bang or number in the left inlet causes urn to output a number between 0 and one less than the value of the size attribute. Each number in the range can only be output once until the object is cleared.
See Also
| Name | Description |
|---|---|
| drunk | Output random numbers within a step range. |
| noise | White noise generator |
| random | Generate random numbers |
| urn |