subsequence 0.6.4__py3-none-any.whl

subsequence/constants/instruments/roland_tr8s.py

@@ -0,0 +1,320 @@
+"""Roland TR-8S instrument definition.
+
+Note assignments and CC mappings for the Roland TR-8S drum machine.
+Note numbers correspond to the factory default trigger assignments
+for the 11 instrument tracks.  CC numbers are from the official MIDI
+Implementation Chart (Version 1.10, 2018-10-04).
+
+Three ways to use this module:
+
+1. **As a drum_note_map** - pass ``ROLAND_TR8S_DRUM_MAP`` to the ``drum_note_map``
+   parameter of ``@composition.pattern()`` and use track names like ``"bd"``
+   or ``"sd"`` in your pattern builder calls::
+
+       import subsequence.constants.instruments.roland_tr8s as tr8s
+
+       @composition.pattern(channel=9, beats=4, drum_note_map=tr8s.ROLAND_TR8S_DRUM_MAP)
+       def drums (p):
+           p.hit_steps("bd", [0, 4, 8, 12], velocity=127)
+
+2. **As a cc_name_map** - pass ``ROLAND_TR8S_CC_MAP`` to the ``cc_name_map``
+   parameter of ``@composition.pattern()`` and use human-readable CC names::
+
+       import subsequence.constants.instruments.roland_tr8s as tr8s
+
+       @composition.pattern(channel=9, beats=4,
+           drum_note_map=tr8s.ROLAND_TR8S_DRUM_MAP,
+           cc_name_map=tr8s.ROLAND_TR8S_CC_MAP)
+       def drums (p):
+           p.hit_steps("bd", [0, 4, 8, 12], velocity=127)
+           p.cc("bd_tune", 64)
+           p.cc_ramp("bd_decay", 40, 100, shape="ease_in")
+
+3. **As constants** - reference note numbers and CC numbers directly::
+
+       import subsequence.constants.instruments.roland_tr8s as tr8s
+
+       p.hit_steps(tr8s.BD, [0, 4, 8, 12], velocity=127)
+       p.cc(tr8s.BD_TUNE, 64)
+
+``ROLAND_TR8S_DRUM_MAP`` also accepts General MIDI drum names — the unnumbered
+``"kick"`` / ``"snare"`` / ``"crash"`` / ``"ride"`` primaries as well as the
+numbered ``"kick_1"``, ``"hi_hat_closed"``, ``"side_stick"``, etc. — as aliases
+for the matching TR-8S voices, a *faithful* subset only, covering the voices
+the machine genuinely has.  This lets GM-named patterns play on the TR-8S and
+lets it take part in symbolic mirroring (each device re-resolves a shared drum
+name through its own map).  Voices the TR-8S lacks (cowbell, tambourine,
+congas, splash/Chinese cymbals, …) are intentionally not aliased — naming one
+anyway is dropped with a one-time warning (never a wrong voice).  Canonical
+GM names come from `pymididefs.drums <https://github.com/simonholliday/PyMidiDefs>`_
+(``GM_DRUM_MAP``).
+
+Note: The TR-8S CC assignments are instrument-specific and overlap with
+standard GM CC numbers in incompatible ways (e.g. CC 9 = Shuffle on the
+TR-8S, not a standard GM assignment).  This map does NOT extend GM_CC_MAP.
+"""
+
+import typing
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  Drum note constants
+# ═══════════════════════════════════════════════════════════════════════
+
+BD = 36          # Bass Drum
+SD = 38          # Snare Drum
+LT = 43          # Low Tom
+MT = 47          # Mid Tom
+HT = 50          # High Tom
+RS = 37          # Rim Shot
+HC = 39          # Hand Clap
+CH = 42          # Closed Hi-Hat
+OH = 46          # Open Hi-Hat
+CC = 49          # Crash Cymbal
+RC = 51          # Ride Cymbal
+
+# Alternate note numbers (configurable on UTILITY:MIDI:Inst Note)
+BD_ALT = 35
+SD_ALT = 40
+LT_ALT = 41
+MT_ALT = 45
+HT_ALT = 48
+RS_ALT = 56
+HC_ALT = 54
+CH_ALT = 44
+OH_ALT = 55
+CC_ALT = 61
+RC_ALT = 63
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  CC constants — global controls
+# ═══════════════════════════════════════════════════════════════════════
+
+SHUFFLE            = 9    # Shuffle amount
+EXTERNAL_IN_LEVEL  = 12   # External input level
+AUTO_FILL_IN       = 14   # Auto fill in on/off
+MASTER_FX_ON       = 15   # Master FX on/off
+DELAY_LEVEL        = 16   # Delay send level
+DELAY_TIME         = 17   # Delay time
+DELAY_FEEDBACK     = 18   # Delay feedback
+MASTER_FX_CTRL     = 19   # Master FX control knob
+AUTO_FILL_IN_MANUAL = 70  # Auto fill in manual trigger
+ACCENT             = 71   # Accent level
+REVERB_LEVEL       = 91   # Reverb send level
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  CC constants — per-instrument (Tune / Decay / Level / Ctrl)
+# ═══════════════════════════════════════════════════════════════════════
+
+# Bass Drum
+BD_TUNE  = 20
+BD_DECAY = 23
+BD_LEVEL = 24
+BD_CTRL  = 96
+
+# Snare Drum
+SD_TUNE  = 25
+SD_DECAY = 28
+SD_LEVEL = 29
+SD_CTRL  = 97
+
+# Low Tom
+LT_TUNE  = 46
+LT_DECAY = 47
+LT_LEVEL = 48
+LT_CTRL  = 102
+
+# Mid Tom
+MT_TUNE  = 49
+MT_DECAY = 50
+MT_LEVEL = 51
+MT_CTRL  = 103
+
+# High Tom
+HT_TUNE  = 52
+HT_DECAY = 53
+HT_LEVEL = 54
+HT_CTRL  = 104
+
+# Rim Shot
+RS_TUNE  = 55
+RS_DECAY = 56
+RS_LEVEL = 57
+RS_CTRL  = 105
+
+# Hand Clap
+HC_TUNE  = 58
+HC_DECAY = 59
+HC_LEVEL = 60
+HC_CTRL  = 106
+
+# Closed Hi-Hat
+CH_TUNE  = 61
+CH_DECAY = 62
+CH_LEVEL = 63
+CH_CTRL  = 107
+
+# Open Hi-Hat
+OH_TUNE  = 80
+OH_DECAY = 81
+OH_LEVEL = 82
+OH_CTRL  = 108
+
+# Crash Cymbal
+CC_TUNE  = 83
+CC_DECAY = 84
+CC_LEVEL = 85
+CC_CTRL  = 109
+
+# Ride Cymbal
+RC_TUNE  = 86
+RC_DECAY = 87
+RC_LEVEL = 88
+RC_CTRL  = 110
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  Drum note map
+# ═══════════════════════════════════════════════════════════════════════
+
+ROLAND_TR8S_DRUM_MAP: typing.Dict[str, int] = {
+	# Native TR-8S track names
+	"bd": BD,
+	"sd": SD,
+	"lt": LT,
+	"mt": MT,
+	"ht": HT,
+	"rs": RS,
+	"hc": HC,
+	"ch": CH,
+	"oh": OH,
+	"cc": CC,
+	"rc": RC,
+
+	# General MIDI aliases — *faithful correspondences only*, i.e. GM names for
+	# the voices the TR-8S genuinely has.  Canonical names come from
+	# ``pymididefs.drums`` (``GM_DRUM_MAP``).  This lets GM-named patterns play
+	# on the TR-8S and lets it take part in symbolic mirroring (each device
+	# re-resolves a shared drum name through its own map).  Voices the TR-8S
+	# lacks (cowbell, tambourine, congas, splash/Chinese cymbals, guiro, …) are
+	# deliberately NOT aliased — no creative approximations onto unrelated voices.
+	#
+	# Unnumbered "primary" aliases (the GM_DRUM_PRIMARY_ALIASES convention from
+	# pymididefs.drums): the bare name resolves to the same voice as the _1
+	# variant.  The TR-8S has a real kick / snare / crash / ride, so all four apply.
+	"kick":  BD,
+	"snare": SD,
+	"crash": CC,
+	"ride":  RC,
+
+	"kick_1": BD,
+	"kick_2": BD,
+	"snare_1": SD,
+	"snare_2": SD,
+	"side_stick": RS,			# GM 37 == TR-8S RS 37
+	"hand_clap": HC,			# GM 39 == TR-8S HC 39
+	"hi_hat_closed": CH,		# GM 42 == TR-8S CH 42
+	"hi_hat_pedal": CH,			# foot-closed hat -> the closed hi-hat voice
+	"hi_hat_open": OH,			# GM 46 == TR-8S OH 46
+	"crash_1": CC,				# GM 49 == TR-8S CC 49
+	"crash_2": CC,
+	"ride_1": RC,				# GM 51 == TR-8S RC 51
+	"ride_2": RC,
+
+	# GM's six toms onto the TR-8S's three, grouped by register (each TR-8S tom
+	# anchored on an exact note match: LT 43, MT 47, HT 50).
+	"low_floor_tom": LT,
+	"high_floor_tom": LT,
+	"low_tom": MT,
+	"low_mid_tom": MT,
+	"high_mid_tom": HT,
+	"high_tom": HT,
+}
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  CC name map
+# ═══════════════════════════════════════════════════════════════════════
+
+ROLAND_TR8S_CC_MAP: typing.Dict[str, int] = {
+	# Global controls
+	"shuffle":              SHUFFLE,
+	"external_in_level":    EXTERNAL_IN_LEVEL,
+	"auto_fill_in":         AUTO_FILL_IN,
+	"master_fx_on":         MASTER_FX_ON,
+	"delay_level":          DELAY_LEVEL,
+	"delay_time":           DELAY_TIME,
+	"delay_feedback":       DELAY_FEEDBACK,
+	"master_fx_ctrl":       MASTER_FX_CTRL,
+	"auto_fill_in_manual":  AUTO_FILL_IN_MANUAL,
+	"accent":               ACCENT,
+	"reverb_level":         REVERB_LEVEL,
+
+	# Bass Drum
+	"bd_tune":  BD_TUNE,
+	"bd_decay": BD_DECAY,
+	"bd_level": BD_LEVEL,
+	"bd_ctrl":  BD_CTRL,
+
+	# Snare Drum
+	"sd_tune":  SD_TUNE,
+	"sd_decay": SD_DECAY,
+	"sd_level": SD_LEVEL,
+	"sd_ctrl":  SD_CTRL,
+
+	# Low Tom
+	"lt_tune":  LT_TUNE,
+	"lt_decay": LT_DECAY,
+	"lt_level": LT_LEVEL,
+	"lt_ctrl":  LT_CTRL,
+
+	# Mid Tom
+	"mt_tune":  MT_TUNE,
+	"mt_decay": MT_DECAY,
+	"mt_level": MT_LEVEL,
+	"mt_ctrl":  MT_CTRL,
+
+	# High Tom
+	"ht_tune":  HT_TUNE,
+	"ht_decay": HT_DECAY,
+	"ht_level": HT_LEVEL,
+	"ht_ctrl":  HT_CTRL,
+
+	# Rim Shot
+	"rs_tune":  RS_TUNE,
+	"rs_decay": RS_DECAY,
+	"rs_level": RS_LEVEL,
+	"rs_ctrl":  RS_CTRL,
+
+	# Hand Clap
+	"hc_tune":  HC_TUNE,
+	"hc_decay": HC_DECAY,
+	"hc_level": HC_LEVEL,
+	"hc_ctrl":  HC_CTRL,
+
+	# Closed Hi-Hat
+	"ch_tune":  CH_TUNE,
+	"ch_decay": CH_DECAY,
+	"ch_level": CH_LEVEL,
+	"ch_ctrl":  CH_CTRL,
+
+	# Open Hi-Hat
+	"oh_tune":  OH_TUNE,
+	"oh_decay": OH_DECAY,
+	"oh_level": OH_LEVEL,
+	"oh_ctrl":  OH_CTRL,
+
+	# Crash Cymbal
+	"cc_tune":  CC_TUNE,
+	"cc_decay": CC_DECAY,
+	"cc_level": CC_LEVEL,
+	"cc_ctrl":  CC_CTRL,
+
+	# Ride Cymbal
+	"rc_tune":  RC_TUNE,
+	"rc_decay": RC_DECAY,
+	"rc_level": RC_LEVEL,
+	"rc_ctrl":  RC_CTRL,
+}

subsequence/constants/instruments/vermona_drm1_drums.py

@@ -0,0 +1,87 @@
+"""Vermona DRM1 MKIV drum note map.
+
+Note assignments for the Vermona DRM1 analog drum synthesizer.
+These note numbers correspond to the factory default trigger assignments.
+
+Two ways to use this module:
+
+1. **As a drum_note_map** - pass ``VERMONA_DRM1_DRUM_MAP`` to the ``drum_note_map`` parameter
+   of ``@composition.pattern()`` and use human-readable names like ``"kick"``
+   or ``"snare"`` in your pattern builder calls::
+
+       import subsequence.constants.instruments.vermona_drm1_drums as drm1
+
+       @composition.pattern(channel=10, beats=4, drum_note_map=drm1.VERMONA_DRM1_DRUM_MAP)
+       def drums (p):
+           p.hit_steps("kick", [0, 4, 8, 12], velocity=127)
+
+2. **As constants** - reference note numbers directly::
+
+       import subsequence.constants.instruments.vermona_drm1_drums as drm1
+
+       @composition.pattern(channel=10, beats=4)
+       def drums (p):
+           p.hit_steps(drm1.KICK, [0, 4, 8, 12], velocity=127)
+
+``VERMONA_DRM1_DRUM_MAP`` also accepts a *faithful* subset of General MIDI drum
+names (e.g. ``"kick_1"``, ``"snare_1"``, ``"hi_hat_closed"``) as aliases — only
+for the voices the DRM1 genuinely has (kick, snare, clap, hi-hats).  These
+shared GM names are what let the DRM1 take part in symbolic mirroring (each
+device re-resolves a drum name through its own map).  GM names for instruments
+the DRM1 lacks (toms, ride/crash cymbals, shakers, cowbell and other latin/aux
+percussion) are intentionally NOT aliased — naming one anyway is dropped with
+a one-time warning (never a wrong voice); address those by their native
+``drum_1`` / ``drum_2`` / ``multi`` names.  Canonical GM names come from
+`pymididefs.drums <https://github.com/simonholliday/PyMidiDefs>`_ (``GM_DRUM_MAP``).
+"""
+
+import typing
+
+
+# ─── Individual note constants ───────────────────────────────────────
+
+KICK = 36                # C2
+DRUM_1 = 45              # A2
+DRUM_2 = 50              # D3
+MULTI = 56               # G#3
+SNARE = 38               # D2
+HIHAT_1_CLOSED = 44      # G#2
+HIHAT_1_OPEN = 46        # A#2 (Cymbal)
+HIHAT_2_CLOSED = 49      # C#3
+HIHAT_2_OPEN = 51        # D#3 (Cymbal)
+CLAP = 39                # D#2
+
+
+# ─── Complete drum note map ──────────────────────────────────────────
+
+VERMONA_DRM1_DRUM_MAP: typing.Dict[str, int] = {
+	# Native DRM1 mapping
+	"kick": KICK,
+	"drum_1": DRUM_1,
+	"drum_2": DRUM_2,
+	"multi": MULTI,
+	"snare": SNARE,
+	"hihat_1_closed": HIHAT_1_CLOSED,
+	"hihat_1_open": HIHAT_1_OPEN,
+	"hihat_2_closed": HIHAT_2_CLOSED,
+	"hihat_2_open": HIHAT_2_OPEN,
+	"clap": CLAP,
+
+	# General MIDI aliases — *faithful correspondences only*, i.e. GM names for
+	# the voices the DRM1 genuinely has.  Canonical names come from
+	# ``pymididefs.drums`` (``GM_DRUM_MAP``); this is the shared vocabulary used
+	# by symbolic mirroring (each device re-resolves a drum name through its own
+	# map).  GM names for instruments the DRM1 lacks — toms, ride/crash cymbals,
+	# shakers, and latin/aux percussion — are deliberately NOT aliased: a
+	# "creative approximation" onto an unrelated voice (cowbell -> multi,
+	# cymbal -> hi-hat) was an over-reach.  Use the native ``drum_1`` /
+	# ``drum_2`` / ``multi`` names for those instead.
+	"kick_1": KICK,
+	"kick_2": KICK,
+	"snare_1": SNARE,
+	"snare_2": SNARE,
+	"hand_clap": CLAP,			# GM 39 == DRM1 CLAP 39
+	"hi_hat_closed": HIHAT_1_CLOSED,
+	"hi_hat_pedal": HIHAT_1_CLOSED,		# foot-closed hat -> the closed hi-hat voice
+	"hi_hat_open": HIHAT_1_OPEN,
+}

subsequence/constants/midi_notes.py

@@ -0,0 +1,29 @@
+"""MIDI note number constants.
+
+Maps note names to their MIDI note numbers (0–127). Convention: **C4 = 60** (Middle C),
+matching the MIDI Manufacturers Association standard and most DAWs (Ableton, Logic, Reaper).
+
+Notes are named ``<Pitch><Octave>`` for naturals and ``<Pitch>S<Octave>`` for sharps::
+
+    import subsequence.constants.midi_notes as notes
+
+    p.note(notes.A4, velocity=100)       # 69
+    p.arpeggio(chord.tones(notes.E2))    # 40
+    root = notes.C3                      # 48
+
+Range: C_NEG1 (0) through G9 (127). Sharps are provided (e.g. ``CS4`` for C♯4);
+flats are enharmonic equivalents (Db4 == CS4 == 61).
+
+Canonical source: `pymididefs <https://github.com/simonholliday/PyMidiDefs>`_.
+"""
+
+# Re-export everything from pymididefs.notes — all note constants (C_NEG1..G9),
+# lookup tables, and conversion functions.
+from pymididefs.notes import *  # noqa: F401,F403
+from pymididefs.notes import (  # noqa: F401 — explicit re-exports for type checkers
+	NOTE_CLASSES,
+	NOTE_NAMES,
+	SEMITONE_MAP,
+	name_to_note,
+	note_to_name,
+)

subsequence/constants/pulses.py

@@ -0,0 +1,17 @@
+"""Pulse-based MIDI timing constants.
+
+The sequencer uses **24 pulses per quarter note** (PPQN = 24) as its internal time base.
+These constants represent the number of pulses for each standard note duration.
+
+These are used internally by the sequencer engine. Pattern builders work in beats
+(see ``subsequence.constants.durations`` for beat-based constants).
+"""
+
+# MIDI Standards - number of pulses in each
+
+MIDI_THIRTYSECOND_NOTE = 3
+MIDI_SIXTEENTH_NOTE = 6
+MIDI_EIGHTH_NOTE = 12
+MIDI_QUARTER_NOTE = 24
+MIDI_HALF_NOTE = 48
+MIDI_WHOLE_NOTE = 96

subsequence/constants/velocity.py

@@ -0,0 +1,22 @@
+"""MIDI velocity constants.
+
+Velocity is the MIDI attack strength (0-127). These constants define sensible
+defaults for different musical contexts.
+"""
+
+# Primary defaults
+DEFAULT_VELOCITY = 100          # Most notes, hits, arpeggios
+DEFAULT_CHORD_VELOCITY = 90     # Chords and harmonic content (softer)
+
+# Generative / texture defaults — named so these values don't scatter as raw literals
+DEFAULT_GENERATIVE_VELOCITY = 80   # Generative melodic lines (lsystem, de_bruijn, evolve, branch, lorenz, …)
+DEFAULT_CA_VELOCITY = 60           # Cellular automata (cellular_1d / cellular_2d)
+GHOST_FILL_VELOCITY = 35           # Deliberately soft ghost-note layer
+
+# Velocity shaping boundaries
+VELOCITY_SHAPE_LOW = 64
+VELOCITY_SHAPE_HIGH = 127
+
+# MIDI standard range
+MIN_VELOCITY = 0
+MAX_VELOCITY = 127