tonal-distance

Distance

Transpose notes by intervals and find distances between notes

Example

// es6
import * as Distance from "tonal-distance"
Distance.interval("C3", "C4") // => "1P"

Example

// es6 import selected functions
import { interval, semitones, transpose } from "tonal-distance"
 
semitones("C" ,"D") // => 2
interval("C4", "G4") // => "5P"
transpose("C4", "P5") // => "G4"

Example

// included in tonal facade
const Tonal = require("tonal");
Tonal.Distance.transpose("C4", "P5")
Tonal.Distance.transposeBy("P5", "C4")

• Distance
  • .transpose(note, interval) ⇒ string
  • .trFifths(pitchClass, fifhts) ⇒ string
  • .fifths(to, from)
  • .transposeBy(note, interval) ⇒ string
  • .add(interval1, interval2) ⇒ string
  • .subtract(minuend, subtrahend) ⇒ string
  • .interval(from, to) ⇒ string
  • .semitones(from, to) ⇒ Integer

Distance.transpose(note, interval) ⇒ string

Transpose a note by an interval. The note can be a pitch class.

This function can be partially applied.

Kind: static method of Distance
Returns: string - the transposed note

Param	Type
note	string
interval	string

Example

import { tranpose } from "tonal-distance"
transpose("d3", "3M") // => "F#3"
// it works with pitch classes
transpose("D", "3M") // => "F#"
// can be partially applied
["C", "D", "E", "F", "G"].map(transpose("M3)) // => ["E", "F#", "G#", "A", "B"]

Distance.trFifths(pitchClass, fifhts) ⇒ string

Transpose a pitch class by a number of perfect fifths.

It can be partially applied.

Kind: static method of Distance
Returns: string - the transposed pitch class

Param	Type	Description
pitchClass	string	the pitch class
fifhts	Integer	the number of fifths

Example

import { trFifths } from "tonal-transpose"
[0, 1, 2, 3, 4].map(trFifths("C")) // => ["C", "G", "D", "A", "E"]
// or using tonal
Distance.trFifths("G4", 1) // => "D"

Distance.fifths(to, from)

Get the distance in fifths between pitch classes

Can be partially applied.

Kind: static method of Distance

Param	Type	Description
to	string	note or pitch class
from	string	note or pitch class

Distance.transposeBy(note, interval) ⇒ string

The same as transpose with the arguments inverted.

Can be partially applied.

Kind: static method of Distance
Returns: string - the transposed note

Param	Type
note	string
interval	string

Example

import { tranposeBy } from "tonal-distance"
transposeBy("3m", "5P") // => "7m"

Distance.add(interval1, interval2) ⇒ string

Add two intervals

Can be partially applied.

Kind: static method of Distance
Returns: string - the resulting interval

Param	Type
interval1	string
interval2	string

Example

import { add } from "tonal-distance"
add("3m", "5P") // => "7m"

Distance.subtract(minuend, subtrahend) ⇒ string

Subtract two intervals

Can be partially applied

Kind: static method of Distance
Returns: string - interval diference

Param	Type
minuend	string
subtrahend	string

Distance.interval(from, to) ⇒ string

Find the interval between two pitches. It works with pitch classes (both must be pitch classes and the interval is always ascending)

Can be partially applied

Kind: static method of Distance
Returns: string - the interval distance

Param	Type	Description
from	string	distance from
to	string	distance to

Example

import { interval } from "tonal-distance"
interval("C2", "C3") // => "P8"
interval("G", "B") // => "M3"

Example

import * as Distance from "tonal-distance"
Distance.interval("M2", "P5") // => "P4"

Distance.semitones(from, to) ⇒ Integer

Get the distance between two notes in semitones

Kind: static method of Distance
Returns: Integer - the distance in semitones or null if not valid notes

Param	Type	Description
from	String | Pitch	first note
to	String | Pitch	last note

Example

import { semitones } from "tonal-distance"
semitones("C3", "A2") // => -3
// or use tonal
Tonal.Distance.semitones("C3", "G3") // => 7