Pitch distance and transposition
import { transpose, distance } from "@tonaljs/pitch-distance";
transpose("C4", "5P"); // => "G4"
distance("C4", "G4"); // => "5P"
Transpose a note by an interval. It returns the note name or "" if not valid parameters.
Examples:
transpose("d3", "3M"); // => "F#3"
transpose("D", "3M"); // => "F#"
["C", "D", "E", "F", "G"].map((pc) => transpose(pc, "M3"));
// => ["E", "F#", "G#", "A", "B"]
This function always returns a string:
transpose("one", "two"); // => ""
Find the distance between two notes. It returns the interval name, or "" if not valid parameters.
Examples:
distance("C3", "E4"); // => "10M"
If one of the note is a pitch class, the interval will be simple:
distance("C", "E"); // => "3M"
distance("C", "E4"); // => "3M"
distance("C4", "E"); // => "3M"
This function always returns a string:
distance("today", "tomorrow"); // => ""
Take a look to @tonaljs/note or @tonaljs/interval modules.
note("C4").octave; // => 4
note("C4").midi; // => 60
note("C4").empty; // => false
note("x").empty; // => true
note("x").name; // => ""
note("x").octave; // => undefined
// remove all invalid note names
[...].map(note).filter(n => !n.empty).map(n => n.name)
You can test the midi numbers:
note("Cb4").midi === note("B3").midi;
Or better yet, use the height
property that is also present on pitch classes (in notes without octaves midi property is null
):
note("Cb").height === note("B").height;
note("Cb4").pc + 5; // => "Cb5"