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

    Function compareReferences

    • Compare two profiled pieces aspect by aspect: form, harmony, melody and melodic rhythm.

      Sequences — sections, phrase lengths, cadences, key plans, structural chords, phrase contours and registers — are aligned by a graded edit distance; distributions — harmonic function, onset placement, inter-onset intervals, motif derivations — by histogram intersection. The surface field compares the motifs' interval cells, so a transposition of the same piece reads 1 on every field. No aggregate is returned: which aspects agree is the answer.

      Parameters

      Returns ReferenceComparison

      One likeness per aspect, and a rationale naming the extremes.

      If either profile or the options cannot be read.

      If the progression alignment would exceed the budget.