tur/polyrhythm

(polymeter [ratio p])

play a pattern with a different effective meter.

Pattern<T> evaluated with time * ratio.

  ((polymeter 1.5 my-pat) 1.0)  ; reads my-pat at time 1.5

(polyrhythm [p1 len1 p2 len2])

play two patterns with independent cycle lengths.

Pattern<Tuple T1 T2> combining both patterns at their own tempos.

  ((polyrhythm kick-pat 3 snare-pat 2) 0.0)

(polyrhythm-n [& pattern-lengths])

play any number of patterns with independent cycle lengths.

(nest [outer & [inner-time-scale 1.0])

evaluate a pattern of patterns: outer selects the inner, inner is evaluated.

(nest2 [outer outer-time-scale inner-time-scale])

nested pattern with independent time scales for outer and inner.

(canon [p copies delay])

play delayed copies of a pattern stacked together.

Pattern<vec<T>> with copies offset by delay * i for i in [0, copies).

  ((canon my-pat 3 0.25) 0.0)

(canon-n [p & delays])

play copies of a pattern with individually specified delays.

(spread [p copies spread-amount])

phase-spread copies of a pattern across a time window.

Pattern<vec<T>> with copies evenly spaced in [0, spread-amount).

  ((spread my-pat 4 1.0) 0.0)

(spread-n [p & spreads])

phase-spread copies with individually specified offsets.

(stack-polymeter [& pattern-meters])

stack patterns each running at their own meter.

(stack-polyrhythm [& pattern-lengths])

stack patterns each with their own cycle lengths.

(timesig [p & sigs])

apply a sequence of time signatures to a pattern.

(make-timesig [beats-per-bar sub-beats-per-bar])

construct a time signature specification.

(three-against-two [p1 p2])

classic 3:2 polyrhythm.

(four-against-three [p1 p2])

4:3 polyrhythm.

(five-against-four [p1 p2])

5:4 polyrhythm.

(five-against-three [p1 p2])

5:3 polyrhythm.

(seven-against-four [p1 p2])

7:4 polyrhythm.

(polyrhythm-offset [p1 len1 offset1 p2 len2 offset2])

polyrhythm with independent phase offsets per pattern.

(polyrhythm-phased [& patterns-and-phases])

polyrhythm with per-pattern length and phase.

(metric-mod [p modulation-fn])

apply an arbitrary time mapping to a pattern.

(metric-mod-linear [p & breakpoints])

apply a piecewise linear time mapping.

(lcm [a b])

least common multiple of two integers.

(gcd [a b])

greatest common divisor using the Euclidean algorithm.

(polyrhythm-alignment [& lengths])

find the beat at which all polyrhythm patterns realign.

The LCM of all lengths (time at which all patterns complete together).

  (polyrhythm-alignment 3 4)  ; => 12

(cross-rhythm [p1 len1 p2 len2 & [phase1 0 phase2 0])

polyrhythm with per-pattern phase offsets.

(hocket [p voices & [selector (cycle (range 0 voices))])

distribute a pattern's output across multiple voices.

Pattern<vec<T>> where only the selected voice receives the pattern value.

  ((hocket my-pat 3) 0.0)