Random Durations and Rests
==========================

*Example script* (scamp): `examples/Tutorial/05_random_durations_and_rests.py <https://github.com/MarcTheSpark/scamp/blob/main/examples/Tutorial/05_random_durations_and_rests.py>`__

*Download:* :download:`05_random_durations_and_rests.py <downloads/tutorial_05_random_durations_and_rests/05_random_durations_and_rests.py>`

Loops a C major arpeggio twice, but with random, floating-point durations. Also sometimes adds a rest of up to a second between notes.

.. raw:: html

   <div style="margin:0.6em 0"><audio controls preload="none" src="../_static/media/Tutorial/05_random_durations_and_rests.mp3" style="width:100%;max-width:520px"></audio></div>

.. code-block:: python

   # import the scamp namespace
   from scamp import *
   # import the random module from
   # the python standard library
   import random

   # construct a session object
   s = Session()
   # add a new violin part to the session
   violin = s.new_part("Violin")

   for _ in range(2):  # loop twice
       for pitch in [60, 64, 67, 72]:
           # pick a duration between 0.5 to 1.5
           dur = random.uniform(0.5, 1.5)
           # play a note of that duration
           violin.play_note(pitch, 1, dur)
           # with probability of one half, wait for between 0 and 1 seconds
           if random.random() < 0.5:
               # note that "wait" is the same here as "s.wait". What "wait" does it find the
               # clock operating on the given thread and call wait on that. In this case, that
               # clock is the Session as a whole.
               wait(random.random())