Documentation

Accidentals.

Natural note names for algorithmic convenience.

Note. The first argument is the octave.

Note names. Double accidentals are not supported.

An alternative representation of note names that is more convenient for algorithms.

Rationals with limited numerators and denominators for representing note lengths.

A collection of notes of same length that sound simultaneously. Non-positive length will result in runtime errors when attempting to generate Lilypond and MIDI files.

Time signature. The first argument describes the subdivisions of the bar. For example, 2 beats per bar is encoded as [2], 3 as [3], 4 as [2, 2], 6 as [2, 3], 9 as [3, 3]. The second argument is the inverse of the length of the beat. Note that non-positive numbers in either numerator or denominator will result in errors, and Lilypond does not accept denominators that are not a power of two.

Time signature and the starting position of the first bar. For example, if the piece starts with a full bar, the initial position is 0. If the piece is in 34 and starts with a 14-note bar, the initial position is 1/2.

Construct the note name from a natural note name and an accidental.

Deconstruct a note name into the natural note name and the accidental.

A QuasiQuoter for compile-time parsing of note sequences. The syntax is loosely based on Lilypond. Some example of use:

• An empty note sequence: [ly||].
• A single note: [ly|<C0>1|].
• Two consecutive notes: [ly|<C0>1 <C0>1|].
• A rest, a single note and two simultaneous notes: [ly|<>1 <C0>1 <C0 D0>1|].
• All natural notes from C to B: [ly|<C0 D0 E0 F0 G0 A0 B0>1|].
• Accidentals: [ly|<Cb0 C0 C#0>1|].
• Different octaves: [ly|<C-1 C0 C1>1|].
• Rests of length 1/3, 1/2, 2/3, 1, 3/2, 2 and 3: [ly|<>3 <>2 <>3~3 <>1 <>1. <>1~1 <>1~1~1|].

The length of one measure.

The length of a note sequence.

The length of a collection of notes.

Discards the topmost division of the bar. For example, 1/1 is transformed into 1/2, 2/2 into 1/2, 3/4 into 1/4, 4/4 into 2/4, 6/8 into 3/8, 9/16 into 3/16.