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.

21 current columns20-column legacy supportedUTF-8 CSV

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 headerTypeMeaning, accepted values and blank handlingRequirement
1composition_titleTextShared song title; identifies which composition the drum part belongs to.
Accepted / units: Nonblank text
Blank: Required.
Required event/composition value
2composition_total_measuresIntegerFull 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
3composition_end_tickIntegerAbsolute 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
4tempo_bpmDecimalQuarter-note tempo of the composition.
Accepted / units: Positive BPM number
Blank: Required; must match the rest of the song.
Required event/composition value
5time_signatureTextShared musical meter.
Accepted / units: Meter text such as 4/4
Blank: Required; must match the rest of the song.
Required event/composition value
6ticks_per_quarterIntegerTick 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
7event_idTextUnique 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
8event_typeTextType 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
9measureIntegerOne-based measure containing the event onset.
Accepted / units: Positive integer within declared length
Blank: Required for events.
Required event/composition value
10absolute_tickIntegerAbsolute attack tick since composition start.
Accepted / units: Nonnegative integer
Blank: Required for timed events.
Required event/composition value
11onset_tick_in_measureIntegerAttack 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
12timing_offset_msDecimalOptional 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
13duration_ticksIntegerLength 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
14surface_idTextMusical 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
15articulationTextSurface-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
16variant_idTextOptional sample/performance variation within an articulation or kit.
Accepted / units: Text identifier resolved by drum kit/mapping
Blank: No variant selected.
Conditional / optional / derived
17velocityIntegerAttack intensity for this individual hit.
Accepted / units: Integer 1–127
Blank: Required for a sounding hit.
Required event/composition value
18note_off_velocityIntegerOptional MIDI release strength for this hit.
Accepted / units: Integer 0–127 when applicable
Blank: No explicit release velocity override.
Conditional / optional / derived
19note_off_methodTextMIDI 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
20choke_groupTextIdentifier 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
21Pan_PositionIntegerPlaces 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