@libraz/libcantus - v1.1.0
    Preparing search index...

    Type Alias Phrase

    One phrase: a span of music closed by a boundary, and the evidence for it.

    type Phrase = {
        startBeat: number;
        endBeat: number;
        cadence: CadenceHit | null;
        signals: PhraseSignal[];
        confidence: number;
        structuralWeight: number;
        rationale: string;
    }
    Index
    startBeat: number

    First beat of the phrase; negative when the phrase begins in a pickup.

    endBeat: number

    End of the phrase, exclusive.

    cadence: CadenceHit | null

    The cadence closing the phrase, or null when the boundary rests on the melody and the metre alone.

    signals: PhraseSignal[]

    Why the closing boundary was placed here, strongest evidence first.

    confidence: number

    How well evidenced the phrase is, in [0, 1]: how strong its closing boundary is, and how close its length is to the length expected of a phrase in this piece.

    structuralWeight: number

    How much structural weight the closing cadence carries, in [0, 1]; 0 for a phrase that no cadence closes.

    This is the number that answers "which cadence matters most": it grades the cadence by how conclusive its type is, then by where the phrase it closes sits — a cadence ending the piece or landing on a hypermetric boundary closes more than one in the middle of a hyperbar. structuralCadences ranks by it.

    rationale: string

    A short reading of the phrase in words.