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

    Class CommaPump

    Comma pump detection: pitch drift of a just-intonation progression.

    Index

    Constructors

    Methods

    Constructors

    Methods

    • Detects if a chord progression drifts in pitch due to JI comma accumulation.

      Returns the total drift in cents and the likely comma type. A drift near 0 means the progression is comma-free ("pumpless"). A drift near a known comma value identifies the pump type.

      Parameters

      • chords: Chord[]

        The progression (all chords should share the same JI tuning).

      • tuning: JustIntonation

        The JI tuning context.

      Returns { commaType?: "syntonic" | "pythagorean" | "septimal"; drift: number }

      • OptionalcommaType?: "syntonic" | "pythagorean" | "septimal"

        The comma the drift matches (within 3 cents, 5 for septimal), if any.

      • drift: number

        Absolute drift after the progression, in cents; 0 for a progression without drift.