{
  "title": "Drums CSV",
  "format": "drums",
  "applicable_tracks": "Tracks 5–6",
  "release": "LABS RC1 / Checkpoint 072",
  "checkpoint": "a45dad7",
  "header_count": 21,
  "legacy_header_count": 20,
  "header_order_verified": true,
  "header_source": "tests/fixtures/SymphonyCSV_Drums_Pan_QA_21col.csv",
  "documented_semantics": "Field meanings based on 2026-11-19 developer dictionary, with RC1 panning fields verified by current integration tests. Runtime validator determines actual acceptance.",
  "headers": [
    "composition_title",
    "composition_total_measures",
    "composition_end_tick",
    "tempo_bpm",
    "time_signature",
    "ticks_per_quarter",
    "event_id",
    "event_type",
    "measure",
    "absolute_tick",
    "onset_tick_in_measure",
    "timing_offset_ms",
    "duration_ticks",
    "surface_id",
    "articulation",
    "variant_id",
    "velocity",
    "note_off_velocity",
    "note_off_method",
    "choke_group",
    "Pan_Position"
  ],
  "columns": [
    {
      "position": 1,
      "name": "composition_title",
      "value_type": "Text",
      "authority": "Composition or performer",
      "requirement": "Required event/composition value",
      "section": "Composition",
      "description": "Shared song title; identifies which composition the drum part belongs to.",
      "accepted_values_and_units": "Nonblank text",
      "blank_means": "Required."
    },
    {
      "position": 2,
      "name": "composition_total_measures",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Composition",
      "description": "Full count of bars in the piece, including measures with no drum hits.",
      "accepted_values_and_units": "Positive integer",
      "blank_means": "Required; must match other tracks."
    },
    {
      "position": 3,
      "name": "composition_end_tick",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Composition",
      "description": "Absolute closing barline tick of the final full measure.",
      "accepted_values_and_units": "Nonnegative integer",
      "blank_means": "Required; do not use last hit time as song end."
    },
    {
      "position": 4,
      "name": "tempo_bpm",
      "value_type": "Decimal",
      "authority": "Composition or performer",
      "requirement": "Required event/composition value",
      "section": "Composition",
      "description": "Quarter-note tempo of the composition.",
      "accepted_values_and_units": "Positive BPM number",
      "blank_means": "Required; must match the rest of the song."
    },
    {
      "position": 5,
      "name": "time_signature",
      "value_type": "Text",
      "authority": "Composition or performer",
      "requirement": "Required event/composition value",
      "section": "Composition",
      "description": "Shared musical meter.",
      "accepted_values_and_units": "Meter text such as 4/4",
      "blank_means": "Required; must match the rest of the song."
    },
    {
      "position": 6,
      "name": "ticks_per_quarter",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Timing",
      "description": "Tick resolution defining the drum timeline.",
      "accepted_values_and_units": "Positive integer; verified sample uses 480",
      "blank_means": "Required; must match the rest of the song."
    },
    {
      "position": 7,
      "name": "event_id",
      "value_type": "Text",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Event identity",
      "description": "Unique identifier for this drum event; use it to review edits.",
      "accepted_values_and_units": "Text, e.g. DR0001",
      "blank_means": "Required for drum event rows."
    },
    {
      "position": 8,
      "name": "event_type",
      "value_type": "Text",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Event identity",
      "description": "Type of drum event represented.",
      "accepted_values_and_units": "hit in verified sample; other values require validator confirmation",
      "blank_means": "Required; do not invent a new type."
    },
    {
      "position": 9,
      "name": "measure",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Timing",
      "description": "One-based measure containing the event onset.",
      "accepted_values_and_units": "Positive integer within declared length",
      "blank_means": "Required for events."
    },
    {
      "position": 10,
      "name": "absolute_tick",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Timing",
      "description": "Absolute attack tick since composition start.",
      "accepted_values_and_units": "Nonnegative integer",
      "blank_means": "Required for timed events."
    },
    {
      "position": 11,
      "name": "onset_tick_in_measure",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Timing",
      "description": "Attack offset in ticks relative to the start of this bar.",
      "accepted_values_and_units": "Nonnegative integer less than measure tick length",
      "blank_means": "Required for timed events."
    },
    {
      "position": 12,
      "name": "timing_offset_ms",
      "value_type": "Decimal",
      "authority": "Composition or performer",
      "requirement": "Conditional / optional / derived",
      "section": "Performance",
      "description": "Optional microtiming deviation in milliseconds from the grid-aligned hit.",
      "accepted_values_and_units": "Signed/unsigned millisecond value; exact accepted bounds need validator check",
      "blank_means": "No performance offset; retain blank."
    },
    {
      "position": 13,
      "name": "duration_ticks",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Required event/composition value",
      "section": "Timing",
      "description": "Length in ticks assigned to the trigger/release event, not necessarily acoustic sample tail.",
      "accepted_values_and_units": "Positive integer ticks in hit examples",
      "blank_means": "Required for hit scheduling."
    },
    {
      "position": 14,
      "name": "surface_id",
      "value_type": "Text",
      "authority": "Composition or performer",
      "requirement": "Required event/composition value",
      "section": "Drum surface",
      "description": "Musical playing surface such as kick or snare, independent of the loaded SoundFont mapping.",
      "accepted_values_and_units": "Surface identifier; verified values include kick_1, snare_1, hihat_1",
      "blank_means": "Required for a hit; kit mapping resolves actual MIDI note."
    },
    {
      "position": 15,
      "name": "articulation",
      "value_type": "Text",
      "authority": "Composition or performer",
      "requirement": "Conditional / optional / derived",
      "section": "Drum surface",
      "description": "Surface-specific way of striking, e.g. closed hi-hat.",
      "accepted_values_and_units": "Text; closed and open appear in verified fixture",
      "blank_means": "Blank means standard/unspecified articulation for the surface."
    },
    {
      "position": 16,
      "name": "variant_id",
      "value_type": "Text",
      "authority": "Timeline / event metadata",
      "requirement": "Conditional / optional / derived",
      "section": "Drum surface",
      "description": "Optional sample/performance variation within an articulation or kit.",
      "accepted_values_and_units": "Text identifier resolved by drum kit/mapping",
      "blank_means": "No variant selected."
    },
    {
      "position": 17,
      "name": "velocity",
      "value_type": "Integer",
      "authority": "Composition or performer",
      "requirement": "Required event/composition value",
      "section": "Performance",
      "description": "Attack intensity for this individual hit.",
      "accepted_values_and_units": "Integer 1–127",
      "blank_means": "Required for a sounding hit."
    },
    {
      "position": 18,
      "name": "note_off_velocity",
      "value_type": "Integer",
      "authority": "Timeline / event metadata",
      "requirement": "Conditional / optional / derived",
      "section": "MIDI output",
      "description": "Optional MIDI release strength for this hit.",
      "accepted_values_and_units": "Integer 0–127 when applicable",
      "blank_means": "No explicit release velocity override."
    },
    {
      "position": 19,
      "name": "note_off_method",
      "value_type": "Text",
      "authority": "Timeline / event metadata",
      "requirement": "Conditional / optional / derived",
      "section": "MIDI output",
      "description": "MIDI representation used when releasing the event.",
      "accepted_values_and_units": "Implementation/policy-specific; e.g. note_off or note_on_velocity_zero",
      "blank_means": "No explicit override; follow validated kit policy."
    },
    {
      "position": 20,
      "name": "choke_group",
      "value_type": "Text",
      "authority": "Timeline / event metadata",
      "requirement": "Conditional / optional / derived",
      "section": "Drum surface",
      "description": "Identifier linking sounds that cut each other off, such as exclusive cymbal/hi-hat groups.",
      "accepted_values_and_units": "Text group ID; playback support depends on kit mapping",
      "blank_means": "No choke group declared."
    },
    {
      "name": "Pan_Position",
      "value_type": "Integer",
      "authority": "Composer / performer",
      "requirement": "Optional stereo placement",
      "section": "Stereo placement",
      "description": "Places this musical note or drum hit in the stereo field; each event can be positioned independently.",
      "accepted_values_and_units": "Whole integer −100 (hard left) through 0 (centre) to +100 (hard right); fractional positions and values outside the range are rejected by RC1 pan validation.",
      "blank_means": "No authored pan override; preserve the loaded SoundFont’s native stereo placement. A blank is NOT the same as 0.",
      "example": "−40, 0, 70, or blank",
      "position": 21
    }
  ]
}
