Pattern Cheat Sheet¶

Quick reference for krach pattern API. See Patterns for full documentation.

Atoms¶

kr.note("C4")                   # melodic trigger (sets freq + gate)
kr.note("C4", "E4", "G4")      # chord
kr.hit()                        # gate trigger (drums)
kr.rest()                       # silence
kr.seq("A2", "D3", None, "E2") # sequence (None = rest)
kr.p("x . x . x . . x")       # mini-notation

Operators¶

a + b             # sequence: play a then b
a | b             # stack: play simultaneously
p * 4             # repeat 4 times

Time¶

p.over(2)         # stretch to 2 cycles
p.fast(2)         # double speed
p.shift(0.5)      # offset by half cycle

Transforms¶

p.reverse()                     # reverse order
p.swing(0.67)                   # swing feel
p.spread(3, 8)                  # euclidean rhythm (3 hits in 8 slots)
p.thin(0.3)                     # drop 30% of events
p.mask("1 1 0 1")              # suppress by mask
p.every(4, lambda p: p.reverse())  # transform every 4th cycle
p.sometimes(0.3, lambda p: p.reverse())  # 30% chance per cycle

Continuous (for control modulation)¶

kr.sine(200, 2000)              # sine sweep lo..hi
kr.saw(0, 1)                    # sawtooth ramp
kr.rand(0, 1)                   # random values
kr.ramp(0, 1)                   # linear ramp
kr.mod_sine(200, 2000)          # sine modulation
kr.mod_tri(200, 2000)           # triangle
kr.mod_ramp(0, 1)               # ramp up
kr.mod_ramp_down(1, 0)          # ramp down
kr.mod_square(0, 1)             # square wave
kr.mod_exp(0, 1)                # exponential

Combinators¶

kr.cat(a, b, c)                 # play each for 1 cycle, loop
kr.stack(a, b)                  # layer simultaneously
kr.struct(rhythm, melody)       # impose rhythm onto melody

Playing patterns¶

# On kr
kr.play("bass", pattern)
kr.play("bass/cutoff", kr.sine(200, 2000).over(4))

# On NodeHandle
bass @ pattern                  # play note pattern
bass @ ("cutoff", pattern)      # modulate control
bass @ None                     # hush
bass @ "A2 D3 ~ E2"            # mini-notation string

Common recipes¶

# Four on the floor
kr.hit() * 4

# Offbeat hats
(kr.rest() + kr.hit()) * 4

# Swung hats
((kr.rest() + kr.hit()) * 4).swing(0.67)

# Bass line with rests
kr.seq("A2", "D3", None, "E2").over(2)

# Euclidean kick (5 hits in 8)
(kr.hit() * 8).spread(5, 8)

# Filter sweep
bass @ ("cutoff", kr.sine(200, 2000).over(4))

# Probabilistic variation
melody.sometimes(0.2, lambda p: p.reverse())

Mini-notation¶

x         hit
.         rest
~         tie / hold
C4 E4 G4  note sequence
[C4 E4]   chord (simultaneous)