Musical CSV · Tracks 1–2
Piano Roll / Pitched CSV
Piano, keyboards, strings and other pitched instruments; Track 2 may use a Double Bass SoundFont without becoming TAB.
How to author this format
One note event per row; simultaneous pitches may share a tick. Track 2 may select a double-bass SoundFont while using this Pitched format. This is not the Guitar TAB schema.
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 85-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 | staff | Text | Names the notation staff for this event. Accepted / units: Text, e.g. Upper staff or Lower staff Blank: Not valid for a sounding Pitched event. | Required event/composition value |
| 2 | measure | Integer | One-based bar number in the composition. Accepted / units: Positive integer, 1 = first bar Blank: Required for every event. | Required event/composition value |
| 3 | count_aloud | Text | Human-friendly counted onset inside the bar. Accepted / units: Meter-specific count, e.g. One, Two and Blank: Required on Pitched note rows. | Required event/composition value |
| 4 | running_time | Text | Display of the event onset on the whole-piece clock. Accepted / units: m minutes and two-digit seconds; e.g. 0m 02s Blank: Regenerate; do not invent it independently. | Conditional / optional / derived |
| 5 | pitch_label | Text | Sounding concert pitch, including octave. Middle C is C4. Accepted / units: Pitch such as C4, F#5 or Bb3 Blank: Required for a Pitched note. | Required event/composition value |
| 6 | duration_beats | Decimal | Sounding note length measured in quarter-note beats. Accepted / units: Positive decimal; 1 = quarter note, 0.25 = sixteenth Blank: Required for a sounding note. | Required event/composition value |
| 7 | duration_ms | Integer | Calculated duration of the event in milliseconds. Accepted / units: Integer milliseconds Blank: Recompute from authoritative timing. | Conditional / optional / derived |
| 8 | velocity | Integer | MIDI note-on attack strength, not mixer volume. Accepted / units: Integer 1–127; 64 is a common starting choice Blank: Required for a sounding note. | Required event/composition value |
| 9 | tempo_bpm | Decimal | Composition tempo expressed as quarter notes per minute. Accepted / units: Positive number, e.g. 92 or 120 Blank: Required; must agree across imported parts. | Required event/composition value |
| 10 | time_signature | Text | Meter used to interpret bars and counts. Accepted / units: Text, e.g. 4/4; historical manual defines 2/4,3/4,4/4,5/4,6/8,7/8 Blank: Required; must agree across imported parts. | Required event/composition value |
| 11 | key_signature | Text | Notated tonal key, distinct from the actual MIDI pitches. Accepted / units: Text, e.g. C major, Bb major Blank: Do not infer or silently change a composer-selected key. | Conditional / optional / derived |
| 12 | instrument | Text | Human-readable musical part or instrument name. Accepted / units: Text, e.g. Piano, Bass, Strings Blank: Historical default Piano; Studio routing is track-specific. | Conditional / optional / derived |
| 13 | event_type | Enum | Kind of musical event represented by the row. Accepted / units: Pitched baseline: note Blank: Required event classification. | Conditional / optional / derived |
| 14 | event_id | Text | Stable, unique identifier used to review edits and receipts. Accepted / units: Text ID; e.g. N00001 Blank: Do not silently regenerate IDs of surviving notes. | Conditional / optional / derived |
| 15 | onset_beat_in_measure | Decimal | Numerical beat offset expressed with 1 at the barline. Accepted / units: Decimal, 1 + elapsed quarter-note beats in the bar Blank: Derived from count and meter. | Conditional / optional / derived |
| 16 | onset_ms | Integer | Event attack position from the start of the composition. Accepted / units: Integer milliseconds Blank: Recompute from tempo and tick position. | Conditional / optional / derived |
| 17 | end_ms | Integer | Event release position from composition start. Accepted / units: Integer milliseconds Blank: Recompute from onset and sounding duration. | Conditional / optional / derived |
| 18 | midi_pitch | Integer | Absolute MIDI note number for the sounding pitch. Accepted / units: Integer 0–127; C4 = 60 Blank: Derived from pitch_label for Pitched notes. | Conditional / optional / derived |
| 19 | velocity_description | Text | Readable dynamic description of the note velocity. Accepted / units: Text such as p, mf or Medium Blank: Display-level derived value; do not use instead of velocity. | Conditional / optional / derived |
| 20 | written_pitch | Text | Optional engraved spelling, which may differ enharmonically from the sounding label. Accepted / units: Text, e.g. Bb3 in place of A#3 Blank: No explicit spelling asserted. | Conditional / optional / derived |
| 21 | pitch_spelling_source | Text | Records how an engraving spelling was obtained. Accepted / units: Text, e.g. composer, score or inference Blank: No provenance assertion. | Conditional / optional / derived |
| 22 | clef | Text | Clef to present on the staff. Accepted / units: Text, e.g. Treble or Bass Blank: May be derived from the staff mapping. | Conditional / optional / derived |
| 23 | clef_sign | Text | Notation clef sign associated with the clef. Accepted / units: Typically G or F for pitched staves Blank: Derived from clef if omitted. | Conditional / optional / derived |
| 24 | clef_line | Integer | Staff line where the clef sign is anchored. Accepted / units: Integer; typical G clef = 2, F clef = 4 Blank: Derived from clef when possible. | Conditional / optional / derived |
| 25 | voice | Integer | Voice number for notation within the staff. Accepted / units: Positive integer Blank: Exporter or reader may infer a notation voice. | Conditional / optional / derived |
| 26 | notated_type | Enum | Engraved duration category, independently of sounding duration. Accepted / units: whole, half, quarter, eighth, 16th in historical guide Blank: Reader may choose notated appearance; no assertion. | Conditional / optional / derived |
| 27 | notated_duration_beats | Decimal | Optional written note value in quarter-note beats. Accepted / units: Positive decimal Blank: Follow sounding duration when not separately specified. | Conditional / optional / derived |
| 28 | notated_dots | Integer | Augmentation-dot count for written notation. Accepted / units: Nonnegative integer Blank: Notation may infer dotting. | Conditional / optional / derived |
| 29 | tie_start | Boolean | Notation flag indicating the beginning of a tie. Accepted / units: Boolean text / encoded truth value Blank: No start of tie explicitly asserted. | Conditional / optional / derived |
| 30 | tie_stop | Boolean | Notation flag indicating the end of a tie. Accepted / units: Boolean text / encoded truth value Blank: No end of tie explicitly asserted. | Conditional / optional / derived |
| 31 | articulation | Text | Written/performance articulation of the event. Accepted / units: Text such as staccato, accent, tenuto, marcato Blank: No articulation specified. | Conditional / optional / derived |
| 32 | beam | Text | Explicit beaming role in notated rhythm. Accepted / units: begin, continue or end in original manual Blank: Notation may infer beaming. | Conditional / optional / derived |
| 33 | midi_file_format | Integer | Standard MIDI File structural format policy. Accepted / units: Integer, historical default 1 Blank: Must use consistent export policy. | Conditional / optional / derived |
| 34 | ticks_per_quarter | Integer | MIDI timeline resolution: ticks per quarter note. Accepted / units: Positive integer; current fixtures commonly use 480 Blank: Do not assume a hard-coded value; read the file. | Conditional / optional / derived |
| 35 | midi_track | Integer | Track number used in MIDI export and mappings. Accepted / units: Nonnegative integer; conductor often track 0 Blank: May be mapped from Studio track/staff. | Conditional / optional / derived |
| 36 | midi_track_name | Text | Readable name of the target MIDI track. Accepted / units: Text Blank: Can be derived from part/staff if absent. | Conditional / optional / derived |
| 37 | midi_channel | Integer | MIDI channel assigned to this part. Accepted / units: Integer 1–16 in the format documentation Blank: Requires track/part mapping if absent. | Conditional / optional / derived |
| 38 | midi_program | Integer | Zero-based General MIDI program number. Accepted / units: Integer 0–127; Acoustic Grand Piano = 0 Blank: Mapped or chosen by instrument profile. | Conditional / optional / derived |
| 39 | program_change_emit | Yes/No | Whether a MIDI program-change event should be emitted. Accepted / units: Yes or No Blank: Historical default No; do not emit changes unasked. | Conditional / optional / derived |
| 40 | program_source | Text | Provenance of the MIDI program selection. Accepted / units: Text Blank: No source assertion. | Conditional / optional / derived |
| 41 | midi_bank_msb | Integer | Optional MIDI bank-select most-significant byte, CC0. Accepted / units: Integer 0–127 Blank: No bank event requested. | Conditional / optional / derived |
| 42 | midi_bank_lsb | Integer | Optional MIDI bank-select least-significant byte, CC32. Accepted / units: Integer 0–127 Blank: No bank event requested. | Conditional / optional / derived |
| 43 | note_off_method | Enum | Policy for serializing note release events. Accepted / units: note_off or note_on_velocity_zero Blank: Historical default note_on_velocity_zero. | Conditional / optional / derived |
| 44 | note_off_velocity | Integer | Release velocity when a note-off is sent. Accepted / units: Integer 0–127; often 0 Blank: Historical default 0. | Conditional / optional / derived |
| 45 | absolute_tick | Integer | Onset tick counted from the composition start. Accepted / units: Nonnegative integer Blank: Recompute from measure and local onset. | Conditional / optional / derived |
| 46 | onset_tick_in_measure | Integer | Tick offset after the start of the bar. Accepted / units: Nonnegative integer Blank: Recompute from local onset. | Conditional / optional / derived |
| 47 | duration_ticks | Integer | Sounding duration in MIDI ticks. Accepted / units: Positive integer for sounding notes Blank: Recompute from beats and tick resolution. | Conditional / optional / derived |
| 48 | end_tick | Integer | Absolute release tick of the note. Accepted / units: Nonnegative integer; onset tick + duration ticks Blank: Recompute from event timing. | Conditional / optional / derived |
| 49 | tempo_us_per_quarter | Integer | MIDI tempo as microseconds for one quarter note. Accepted / units: Positive integer; 60,000,000 / tempo_bpm Blank: Recompute from tempo_bpm. | Conditional / optional / derived |
| 50 | tempo_beat_unit | Text | Unit against which the BPM count is expressed. Accepted / units: quarter in the original six-meter baseline Blank: Historical policy is quarter. | Conditional / optional / derived |
| 51 | pitch_octave_convention | Text | Defines the pitch/octave naming system. Accepted / units: C4=60 in the reference format Blank: Policy must remain consistent. | Conditional / optional / derived |
| 52 | tick_rounding_policy | Text | States how fractional tick results are rounded/handled. Accepted / units: Text policy; respect actual imported policy Blank: Do not silently invent new rounding. | Conditional / optional / derived |
| 53 | same_tick_event_order | Text | Ordering policy for simultaneous note releases and attacks. Accepted / units: note_off_before_note_on in reference Blank: Protect deterministic retrigger ordering. | Conditional / optional / derived |
| 54 | time_signature_num | Integer | Numerator derived from the time signature. Accepted / units: Positive integer, e.g. 4 for 4/4 Blank: Computed from time_signature. | Conditional / optional / derived |
| 55 | time_signature_den | Integer | Denominator derived from the time signature. Accepted / units: Positive integer, e.g. 4 for 4/4 Blank: Computed from time_signature. | Conditional / optional / derived |
| 56 | key_signature_fifths | Integer | Circle-of-fifths encoding of key signature. Accepted / units: Integer; flats negative, sharps positive Blank: Derived from key_signature. | Conditional / optional / derived |
| 57 | key_signature_mode | Text | Major/minor designation for MIDI key signature. Accepted / units: major or minor Blank: Derived from key_signature. | Conditional / optional / derived |
| 58 | controller_number | Integer | Generic MIDI Continuous Controller number. Accepted / units: Integer 0–127 Blank: No generic controller event. | Conditional / optional / derived |
| 59 | controller_value | Integer | Value for the generic MIDI controller above. Accepted / units: Integer 0–127; zero is explicit Blank: No generic controller event; verify paired fields. | Conditional / optional / derived |
| 60 | cc1_modulation | Integer | MIDI CC1 modulation amount. Accepted / units: Integer 0–127 Blank: Do not emit controller event. | Conditional / optional / derived |
| 61 | cc2_breath | Integer | MIDI CC2 breath controller amount. Accepted / units: Integer 0–127 Blank: Do not emit controller event. | Conditional / optional / derived |
| 62 | cc7_channel_volume | Integer | MIDI CC7 channel volume; different from note velocity. Accepted / units: Integer 0–127 Blank: Do not emit controller event. | Conditional / optional / derived |
| 63 | cc10_pan | Integer | MIDI CC10 pan position. Accepted / units: Integer 0–127; centre 64 Blank: Do not emit controller event. | Conditional / optional / derived |
| 64 | cc11_expression | Integer | MIDI CC11 musical expression amount. Accepted / units: Integer 0–127 Blank: Do not emit controller event. | Conditional / optional / derived |
| 65 | cc64_sustain | Integer | MIDI CC64 sustain-pedal state. Accepted / units: Integer 0–127; >=64 generally on Blank: Blank means no event, not pedal release. | Conditional / optional / derived |
| 66 | cc91_reverb_send | Integer | MIDI CC91 reverb send, not Studio’s necessarily separate audio effect settings. Accepted / units: Integer 0–127 Blank: Do not emit controller event. | Conditional / optional / derived |
| 67 | cc93_chorus_send | Integer | MIDI CC93 chorus send, not Studio’s necessarily separate audio effect settings. Accepted / units: Integer 0–127 Blank: Do not emit controller event. | Conditional / optional / derived |
| 68 | pitch_bend | Integer | Raw MIDI pitch bend position for this event. Accepted / units: Integer 0–16383; centre 8192 Blank: No pitch-bend message requested. | Conditional / optional / derived |
| 69 | channel_aftertouch | Integer | Channel-wide pressure aftertouch amount. Accepted / units: Integer 0–127 Blank: No channel-pressure event. | Conditional / optional / derived |
| 70 | poly_aftertouch | Integer | Per-note pressure aftertouch amount. Accepted / units: Integer 0–127 Blank: No per-note aftertouch event. | Conditional / optional / derived |
| 71 | sysex_payload | Text | MIDI System Exclusive content if implemented by an exporter. Accepted / units: Text payload; codec/encoding must be specified separately Blank: No SysEx message. | Conditional / optional / derived |
| 72 | controller_event_policy | Text | Describes whether an empty controller column emits an event. Accepted / units: Text policy; reference: blank = emit no event Blank: Do not assume unspecified controller events. | Conditional / optional / derived |
| 73 | composition_title | Text | Title establishing the identity of the shared composition. Accepted / units: Text; identical across participating tracks Blank: Required to establish/import a composition. | Required event/composition value |
| 74 | composer | Text | Human-approved composer credit. Accepted / units: Text Blank: Never fabricate a composer credit. | Conditional / optional / derived |
| 75 | composition_total_measures | Integer | Declared total number of full measures in the composition. Accepted / units: Positive integer; same across tracks Blank: Required for synchronized composition identity. | Required event/composition value |
| 76 | composition_end_tick | Integer | Final measure closing barline, independent of final note onset. Accepted / units: Integer computed from meter × ticks-per-quarter × total measures Blank: Recompute/verify; do not end early at last note. | Required event/composition value |
| 77 | composition_duration | Text | Readable whole-piece length for display. Accepted / units: Text such as 0m 08s Blank: Derived from full-measure composition length. | Conditional / optional / derived |
| 78 | lyric | Text | Lyric syllable attached to the musical event. Accepted / units: Text Blank: No lyric attached. | Conditional / optional / derived |
| 79 | marker | Text | Section marker or structural cue at an onset. Accepted / units: Text Blank: No marker attached. | Conditional / optional / derived |
| 80 | source_note_data | Text | Explains the provenance of note content. Accepted / units: Text Blank: No note-source claim recorded. | Conditional / optional / derived |
| 81 | source_clef | Text | Explains where the chosen clef came from. Accepted / units: Text Blank: No clef-source claim. | Conditional / optional / derived |
| 82 | source_key_signature | Text | Explains evidence for the selected key signature. Accepted / units: Text Blank: No key-source claim. | Conditional / optional / derived |
| 83 | source_instrument | Text | Explains the observed or authored instrument/program choice. Accepted / units: Text Blank: No instrument-source claim. | Conditional / optional / derived |
| 84 | source_license | Text | Describes the rights/licence of source musical material. Accepted / units: Text; verify externally before redistributing Blank: No licence claim. Do not assume public domain. | Conditional / optional / derived |
| 85 | source_url | URL | A source reference for provenance and attribution. Accepted / units: URL text Blank: No source URL claimed. | Conditional / optional / derived |
| 86 | 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 |
86 columns