tur/structural

(seq [& patterns])

sequence patterns end to end, each getting equal time per cycle.

Pattern<T> cycling through patterns one beat at a time.

  ((seq pat-a pat-b pat-c) 1.5)  ; evaluates pat-b at sub-time 0.5

(seq-n [& pattern-lengths])

sequence patterns with custom durations per segment.

(stack [& patterns])

evaluate all patterns simultaneously and return their values as a vector.

Pattern<vec<T>> where each element is one pattern's value at the current time.

  ((stack kick-pat snare-pat hat-pat) 0.0)

(stack-with [f & patterns])

stack patterns and fold results with a combiner function.

(sum [& patterns])

pointwise sum of numeric patterns.

NumPattern returning the sum of all pattern values.

  ((sum bass-pat melody-pat) 0.5)

(multiply [& patterns])

pointwise product of numeric patterns.

(average [& patterns])

pointwise average of numeric patterns.

(when [cond p & [zero 0])

gate a pattern through a boolean condition.

Pattern<T>.

  (when (pattern/every-n 2) kick-pat 0)

(if-pat [cond then-p else-p])

select between two patterns based on a boolean pattern.

(every [n p & [zero 0])

trigger a pattern every n beats.

Pattern<T>.

  (every 4 fill-pat)

(nth [n p & [offset 0 zero 0])

trigger a pattern when beat number mod n equals offset.

(euclid [steps hits & [rotation 0])

Euclidean rhythm distributing hits as evenly as possible.

NumPattern returning 1 for hits and 0 for rests.

  ((euclid 8 5) 0.0)  ; classic 5-in-8 Euclidean rhythm

(euclid-vals [steps hits & [on-value 1 off-value 0 rotation 0])

Euclidean rhythm with custom on/off values.

(select [index & patterns])

choose among patterns using an index pattern.

Pattern<T> delegating to the selected sub-pattern.

  ((select (cycle 0 1 2) pat-a pat-b pat-c) 0.5)

(first-nonzero [& [zero 0 patterns])

return the first non-zero value from a set of patterns.

(index [& [cycle-length 1])

return the step index within a cycle.

(first-beat [& [cycle-length 1])

true on the first step of each cycle.

(last-beat [& [cycle-length 1])

true on the last step of each cycle.

(chain [& [sentinel nil patterns])

concatenate patterns, advancing when a sentinel value is returned.

(interleave [& patterns])

alternate between patterns each beat.

Pattern<T> cycling through patterns one per beat, with each sub-pattern
  receiving compressed time equal to the number of patterns.

  ((interleave pat-a pat-b) 0.5)  ; reads pat-a at time 1.0

(interleave-n [& pattern-lengths])

interleave patterns with custom durations (alias for seq-n).

(mask [source mask & [zero 0])

let signal pass only where a boolean mask is true.

Pattern<T>.

  (mask melody-pat (euclid 8 5))

(invert [p])

invert a boolean pattern.

(and-pat [a b])

logical AND of two boolean patterns.

(or-pat [a b])

logical OR of two boolean patterns.

(xor-pat [a b])

logical XOR of two boolean patterns.

(group [group-size group-pattern & patterns])

partition patterns into groups and apply a group combiner.