Functions to work with midi numbers
npm install @tonaljs/midi> A collection of functions to work with midi numbers.
ES6:
``js`
import { Midi } from "tonal";
nodejs:
`js`
const { Midi } = require("tonal");
Given a note name or number, return the midi number. Midi numbers are always in range 0..127
Examples:
`js`
Midi.toMidi("C4"); // => 60
Midi.toMidi("#"); // => null
Midi.toMidi(60); // => 60
Midi.toMidi("60"); // => 60
Midi.toMidi(-1); // => null
Given a midi number, return the frequency:
Examples:
`js`
Midi.midiToFreq(60); // => 261.6255653005986
Midi.midiToFreq(69); // => 440
Midi.midiToFreq(69, 443); // => 443
Given a midi number, returns a note name. The altered notes will have flats unless explicitly set with the optional useSharps parameter.
Examples:
`js`
Midi.midiToNoteName(61); // => "Db4"
Midi.midiToNoteName(61, { pitchClass: true }); // => "Db"
Midi.midiToNoteName(61, { sharps: true }); // => "C#4"
Midi.midiToNoteName(61, { pitchClass: true, sharps: true }); // => "C#"
// it rounds to nearest note
midiToNoteName(61.7); // => "D4"
Given a frequency in hertz, returns the midi number. The midi number can have decimals (with two digits precision)
Example:
`js`
Midi.freqToMidi(220); //=> 57
Midi.freqToMidi(261.62); //=> 60
Midi.freqToMidi(261); //=> 59.96
Return the pitch class set from a number of midi note numbers or pcset chroma.
A pitch class set in this Midi package refers to a unique sorted collection of notes between 0 and 11 (that represents the pitch class of the note.
Example:
`js`
Midi.pcset([62, 63, 60, 65, 70, 72]); // => [0, 2, 3, 5, 10]
Midi.pcset("100100100101"); // => [0, 3, 6, 9, 11]
You can read more about pitch classes on Note module.
The string is a pitch class chroma, a string with a binary representation of a set. Read more about pitch class chroma in Pcset module documentation.
Returns a function that finds the nearest midi note of a pitch class set. Can be used to constrain a note to a scale, for example:
`js`
const nearest = Midi.pcsetNearest(Scale.get("D dorian").chroma);
[60, 61, 62, 63, 64, 65, 66].map(nearest); // => [60, 62, 62, 63, 65, 65, 67]
Returns a function to map a pitch class set over any note. Given a tonic a pitch class set, step 0 means the first note, step 1 the second, and so on:
`js`
const steps = Midi.pcsetSteps(Scale.get("D dorian").chroma, 60);
[-2, -1, 0, 1, 2, 3].map(steps); // => [ 57, 58, 60, 62, 63, 65 ]
A similar function called pcsetDegrees exists that just uses 1 as first note instead of 0 (more common in music theory books). See Scale.degrees and Chord.degrees` for more information.