Musical CSV · Tracks 5–6
Drums CSV
Track 5 is Acoustic Drums; Track 6 is Electronic Drums. Both use the same event columns and a separate kit mapping.
How to author this format
Track 5 is Acoustic Drums, Track 6 is Electronic Drums. Both write events for named percussion surfaces. A kit-profile mapping resolves surfaces to the selected SoundFont; do not replace a surface ID with an arbitrary MIDI note number.
Keep exactly the supplied headers in their proper order. CSV supports commas inside quoted strings, and empty optional cells retain their position. Event rows are required for playable content; the header-only template is deliberately not playable.
All optional Pan_Position values use integer −100 to +100. Blank preserves the original SoundFont stereo placement, while 0 explicitly centres the note/strike/string. RC1 also accepts the earlier 20-column legacy layout without pan fields.
Composition length uses the declared full-measure final barline rather than the last note onset. Cross-track tempo, meter and composition length must agree. MIDI import into Studio first converts to a SymphonyCSV musical format.
Every column, in RC1 order
Descriptions distinguish input meaning, accepted-value guidance, and blank-cell meaning. The live Rust/WASM importer remains definitive for uncommon event values.
| # | Exact header | Type | Meaning, accepted values and blank handling | Requirement |
|---|---|---|---|---|
| 1 | composition_title | Text | Shared song title; identifies which composition the drum part belongs to. Accepted / units: Nonblank text Blank: Required. | Required event/composition value |
| 2 | composition_total_measures | Integer | Full count of bars in the piece, including measures with no drum hits. Accepted / units: Positive integer Blank: Required; must match other tracks. | Required event/composition value |
| 3 | composition_end_tick | Integer | Absolute closing barline tick of the final full measure. Accepted / units: Nonnegative integer Blank: Required; do not use last hit time as song end. | Required event/composition value |
| 4 | tempo_bpm | Decimal | Quarter-note tempo of the composition. Accepted / units: Positive BPM number Blank: Required; must match the rest of the song. | Required event/composition value |
| 5 | time_signature | Text | Shared musical meter. Accepted / units: Meter text such as 4/4 Blank: Required; must match the rest of the song. | Required event/composition value |
| 6 | ticks_per_quarter | Integer | Tick resolution defining the drum timeline. Accepted / units: Positive integer; verified sample uses 480 Blank: Required; must match the rest of the song. | Required event/composition value |
| 7 | event_id | Text | Unique identifier for this drum event; use it to review edits. Accepted / units: Text, e.g. DR0001 Blank: Required for drum event rows. | Required event/composition value |
| 8 | event_type | Text | Type of drum event represented. Accepted / units: hit in verified sample; other values require validator confirmation Blank: Required; do not invent a new type. | Required event/composition value |
| 9 | measure | Integer | One-based measure containing the event onset. Accepted / units: Positive integer within declared length Blank: Required for events. | Required event/composition value |
| 10 | absolute_tick | Integer | Absolute attack tick since composition start. Accepted / units: Nonnegative integer Blank: Required for timed events. | Required event/composition value |
| 11 | onset_tick_in_measure | Integer | Attack offset in ticks relative to the start of this bar. Accepted / units: Nonnegative integer less than measure tick length Blank: Required for timed events. | Required event/composition value |
| 12 | timing_offset_ms | Decimal | Optional microtiming deviation in milliseconds from the grid-aligned hit. Accepted / units: Signed/unsigned millisecond value; exact accepted bounds need validator check Blank: No performance offset; retain blank. | Conditional / optional / derived |
| 13 | duration_ticks | Integer | Length in ticks assigned to the trigger/release event, not necessarily acoustic sample tail. Accepted / units: Positive integer ticks in hit examples Blank: Required for hit scheduling. | Required event/composition value |
| 14 | surface_id | Text | Musical playing surface such as kick or snare, independent of the loaded SoundFont mapping. Accepted / units: Surface identifier; verified values include kick_1, snare_1, hihat_1 Blank: Required for a hit; kit mapping resolves actual MIDI note. | Required event/composition value |
| 15 | articulation | Text | Surface-specific way of striking, e.g. closed hi-hat. Accepted / units: Text; closed and open appear in verified fixture Blank: Blank means standard/unspecified articulation for the surface. | Conditional / optional / derived |
| 16 | variant_id | Text | Optional sample/performance variation within an articulation or kit. Accepted / units: Text identifier resolved by drum kit/mapping Blank: No variant selected. | Conditional / optional / derived |
| 17 | velocity | Integer | Attack intensity for this individual hit. Accepted / units: Integer 1–127 Blank: Required for a sounding hit. | Required event/composition value |
| 18 | note_off_velocity | Integer | Optional MIDI release strength for this hit. Accepted / units: Integer 0–127 when applicable Blank: No explicit release velocity override. | Conditional / optional / derived |
| 19 | note_off_method | Text | MIDI representation used when releasing the event. Accepted / units: Implementation/policy-specific; e.g. note_off or note_on_velocity_zero Blank: No explicit override; follow validated kit policy. | Conditional / optional / derived |
| 20 | choke_group | Text | Identifier linking sounds that cut each other off, such as exclusive cymbal/hi-hat groups. Accepted / units: Text group ID; playback support depends on kit mapping Blank: No choke group declared. | Conditional / optional / derived |
| 21 | Pan_Position | Integer | Places this musical note or drum hit in the stereo field; each event can be positioned independently. Accepted / 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: 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 | Optional stereo placement |
21 columns