@kairotic/rhythm 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,58 @@
1
- # Temporary Holding Version
1
+ # @kairotic/rhythm
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ *Official package of [Kairotic](https://github.com/bonuoq/kairotic) · [all packages](../README.md)*
4
+
5
+ Rhythm as geometry, after Godfried Toussaint (*The Geometry of Musical Rhythm*; discussion
6
+ [#252](https://github.com/bonuoq/kairotic/discussions/252)). A rhythm that repeats is a **necklace**: k onsets among n
7
+ pulses around a circle — the same object as a pitch-class set on `pcclock` (in `@kairotic/theory`), measured with the
8
+ same geometry. Each class draws itself in the patch, and its pulses can be pressed.
9
+
10
+ | Class | What it shows and sends |
11
+ |---|---|
12
+ | `euclid [k 3] [n 8] [rotation 0] [bars 1] [midi]` | **a Euclidean rhythm** (Bjorklund's algorithm, after Toussaint): k onsets as evenly as they can be over n pulses — `euclid 3 8` the tresillo, `5 8` the cinquillo, `5 16` a rotation of the bossa nova, `7 12` the bembé —, drawn as a **necklace** (the pulses around a circle, the onsets a polygon; pressing a pulse makes the rhythm start there). Out: a **musical tree** for a `tree` box (left), the **`:rtm` map** alone (middle) and the **pulses** as ones and zeros (right) |
13
+ | `necklace [n 16] [bars 1] [midi]` | **a cyclic rhythm on the circle and its geometry** (Toussaint): the same object as a pitch-class set on `pcclock`, k onsets among n pulses. It takes pulses (`euclid`'s right outlet), intervals (`[3 3 2]`), box notation (`"x..x..x."`), an `:rtm` map or a tree; pressing a pulse adds or takes away an onset. Its **axes of mirror symmetry** are drawn. Out as `euclid` (tree, `:rtm` map, pulses), and its **measures** (right): interval vector, evenness, deep, flat, axes, longest gap, rhythmic oddity, the rotation of E(k,n) it is |
14
+
15
+ Both send rhythm **apart from pitch**, the same way: a musical tree for a `tree` box (outlet 0), its `:rtm` map
16
+ alone (outlet 1) and its pulses as ones and zeros (outlet 2); their right inlet gives the notes their pitches.
17
+
18
+ `euclid` keeps **rhythm apart from pitch**, as the `:rtm` of a musical tree does (see *Musical trees*,
19
+ `docs/mt.md`): the rhythm goes out as `[:rtm {:shares [3 3 2]}]`, the intervals between onsets as shares (a
20
+ negative share is a silence, as when a rotation leaves the first pulses empty), in a bar of n pulses (4/4 for
21
+ 8 or 16, 12/8 for 12, n/8 up to 12, else n/16; `[:meter "3/4"]` for another). Its **right inlet** (cold) takes the
22
+ pitches its notes take in turn, starting again when they run out — *talea* and *color*: a map with `:pitches`
23
+ or `:pitch` (kept as it is), a pattern (`{:note [...]}`), a melody string, a list of Hz
24
+ (the keys held on a keyboard; MIDI with `midi`), notes or chords of a tree; `:clear` forgets them. With `bars`
25
+ the color goes on from bar to bar. Its middle outlet is the `:rtm` map alone, so any map of pitches can be
26
+ merged with it elsewhere (`merge`, then `vector :rtm %`). A bang sends it; `[:k 5]`, `[:n 16]`, `[:rotation 2]`,
27
+ `[:bars 4]`, `[:meter "3/4"]` (or one map of them) change it and send it when it is new; a number is k.
28
+
29
+ ```clojure
30
+ (box :b1 "msg :bang" 40 20)
31
+ (box :b2 "keyboard 60 24" 160 20)
32
+ (box :b3 "euclid 5 8" 40 120)
33
+ (box :b4 "tree" 40 340)
34
+ (connect :b2 0 :b3 1) (connect :b1 0 :b3 0) (connect :b3 0 :b4 0)
35
+ ```
36
+
37
+ Hold a chord on the keyboard and click bang: the cinquillo, its notes taking the chord's pitches in turn.
38
+
39
+ `necklace` measures what Toussaint measures. The **interval vector** (`:ivec`) counts how often each distance
40
+ between onsets occurs (the son clave: `[0 1 2 2 0 3 2 0]`). **Evenness** (`:evenness`) is the sum of the chords
41
+ between all pairs of onsets (Block and Douthett) — arcs would give the six 4/4 claves the same value; chords
42
+ tell the rumba from the bossa nova —, and `:even` is that sum against the Euclidean rhythm's, 1 when it is as
43
+ even. A rhythm is **deep** when each distance occurs a different number of times (the bembé, as the diatonic
44
+ scale), **flat** when each occurs once. `:axes` are its axes of mirror symmetry (in pulses), `:gap` its longest
45
+ interval, `:oddity` true when no two onsets halve the cycle, and `:euclid` the rotation of E(k,n) it is (or nil).
46
+ It is an editor too: pressing a pulse (or a number, its index), `:complement`, `[:rotate 1]`, `[:n 12]`, `:clear`.
47
+ Its outlets are `euclid`'s, so either can feed the same trees and pitches; a necklace after a `euclid` names what
48
+ the euclid made:
49
+
50
+ ```clojure
51
+ (box :b1 "msg [:rotation 6]" 40 20)
52
+ (box :b2 "euclid 5 16" 40 60)
53
+ (box :b3 "necklace" 260 60)
54
+ (box :b4 "print" 260 320)
55
+ (connect :b1 0 :b2 0) (connect :b2 2 :b3 0) (connect :b3 3 :b4 0)
56
+ ```
57
+
58
+ Writing one of its classes in a work brings the package into it. Licence: [MPL-2.0](../../LICENSE).
@@ -0,0 +1,9 @@
1
+ // Generated by packages/build.mjs from src/euclid.cljs
2
+ export default {
3
+ "class": "euclid",
4
+ "version": "0.1.1",
5
+ "author": "bonuoq",
6
+ "license": "MPL-2.0",
7
+ "doc": "A Euclidean rhythm (Bjorklund's algorithm, after Toussaint): k onsets spread as evenly as they can be over n pulses — euclid 3 8 is the tresillo (3-3-2), euclid 5 8 the cinquillo, euclid 5 16 a rotation of the bossa nova, euclid 7 12 the bembé. Drawn as a necklace: the pulses around a circle, time clockwise from the top, the onsets joined into a polygon; pressing a pulse makes the rhythm start there (a rotation). A bang sends it; [:k 5], [:n 16], [:rotation 2], [:bars 4], [:meter \"3/4\"] (or a map of them) change it and send it when it is new, a number is k. Rhythm apart from pitch: out of the left outlet a musical tree, a bar of n pulses (4/4 for 8 or 16, 12/8 for 12, n/8 up to 12, else n/16; [:meter …] for another) with an :rtm whose shares are the intervals between onsets (a negative share a silence); bars repeat it, the pitches going on. Its right inlet (cold) takes the pitches the notes take in turn, starting again when they run out (talea and color): a map with :pitches or :pitch (kept as it is), a pattern ({:note [...]}), a melody string (\"c4 e4 g4\"), a list of Hz (the keys held on a keyboard; MIDI with midi), notes or chords of a tree; :clear forgets them (every note c4). Outlet 1 is the :rtm map alone ({:shares [3 3 2] :pitches …}), to merge with other pitches (merge) and write as a node (vector :rtm %); outlet 2 the pulses, ones and zeros ([1 0 0 1 0 0 1 0]).",
8
+ "source": ";; euclid · a Euclidean rhythm: k onsets spread as evenly as they can be over n pulses\n;; Part of @kairotic/rhythm. Written against the Kairotic API (api/…).\n;; Bjorklund's algorithm (Toussaint, \"The Euclidean algorithm generates traditional musical rhythms\", 2005):\n;; E(3,8) is the tresillo, E(5,8) the cinquillo, E(5,16) a rotation of the bossa nova, E(7,12) the bembé.\n;; The rhythm is drawn as a necklace — the n pulses around a circle, time running clockwise from the top,\n;; the onsets joined into a polygon — and pressing a pulse makes the rhythm start there (a rotation).\n;; What it sends is rhythm apart from pitch, as an :rtm of kairotic.mt (shares: the intervals between\n;; onsets, a negative share a silence), so that it can be merged with a map of pitches ({:pitches …}, the\n;; talea and color of an isorhythm) into a musical tree: the box does it with what reaches its right inlet,\n;; and its outlet 1 gives the bare :rtm map to merge elsewhere (merge, then vector :rtm %).\n(let [;; Bjorklund: k ones and n − k zeros, the remainder paired again and again (Euclid's algorithm)\n bjorklund (fn [k n]\n (cond (<= n 0) []\n (<= k 0) (vec (repeat n 0))\n (>= k n) (vec (repeat n 1))\n :else (loop [a (vec (repeat k [1])) b (vec (repeat (- n k) [0]))]\n (if (<= (count b) 1)\n (vec (apply concat (concat a b)))\n (let [m (min (count a) (count b))]\n (recur (mapv into (subvec a 0 m) (subvec b 0 m))\n (if (> (count a) m) (subvec a m) (subvec b m))))))))\n ;; a necklace read from pulse r on: the rhythm in a fixed position against the beat\n rotate (fn [xs r] (let [n (count xs)] (if (zero? n) xs (let [r (mod r n)] (vec (concat (subvec xs r) (subvec xs 0 r)))))))\n onsets-of (fn [ps] (vec (keep-indexed (fn [i x] (when (= 1 x) i)) ps)))\n ;; the intervals between onsets, around the circle (3 3 2): the rhythm as a necklace\n intervals-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (if (empty? os) [] (mapv (fn [a b] (- b a)) os (conj (subvec os 1) (+ n (first os)))))))\n ;; the shares of an :rtm: from each onset to the next one (or the end of the bar); the pulses before the\n ;; first onset a silence (a negative share): 01001001 → [-1 3 3 1]\n shares-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (cond (zero? n) []\n (empty? os) [(- n)]\n :else (vec (concat (when (pos? (first os)) [(- (first os))])\n (map (fn [a b] (- b a)) os (conj (subvec os 1) n)))))))\n ;; the meter of a bar of n pulses, when none is asked: the pulse a written value\n pow2? (fn [x] (and (pos? x) (== x (js/Math.pow 2 (js/Math.round (js/Math.log2 x))))))\n meter-of (fn [n] (cond (and (>= n 4) (pow2? n)) [4 4]\n (and (>= n 12) (zero? (mod n 3)) (pow2? (/ n 3))) [12 8]\n (< n 4) [n 4]\n (<= n 12) [n 8]\n :else [n 16]))\n ;; a meter asked for: [3 4], \"3/4\", \"7/8[2+2+3]\", or nil (as the pulses say)\n meter-arg (fn [v] (cond (and (sequential? v) (= 2 (count v)) (every? number? v)) (vec v)\n (string? v) v\n (keyword? v) (name v)\n :else nil))\n ;; pitches, as theory boxes take them: Hz by default, MIDI with midi; the MIDI notes kept to 3 decimals\n hz->m (fn [x] (when (and (number? x) (pos? x)) (/ (js/Math.round (* 1000 (+ 69 (* 12 (js/Math.log2 (/ x 440)))))) 1000)))\n ;; what reaches the right inlet, as the pitches of the :rtm (or nil, to forget them): a map of pitches\n ;; ({:pitches …} or {:pitch …}, kept as they are), a pattern ({:note [...]}, MIDI;\n ;; nil a rest), a melody string (\"c4 e4 g4\"), a list of pitches (Hz, as a keyboard sends the keys held;\n ;; MIDI with midi), a list of notes or chords of a tree, or one pitch\n pitches-of (fn [midi? v]\n (let [p (fn [x] (if midi? x (hz->m x)))]\n (cond (#{:clear} v) nil\n (map? v) (cond (or (contains? v :pitches) (contains? v :pitch)) (select-keys v [:pitches :pitch])\n (sequential? (:note v)) {:pitches (mapv (fn [x] (if (number? x) x \"r\")) (:note v))}\n :else :ignore)\n (string? v) {:pitches v}\n (number? v) (if-let [m (p v)] {:pitch m} :ignore)\n (and (sequential? v) (keyword? (first v))) {:pitches [v]}\n (and (sequential? v) (seq v) (every? number? v)) (let [ms (vec (keep p v))] (if (seq ms) {:pitches ms} :ignore))\n (and (sequential? v) (seq v)) {:pitches (vec v)}\n :else :ignore)))\n ;; the color goes on over the bars: bar i begins where the notes of the bar before left it\n tokens (fn [ps] (cond (string? ps) (vec (remove #{\"\"} (.split (.trim ps) (js/RegExp. \"\\\\s+\"))))\n (sequential? ps) (vec ps)\n :else nil))\n color-at (fn [pm skip]\n (let [ts (tokens (:pitches pm))]\n (if (or (empty? ts) (zero? (mod skip (count ts))))\n pm\n (let [r (mod skip (count ts)) ts2 (vec (concat (subvec ts r) (subvec ts 0 r)))]\n (assoc pm :pitches (if (string? (:pitches pm)) (apply str (interpose \" \" ts2)) ts2))))))\n ;; everything the box knows: its words, changed by messages\n params (fn [args st]\n (let [o (merge args (:over st))\n n (max 1 (js/Math.round (or (:n o) 8)))]\n {:n n :k (api/clamp (js/Math.round (or (:k o) 3)) 0 n) :rotation (mod (js/Math.round (or (:rotation o) 0)) n)\n :bars (api/clamp (js/Math.round (or (:bars o) 1)) 1 64) :meter (or (:meter o) (meter-of n))}))\n ;; the rhythm as data: the pulses, its necklace, and the :rtm with the pitches merged\n rhythm (fn [{:keys [k n rotation bars meter]} pm]\n (let [ps (rotate (bjorklund k n) rotation)\n rtm (merge {:shares (shares-of ps)} (or pm {}))\n bar (fn [i] (let [a (color-at rtm (* i k))]\n (if (zero? i) [:measure {:meter meter} [:rtm a]] [:measure [:rtm a]])))]\n {:pulses ps :onsets (onsets-of ps) :intervals (intervals-of ps) :rtm rtm\n :tree (into [:voice] (map bar (range bars)))}))\n shown-of (fn [p r] (merge (select-keys p [:k :n :rotation :bars]) (select-keys r [:pulses :onsets :intervals])))\n ;; what goes out: the tree (0), the :rtm map (1), the pulses (2), the last first (as Max does)\n outs (fn [r] [[2 (:pulses r)] [1 (:rtm r)] [0 (:tree r)]])\n ;; a change: sent when what it makes is new (the same again changes nothing); a bang sends it anyway\n changed (fn [args st over always?]\n (let [st2 (assoc st :over over) p (params args st2) r (rhythm p (:pm st2))]\n (if (and (not always?) (= (:tree r) (:sent st)))\n {:state st2 :show (shown-of p r)}\n {:state (assoc st2 :sent (:tree r)) :show (shown-of p r) :out (outs r)})))\n polar (fn [cx cy R i n] (let [a (* 2 js/Math.PI (/ i n))] [(+ cx (* R (js/Math.sin a))) (- cy (* R (js/Math.cos a)))]))]\n {;; ── about ──\n :class \"euclid\"\n :license \"MPL-2.0\"\n :doc \"A Euclidean rhythm (Bjorklund's algorithm, after Toussaint): k onsets spread as evenly as they can be over n pulses — euclid 3 8 is the tresillo (3-3-2), euclid 5 8 the cinquillo, euclid 5 16 a rotation of the bossa nova, euclid 7 12 the bembé. Drawn as a necklace: the pulses around a circle, time clockwise from the top, the onsets joined into a polygon; pressing a pulse makes the rhythm start there (a rotation). A bang sends it; [:k 5], [:n 16], [:rotation 2], [:bars 4], [:meter \\\"3/4\\\"] (or a map of them) change it and send it when it is new, a number is k. Rhythm apart from pitch: out of the left outlet a musical tree, a bar of n pulses (4/4 for 8 or 16, 12/8 for 12, n/8 up to 12, else n/16; [:meter …] for another) with an :rtm whose shares are the intervals between onsets (a negative share a silence); bars repeat it, the pitches going on. Its right inlet (cold) takes the pitches the notes take in turn, starting again when they run out (talea and color): a map with :pitches or :pitch (kept as it is), a pattern ({:note [...]}), a melody string (\\\"c4 e4 g4\\\"), a list of Hz (the keys held on a keyboard; MIDI with midi), notes or chords of a tree; :clear forgets them (every note c4). Outlet 1 is the :rtm map alone ({:shares [3 3 2] :pitches …}), to merge with other pitches (merge) and write as a node (vector :rtm %); outlet 2 the pulses, ones and zeros ([1 0 0 1 0 0 1 0]).\"\n :usage \"euclid [k 3] [n 8] [rotation 0] [bars 1] [midi]\"\n :io [2 3]\n :size [180 200]\n\n ;; ── arguments ──\n :args [[:k 3] [:n 8] [:rotation 0] [:bars 1] [:midi false]]\n\n ;; ── logic ──\n :receive (fn [{:keys [inlet value state args]}]\n (let [st (or state {:over {} :pm nil})\n over (:over st)\n set-over (fn [m] (changed args st (merge over m) false))]\n (if (= inlet 1)\n (let [pm (pitches-of (:midi args) value)]\n (if (= pm :ignore) {} {:state (assoc st :pm pm)}))\n (cond\n (#{:bang} value) (changed args st over true)\n (number? value) (set-over {:k value})\n (and (vector? value) (= :pressed (first value)) (number? (second value)))\n (let [p (params args st)] (set-over {:rotation (+ (:rotation p) (second value))}))\n (and (vector? value) (= 2 (count value)) (#{:k :n :rotation :bars} (first value)) (number? (second value)))\n (set-over {(first value) (second value)})\n (and (vector? value) (= :meter (first value))) (set-over {:meter (meter-arg (second value))})\n (map? value) (set-over (cond-> (select-keys value [:k :n :rotation :bars])\n (contains? value :meter) (assoc :meter (meter-arg (:meter value)))))\n :else {}))))\n ;; pressing a pulse: the rhythm starts there (sent once, on release)\n :gesture (fn [{:keys [up hit]}] (when (and up (number? hit)) [:pressed hit]))\n\n ;; ── view ──\n :draw (fn [{:keys [shown w h args]}]\n (let [p (or shown (let [n (max 1 (js/Math.round (or (:n args) 8)))\n k (api/clamp (js/Math.round (or (:k args) 3)) 0 n)\n ps (rotate (bjorklund k n) (or (:rotation args) 0))]\n {:k k :n n :pulses ps :onsets (onsets-of ps) :intervals (intervals-of ps)}))\n n (:n p) ps (:pulses p) os (:onsets p)\n cx (/ w 2) cy (/ (- h 30) 2) R (- (min cx cy) 16)\n r (cond (> n 32) 2.2 (> n 16) 3 :else 4.5)]\n (concat\n [[:circle {:cx cx :cy cy :r R :stroke :grid}]]\n ;; the start of the bar, at the top\n (let [[x1 y1] (polar cx cy (- R 9) 0 n) [x2 y2] (polar cx cy (+ R 9) 0 n)]\n [[:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1.5 :opacity 0.8}]])\n (when (> (count os) 1) [[:path {:points (mapv (fn [i] (polar cx cy R i n)) os) :closed true :stroke :accent :weight 2}]])\n (for [i (range n)]\n (let [[x y] (polar cx cy R i n) on (= 1 (nth ps i 0))]\n [:group {:hit i}\n [[:circle {:cx x :cy y :r (if on (+ r 1.5) r) :fill (if on :accent :bg) :stroke (if on :accent :soft)}]]]))\n [[:text {:x cx :y (- h 15) :anchor :middle :size 10 :fill :ink}\n (str \"E(\" (:k p) \",\" n \")\" (when (pos? (or (:rotation p) 0)) (str \" ↻\" (:rotation p))))]\n [:text {:x cx :y (- h 3) :anchor :middle :size 9 :fill :soft}\n (if (seq (:intervals p)) (apply str (interpose \"-\" (:intervals p))) \"silence\")]])))})\n"
9
+ };
package/dist/index.mjs ADDED
@@ -0,0 +1,22 @@
1
+ // Generated by packages/build.mjs
2
+ export default {
3
+ "package": "@kairotic/rhythm",
4
+ "version": "0.1.1",
5
+ "api": 1,
6
+ "author": "bonuoq",
7
+ "license": "MPL-2.0",
8
+ "components": [
9
+ {
10
+ "class": "euclid",
11
+ "license": "MPL-2.0",
12
+ "doc": "A Euclidean rhythm (Bjorklund's algorithm, after Toussaint): k onsets spread as evenly as they can be over n pulses — euclid 3 8 is the tresillo (3-3-2), euclid 5 8 the cinquillo, euclid 5 16 a rotation of the bossa nova, euclid 7 12 the bembé. Drawn as a necklace: the pulses around a circle, time clockwise from the top, the onsets joined into a polygon; pressing a pulse makes the rhythm start there (a rotation). A bang sends it; [:k 5], [:n 16], [:rotation 2], [:bars 4], [:meter \"3/4\"] (or a map of them) change it and send it when it is new, a number is k. Rhythm apart from pitch: out of the left outlet a musical tree, a bar of n pulses (4/4 for 8 or 16, 12/8 for 12, n/8 up to 12, else n/16; [:meter …] for another) with an :rtm whose shares are the intervals between onsets (a negative share a silence); bars repeat it, the pitches going on. Its right inlet (cold) takes the pitches the notes take in turn, starting again when they run out (talea and color): a map with :pitches or :pitch (kept as it is), a pattern ({:note [...]}), a melody string (\"c4 e4 g4\"), a list of Hz (the keys held on a keyboard; MIDI with midi), notes or chords of a tree; :clear forgets them (every note c4). Outlet 1 is the :rtm map alone ({:shares [3 3 2] :pitches …}), to merge with other pitches (merge) and write as a node (vector :rtm %); outlet 2 the pulses, ones and zeros ([1 0 0 1 0 0 1 0]).",
13
+ "source": ";; euclid · a Euclidean rhythm: k onsets spread as evenly as they can be over n pulses\n;; Part of @kairotic/rhythm. Written against the Kairotic API (api/…).\n;; Bjorklund's algorithm (Toussaint, \"The Euclidean algorithm generates traditional musical rhythms\", 2005):\n;; E(3,8) is the tresillo, E(5,8) the cinquillo, E(5,16) a rotation of the bossa nova, E(7,12) the bembé.\n;; The rhythm is drawn as a necklace — the n pulses around a circle, time running clockwise from the top,\n;; the onsets joined into a polygon — and pressing a pulse makes the rhythm start there (a rotation).\n;; What it sends is rhythm apart from pitch, as an :rtm of kairotic.mt (shares: the intervals between\n;; onsets, a negative share a silence), so that it can be merged with a map of pitches ({:pitches …}, the\n;; talea and color of an isorhythm) into a musical tree: the box does it with what reaches its right inlet,\n;; and its outlet 1 gives the bare :rtm map to merge elsewhere (merge, then vector :rtm %).\n(let [;; Bjorklund: k ones and n − k zeros, the remainder paired again and again (Euclid's algorithm)\n bjorklund (fn [k n]\n (cond (<= n 0) []\n (<= k 0) (vec (repeat n 0))\n (>= k n) (vec (repeat n 1))\n :else (loop [a (vec (repeat k [1])) b (vec (repeat (- n k) [0]))]\n (if (<= (count b) 1)\n (vec (apply concat (concat a b)))\n (let [m (min (count a) (count b))]\n (recur (mapv into (subvec a 0 m) (subvec b 0 m))\n (if (> (count a) m) (subvec a m) (subvec b m))))))))\n ;; a necklace read from pulse r on: the rhythm in a fixed position against the beat\n rotate (fn [xs r] (let [n (count xs)] (if (zero? n) xs (let [r (mod r n)] (vec (concat (subvec xs r) (subvec xs 0 r)))))))\n onsets-of (fn [ps] (vec (keep-indexed (fn [i x] (when (= 1 x) i)) ps)))\n ;; the intervals between onsets, around the circle (3 3 2): the rhythm as a necklace\n intervals-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (if (empty? os) [] (mapv (fn [a b] (- b a)) os (conj (subvec os 1) (+ n (first os)))))))\n ;; the shares of an :rtm: from each onset to the next one (or the end of the bar); the pulses before the\n ;; first onset a silence (a negative share): 01001001 → [-1 3 3 1]\n shares-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (cond (zero? n) []\n (empty? os) [(- n)]\n :else (vec (concat (when (pos? (first os)) [(- (first os))])\n (map (fn [a b] (- b a)) os (conj (subvec os 1) n)))))))\n ;; the meter of a bar of n pulses, when none is asked: the pulse a written value\n pow2? (fn [x] (and (pos? x) (== x (js/Math.pow 2 (js/Math.round (js/Math.log2 x))))))\n meter-of (fn [n] (cond (and (>= n 4) (pow2? n)) [4 4]\n (and (>= n 12) (zero? (mod n 3)) (pow2? (/ n 3))) [12 8]\n (< n 4) [n 4]\n (<= n 12) [n 8]\n :else [n 16]))\n ;; a meter asked for: [3 4], \"3/4\", \"7/8[2+2+3]\", or nil (as the pulses say)\n meter-arg (fn [v] (cond (and (sequential? v) (= 2 (count v)) (every? number? v)) (vec v)\n (string? v) v\n (keyword? v) (name v)\n :else nil))\n ;; pitches, as theory boxes take them: Hz by default, MIDI with midi; the MIDI notes kept to 3 decimals\n hz->m (fn [x] (when (and (number? x) (pos? x)) (/ (js/Math.round (* 1000 (+ 69 (* 12 (js/Math.log2 (/ x 440)))))) 1000)))\n ;; what reaches the right inlet, as the pitches of the :rtm (or nil, to forget them): a map of pitches\n ;; ({:pitches …} or {:pitch …}, kept as they are), a pattern ({:note [...]}, MIDI;\n ;; nil a rest), a melody string (\"c4 e4 g4\"), a list of pitches (Hz, as a keyboard sends the keys held;\n ;; MIDI with midi), a list of notes or chords of a tree, or one pitch\n pitches-of (fn [midi? v]\n (let [p (fn [x] (if midi? x (hz->m x)))]\n (cond (#{:clear} v) nil\n (map? v) (cond (or (contains? v :pitches) (contains? v :pitch)) (select-keys v [:pitches :pitch])\n (sequential? (:note v)) {:pitches (mapv (fn [x] (if (number? x) x \"r\")) (:note v))}\n :else :ignore)\n (string? v) {:pitches v}\n (number? v) (if-let [m (p v)] {:pitch m} :ignore)\n (and (sequential? v) (keyword? (first v))) {:pitches [v]}\n (and (sequential? v) (seq v) (every? number? v)) (let [ms (vec (keep p v))] (if (seq ms) {:pitches ms} :ignore))\n (and (sequential? v) (seq v)) {:pitches (vec v)}\n :else :ignore)))\n ;; the color goes on over the bars: bar i begins where the notes of the bar before left it\n tokens (fn [ps] (cond (string? ps) (vec (remove #{\"\"} (.split (.trim ps) (js/RegExp. \"\\\\s+\"))))\n (sequential? ps) (vec ps)\n :else nil))\n color-at (fn [pm skip]\n (let [ts (tokens (:pitches pm))]\n (if (or (empty? ts) (zero? (mod skip (count ts))))\n pm\n (let [r (mod skip (count ts)) ts2 (vec (concat (subvec ts r) (subvec ts 0 r)))]\n (assoc pm :pitches (if (string? (:pitches pm)) (apply str (interpose \" \" ts2)) ts2))))))\n ;; everything the box knows: its words, changed by messages\n params (fn [args st]\n (let [o (merge args (:over st))\n n (max 1 (js/Math.round (or (:n o) 8)))]\n {:n n :k (api/clamp (js/Math.round (or (:k o) 3)) 0 n) :rotation (mod (js/Math.round (or (:rotation o) 0)) n)\n :bars (api/clamp (js/Math.round (or (:bars o) 1)) 1 64) :meter (or (:meter o) (meter-of n))}))\n ;; the rhythm as data: the pulses, its necklace, and the :rtm with the pitches merged\n rhythm (fn [{:keys [k n rotation bars meter]} pm]\n (let [ps (rotate (bjorklund k n) rotation)\n rtm (merge {:shares (shares-of ps)} (or pm {}))\n bar (fn [i] (let [a (color-at rtm (* i k))]\n (if (zero? i) [:measure {:meter meter} [:rtm a]] [:measure [:rtm a]])))]\n {:pulses ps :onsets (onsets-of ps) :intervals (intervals-of ps) :rtm rtm\n :tree (into [:voice] (map bar (range bars)))}))\n shown-of (fn [p r] (merge (select-keys p [:k :n :rotation :bars]) (select-keys r [:pulses :onsets :intervals])))\n ;; what goes out: the tree (0), the :rtm map (1), the pulses (2), the last first (as Max does)\n outs (fn [r] [[2 (:pulses r)] [1 (:rtm r)] [0 (:tree r)]])\n ;; a change: sent when what it makes is new (the same again changes nothing); a bang sends it anyway\n changed (fn [args st over always?]\n (let [st2 (assoc st :over over) p (params args st2) r (rhythm p (:pm st2))]\n (if (and (not always?) (= (:tree r) (:sent st)))\n {:state st2 :show (shown-of p r)}\n {:state (assoc st2 :sent (:tree r)) :show (shown-of p r) :out (outs r)})))\n polar (fn [cx cy R i n] (let [a (* 2 js/Math.PI (/ i n))] [(+ cx (* R (js/Math.sin a))) (- cy (* R (js/Math.cos a)))]))]\n {;; ── about ──\n :class \"euclid\"\n :license \"MPL-2.0\"\n :doc \"A Euclidean rhythm (Bjorklund's algorithm, after Toussaint): k onsets spread as evenly as they can be over n pulses — euclid 3 8 is the tresillo (3-3-2), euclid 5 8 the cinquillo, euclid 5 16 a rotation of the bossa nova, euclid 7 12 the bembé. Drawn as a necklace: the pulses around a circle, time clockwise from the top, the onsets joined into a polygon; pressing a pulse makes the rhythm start there (a rotation). A bang sends it; [:k 5], [:n 16], [:rotation 2], [:bars 4], [:meter \\\"3/4\\\"] (or a map of them) change it and send it when it is new, a number is k. Rhythm apart from pitch: out of the left outlet a musical tree, a bar of n pulses (4/4 for 8 or 16, 12/8 for 12, n/8 up to 12, else n/16; [:meter …] for another) with an :rtm whose shares are the intervals between onsets (a negative share a silence); bars repeat it, the pitches going on. Its right inlet (cold) takes the pitches the notes take in turn, starting again when they run out (talea and color): a map with :pitches or :pitch (kept as it is), a pattern ({:note [...]}), a melody string (\\\"c4 e4 g4\\\"), a list of Hz (the keys held on a keyboard; MIDI with midi), notes or chords of a tree; :clear forgets them (every note c4). Outlet 1 is the :rtm map alone ({:shares [3 3 2] :pitches …}), to merge with other pitches (merge) and write as a node (vector :rtm %); outlet 2 the pulses, ones and zeros ([1 0 0 1 0 0 1 0]).\"\n :usage \"euclid [k 3] [n 8] [rotation 0] [bars 1] [midi]\"\n :io [2 3]\n :size [180 200]\n\n ;; ── arguments ──\n :args [[:k 3] [:n 8] [:rotation 0] [:bars 1] [:midi false]]\n\n ;; ── logic ──\n :receive (fn [{:keys [inlet value state args]}]\n (let [st (or state {:over {} :pm nil})\n over (:over st)\n set-over (fn [m] (changed args st (merge over m) false))]\n (if (= inlet 1)\n (let [pm (pitches-of (:midi args) value)]\n (if (= pm :ignore) {} {:state (assoc st :pm pm)}))\n (cond\n (#{:bang} value) (changed args st over true)\n (number? value) (set-over {:k value})\n (and (vector? value) (= :pressed (first value)) (number? (second value)))\n (let [p (params args st)] (set-over {:rotation (+ (:rotation p) (second value))}))\n (and (vector? value) (= 2 (count value)) (#{:k :n :rotation :bars} (first value)) (number? (second value)))\n (set-over {(first value) (second value)})\n (and (vector? value) (= :meter (first value))) (set-over {:meter (meter-arg (second value))})\n (map? value) (set-over (cond-> (select-keys value [:k :n :rotation :bars])\n (contains? value :meter) (assoc :meter (meter-arg (:meter value)))))\n :else {}))))\n ;; pressing a pulse: the rhythm starts there (sent once, on release)\n :gesture (fn [{:keys [up hit]}] (when (and up (number? hit)) [:pressed hit]))\n\n ;; ── view ──\n :draw (fn [{:keys [shown w h args]}]\n (let [p (or shown (let [n (max 1 (js/Math.round (or (:n args) 8)))\n k (api/clamp (js/Math.round (or (:k args) 3)) 0 n)\n ps (rotate (bjorklund k n) (or (:rotation args) 0))]\n {:k k :n n :pulses ps :onsets (onsets-of ps) :intervals (intervals-of ps)}))\n n (:n p) ps (:pulses p) os (:onsets p)\n cx (/ w 2) cy (/ (- h 30) 2) R (- (min cx cy) 16)\n r (cond (> n 32) 2.2 (> n 16) 3 :else 4.5)]\n (concat\n [[:circle {:cx cx :cy cy :r R :stroke :grid}]]\n ;; the start of the bar, at the top\n (let [[x1 y1] (polar cx cy (- R 9) 0 n) [x2 y2] (polar cx cy (+ R 9) 0 n)]\n [[:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1.5 :opacity 0.8}]])\n (when (> (count os) 1) [[:path {:points (mapv (fn [i] (polar cx cy R i n)) os) :closed true :stroke :accent :weight 2}]])\n (for [i (range n)]\n (let [[x y] (polar cx cy R i n) on (= 1 (nth ps i 0))]\n [:group {:hit i}\n [[:circle {:cx x :cy y :r (if on (+ r 1.5) r) :fill (if on :accent :bg) :stroke (if on :accent :soft)}]]]))\n [[:text {:x cx :y (- h 15) :anchor :middle :size 10 :fill :ink}\n (str \"E(\" (:k p) \",\" n \")\" (when (pos? (or (:rotation p) 0)) (str \" ↻\" (:rotation p))))]\n [:text {:x cx :y (- h 3) :anchor :middle :size 9 :fill :soft}\n (if (seq (:intervals p)) (apply str (interpose \"-\" (:intervals p))) \"silence\")]])))})\n"
14
+ },
15
+ {
16
+ "class": "necklace",
17
+ "license": "MPL-2.0",
18
+ "doc": "A cyclic rhythm on the circle and its geometry (Toussaint): k onsets among n pulses around a circle, time clockwise from the top — the same object as a pitch-class set on pcclock. A rhythm arrives as pulses (ones and zeros, as euclid's right outlet sends them), as intervals between onsets ([3 3 2]), as box notation (\"x..x..x.\"), as an :rtm map ({:shares [3 3 2]}, euclid's middle outlet), a tree with an :rtm, or {:onsets [0 3 6] :n 8}; it is drawn as a polygon, with its axes of mirror symmetry. Pressing a pulse (or a number, its index) adds or takes away an onset. :complement swaps onsets and silences, [:rotate 1] starts it a pulse later, [:n 12] makes the circle longer or shorter, :clear empties it, [:bars 4] and [:meter \"3/4\"] as euclid, a bang sends it again. Out, as euclid: a musical tree (left: a bar of n pulses with an :rtm whose shares are the intervals between onsets), the :rtm map alone (1), the pulses (2); and its measures (3): {:n :k :onsets :intervals :ivec — how often each distance occurs —, :evenness — the sum of the chords between all pairs (Block and Douthett) —, :even — that sum against the Euclidean rhythm's, 1 as even as it —, :deep — each distance a different number of times —, :flat — each once —, :axes — of mirror symmetry, in pulses —, :gap — the longest interval —, :oddity — no two onsets halving the cycle —, :euclid — the rotation of E(k,n) it is, or nil}. Its right inlet (cold) takes the pitches the notes take in turn, as euclid's.",
19
+ "source": ";; necklace · a cyclic rhythm on the circle, and its geometry (Toussaint)\n;; Part of @kairotic/rhythm. Written against the Kairotic API (api/…).\n;; A rhythm that repeats is a necklace: k onsets among n pulses around a circle, time clockwise from the\n;; top. Seen so, it is the same object as a pitch-class set on pcclock, and the same geometry measures it\n;; (Toussaint, \"The Geometry of Musical Rhythm\"): its full-interval vector (how often each distance between\n;; onsets occurs), its evenness (the sum of the chords between all pairs of onsets, after Block and Douthett;\n;; arcs are too coarse: the six 4/4 claves would all score the same), whether it is deep (each distance a\n;; different number of times, as the diatonic scale and the bembé), flat (each distance once), its axes of\n;; mirror symmetry, its longest gap, rhythmic oddity (no two onsets halving the cycle), and whether it is a\n;; rotation of the Euclidean rhythm E(k,n). Pressing a pulse adds or takes away an onset: the necklace is\n;; also an editor. What it sends is as euclid's — a musical tree, its :rtm map, its pulses —, so it merges\n;; with pitches the same way (the right inlet, or merge with outlet 1), and its measures go out on the right.\n(let [TAU (* 2 js/Math.PI)\n bjorklund (fn [k n]\n (cond (<= n 0) []\n (<= k 0) (vec (repeat n 0))\n (>= k n) (vec (repeat n 1))\n :else (loop [a (vec (repeat k [1])) b (vec (repeat (- n k) [0]))]\n (if (<= (count b) 1)\n (vec (apply concat (concat a b)))\n (let [m (min (count a) (count b))]\n (recur (mapv into (subvec a 0 m) (subvec b 0 m))\n (if (> (count a) m) (subvec a m) (subvec b m))))))))\n rotate (fn [xs r] (let [n (count xs)] (if (zero? n) xs (let [r (mod r n)] (vec (concat (subvec xs r) (subvec xs 0 r)))))))\n onsets-of (fn [ps] (vec (keep-indexed (fn [i x] (when (= 1 x) i)) ps)))\n intervals-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (if (empty? os) [] (mapv (fn [a b] (- b a)) os (conj (subvec os 1) (+ n (first os)))))))\n shares-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (cond (zero? n) []\n (empty? os) [(- n)]\n :else (vec (concat (when (pos? (first os)) [(- (first os))])\n (map (fn [a b] (- b a)) os (conj (subvec os 1) n)))))))\n r3 (fn [x] (/ (js/Math.round (* 1000 x)) 1000))\n ;; ── what arrives, as pulses (ones and zeros), or nil when it is not a rhythm ──\n whole? (fn [x] (and (number? x) (== x (js/Math.round x))))\n from-shares (fn [sh] (when (and (sequential? sh) (seq sh) (every? (fn [x] (and (whole? x) (not (zero? x)))) sh))\n (vec (mapcat (fn [x] (if (pos? x) (cons 1 (repeat (dec x) 0)) (repeat (- x) 0))) sh))))\n from-onsets (fn [os n] (when (and (whole? n) (pos? n) (sequential? os) (every? whole? os))\n (let [on (set (map (fn [o] (mod o n)) os))] (mapv (fn [i] (if (on i) 1 0)) (range n)))))\n ;; the first :rtm of a tree (as euclid sends it)\n rtm-in (fn rtm-in [t] (when (sequential? t)\n (if (= :rtm (first t)) (second t) (some rtm-in (filter sequential? t)))))\n ;; a list: ones and zeros are pulses; other whole numbers, the intervals between onsets (3 3 2)\n pulses-of-list (fn [v] (when (and (sequential? v) (seq v) (every? whole? v))\n (if (every? #{0 1} v) (vec v) (when (every? pos? v) (from-shares v)))))\n pulses-of (fn [v]\n (cond\n ;; box notation (TUBS): \"x..x..x.\" (x, X or 1 an onset; . - _ or 0 a pulse without one)\n (string? v) (let [cs (remove #{\" \"} (seq v))]\n (when (and (seq cs) (every? #{\"x\" \"X\" \"1\" \".\" \"-\" \"_\" \"0\"} cs))\n (mapv (fn [c] (if (#{\"x\" \"X\" \"1\"} c) 1 0)) cs)))\n (map? v) (cond (contains? v :shares) (from-shares (:shares v))\n (contains? v :pulses) (pulses-of-list (:pulses v))\n (contains? v :onsets) (from-onsets (:onsets v) (:n v)))\n (and (sequential? v) (keyword? (first v))) (some-> (rtm-in v) :shares from-shares)\n :else nil))\n ;; ── its geometry ──\n dist (fn [n a b] (let [d (js/Math.abs (- a b))] (min d (- n d))))\n pairs (fn [os] (for [i (range (count os)) j (range (inc i) (count os))] [(nth os i) (nth os j)]))\n ivec-of (fn [n os] (let [c (frequencies (map (fn [[a b]] (dist n a b)) (pairs os)))]\n (mapv (fn [d] (get c d 0)) (range 1 (inc (quot n 2))))))\n evenness-of (fn [n os] (reduce + 0 (map (fn [[a b]] (* 2 (js/Math.sin (/ (* js/Math.PI (dist n a b)) n)))) (pairs os))))\n ;; the axes of mirror symmetry, in pulses: x → a − x keeps the set; the axis passes through a/2 (and a/2 + n/2)\n axes-of (fn [n os] (let [s (set os)]\n (if (empty? s) []\n (vec (for [a (range n) :when (= s (set (map (fn [x] (mod (- a x) n)) os)))] (/ a 2))))))\n measures (fn [ps]\n (let [n (count ps) os (onsets-of ps) k (count os) iv (ivec-of n os) ev (evenness-of n os)\n e (bjorklund k n) eev (evenness-of n (onsets-of e))\n er (first (filter (fn [r] (= ps (rotate e r))) (range (max n 1))))]\n {:n n :k k :onsets os :intervals (intervals-of ps) :ivec iv\n :evenness (r3 ev) :even (if (pos? eev) (r3 (/ ev eev)) 1)\n :deep (and (>= k 2) (= (count (distinct iv)) (count iv)))\n :flat (and (seq iv) (every? #{1} iv))\n :axes (axes-of n os)\n :gap (if (seq os) (apply max (intervals-of ps)) n)\n :oddity (or (odd? n) (not-any? (fn [[a b]] (= (* 2 (dist n a b)) n)) (pairs os)))\n :euclid er}))\n ;; ── as euclid sends a rhythm: the meter of a bar of n pulses, the pitches, the color over bars ──\n pow2? (fn [x] (and (pos? x) (== x (js/Math.pow 2 (js/Math.round (js/Math.log2 x))))))\n meter-of (fn [n] (cond (and (>= n 4) (pow2? n)) [4 4]\n (and (>= n 12) (zero? (mod n 3)) (pow2? (/ n 3))) [12 8]\n (< n 4) [n 4]\n (<= n 12) [n 8]\n :else [n 16]))\n meter-arg (fn [v] (cond (and (sequential? v) (= 2 (count v)) (every? number? v)) (vec v)\n (string? v) v\n (keyword? v) (name v)\n :else nil))\n hz->m (fn [x] (when (and (number? x) (pos? x)) (/ (js/Math.round (* 1000 (+ 69 (* 12 (js/Math.log2 (/ x 440)))))) 1000)))\n pitches-of (fn [midi? v]\n (let [p (fn [x] (if midi? x (hz->m x)))]\n (cond (#{:clear} v) nil\n (map? v) (cond (or (contains? v :pitches) (contains? v :pitch)) (select-keys v [:pitches :pitch])\n (sequential? (:note v)) {:pitches (mapv (fn [x] (if (number? x) x \"r\")) (:note v))}\n :else :ignore)\n (string? v) {:pitches v}\n (number? v) (if-let [m (p v)] {:pitch m} :ignore)\n (and (sequential? v) (keyword? (first v))) {:pitches [v]}\n (and (sequential? v) (seq v) (every? number? v)) (let [ms (vec (keep p v))] (if (seq ms) {:pitches ms} :ignore))\n (and (sequential? v) (seq v)) {:pitches (vec v)}\n :else :ignore)))\n tokens (fn [ps] (cond (string? ps) (vec (remove #{\"\"} (.split (.trim ps) (js/RegExp. \"\\\\s+\"))))\n (sequential? ps) (vec ps)\n :else nil))\n color-at (fn [pm skip]\n (let [ts (tokens (:pitches pm))]\n (if (or (empty? ts) (zero? (mod skip (count ts))))\n pm\n (let [r (mod skip (count ts)) ts2 (vec (concat (subvec ts r) (subvec ts 0 r)))]\n (assoc pm :pitches (if (string? (:pitches pm)) (apply str (interpose \" \" ts2)) ts2))))))\n rhythm (fn [ps st]\n (let [k (count (onsets-of ps)) bars (:bars st) meter (or (:meter st) (meter-of (count ps)))\n rtm (merge {:shares (shares-of ps)} (or (:pm st) {}))\n bar (fn [i] (let [a (color-at rtm (* i k))]\n (if (zero? i) [:measure {:meter meter} [:rtm a]] [:measure [:rtm a]])))]\n {:rtm rtm :tree (into [:voice] (map bar (range bars)))}))\n ;; what goes out (the last first, as Max does): the measures (3), the pulses (2), the :rtm map (1), the tree (0)\n outs (fn [ps st] (let [r (rhythm ps st)] [[3 (measures ps)] [2 ps] [1 (:rtm r)] [0 (:tree r)]]))\n ;; a new state: sent when the rhythm, its bars or its meter are new (the same again changes nothing); a bang anyway\n settle (fn [st st2 always?]\n (let [ps (:pulses st2) key [ps (:bars st2) (:meter st2)]\n show (assoc (measures ps) :pulses ps)]\n (cond (empty? ps) {:state st2}\n (and (not always?) (= key (:sent st))) {:state st2 :show show}\n :else {:state (assoc st2 :sent key) :show show :out (outs ps st2)})))\n polar (fn [cx cy R i n] (let [a (* TAU (/ i n))] [(+ cx (* R (js/Math.sin a))) (- cy (* R (js/Math.cos a)))]))]\n {;; ── about ──\n :class \"necklace\"\n :license \"MPL-2.0\"\n :doc \"A cyclic rhythm on the circle and its geometry (Toussaint): k onsets among n pulses around a circle, time clockwise from the top — the same object as a pitch-class set on pcclock. A rhythm arrives as pulses (ones and zeros, as euclid's right outlet sends them), as intervals between onsets ([3 3 2]), as box notation (\\\"x..x..x.\\\"), as an :rtm map ({:shares [3 3 2]}, euclid's middle outlet), a tree with an :rtm, or {:onsets [0 3 6] :n 8}; it is drawn as a polygon, with its axes of mirror symmetry. Pressing a pulse (or a number, its index) adds or takes away an onset. :complement swaps onsets and silences, [:rotate 1] starts it a pulse later, [:n 12] makes the circle longer or shorter, :clear empties it, [:bars 4] and [:meter \\\"3/4\\\"] as euclid, a bang sends it again. Out, as euclid: a musical tree (left: a bar of n pulses with an :rtm whose shares are the intervals between onsets), the :rtm map alone (1), the pulses (2); and its measures (3): {:n :k :onsets :intervals :ivec — how often each distance occurs —, :evenness — the sum of the chords between all pairs (Block and Douthett) —, :even — that sum against the Euclidean rhythm's, 1 as even as it —, :deep — each distance a different number of times —, :flat — each once —, :axes — of mirror symmetry, in pulses —, :gap — the longest interval —, :oddity — no two onsets halving the cycle —, :euclid — the rotation of E(k,n) it is, or nil}. Its right inlet (cold) takes the pitches the notes take in turn, as euclid's.\"\n :usage \"necklace [n 16] [bars 1] [midi]\"\n :io [2 4]\n :size [200 240]\n\n ;; ── arguments ──\n :args [[:n 16] [:bars 1] [:midi false]]\n\n ;; ── logic ──\n :receive (fn [{:keys [inlet value state args]}]\n (let [st (or state {:pulses (vec (repeat (max 1 (js/Math.round (or (:n args) 16))) 0))\n :bars (api/clamp (js/Math.round (or (:bars args) 1)) 1 64) :meter nil :pm nil})\n ps (:pulses st) n (count ps)\n to (fn [m] (settle st (merge st m) false))\n toggle (fn [i] (let [i (mod (js/Math.round i) n)] (to {:pulses (update ps i (fn [x] (- 1 x)))})))]\n (if (= inlet 1)\n (let [pm (pitches-of (:midi args) value)]\n (if (= pm :ignore) {} {:state (assoc st :pm pm)}))\n (cond\n (#{:bang} value) (settle st st true)\n (#{:clear} value) (to {:pulses (vec (repeat n 0))})\n (#{:complement} value) (to {:pulses (mapv (fn [x] (- 1 x)) ps)})\n (number? value) (toggle value)\n (and (vector? value) (= :pressed (first value)) (number? (second value))) (toggle (second value))\n (and (vector? value) (= :rotate (first value)) (number? (second value))) (to {:pulses (rotate ps (js/Math.round (second value)))})\n (and (vector? value) (= :n (first value)) (number? (second value)))\n (let [m (api/clamp (js/Math.round (second value)) 1 128)]\n (to {:pulses (vec (take m (concat ps (repeat 0))))}))\n (and (vector? value) (= :bars (first value)) (number? (second value))) (to {:bars (api/clamp (js/Math.round (second value)) 1 64)})\n (and (vector? value) (= :meter (first value))) (to {:meter (meter-arg (second value))})\n :else (if-let [p (or (pulses-of-list value) (pulses-of value))]\n (to {:pulses p})\n {})))))\n ;; pressing a pulse adds or takes away an onset (sent once, on release)\n :gesture (fn [{:keys [up hit]}] (when (and up (number? hit)) [:pressed hit]))\n\n ;; ── view ──\n :draw (fn [{:keys [shown w h args]}]\n (let [p (or shown (let [ps (vec (repeat (max 1 (js/Math.round (or (:n args) 16))) 0))] (assoc (measures ps) :pulses ps)))\n n (:n p) ps (:pulses p) os (:onsets p)\n cx (/ w 2) cy (/ (- h 44) 2) R (- (min cx cy) 16)\n r (cond (> n 32) 2.2 (> n 16) 3 :else 4.5)\n flags (remove nil? [(str \"even \" (:even p))\n (let [a (count (:axes p))] (case a 0 \"asymmetric\" 1 \"1 axis\" (str a \" axes\")))\n (when (:deep p) \"deep\") (when (:flat p) \"flat\")\n (when (and (even? n) (:oddity p) (pos? (:k p))) \"oddity\")\n (when (:euclid p) (str \"E(\" (:k p) \",\" n \")\" (when (pos? (:euclid p)) (str \" ↻\" (:euclid p)))))])]\n (concat\n [[:circle {:cx cx :cy cy :r R :stroke :grid}]]\n (let [[x1 y1] (polar cx cy (- R 9) 0 n) [x2 y2] (polar cx cy (+ R 9) 0 n)]\n [[:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1.5 :opacity 0.8}]])\n ;; the axes of symmetry, across the circle\n (for [a (:axes p)]\n (let [[x1 y1] (polar cx cy (+ R 7) a n) [x2 y2] (polar cx cy (+ R 7) (+ a (/ n 2)) n)]\n [:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1 :opacity 0.5}]))\n (when (> (count os) 1) [[:path {:points (mapv (fn [i] (polar cx cy R i n)) os) :closed true :stroke :accent :weight 2}]])\n (for [i (range n)]\n (let [[x y] (polar cx cy R i n) on (= 1 (nth ps i 0))]\n [:group {:hit i}\n [[:circle {:cx x :cy y :r (if on (+ r 1.5) r) :fill (if on :accent :bg) :stroke (if on :accent :soft)}]]]))\n [[:text {:x cx :y (- h 29) :anchor :middle :size 10 :fill :ink}\n (str (:k p) \"/\" n \" · \" (if (seq (:intervals p)) (apply str (interpose \"-\" (:intervals p))) \"silence\"))]\n [:text {:x cx :y (- h 16) :anchor :middle :size 9 :fill :soft} (str \"<\" (apply str (interpose \" \" (:ivec p))) \">\")]\n [:text {:x cx :y (- h 3) :anchor :middle :size 9 :fill :soft} (apply str (interpose \" · \" flags))]])))})\n"
20
+ }
21
+ ]
22
+ };
@@ -0,0 +1,9 @@
1
+ // Generated by packages/build.mjs from src/necklace.cljs
2
+ export default {
3
+ "class": "necklace",
4
+ "version": "0.1.1",
5
+ "author": "bonuoq",
6
+ "license": "MPL-2.0",
7
+ "doc": "A cyclic rhythm on the circle and its geometry (Toussaint): k onsets among n pulses around a circle, time clockwise from the top — the same object as a pitch-class set on pcclock. A rhythm arrives as pulses (ones and zeros, as euclid's right outlet sends them), as intervals between onsets ([3 3 2]), as box notation (\"x..x..x.\"), as an :rtm map ({:shares [3 3 2]}, euclid's middle outlet), a tree with an :rtm, or {:onsets [0 3 6] :n 8}; it is drawn as a polygon, with its axes of mirror symmetry. Pressing a pulse (or a number, its index) adds or takes away an onset. :complement swaps onsets and silences, [:rotate 1] starts it a pulse later, [:n 12] makes the circle longer or shorter, :clear empties it, [:bars 4] and [:meter \"3/4\"] as euclid, a bang sends it again. Out, as euclid: a musical tree (left: a bar of n pulses with an :rtm whose shares are the intervals between onsets), the :rtm map alone (1), the pulses (2); and its measures (3): {:n :k :onsets :intervals :ivec — how often each distance occurs —, :evenness — the sum of the chords between all pairs (Block and Douthett) —, :even — that sum against the Euclidean rhythm's, 1 as even as it —, :deep — each distance a different number of times —, :flat — each once —, :axes — of mirror symmetry, in pulses —, :gap — the longest interval —, :oddity — no two onsets halving the cycle —, :euclid — the rotation of E(k,n) it is, or nil}. Its right inlet (cold) takes the pitches the notes take in turn, as euclid's.",
8
+ "source": ";; necklace · a cyclic rhythm on the circle, and its geometry (Toussaint)\n;; Part of @kairotic/rhythm. Written against the Kairotic API (api/…).\n;; A rhythm that repeats is a necklace: k onsets among n pulses around a circle, time clockwise from the\n;; top. Seen so, it is the same object as a pitch-class set on pcclock, and the same geometry measures it\n;; (Toussaint, \"The Geometry of Musical Rhythm\"): its full-interval vector (how often each distance between\n;; onsets occurs), its evenness (the sum of the chords between all pairs of onsets, after Block and Douthett;\n;; arcs are too coarse: the six 4/4 claves would all score the same), whether it is deep (each distance a\n;; different number of times, as the diatonic scale and the bembé), flat (each distance once), its axes of\n;; mirror symmetry, its longest gap, rhythmic oddity (no two onsets halving the cycle), and whether it is a\n;; rotation of the Euclidean rhythm E(k,n). Pressing a pulse adds or takes away an onset: the necklace is\n;; also an editor. What it sends is as euclid's — a musical tree, its :rtm map, its pulses —, so it merges\n;; with pitches the same way (the right inlet, or merge with outlet 1), and its measures go out on the right.\n(let [TAU (* 2 js/Math.PI)\n bjorklund (fn [k n]\n (cond (<= n 0) []\n (<= k 0) (vec (repeat n 0))\n (>= k n) (vec (repeat n 1))\n :else (loop [a (vec (repeat k [1])) b (vec (repeat (- n k) [0]))]\n (if (<= (count b) 1)\n (vec (apply concat (concat a b)))\n (let [m (min (count a) (count b))]\n (recur (mapv into (subvec a 0 m) (subvec b 0 m))\n (if (> (count a) m) (subvec a m) (subvec b m))))))))\n rotate (fn [xs r] (let [n (count xs)] (if (zero? n) xs (let [r (mod r n)] (vec (concat (subvec xs r) (subvec xs 0 r)))))))\n onsets-of (fn [ps] (vec (keep-indexed (fn [i x] (when (= 1 x) i)) ps)))\n intervals-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (if (empty? os) [] (mapv (fn [a b] (- b a)) os (conj (subvec os 1) (+ n (first os)))))))\n shares-of (fn [ps] (let [os (onsets-of ps) n (count ps)]\n (cond (zero? n) []\n (empty? os) [(- n)]\n :else (vec (concat (when (pos? (first os)) [(- (first os))])\n (map (fn [a b] (- b a)) os (conj (subvec os 1) n)))))))\n r3 (fn [x] (/ (js/Math.round (* 1000 x)) 1000))\n ;; ── what arrives, as pulses (ones and zeros), or nil when it is not a rhythm ──\n whole? (fn [x] (and (number? x) (== x (js/Math.round x))))\n from-shares (fn [sh] (when (and (sequential? sh) (seq sh) (every? (fn [x] (and (whole? x) (not (zero? x)))) sh))\n (vec (mapcat (fn [x] (if (pos? x) (cons 1 (repeat (dec x) 0)) (repeat (- x) 0))) sh))))\n from-onsets (fn [os n] (when (and (whole? n) (pos? n) (sequential? os) (every? whole? os))\n (let [on (set (map (fn [o] (mod o n)) os))] (mapv (fn [i] (if (on i) 1 0)) (range n)))))\n ;; the first :rtm of a tree (as euclid sends it)\n rtm-in (fn rtm-in [t] (when (sequential? t)\n (if (= :rtm (first t)) (second t) (some rtm-in (filter sequential? t)))))\n ;; a list: ones and zeros are pulses; other whole numbers, the intervals between onsets (3 3 2)\n pulses-of-list (fn [v] (when (and (sequential? v) (seq v) (every? whole? v))\n (if (every? #{0 1} v) (vec v) (when (every? pos? v) (from-shares v)))))\n pulses-of (fn [v]\n (cond\n ;; box notation (TUBS): \"x..x..x.\" (x, X or 1 an onset; . - _ or 0 a pulse without one)\n (string? v) (let [cs (remove #{\" \"} (seq v))]\n (when (and (seq cs) (every? #{\"x\" \"X\" \"1\" \".\" \"-\" \"_\" \"0\"} cs))\n (mapv (fn [c] (if (#{\"x\" \"X\" \"1\"} c) 1 0)) cs)))\n (map? v) (cond (contains? v :shares) (from-shares (:shares v))\n (contains? v :pulses) (pulses-of-list (:pulses v))\n (contains? v :onsets) (from-onsets (:onsets v) (:n v)))\n (and (sequential? v) (keyword? (first v))) (some-> (rtm-in v) :shares from-shares)\n :else nil))\n ;; ── its geometry ──\n dist (fn [n a b] (let [d (js/Math.abs (- a b))] (min d (- n d))))\n pairs (fn [os] (for [i (range (count os)) j (range (inc i) (count os))] [(nth os i) (nth os j)]))\n ivec-of (fn [n os] (let [c (frequencies (map (fn [[a b]] (dist n a b)) (pairs os)))]\n (mapv (fn [d] (get c d 0)) (range 1 (inc (quot n 2))))))\n evenness-of (fn [n os] (reduce + 0 (map (fn [[a b]] (* 2 (js/Math.sin (/ (* js/Math.PI (dist n a b)) n)))) (pairs os))))\n ;; the axes of mirror symmetry, in pulses: x → a − x keeps the set; the axis passes through a/2 (and a/2 + n/2)\n axes-of (fn [n os] (let [s (set os)]\n (if (empty? s) []\n (vec (for [a (range n) :when (= s (set (map (fn [x] (mod (- a x) n)) os)))] (/ a 2))))))\n measures (fn [ps]\n (let [n (count ps) os (onsets-of ps) k (count os) iv (ivec-of n os) ev (evenness-of n os)\n e (bjorklund k n) eev (evenness-of n (onsets-of e))\n er (first (filter (fn [r] (= ps (rotate e r))) (range (max n 1))))]\n {:n n :k k :onsets os :intervals (intervals-of ps) :ivec iv\n :evenness (r3 ev) :even (if (pos? eev) (r3 (/ ev eev)) 1)\n :deep (and (>= k 2) (= (count (distinct iv)) (count iv)))\n :flat (and (seq iv) (every? #{1} iv))\n :axes (axes-of n os)\n :gap (if (seq os) (apply max (intervals-of ps)) n)\n :oddity (or (odd? n) (not-any? (fn [[a b]] (= (* 2 (dist n a b)) n)) (pairs os)))\n :euclid er}))\n ;; ── as euclid sends a rhythm: the meter of a bar of n pulses, the pitches, the color over bars ──\n pow2? (fn [x] (and (pos? x) (== x (js/Math.pow 2 (js/Math.round (js/Math.log2 x))))))\n meter-of (fn [n] (cond (and (>= n 4) (pow2? n)) [4 4]\n (and (>= n 12) (zero? (mod n 3)) (pow2? (/ n 3))) [12 8]\n (< n 4) [n 4]\n (<= n 12) [n 8]\n :else [n 16]))\n meter-arg (fn [v] (cond (and (sequential? v) (= 2 (count v)) (every? number? v)) (vec v)\n (string? v) v\n (keyword? v) (name v)\n :else nil))\n hz->m (fn [x] (when (and (number? x) (pos? x)) (/ (js/Math.round (* 1000 (+ 69 (* 12 (js/Math.log2 (/ x 440)))))) 1000)))\n pitches-of (fn [midi? v]\n (let [p (fn [x] (if midi? x (hz->m x)))]\n (cond (#{:clear} v) nil\n (map? v) (cond (or (contains? v :pitches) (contains? v :pitch)) (select-keys v [:pitches :pitch])\n (sequential? (:note v)) {:pitches (mapv (fn [x] (if (number? x) x \"r\")) (:note v))}\n :else :ignore)\n (string? v) {:pitches v}\n (number? v) (if-let [m (p v)] {:pitch m} :ignore)\n (and (sequential? v) (keyword? (first v))) {:pitches [v]}\n (and (sequential? v) (seq v) (every? number? v)) (let [ms (vec (keep p v))] (if (seq ms) {:pitches ms} :ignore))\n (and (sequential? v) (seq v)) {:pitches (vec v)}\n :else :ignore)))\n tokens (fn [ps] (cond (string? ps) (vec (remove #{\"\"} (.split (.trim ps) (js/RegExp. \"\\\\s+\"))))\n (sequential? ps) (vec ps)\n :else nil))\n color-at (fn [pm skip]\n (let [ts (tokens (:pitches pm))]\n (if (or (empty? ts) (zero? (mod skip (count ts))))\n pm\n (let [r (mod skip (count ts)) ts2 (vec (concat (subvec ts r) (subvec ts 0 r)))]\n (assoc pm :pitches (if (string? (:pitches pm)) (apply str (interpose \" \" ts2)) ts2))))))\n rhythm (fn [ps st]\n (let [k (count (onsets-of ps)) bars (:bars st) meter (or (:meter st) (meter-of (count ps)))\n rtm (merge {:shares (shares-of ps)} (or (:pm st) {}))\n bar (fn [i] (let [a (color-at rtm (* i k))]\n (if (zero? i) [:measure {:meter meter} [:rtm a]] [:measure [:rtm a]])))]\n {:rtm rtm :tree (into [:voice] (map bar (range bars)))}))\n ;; what goes out (the last first, as Max does): the measures (3), the pulses (2), the :rtm map (1), the tree (0)\n outs (fn [ps st] (let [r (rhythm ps st)] [[3 (measures ps)] [2 ps] [1 (:rtm r)] [0 (:tree r)]]))\n ;; a new state: sent when the rhythm, its bars or its meter are new (the same again changes nothing); a bang anyway\n settle (fn [st st2 always?]\n (let [ps (:pulses st2) key [ps (:bars st2) (:meter st2)]\n show (assoc (measures ps) :pulses ps)]\n (cond (empty? ps) {:state st2}\n (and (not always?) (= key (:sent st))) {:state st2 :show show}\n :else {:state (assoc st2 :sent key) :show show :out (outs ps st2)})))\n polar (fn [cx cy R i n] (let [a (* TAU (/ i n))] [(+ cx (* R (js/Math.sin a))) (- cy (* R (js/Math.cos a)))]))]\n {;; ── about ──\n :class \"necklace\"\n :license \"MPL-2.0\"\n :doc \"A cyclic rhythm on the circle and its geometry (Toussaint): k onsets among n pulses around a circle, time clockwise from the top — the same object as a pitch-class set on pcclock. A rhythm arrives as pulses (ones and zeros, as euclid's right outlet sends them), as intervals between onsets ([3 3 2]), as box notation (\\\"x..x..x.\\\"), as an :rtm map ({:shares [3 3 2]}, euclid's middle outlet), a tree with an :rtm, or {:onsets [0 3 6] :n 8}; it is drawn as a polygon, with its axes of mirror symmetry. Pressing a pulse (or a number, its index) adds or takes away an onset. :complement swaps onsets and silences, [:rotate 1] starts it a pulse later, [:n 12] makes the circle longer or shorter, :clear empties it, [:bars 4] and [:meter \\\"3/4\\\"] as euclid, a bang sends it again. Out, as euclid: a musical tree (left: a bar of n pulses with an :rtm whose shares are the intervals between onsets), the :rtm map alone (1), the pulses (2); and its measures (3): {:n :k :onsets :intervals :ivec — how often each distance occurs —, :evenness — the sum of the chords between all pairs (Block and Douthett) —, :even — that sum against the Euclidean rhythm's, 1 as even as it —, :deep — each distance a different number of times —, :flat — each once —, :axes — of mirror symmetry, in pulses —, :gap — the longest interval —, :oddity — no two onsets halving the cycle —, :euclid — the rotation of E(k,n) it is, or nil}. Its right inlet (cold) takes the pitches the notes take in turn, as euclid's.\"\n :usage \"necklace [n 16] [bars 1] [midi]\"\n :io [2 4]\n :size [200 240]\n\n ;; ── arguments ──\n :args [[:n 16] [:bars 1] [:midi false]]\n\n ;; ── logic ──\n :receive (fn [{:keys [inlet value state args]}]\n (let [st (or state {:pulses (vec (repeat (max 1 (js/Math.round (or (:n args) 16))) 0))\n :bars (api/clamp (js/Math.round (or (:bars args) 1)) 1 64) :meter nil :pm nil})\n ps (:pulses st) n (count ps)\n to (fn [m] (settle st (merge st m) false))\n toggle (fn [i] (let [i (mod (js/Math.round i) n)] (to {:pulses (update ps i (fn [x] (- 1 x)))})))]\n (if (= inlet 1)\n (let [pm (pitches-of (:midi args) value)]\n (if (= pm :ignore) {} {:state (assoc st :pm pm)}))\n (cond\n (#{:bang} value) (settle st st true)\n (#{:clear} value) (to {:pulses (vec (repeat n 0))})\n (#{:complement} value) (to {:pulses (mapv (fn [x] (- 1 x)) ps)})\n (number? value) (toggle value)\n (and (vector? value) (= :pressed (first value)) (number? (second value))) (toggle (second value))\n (and (vector? value) (= :rotate (first value)) (number? (second value))) (to {:pulses (rotate ps (js/Math.round (second value)))})\n (and (vector? value) (= :n (first value)) (number? (second value)))\n (let [m (api/clamp (js/Math.round (second value)) 1 128)]\n (to {:pulses (vec (take m (concat ps (repeat 0))))}))\n (and (vector? value) (= :bars (first value)) (number? (second value))) (to {:bars (api/clamp (js/Math.round (second value)) 1 64)})\n (and (vector? value) (= :meter (first value))) (to {:meter (meter-arg (second value))})\n :else (if-let [p (or (pulses-of-list value) (pulses-of value))]\n (to {:pulses p})\n {})))))\n ;; pressing a pulse adds or takes away an onset (sent once, on release)\n :gesture (fn [{:keys [up hit]}] (when (and up (number? hit)) [:pressed hit]))\n\n ;; ── view ──\n :draw (fn [{:keys [shown w h args]}]\n (let [p (or shown (let [ps (vec (repeat (max 1 (js/Math.round (or (:n args) 16))) 0))] (assoc (measures ps) :pulses ps)))\n n (:n p) ps (:pulses p) os (:onsets p)\n cx (/ w 2) cy (/ (- h 44) 2) R (- (min cx cy) 16)\n r (cond (> n 32) 2.2 (> n 16) 3 :else 4.5)\n flags (remove nil? [(str \"even \" (:even p))\n (let [a (count (:axes p))] (case a 0 \"asymmetric\" 1 \"1 axis\" (str a \" axes\")))\n (when (:deep p) \"deep\") (when (:flat p) \"flat\")\n (when (and (even? n) (:oddity p) (pos? (:k p))) \"oddity\")\n (when (:euclid p) (str \"E(\" (:k p) \",\" n \")\" (when (pos? (:euclid p)) (str \" ↻\" (:euclid p)))))])]\n (concat\n [[:circle {:cx cx :cy cy :r R :stroke :grid}]]\n (let [[x1 y1] (polar cx cy (- R 9) 0 n) [x2 y2] (polar cx cy (+ R 9) 0 n)]\n [[:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1.5 :opacity 0.8}]])\n ;; the axes of symmetry, across the circle\n (for [a (:axes p)]\n (let [[x1 y1] (polar cx cy (+ R 7) a n) [x2 y2] (polar cx cy (+ R 7) (+ a (/ n 2)) n)]\n [:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1 :opacity 0.5}]))\n (when (> (count os) 1) [[:path {:points (mapv (fn [i] (polar cx cy R i n)) os) :closed true :stroke :accent :weight 2}]])\n (for [i (range n)]\n (let [[x y] (polar cx cy R i n) on (= 1 (nth ps i 0))]\n [:group {:hit i}\n [[:circle {:cx x :cy y :r (if on (+ r 1.5) r) :fill (if on :accent :bg) :stroke (if on :accent :soft)}]]]))\n [[:text {:x cx :y (- h 29) :anchor :middle :size 10 :fill :ink}\n (str (:k p) \"/\" n \" · \" (if (seq (:intervals p)) (apply str (interpose \"-\" (:intervals p))) \"silence\"))]\n [:text {:x cx :y (- h 16) :anchor :middle :size 9 :fill :soft} (str \"<\" (apply str (interpose \" \" (:ivec p))) \">\")]\n [:text {:x cx :y (- h 3) :anchor :middle :size 9 :fill :soft} (apply str (interpose \" · \" flags))]])))})\n"
9
+ };
package/package.json CHANGED
@@ -1,6 +1,42 @@
1
1
  {
2
2
  "name": "@kairotic/rhythm",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.1",
4
+ "description": "Kairotic rhythm as geometry (after Toussaint): euclid (a Euclidean rhythm by Bjorklund's algorithm, drawn as a necklace) and necklace (a cyclic rhythm on the circle and its measures: interval vector, evenness, deep, flat, axes of symmetry, oddity; also an editor) — both sent as musical trees whose :rtm merges with any pitches",
5
+ "author": "bonuoq",
6
+ "license": "MPL-2.0",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/bonuoq/kairotic.git",
10
+ "directory": "packages/rhythm"
11
+ },
12
+ "homepage": "https://github.com/bonuoq/kairotic/tree/main/packages#readme",
13
+ "type": "module",
14
+ "main": "dist/index.mjs",
15
+ "files": [
16
+ "dist",
17
+ "src",
18
+ "README.md"
19
+ ],
20
+ "publishConfig": {
21
+ "access": "public"
22
+ },
23
+ "kairotic": {
24
+ "api": 1
25
+ },
26
+ "scripts": {
27
+ "build": "node ../build.mjs rhythm",
28
+ "prepublishOnly": "node ../build.mjs rhythm"
29
+ },
30
+ "keywords": [
31
+ "kairotic",
32
+ "music",
33
+ "rhythm",
34
+ "euclidean rhythm",
35
+ "bjorklund",
36
+ "necklace",
37
+ "toussaint",
38
+ "interval vector",
39
+ "talea",
40
+ "isorhythm"
41
+ ]
42
+ }
@@ -0,0 +1,154 @@
1
+ ;; euclid · a Euclidean rhythm: k onsets spread as evenly as they can be over n pulses
2
+ ;; Part of @kairotic/rhythm. Written against the Kairotic API (api/…).
3
+ ;; Bjorklund's algorithm (Toussaint, "The Euclidean algorithm generates traditional musical rhythms", 2005):
4
+ ;; E(3,8) is the tresillo, E(5,8) the cinquillo, E(5,16) a rotation of the bossa nova, E(7,12) the bembé.
5
+ ;; The rhythm is drawn as a necklace — the n pulses around a circle, time running clockwise from the top,
6
+ ;; the onsets joined into a polygon — and pressing a pulse makes the rhythm start there (a rotation).
7
+ ;; What it sends is rhythm apart from pitch, as an :rtm of kairotic.mt (shares: the intervals between
8
+ ;; onsets, a negative share a silence), so that it can be merged with a map of pitches ({:pitches …}, the
9
+ ;; talea and color of an isorhythm) into a musical tree: the box does it with what reaches its right inlet,
10
+ ;; and its outlet 1 gives the bare :rtm map to merge elsewhere (merge, then vector :rtm %).
11
+ (let [;; Bjorklund: k ones and n − k zeros, the remainder paired again and again (Euclid's algorithm)
12
+ bjorklund (fn [k n]
13
+ (cond (<= n 0) []
14
+ (<= k 0) (vec (repeat n 0))
15
+ (>= k n) (vec (repeat n 1))
16
+ :else (loop [a (vec (repeat k [1])) b (vec (repeat (- n k) [0]))]
17
+ (if (<= (count b) 1)
18
+ (vec (apply concat (concat a b)))
19
+ (let [m (min (count a) (count b))]
20
+ (recur (mapv into (subvec a 0 m) (subvec b 0 m))
21
+ (if (> (count a) m) (subvec a m) (subvec b m))))))))
22
+ ;; a necklace read from pulse r on: the rhythm in a fixed position against the beat
23
+ rotate (fn [xs r] (let [n (count xs)] (if (zero? n) xs (let [r (mod r n)] (vec (concat (subvec xs r) (subvec xs 0 r)))))))
24
+ onsets-of (fn [ps] (vec (keep-indexed (fn [i x] (when (= 1 x) i)) ps)))
25
+ ;; the intervals between onsets, around the circle (3 3 2): the rhythm as a necklace
26
+ intervals-of (fn [ps] (let [os (onsets-of ps) n (count ps)]
27
+ (if (empty? os) [] (mapv (fn [a b] (- b a)) os (conj (subvec os 1) (+ n (first os)))))))
28
+ ;; the shares of an :rtm: from each onset to the next one (or the end of the bar); the pulses before the
29
+ ;; first onset a silence (a negative share): 01001001 → [-1 3 3 1]
30
+ shares-of (fn [ps] (let [os (onsets-of ps) n (count ps)]
31
+ (cond (zero? n) []
32
+ (empty? os) [(- n)]
33
+ :else (vec (concat (when (pos? (first os)) [(- (first os))])
34
+ (map (fn [a b] (- b a)) os (conj (subvec os 1) n)))))))
35
+ ;; the meter of a bar of n pulses, when none is asked: the pulse a written value
36
+ pow2? (fn [x] (and (pos? x) (== x (js/Math.pow 2 (js/Math.round (js/Math.log2 x))))))
37
+ meter-of (fn [n] (cond (and (>= n 4) (pow2? n)) [4 4]
38
+ (and (>= n 12) (zero? (mod n 3)) (pow2? (/ n 3))) [12 8]
39
+ (< n 4) [n 4]
40
+ (<= n 12) [n 8]
41
+ :else [n 16]))
42
+ ;; a meter asked for: [3 4], "3/4", "7/8[2+2+3]", or nil (as the pulses say)
43
+ meter-arg (fn [v] (cond (and (sequential? v) (= 2 (count v)) (every? number? v)) (vec v)
44
+ (string? v) v
45
+ (keyword? v) (name v)
46
+ :else nil))
47
+ ;; pitches, as theory boxes take them: Hz by default, MIDI with midi; the MIDI notes kept to 3 decimals
48
+ hz->m (fn [x] (when (and (number? x) (pos? x)) (/ (js/Math.round (* 1000 (+ 69 (* 12 (js/Math.log2 (/ x 440)))))) 1000)))
49
+ ;; what reaches the right inlet, as the pitches of the :rtm (or nil, to forget them): a map of pitches
50
+ ;; ({:pitches …} or {:pitch …}, kept as they are), a pattern ({:note [...]}, MIDI;
51
+ ;; nil a rest), a melody string ("c4 e4 g4"), a list of pitches (Hz, as a keyboard sends the keys held;
52
+ ;; MIDI with midi), a list of notes or chords of a tree, or one pitch
53
+ pitches-of (fn [midi? v]
54
+ (let [p (fn [x] (if midi? x (hz->m x)))]
55
+ (cond (#{:clear} v) nil
56
+ (map? v) (cond (or (contains? v :pitches) (contains? v :pitch)) (select-keys v [:pitches :pitch])
57
+ (sequential? (:note v)) {:pitches (mapv (fn [x] (if (number? x) x "r")) (:note v))}
58
+ :else :ignore)
59
+ (string? v) {:pitches v}
60
+ (number? v) (if-let [m (p v)] {:pitch m} :ignore)
61
+ (and (sequential? v) (keyword? (first v))) {:pitches [v]}
62
+ (and (sequential? v) (seq v) (every? number? v)) (let [ms (vec (keep p v))] (if (seq ms) {:pitches ms} :ignore))
63
+ (and (sequential? v) (seq v)) {:pitches (vec v)}
64
+ :else :ignore)))
65
+ ;; the color goes on over the bars: bar i begins where the notes of the bar before left it
66
+ tokens (fn [ps] (cond (string? ps) (vec (remove #{""} (.split (.trim ps) (js/RegExp. "\\s+"))))
67
+ (sequential? ps) (vec ps)
68
+ :else nil))
69
+ color-at (fn [pm skip]
70
+ (let [ts (tokens (:pitches pm))]
71
+ (if (or (empty? ts) (zero? (mod skip (count ts))))
72
+ pm
73
+ (let [r (mod skip (count ts)) ts2 (vec (concat (subvec ts r) (subvec ts 0 r)))]
74
+ (assoc pm :pitches (if (string? (:pitches pm)) (apply str (interpose " " ts2)) ts2))))))
75
+ ;; everything the box knows: its words, changed by messages
76
+ params (fn [args st]
77
+ (let [o (merge args (:over st))
78
+ n (max 1 (js/Math.round (or (:n o) 8)))]
79
+ {:n n :k (api/clamp (js/Math.round (or (:k o) 3)) 0 n) :rotation (mod (js/Math.round (or (:rotation o) 0)) n)
80
+ :bars (api/clamp (js/Math.round (or (:bars o) 1)) 1 64) :meter (or (:meter o) (meter-of n))}))
81
+ ;; the rhythm as data: the pulses, its necklace, and the :rtm with the pitches merged
82
+ rhythm (fn [{:keys [k n rotation bars meter]} pm]
83
+ (let [ps (rotate (bjorklund k n) rotation)
84
+ rtm (merge {:shares (shares-of ps)} (or pm {}))
85
+ bar (fn [i] (let [a (color-at rtm (* i k))]
86
+ (if (zero? i) [:measure {:meter meter} [:rtm a]] [:measure [:rtm a]])))]
87
+ {:pulses ps :onsets (onsets-of ps) :intervals (intervals-of ps) :rtm rtm
88
+ :tree (into [:voice] (map bar (range bars)))}))
89
+ shown-of (fn [p r] (merge (select-keys p [:k :n :rotation :bars]) (select-keys r [:pulses :onsets :intervals])))
90
+ ;; what goes out: the tree (0), the :rtm map (1), the pulses (2), the last first (as Max does)
91
+ outs (fn [r] [[2 (:pulses r)] [1 (:rtm r)] [0 (:tree r)]])
92
+ ;; a change: sent when what it makes is new (the same again changes nothing); a bang sends it anyway
93
+ changed (fn [args st over always?]
94
+ (let [st2 (assoc st :over over) p (params args st2) r (rhythm p (:pm st2))]
95
+ (if (and (not always?) (= (:tree r) (:sent st)))
96
+ {:state st2 :show (shown-of p r)}
97
+ {:state (assoc st2 :sent (:tree r)) :show (shown-of p r) :out (outs r)})))
98
+ polar (fn [cx cy R i n] (let [a (* 2 js/Math.PI (/ i n))] [(+ cx (* R (js/Math.sin a))) (- cy (* R (js/Math.cos a)))]))]
99
+ {;; ── about ──
100
+ :class "euclid"
101
+ :license "MPL-2.0"
102
+ :doc "A Euclidean rhythm (Bjorklund's algorithm, after Toussaint): k onsets spread as evenly as they can be over n pulses — euclid 3 8 is the tresillo (3-3-2), euclid 5 8 the cinquillo, euclid 5 16 a rotation of the bossa nova, euclid 7 12 the bembé. Drawn as a necklace: the pulses around a circle, time clockwise from the top, the onsets joined into a polygon; pressing a pulse makes the rhythm start there (a rotation). A bang sends it; [:k 5], [:n 16], [:rotation 2], [:bars 4], [:meter \"3/4\"] (or a map of them) change it and send it when it is new, a number is k. Rhythm apart from pitch: out of the left outlet a musical tree, a bar of n pulses (4/4 for 8 or 16, 12/8 for 12, n/8 up to 12, else n/16; [:meter …] for another) with an :rtm whose shares are the intervals between onsets (a negative share a silence); bars repeat it, the pitches going on. Its right inlet (cold) takes the pitches the notes take in turn, starting again when they run out (talea and color): a map with :pitches or :pitch (kept as it is), a pattern ({:note [...]}), a melody string (\"c4 e4 g4\"), a list of Hz (the keys held on a keyboard; MIDI with midi), notes or chords of a tree; :clear forgets them (every note c4). Outlet 1 is the :rtm map alone ({:shares [3 3 2] :pitches …}), to merge with other pitches (merge) and write as a node (vector :rtm %); outlet 2 the pulses, ones and zeros ([1 0 0 1 0 0 1 0])."
103
+ :usage "euclid [k 3] [n 8] [rotation 0] [bars 1] [midi]"
104
+ :io [2 3]
105
+ :size [180 200]
106
+
107
+ ;; ── arguments ──
108
+ :args [[:k 3] [:n 8] [:rotation 0] [:bars 1] [:midi false]]
109
+
110
+ ;; ── logic ──
111
+ :receive (fn [{:keys [inlet value state args]}]
112
+ (let [st (or state {:over {} :pm nil})
113
+ over (:over st)
114
+ set-over (fn [m] (changed args st (merge over m) false))]
115
+ (if (= inlet 1)
116
+ (let [pm (pitches-of (:midi args) value)]
117
+ (if (= pm :ignore) {} {:state (assoc st :pm pm)}))
118
+ (cond
119
+ (#{:bang} value) (changed args st over true)
120
+ (number? value) (set-over {:k value})
121
+ (and (vector? value) (= :pressed (first value)) (number? (second value)))
122
+ (let [p (params args st)] (set-over {:rotation (+ (:rotation p) (second value))}))
123
+ (and (vector? value) (= 2 (count value)) (#{:k :n :rotation :bars} (first value)) (number? (second value)))
124
+ (set-over {(first value) (second value)})
125
+ (and (vector? value) (= :meter (first value))) (set-over {:meter (meter-arg (second value))})
126
+ (map? value) (set-over (cond-> (select-keys value [:k :n :rotation :bars])
127
+ (contains? value :meter) (assoc :meter (meter-arg (:meter value)))))
128
+ :else {}))))
129
+ ;; pressing a pulse: the rhythm starts there (sent once, on release)
130
+ :gesture (fn [{:keys [up hit]}] (when (and up (number? hit)) [:pressed hit]))
131
+
132
+ ;; ── view ──
133
+ :draw (fn [{:keys [shown w h args]}]
134
+ (let [p (or shown (let [n (max 1 (js/Math.round (or (:n args) 8)))
135
+ k (api/clamp (js/Math.round (or (:k args) 3)) 0 n)
136
+ ps (rotate (bjorklund k n) (or (:rotation args) 0))]
137
+ {:k k :n n :pulses ps :onsets (onsets-of ps) :intervals (intervals-of ps)}))
138
+ n (:n p) ps (:pulses p) os (:onsets p)
139
+ cx (/ w 2) cy (/ (- h 30) 2) R (- (min cx cy) 16)
140
+ r (cond (> n 32) 2.2 (> n 16) 3 :else 4.5)]
141
+ (concat
142
+ [[:circle {:cx cx :cy cy :r R :stroke :grid}]]
143
+ ;; the start of the bar, at the top
144
+ (let [[x1 y1] (polar cx cy (- R 9) 0 n) [x2 y2] (polar cx cy (+ R 9) 0 n)]
145
+ [[:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1.5 :opacity 0.8}]])
146
+ (when (> (count os) 1) [[:path {:points (mapv (fn [i] (polar cx cy R i n)) os) :closed true :stroke :accent :weight 2}]])
147
+ (for [i (range n)]
148
+ (let [[x y] (polar cx cy R i n) on (= 1 (nth ps i 0))]
149
+ [:group {:hit i}
150
+ [[:circle {:cx x :cy y :r (if on (+ r 1.5) r) :fill (if on :accent :bg) :stroke (if on :accent :soft)}]]]))
151
+ [[:text {:x cx :y (- h 15) :anchor :middle :size 10 :fill :ink}
152
+ (str "E(" (:k p) "," n ")" (when (pos? (or (:rotation p) 0)) (str " ↻" (:rotation p))))]
153
+ [:text {:x cx :y (- h 3) :anchor :middle :size 9 :fill :soft}
154
+ (if (seq (:intervals p)) (apply str (interpose "-" (:intervals p))) "silence")]])))})
@@ -0,0 +1,194 @@
1
+ ;; necklace · a cyclic rhythm on the circle, and its geometry (Toussaint)
2
+ ;; Part of @kairotic/rhythm. Written against the Kairotic API (api/…).
3
+ ;; A rhythm that repeats is a necklace: k onsets among n pulses around a circle, time clockwise from the
4
+ ;; top. Seen so, it is the same object as a pitch-class set on pcclock, and the same geometry measures it
5
+ ;; (Toussaint, "The Geometry of Musical Rhythm"): its full-interval vector (how often each distance between
6
+ ;; onsets occurs), its evenness (the sum of the chords between all pairs of onsets, after Block and Douthett;
7
+ ;; arcs are too coarse: the six 4/4 claves would all score the same), whether it is deep (each distance a
8
+ ;; different number of times, as the diatonic scale and the bembé), flat (each distance once), its axes of
9
+ ;; mirror symmetry, its longest gap, rhythmic oddity (no two onsets halving the cycle), and whether it is a
10
+ ;; rotation of the Euclidean rhythm E(k,n). Pressing a pulse adds or takes away an onset: the necklace is
11
+ ;; also an editor. What it sends is as euclid's — a musical tree, its :rtm map, its pulses —, so it merges
12
+ ;; with pitches the same way (the right inlet, or merge with outlet 1), and its measures go out on the right.
13
+ (let [TAU (* 2 js/Math.PI)
14
+ bjorklund (fn [k n]
15
+ (cond (<= n 0) []
16
+ (<= k 0) (vec (repeat n 0))
17
+ (>= k n) (vec (repeat n 1))
18
+ :else (loop [a (vec (repeat k [1])) b (vec (repeat (- n k) [0]))]
19
+ (if (<= (count b) 1)
20
+ (vec (apply concat (concat a b)))
21
+ (let [m (min (count a) (count b))]
22
+ (recur (mapv into (subvec a 0 m) (subvec b 0 m))
23
+ (if (> (count a) m) (subvec a m) (subvec b m))))))))
24
+ rotate (fn [xs r] (let [n (count xs)] (if (zero? n) xs (let [r (mod r n)] (vec (concat (subvec xs r) (subvec xs 0 r)))))))
25
+ onsets-of (fn [ps] (vec (keep-indexed (fn [i x] (when (= 1 x) i)) ps)))
26
+ intervals-of (fn [ps] (let [os (onsets-of ps) n (count ps)]
27
+ (if (empty? os) [] (mapv (fn [a b] (- b a)) os (conj (subvec os 1) (+ n (first os)))))))
28
+ shares-of (fn [ps] (let [os (onsets-of ps) n (count ps)]
29
+ (cond (zero? n) []
30
+ (empty? os) [(- n)]
31
+ :else (vec (concat (when (pos? (first os)) [(- (first os))])
32
+ (map (fn [a b] (- b a)) os (conj (subvec os 1) n)))))))
33
+ r3 (fn [x] (/ (js/Math.round (* 1000 x)) 1000))
34
+ ;; ── what arrives, as pulses (ones and zeros), or nil when it is not a rhythm ──
35
+ whole? (fn [x] (and (number? x) (== x (js/Math.round x))))
36
+ from-shares (fn [sh] (when (and (sequential? sh) (seq sh) (every? (fn [x] (and (whole? x) (not (zero? x)))) sh))
37
+ (vec (mapcat (fn [x] (if (pos? x) (cons 1 (repeat (dec x) 0)) (repeat (- x) 0))) sh))))
38
+ from-onsets (fn [os n] (when (and (whole? n) (pos? n) (sequential? os) (every? whole? os))
39
+ (let [on (set (map (fn [o] (mod o n)) os))] (mapv (fn [i] (if (on i) 1 0)) (range n)))))
40
+ ;; the first :rtm of a tree (as euclid sends it)
41
+ rtm-in (fn rtm-in [t] (when (sequential? t)
42
+ (if (= :rtm (first t)) (second t) (some rtm-in (filter sequential? t)))))
43
+ ;; a list: ones and zeros are pulses; other whole numbers, the intervals between onsets (3 3 2)
44
+ pulses-of-list (fn [v] (when (and (sequential? v) (seq v) (every? whole? v))
45
+ (if (every? #{0 1} v) (vec v) (when (every? pos? v) (from-shares v)))))
46
+ pulses-of (fn [v]
47
+ (cond
48
+ ;; box notation (TUBS): "x..x..x." (x, X or 1 an onset; . - _ or 0 a pulse without one)
49
+ (string? v) (let [cs (remove #{" "} (seq v))]
50
+ (when (and (seq cs) (every? #{"x" "X" "1" "." "-" "_" "0"} cs))
51
+ (mapv (fn [c] (if (#{"x" "X" "1"} c) 1 0)) cs)))
52
+ (map? v) (cond (contains? v :shares) (from-shares (:shares v))
53
+ (contains? v :pulses) (pulses-of-list (:pulses v))
54
+ (contains? v :onsets) (from-onsets (:onsets v) (:n v)))
55
+ (and (sequential? v) (keyword? (first v))) (some-> (rtm-in v) :shares from-shares)
56
+ :else nil))
57
+ ;; ── its geometry ──
58
+ dist (fn [n a b] (let [d (js/Math.abs (- a b))] (min d (- n d))))
59
+ pairs (fn [os] (for [i (range (count os)) j (range (inc i) (count os))] [(nth os i) (nth os j)]))
60
+ ivec-of (fn [n os] (let [c (frequencies (map (fn [[a b]] (dist n a b)) (pairs os)))]
61
+ (mapv (fn [d] (get c d 0)) (range 1 (inc (quot n 2))))))
62
+ evenness-of (fn [n os] (reduce + 0 (map (fn [[a b]] (* 2 (js/Math.sin (/ (* js/Math.PI (dist n a b)) n)))) (pairs os))))
63
+ ;; the axes of mirror symmetry, in pulses: x → a − x keeps the set; the axis passes through a/2 (and a/2 + n/2)
64
+ axes-of (fn [n os] (let [s (set os)]
65
+ (if (empty? s) []
66
+ (vec (for [a (range n) :when (= s (set (map (fn [x] (mod (- a x) n)) os)))] (/ a 2))))))
67
+ measures (fn [ps]
68
+ (let [n (count ps) os (onsets-of ps) k (count os) iv (ivec-of n os) ev (evenness-of n os)
69
+ e (bjorklund k n) eev (evenness-of n (onsets-of e))
70
+ er (first (filter (fn [r] (= ps (rotate e r))) (range (max n 1))))]
71
+ {:n n :k k :onsets os :intervals (intervals-of ps) :ivec iv
72
+ :evenness (r3 ev) :even (if (pos? eev) (r3 (/ ev eev)) 1)
73
+ :deep (and (>= k 2) (= (count (distinct iv)) (count iv)))
74
+ :flat (and (seq iv) (every? #{1} iv))
75
+ :axes (axes-of n os)
76
+ :gap (if (seq os) (apply max (intervals-of ps)) n)
77
+ :oddity (or (odd? n) (not-any? (fn [[a b]] (= (* 2 (dist n a b)) n)) (pairs os)))
78
+ :euclid er}))
79
+ ;; ── as euclid sends a rhythm: the meter of a bar of n pulses, the pitches, the color over bars ──
80
+ pow2? (fn [x] (and (pos? x) (== x (js/Math.pow 2 (js/Math.round (js/Math.log2 x))))))
81
+ meter-of (fn [n] (cond (and (>= n 4) (pow2? n)) [4 4]
82
+ (and (>= n 12) (zero? (mod n 3)) (pow2? (/ n 3))) [12 8]
83
+ (< n 4) [n 4]
84
+ (<= n 12) [n 8]
85
+ :else [n 16]))
86
+ meter-arg (fn [v] (cond (and (sequential? v) (= 2 (count v)) (every? number? v)) (vec v)
87
+ (string? v) v
88
+ (keyword? v) (name v)
89
+ :else nil))
90
+ hz->m (fn [x] (when (and (number? x) (pos? x)) (/ (js/Math.round (* 1000 (+ 69 (* 12 (js/Math.log2 (/ x 440)))))) 1000)))
91
+ pitches-of (fn [midi? v]
92
+ (let [p (fn [x] (if midi? x (hz->m x)))]
93
+ (cond (#{:clear} v) nil
94
+ (map? v) (cond (or (contains? v :pitches) (contains? v :pitch)) (select-keys v [:pitches :pitch])
95
+ (sequential? (:note v)) {:pitches (mapv (fn [x] (if (number? x) x "r")) (:note v))}
96
+ :else :ignore)
97
+ (string? v) {:pitches v}
98
+ (number? v) (if-let [m (p v)] {:pitch m} :ignore)
99
+ (and (sequential? v) (keyword? (first v))) {:pitches [v]}
100
+ (and (sequential? v) (seq v) (every? number? v)) (let [ms (vec (keep p v))] (if (seq ms) {:pitches ms} :ignore))
101
+ (and (sequential? v) (seq v)) {:pitches (vec v)}
102
+ :else :ignore)))
103
+ tokens (fn [ps] (cond (string? ps) (vec (remove #{""} (.split (.trim ps) (js/RegExp. "\\s+"))))
104
+ (sequential? ps) (vec ps)
105
+ :else nil))
106
+ color-at (fn [pm skip]
107
+ (let [ts (tokens (:pitches pm))]
108
+ (if (or (empty? ts) (zero? (mod skip (count ts))))
109
+ pm
110
+ (let [r (mod skip (count ts)) ts2 (vec (concat (subvec ts r) (subvec ts 0 r)))]
111
+ (assoc pm :pitches (if (string? (:pitches pm)) (apply str (interpose " " ts2)) ts2))))))
112
+ rhythm (fn [ps st]
113
+ (let [k (count (onsets-of ps)) bars (:bars st) meter (or (:meter st) (meter-of (count ps)))
114
+ rtm (merge {:shares (shares-of ps)} (or (:pm st) {}))
115
+ bar (fn [i] (let [a (color-at rtm (* i k))]
116
+ (if (zero? i) [:measure {:meter meter} [:rtm a]] [:measure [:rtm a]])))]
117
+ {:rtm rtm :tree (into [:voice] (map bar (range bars)))}))
118
+ ;; what goes out (the last first, as Max does): the measures (3), the pulses (2), the :rtm map (1), the tree (0)
119
+ outs (fn [ps st] (let [r (rhythm ps st)] [[3 (measures ps)] [2 ps] [1 (:rtm r)] [0 (:tree r)]]))
120
+ ;; a new state: sent when the rhythm, its bars or its meter are new (the same again changes nothing); a bang anyway
121
+ settle (fn [st st2 always?]
122
+ (let [ps (:pulses st2) key [ps (:bars st2) (:meter st2)]
123
+ show (assoc (measures ps) :pulses ps)]
124
+ (cond (empty? ps) {:state st2}
125
+ (and (not always?) (= key (:sent st))) {:state st2 :show show}
126
+ :else {:state (assoc st2 :sent key) :show show :out (outs ps st2)})))
127
+ polar (fn [cx cy R i n] (let [a (* TAU (/ i n))] [(+ cx (* R (js/Math.sin a))) (- cy (* R (js/Math.cos a)))]))]
128
+ {;; ── about ──
129
+ :class "necklace"
130
+ :license "MPL-2.0"
131
+ :doc "A cyclic rhythm on the circle and its geometry (Toussaint): k onsets among n pulses around a circle, time clockwise from the top — the same object as a pitch-class set on pcclock. A rhythm arrives as pulses (ones and zeros, as euclid's right outlet sends them), as intervals between onsets ([3 3 2]), as box notation (\"x..x..x.\"), as an :rtm map ({:shares [3 3 2]}, euclid's middle outlet), a tree with an :rtm, or {:onsets [0 3 6] :n 8}; it is drawn as a polygon, with its axes of mirror symmetry. Pressing a pulse (or a number, its index) adds or takes away an onset. :complement swaps onsets and silences, [:rotate 1] starts it a pulse later, [:n 12] makes the circle longer or shorter, :clear empties it, [:bars 4] and [:meter \"3/4\"] as euclid, a bang sends it again. Out, as euclid: a musical tree (left: a bar of n pulses with an :rtm whose shares are the intervals between onsets), the :rtm map alone (1), the pulses (2); and its measures (3): {:n :k :onsets :intervals :ivec — how often each distance occurs —, :evenness — the sum of the chords between all pairs (Block and Douthett) —, :even — that sum against the Euclidean rhythm's, 1 as even as it —, :deep — each distance a different number of times —, :flat — each once —, :axes — of mirror symmetry, in pulses —, :gap — the longest interval —, :oddity — no two onsets halving the cycle —, :euclid — the rotation of E(k,n) it is, or nil}. Its right inlet (cold) takes the pitches the notes take in turn, as euclid's."
132
+ :usage "necklace [n 16] [bars 1] [midi]"
133
+ :io [2 4]
134
+ :size [200 240]
135
+
136
+ ;; ── arguments ──
137
+ :args [[:n 16] [:bars 1] [:midi false]]
138
+
139
+ ;; ── logic ──
140
+ :receive (fn [{:keys [inlet value state args]}]
141
+ (let [st (or state {:pulses (vec (repeat (max 1 (js/Math.round (or (:n args) 16))) 0))
142
+ :bars (api/clamp (js/Math.round (or (:bars args) 1)) 1 64) :meter nil :pm nil})
143
+ ps (:pulses st) n (count ps)
144
+ to (fn [m] (settle st (merge st m) false))
145
+ toggle (fn [i] (let [i (mod (js/Math.round i) n)] (to {:pulses (update ps i (fn [x] (- 1 x)))})))]
146
+ (if (= inlet 1)
147
+ (let [pm (pitches-of (:midi args) value)]
148
+ (if (= pm :ignore) {} {:state (assoc st :pm pm)}))
149
+ (cond
150
+ (#{:bang} value) (settle st st true)
151
+ (#{:clear} value) (to {:pulses (vec (repeat n 0))})
152
+ (#{:complement} value) (to {:pulses (mapv (fn [x] (- 1 x)) ps)})
153
+ (number? value) (toggle value)
154
+ (and (vector? value) (= :pressed (first value)) (number? (second value))) (toggle (second value))
155
+ (and (vector? value) (= :rotate (first value)) (number? (second value))) (to {:pulses (rotate ps (js/Math.round (second value)))})
156
+ (and (vector? value) (= :n (first value)) (number? (second value)))
157
+ (let [m (api/clamp (js/Math.round (second value)) 1 128)]
158
+ (to {:pulses (vec (take m (concat ps (repeat 0))))}))
159
+ (and (vector? value) (= :bars (first value)) (number? (second value))) (to {:bars (api/clamp (js/Math.round (second value)) 1 64)})
160
+ (and (vector? value) (= :meter (first value))) (to {:meter (meter-arg (second value))})
161
+ :else (if-let [p (or (pulses-of-list value) (pulses-of value))]
162
+ (to {:pulses p})
163
+ {})))))
164
+ ;; pressing a pulse adds or takes away an onset (sent once, on release)
165
+ :gesture (fn [{:keys [up hit]}] (when (and up (number? hit)) [:pressed hit]))
166
+
167
+ ;; ── view ──
168
+ :draw (fn [{:keys [shown w h args]}]
169
+ (let [p (or shown (let [ps (vec (repeat (max 1 (js/Math.round (or (:n args) 16))) 0))] (assoc (measures ps) :pulses ps)))
170
+ n (:n p) ps (:pulses p) os (:onsets p)
171
+ cx (/ w 2) cy (/ (- h 44) 2) R (- (min cx cy) 16)
172
+ r (cond (> n 32) 2.2 (> n 16) 3 :else 4.5)
173
+ flags (remove nil? [(str "even " (:even p))
174
+ (let [a (count (:axes p))] (case a 0 "asymmetric" 1 "1 axis" (str a " axes")))
175
+ (when (:deep p) "deep") (when (:flat p) "flat")
176
+ (when (and (even? n) (:oddity p) (pos? (:k p))) "oddity")
177
+ (when (:euclid p) (str "E(" (:k p) "," n ")" (when (pos? (:euclid p)) (str " ↻" (:euclid p)))))])]
178
+ (concat
179
+ [[:circle {:cx cx :cy cy :r R :stroke :grid}]]
180
+ (let [[x1 y1] (polar cx cy (- R 9) 0 n) [x2 y2] (polar cx cy (+ R 9) 0 n)]
181
+ [[:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1.5 :opacity 0.8}]])
182
+ ;; the axes of symmetry, across the circle
183
+ (for [a (:axes p)]
184
+ (let [[x1 y1] (polar cx cy (+ R 7) a n) [x2 y2] (polar cx cy (+ R 7) (+ a (/ n 2)) n)]
185
+ [:line {:x1 x1 :y1 y1 :x2 x2 :y2 y2 :stroke :kairos :weight 1 :opacity 0.5}]))
186
+ (when (> (count os) 1) [[:path {:points (mapv (fn [i] (polar cx cy R i n)) os) :closed true :stroke :accent :weight 2}]])
187
+ (for [i (range n)]
188
+ (let [[x y] (polar cx cy R i n) on (= 1 (nth ps i 0))]
189
+ [:group {:hit i}
190
+ [[:circle {:cx x :cy y :r (if on (+ r 1.5) r) :fill (if on :accent :bg) :stroke (if on :accent :soft)}]]]))
191
+ [[:text {:x cx :y (- h 29) :anchor :middle :size 10 :fill :ink}
192
+ (str (:k p) "/" n " · " (if (seq (:intervals p)) (apply str (interpose "-" (:intervals p))) "silence"))]
193
+ [:text {:x cx :y (- h 16) :anchor :middle :size 9 :fill :soft} (str "<" (apply str (interpose " " (:ivec p))) ">")]
194
+ [:text {:x cx :y (- h 3) :anchor :middle :size 9 :fill :soft} (apply str (interpose " · " flags))]])))})