Create Euclidean sequencer
create_euclidean_sequencerGenerate Euclidean rhythm patterns by specifying pulses and steps; the tool writes the beat sequence to a Table DAT and dispatches events to control parameters or cues on each active step.
Instructions
Build a Euclidean rhythm sequencer: given pulses evenly distributed across steps via Bjorklund's algorithm (with optional cyclic rotation), it writes the resulting on/off pattern to a Table DAT and fires one dispatch per active step on each beat boundary. The deterministic, mathematically-grounded sibling of create_beat_grid_sequencer — program rhythms by musical intent (e.g. E(3,8) tresillo, E(5,8) cinquillo, E(4,16) four-on-the-floor) rather than by hand-editing cells. Sweep the Pulses/Rotation custom parameters live and the table re-shapes in place. action=param sets a custom parameter to on_value/off_value per step; action=cue recalls a cue per active step (cues stored with manage_cue). NOTE: beat-callback timing is UNVERIFIED offline — check op().time.play if steps don't fire when the TD timeline is paused.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the sequencer COMP. | euclidean |
| parent_path | No | Parent COMP path to create the sequencer inside. | /project1 |
| target | Yes | COMP whose parameter or cue each active step fires on a beat boundary. | |
| steps | No | Number of steps in the Euclidean grid. | |
| pulses | No | Number of active pulses distributed evenly across `steps` via Bjorklund's algorithm. Clamped to <= steps at build time. | |
| rotation | No | Cyclic rotation of the generated pattern (downbeat offset). | |
| action | No | param: set a target custom-parameter value per active step; cue: recall a named cue per active step (cues stored with manage_cue). | param |
| param | No | (action=param) The custom-parameter name on the target COMP to set on each active step. | |
| on_value | No | (action=param) Value written into the table cell for active steps. | |
| off_value | No | (action=param) Value written into the table cell for inactive steps. | |
| bpm_source | No | Path to an existing Beat CHOP or tempo source. Omit to create a new Beat CHOP (on the global TD tempo). |