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

    Type Alias ReferenceComparison

    How alike two profiled pieces are, one field per aspect.

    Every value is in [0, 1] and symmetric in the two profiles. A value is null when neither profile has anything to measure it on, and 0 when only one does.

    type ReferenceComparison = {
        form: {
            sectionSequenceSimilarity: number | null;
            phraseLengthSimilarity: number | null;
        };
        harmony: {
            progressionSimilarity: number
            | null;
            functionSimilarity: number | null;
            cadenceSimilarity: number | null;
            keyPlanSimilarity: number | null;
            harmonicRhythmOnsetSimilarity: number | null;
            harmonicRhythmDensitySimilarity: number | null;
        };
        melody: {
            surfaceSimilarity: number
            | null;
            motifStructureSimilarity: number | null;
            contourSimilarity: number | null;
            registerSimilarity: number | null;
        };
        rhythm: {
            onsetSimilarity: number
            | null;
            densitySimilarity: number | null;
            durationSimilarity: number | null;
            syncopationSimilarity: number | null;
        };
        rationale: string;
    }
    Index
    form: {
        sectionSequenceSimilarity: number | null;
        phraseLengthSimilarity: number | null;
    }

    Formal layout.

    Type Declaration

    • sectionSequenceSimilarity: number | null

      Likeness of the section-label sequences.

    • phraseLengthSimilarity: number | null

      Likeness of the phrase-length sequences.

    harmony: {
        progressionSimilarity: number | null;
        functionSimilarity: number | null;
        cadenceSimilarity: number | null;
        keyPlanSimilarity: number | null;
        harmonicRhythmOnsetSimilarity: number | null;
        harmonicRhythmDensitySimilarity: number | null;
    }

    Harmony.

    Type Declaration

    • progressionSimilarity: number | null

      Likeness of the structural Roman-numeral progressions.

    • functionSimilarity: number | null

      Likeness of how long each harmonic function is held.

    • cadenceSimilarity: number | null

      Likeness of the phrase-by-phrase cadence sequences.

    • keyPlanSimilarity: number | null

      Likeness of the key plans, read relative to each piece's first key.

    • harmonicRhythmOnsetSimilarity: number | null

      Likeness of where in the bar the chords change.

    • harmonicRhythmDensitySimilarity: number | null

      Likeness of how often the chords change.

    melody: {
        surfaceSimilarity: number | null;
        motifStructureSimilarity: number | null;
        contourSimilarity: number | null;
        registerSimilarity: number | null;
    }

    Melody.

    Type Declaration

    • surfaceSimilarity: number | null

      Likeness of the motifs' interval content: the one field that reads the surface.

    • motifStructureSimilarity: number | null

      Likeness of how the motifs derive from one another.

    • contourSimilarity: number | null

      Likeness of the phrases' melodic outlines, each scaled by its own range.

    • registerSimilarity: number | null

      Likeness of the phrases' registers, each relative to its piece's melodic mean.

    rhythm: {
        onsetSimilarity: number | null;
        densitySimilarity: number | null;
        durationSimilarity: number | null;
        syncopationSimilarity: number | null;
    }

    Melodic rhythm.

    Type Declaration

    • onsetSimilarity: number | null

      Likeness of where in the bar the melody's onsets fall.

    • densitySimilarity: number | null

      Likeness of the melodies' onsets per bar.

    • durationSimilarity: number | null

      Likeness of the melodies' inter-onset-interval distributions.

    • syncopationSimilarity: number | null

      Likeness of the melodies' syncopation.

    rationale: string

    The two most and the two least alike fields, by name.