# Irish Jig — 6/8 compound duple groove
# Reference: Celtic Rhythms for Drum Kit (Folklore & Fiction / csmaccath.com),
#            "The Complete Irish Drummer" (Tim Gillen), bodhran technique guides
# 6/8 = 2 compound beats of 3 eighth notes. Resolution 12 = 12 sixteenth-note steps per bar.
# Each 8th note = 2 steps. Compound beat 1 = steps 0-5; compound beat 2 = steps 6-11.
#
# Bodhran technique modelled:
#   DOWN stroke (X) on compound beat downbeats (steps 0, 6) — strong open skin hit.
#   UP tip (x)      on intermediate 8th notes — lighter, drier.
#   Cross-stick "tip" (note 37) simulates the bodhran drummer's knuckle/back stroke
#   on the skin ring: quieter, clickier, characteristic of traditional session playing.
#
# Step mapping (0-indexed) within a 12-step 6/8 bar:
#   Step 0 = compound beat 1 downbeat    (8th note 1)
#   Step 2 = "e" of compound beat 1      (8th note 2)
#   Step 4 = "a" of compound beat 1      (8th note 3)
#   Step 6 = compound beat 2 downbeat    (8th note 4)
#   Step 8 = "e" of compound beat 2      (8th note 5)
#   Step 10= "a" of compound beat 2      (8th note 6)
#   Odd steps = 16th-note subdivisions (rarely played in traditional jig)
# GM notes: 36=kick (low bodhran hit), 38=snare (accent), 37=cross-stick (bodhran tip),
#           42=HH (continuous 8ths), 48=hi-tom (tonal accent), 49=crash

#
# ── Step grid notation ────────────────────────────────────────────────────────
# Each character in a step grid represents one subdivision of the bar.
# Resolution controls how many steps per bar (16 = 16th notes in 4/4; 12 = 16th notes in 6/8).
#
#   X   Strong accent  — velocity = base_velocity × 1.00  (full hit / downbeat)
#   x   Medium accent  — velocity = base_velocity × 0.75  (firm stroke / upbeat)
#   o   Soft hit       — velocity = base_velocity × 0.55  (brush / light touch)
#   g   Ghost note     — velocity = base_velocity × 0.28  (barely audible, mostly felt)
#   .   Rest           — no note fired at this step
#
# Beat positions — 4/4 at resolution 16 (one char per 16th note):
#   pos  0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15
#        1  e1 +1 a1  2  e2 +2 a2  3  e3 +3 a3  4  e4 +4 a4
#   (1/+/2/+/3/+/4/+ = quarter beats; e = "e of"; a = "and-a of")
#
# Beat positions — 6/8 at resolution 12 (one char per 16th note):
#   pos  0  1  2  3  4  5  6  7  8  9 10 11
#        C1 .  e1 .  a1 .  C2 .  e2 .  a2 .
#   (C1/C2 = compound beat downbeats; each compound beat = 3 eighth notes = 6 steps)
#
# Swing / feel: the 'feel' field shifts odd-indexed steps (1,3,5,7…) forward in time.
#   straight   — no shift (all steps exactly on the grid)
#   swing_soft — odd steps delayed ~16 % of a step (light swing)
#   swing_hard — odd steps delayed ~34 % of a step (jazz/shuffle triplet feel)
#   laid_back  — same as straight with slower humanisation envelope
# ─────────────────────────────────────────────────────────────────────────────

name: Irish Jig
family: celtic
bpm_range: [100, 180]
time_signature: [6, 8]
resolution: 12
feel: straight

instruments:
  kick:    { note: 36, base_velocity: 100, velocity_range: 14, timing_jitter: 0.015, duration_beats: 0.10 }
  snare:   { note: 38, base_velocity: 88,  velocity_range: 18, timing_jitter: 0.018, duration_beats: 0.08 }
  cross:   { note: 37, base_velocity: 68,  velocity_range: 16, timing_jitter: 0.018, duration_beats: 0.06 }
  hihat:   { note: 42, base_velocity: 78,  velocity_range: 12, timing_jitter: 0.014, duration_beats: 0.07 }
  tom_hi:  { note: 48, base_velocity: 90,  velocity_range: 15, timing_jitter: 0.018, duration_beats: 0.10 }
  crash:   { note: 49, base_velocity: 95,  velocity_range: 8,  timing_jitter: 0.010, duration_beats: 0.22 }

humanization:
  timing_jitter: 0.018
  velocity_jitter: 14
  velocity_drift: 0.07

sections:
  intro:
    type: count_in
    hits: 4
    note: 42

  groove:
    bars: 1
    variations:
      - name: bodhran_down
        weight: 4
        # Classic bodhran feel: kick drives compound beats (0, 6), hi-hat continuous 8ths
        # with compound-beat accents. Snare accent on the 3rd 8th (steps 4, 10) gives
        # the characteristic "lilt" that distinguishes a jig from a march.
        # Soft kick at the end of each group (steps 5, 11) suggests the bodhran lift-tip.
        kick:  "X....xX....x"
        snare: "...x.....x.."
        hihat: "X.x.x.X.x.x."
      - name: bodhran_tip
        weight: 3
        # Cross-stick "tip" strokes on the 2nd and 5th 8th notes (steps 2, 8) add
        # the dry click of the bodhran stick's back face hitting the skin ring —
        # the defining texture of traditional session playing.
        kick:  "X....xX....x"
        cross: "..x...x....."
        hihat: "X.x.x.X.x.x."
      - name: swell
        weight: 2
        # "Swell" variation: kick adds a push on the 4th 8th note (step 6+1=7? no, step 4+2=6 = compound beat 2 downbeat).
        # Actually: kick on step 4 ("a" of group 1) adds weight before compound beat 2.
        # Snare and cross-stick together on upbeat steps for a denser sound.
        kick:  "X...X.X....x"
        snare: "...x.....x.."
        cross: "..x...x....."
        hihat: "X.x.x.X.x.x."

  fill:
    bars: 1
    variations:
      - name: snare_roll
        # Alternating snare/tom — leads into the next A-part repeat.
        snare:  "XxXxXxXxXxXx"
        tom_hi: "........X..."
        kick:   "X..........."
      - name: tom_groups
        # Groups of 3 on toms mirror the compound grouping of 6/8.
        tom_hi: "X..X..X....."
        snare:  "..........Xx"
        kick:   "X..........."

  crash:
    bars: 1
    variations:
      - name: standard
        crash: "X..........."
        kick:  "X..........."
        hihat: "X.x.x.X.x.x."

structure:
  fill_every: 8
  break_every: 0
  break_length: 1
  crash_after_fill: true
  dynamic_build: false