Progressions
Parse and create harmonic progressions
import { Progression } from "tonal";
Progression.fromRomanNumerals("C", ["IMaj7", "IIm7", "V7"]); // => ["CMaj7", "Dm7", "G7"]API
Progression.fromRomanNumerals
fromRomanNumerals(keyTonic: string, chordProgression: string[]) => string[]
Given a tonic and a chord progression expressed in roman numeral analysis chords, returns the progression expressed in leadsheet chords.
Progression.fromRomanNumerals("C", ["IMaj7", "IIm7", "V7"]);
// => ["CMaj7", "Dm7", "G7"]A lowercase roman numeral is a minor chord, unless its chord type already has a quality (like viio, iim7 or ii+). Every spelling of a chord type gives the same chord (iimaj7 and iiMaj7 are both minor-major sevenths):
Progression.fromRomanNumerals("C", ["I", "vi", "ii7", "V7", "viio"]);
// => ["C", "Am", "Dm7", "G7", "Bo"]An applied (secondary) chord, like V7/V, is a chord on a degree of another degree's major scale. Applied chords can nest:
Progression.fromRomanNumerals("C", ["I", "V7/ii", "ii", "V7/V", "V7", "I"]);
// => ["C", "A7", "Dm", "D7", "G7", "C"]
Progression.fromRomanNumerals("C", ["viio7/V", "V/V/V"]);
// => ["F#o7", "A"]A note after a slash is the bass: I/E is C/E. A numeral whose chord type isn't a known chord type gives an empty string:
Progression.fromRomanNumerals("C", ["I/E", "V65", "It6"]);
// => ["C/E", "", ""]Progression.toRomanNumerals
toRomanNumerals(keyTonic: string, chordProgression: string[]) => string[]
The opposite of fromRomanNumerals. Given a tonic and a chord progression expressed in leadsheet chords, returns the progression using roman numeral analysis chords.
Progression.toRomanNumerals("C", ["CMaj7", "Dm7", "G7"]);
// => "IMaj7", "IIm7", "V7"]