index :: random

random.atom

aliases: [random.a]

weighted atom generation from specified list

available since version: 0.9.1

---

information

Choose random atom from specified list (with weights) and output it. If no weights specified, choose elements with random uniform distribution. Use @seed property to get reproducible sequences. If @seed property was not explicitly set or specified, uses generator initialized with current time. Note: when @nonrep property is set, distribution is not uniform or weighted.

arguments:

• VALUE list of atoms
  type: list
  

properties:

• @value Get/set list of atoms
  type: list
  

• @w Get/set list of atom weights
  type: list
  

• @seed Get/set generator seed
  type: int
  min value: 0
  default: 0
  

• @nonrep Get/set generate non-repeated adjacent values (note: distribution will changed!)
  type: bool
  default: 0
  

inlets:

• output random atom
  type: control
• set list of elements to choose from. Note: clear all weights.
  type: control

outlets:

• random atom value
  type: control

keywords:

random atom

See also: [random.float] [random.gauss]

Authors: Serge Poltavsky

License: GPL3 or later