Conditional Modifiers

lastOf

Applies the given function every n cycles, starting from the last cycle.

  • n (number): how many cycles
  • func (function): function to apply
note("c3 d3 e3 g3").lastOf(4, x=>x.rev())

firstOf

Applies the given function every n cycles, starting from the first cycle.

  • n (number): how many cycles
  • func (function): function to apply
note("c3 d3 e3 g3").firstOf(4, x=>x.rev())

when

Applies the given function whenever the given pattern is in a true state.

  • binary_pat (Pattern):
  • func (function):
"c3 eb3 g3".when("<0 1>/2", x=>x.sub("5")).note()

chunk

Synonyms: slowChunk, slowchunk

Divides a pattern into a given number of parts, then cycles through those parts in turn, applying the given function to each part in turn (one part per cycle).

    "0 1 2 3".chunk(4, x=>x.add(7))
    .scale("A:minor").note()

    chunkBack

    Synonyms: chunkback

    Like chunk, but cycles through the parts in reverse order. Known as chunk' in tidalcycles

      "0 1 2 3".chunkBack(4, x=>x.add(7))
      .scale("A:minor").note()

      fastChunk

      Synonyms: fastchunk

      Like chunk, but the cycles of the source pattern aren't repeated for each set of chunks.

        "<0 8> 1 2 3 4 5 6 7"
        .fastChunk(4, x => x.color('red')).slow(2)
        .scale("C2:major").note()

        arp

        arpWith πŸ§ͺ

        struct

        Applies the given structure to the pattern:

          note("c,eb,g")
            .struct("x ~ x ~ ~ x ~ x ~ ~ ~ x ~ x ~ ~")
            .slow(2)

          mask

          Returns silence when mask is 0 or "~"

            note("c [eb,g] d [eb,g]").mask("<1 [0 1]>")

            reset

            Resets the pattern to the start of the cycle for each onset of the reset pattern.

              s("[<bd lt> sd]*2, hh*8").reset("<x@3 x(5,8)>")

              restart

              Restarts the pattern for each onset of the restart pattern. While reset will only reset the current cycle, restart will start from cycle 0.

                s("[<bd lt> sd]*2, hh*8").restart("<x@3 x(5,8)>")

                hush

                invert

                Synonyms: inv

                Swaps 1s and 0s in a binary pattern.

                  s("bd").struct("1 0 0 1 0 0 1 0".lastOf(4, invert))

                  pick

                  Picks patterns (or plain values) either from a list (by index) or a lookup table (by name). Similar to inhabit, but maintains the structure of the original patterns.

                  • pat (Pattern):
                  • xs (*):
                  note("<0 1 2!2 3>".pick(["g a", "e f", "f g f g" , "g c d"]))
                  sound("<0 1 [2,0]>".pick(["bd sd", "cp cp", "hh hh"]))
                  sound("<0!2 [0,1] 1>".pick(["bd(3,8)", "sd sd"]))
                  s("<a!2 [a,b] b>".pick({a: "bd(3,8)", b: "sd sd"}))

                  pickmod

                  The same as pick, but if you pick a number greater than the size of the list, it wraps around, rather than sticking at the maximum value. For example, if you pick the fifth pattern of a list of three, you'll get the second one.

                  • pat (Pattern):
                  • xs (*):

                  pickF

                  pickF lets you use a pattern of numbers to pick which function to apply to another pattern.

                  • pat (Pattern):
                  • lookup (Pattern): a pattern of indices
                  • funcs (Array.<function()>): the array of functions from which to pull
                  s("bd [rim hh]").pickF("<0 1 2>", [rev,jux(rev),fast(2)])
                  note("<c2 d2>(3,8)").s("square")
                      .pickF("<0 2> 1", [jux(rev),fast(2),x=>x.lpf(800)])

                  pickmodF

                  The same as pickF, but if you pick a number greater than the size of the functions list, it wraps around, rather than sticking at the maximum value.

                  • pat (Pattern):
                  • lookup (Pattern): a pattern of indices
                  • funcs (Array.<function()>): the array of functions from which to pull

                  pickRestart

                  Similar to pick, but the choosen pattern is restarted when its index is triggered.

                  • pat (Pattern):
                  • xs (*):

                  pickmodRestart

                  The same as pickRestart, but if you pick a number greater than the size of the list, it wraps around, rather than sticking at the maximum value.

                  • pat (Pattern):
                  • xs (*):
                  "<a@2 b@2 c@2 d@2>".pickRestart({
                          a: n("0 1 2 0"),
                          b: n("2 3 4 ~"),
                          c: n("[4 5] [4 3] 2 0"),
                          d: n("0 -3 0 ~")
                        }).scale("C:major").s("piano")

                  pickReset

                  Similar to pick, but the choosen pattern is reset when its index is triggered.

                  • pat (Pattern):
                  • xs (*):

                  pickmodReset

                  The same as pickReset, but if you pick a number greater than the size of the list, it wraps around, rather than sticking at the maximum value.

                  • pat (Pattern):
                  • xs (*):

                  inhabit

                  Synonyms: pickSqueeze

                  Picks patterns (or plain values) either from a list (by index) or a lookup table (by name). Similar to pick, but cycles are squeezed into the target ('inhabited') pattern.

                  • pat (Pattern):
                  • xs (*):
                  "<a b [a,b]>".inhabit({a: s("bd(3,8)"),
                                              b: s("cp sd")
                                             })
                  s("a@2 [a b] a".inhabit({a: "bd(3,8)", b: "sd sd"})).slow(4)

                  inhabitmod

                  Synonyms: pickmodSqueeze

                  The same as inhabit, but if you pick a number greater than the size of the list, it wraps around, rather than sticking at the maximum value. For example, if you pick the fifth pattern of a list of three, you'll get the second one.

                  • pat (Pattern):
                  • xs (*):

                  squeeze

                  Pick from the list of values (or patterns of values) via the index using the given pattern of integers. The selected pattern will be compressed to fit the duration of the selecting event

                  • pat (Pattern):
                  • xs (*):
                  note(squeeze("<0@2 [1!2] 2>", ["g a", "f g f g" , "g a c d"]))

                  After Conditional Modifiers, let’s see what Accumulation Modifiers have to offer.