Universal Music Theory Library - v0.12.0
    Preparing search index...

    Interface ChordAnalysis

    Full harmonic analysis of a chord within a key context. Includes Roman numeral, function (T/S/D), modal borrowing, and cadence detection.

    interface ChordAnalysis {
        borrowedFrom?: string;
        cadenceWithNext?: string;
        chord: Chord;
        degree: number;
        function: "D" | "unknown" | "T" | "S";
        isBorrowed: boolean;
        isDiatonic: boolean;
        isSecondary: boolean;
        key: string;
        roman: string;
        secondaryTarget?: string;
        substitutionCandidate?: string;
    }
    Index

    Properties

    borrowedFrom? cadenceWithNext? chord degree function isBorrowed isDiatonic isSecondary key roman secondaryTarget? substitutionCandidate?

    Properties

    borrowedFrom?: string

    Mode it is borrowed from: 'minor', 'dorian', 'phrygian', 'mixolydian', 'lydian', 'harmonic minor'…

    cadenceWithNext?: string

    Cadence formed with the next chord, read in the next chord's key: 'Authentic Cadence (V -> I)'… (see Harmony.analyzeCadence).

    chord: Chord

    The chord analyzed, as passed in.

    degree: number

    Scale degree of the root, 1-7, or -1 when the root cannot be placed on a degree.

    function: "D" | "unknown" | "T" | "S"

    Tonic, subdominant or dominant function; secondary dominants and the tritone sub of V are 'D'.

    isBorrowed: boolean

    The chord comes from a parallel mode (see borrowedFrom). Secondary dominants are not borrowed.

    isDiatonic: boolean

    Every note belongs to the local key (in natural minor, also V, V7, vii° and vii°7 with the raised seventh).

    isSecondary: boolean

    A secondary dominant or leading-tone chord (see secondaryTarget).

    key: string

    The key this chord was read in: the home key, or the key of the last modulation.

    roman: string

    Roman numeral in the local key, readable back with parseRomanProgression: 'ii7', 'V7', 'bVImaj7', '#iv°7', 'ivm' (a minor chord the key does not hold).

    secondaryTarget?: string

    The secondary function: 'V7/ii', 'V7/IV', 'vii°7/V'. The target is cased by its triad in the key.

    substitutionCandidate?: string

    'tritone sub of V' for a dominant seventh on bII.

    Settings

    Member Visibility

    On This Page

    Properties