# Set random seed generator to known seed

``

    use_random_seed  seed (number)

Resets the random number generator to the specified seed. All subsequently generated random numbers and randomisation functions such as `shuffle` and `choose` will use this new generator and the current generator is discarded. Use this to change the sequence of random numbers in your piece in a way that can be reproduced. Especially useful if combined with iteration. See examples.

Introduced in v2.0

## Examples

# Example 1
``
      use_random_seed 1
      puts rand
      use_random_seed 1
      puts rand
| ``
    # Basic usage

    # reset random seed to 1
    # => 0.417022004702574
    # reset random seed back to 1
    #=> 0.417022004702574
# Example 2
``
      notes = (scale :eb3, :minor_pentatonic)

      with_fx :reverb do
        live_loop :repeating_melody do

          use_random_seed 300

          8.times do

            play notes.choose, release: 0.1

            sleep 0.125
          end
        end
      end
| ``
    # Generating melodies
    # Create a set of notes to choose from.
    # Scales work well for this

    # Create a live loop

    # Set the random seed to a known value every
    # time around the loop. This seed is the key
    # to our melody. Try changing the number to
    # something else. Different numbers produce
    # different melodies

    # Now iterate a number of times. The size of
    # the iteration will be the length of the
    # repeating melody.

    # 'Randomly' choose a note from our ring of
    # notes. See how this isn't actually random
    # but uses a reproducible method! These notes
    # are therefore repeated over and over...