Tonality

Extension

Creates a new Tonality instance with a base note integer and a string type. "M" major = [0,2,4,5,7,9,11], "m" harmonic minor = [0, 2, 3, 5, 7, 8, 11] Can be called with the shorthand notationa = Tonality.new(0,"M") b = Tonality(0,"m")

Arguments:

Converts string degree to integer value.Tonality.degreeRoman2Number("I") // 0 Tonality.degreeRoman2Number("iii") // 2 Tonality.degreeRoman2Number("VII") // 6

Arguments:

Returns:

A origin harmony and a target harmony, this function returns an harmony equivalent to the "target" that is closest to the "origin" harmony using the Manhattan metric (taxicab metric).a= Harmony([0,4,7,12]) b= Harmony.create(9,"D7") b.print c=Tonality.getClosestChord(a,b) c.print // [9,13,16,19]

Arguments:

Returns:

Checks the percentage (value from 0 to 1), of notes in an array that are part of the current tonality.a = Tonality(0,"M") // [0,2,4,5,7,9,11] a.notesPercentage([0,2,4]) // 1.0 a.notesPercentage([1,3,6]) // 0.0 a.notesPercentage([4,6,7]) // 0.666... a.notesPercentage([0,1]) // 0.5

Arguments:

Returns:

Returns the harmony/chord associated with the corresponding scale degree in roman numeral.a = Tonality(0,"M") // [0,2,4,5,7,9,11] h = a.getHarmonyfromDegree("I") // Harmony h.printSimple // CM a.getHarmonyfromDegree("i").printSimple // CM since its case insensitive a.getHarmonyfromDegree("II").printSimple // Dm a.getHarmonyfromDegree("III").printSimple // Em a.getHarmonyfromDegree("IV").printSimple // FM a.getHarmonyfromDegree("V").printSimple // GM a.getHarmonyfromDegree("V7/V").printSimple // DD7 7 (D dominant seventh) a.getHarmonyfromDegree("VI").printSimple // AM a.getHarmonyfromDegree("VI").printSimple // AM a.getHarmonyfromDegree("VII").printSimple // Bo (B diminished) a.getHarmonyfromDegree("x") // nil

Arguments:

Returns:

Returns the harmony/chord triad or seventh associated with the corresponding scale degree in numeric value (0-6).a = Tonality(0,"M") h = a.getHarmony(0,"3") // Harmony h.print // CM a.getHarmony(0,"3").printSimple // CM a.getHarmony(0,"7").printSimple // CM7 a.getHarmony(1,"3").printSimple // Dm a.getHarmony(1,"7").printSimple // Dm7 a.getHarmony(2,"3").printSimple // Em a.getHarmony(2,"7").printSimple // Em7 a.getHarmony(3,"3").printSimple // FM a.getHarmony(3,"7").printSimple // FM7

Arguments:

Returns:

Returns the harmony/chord seventh associated with the corresponding scale degree in numeric value (0-6).a = Tonality(0,"M") h = a.getHarmonySeventh(0) // Harmony h.print // CM a.getHarmonySeventh(1).printSimple // Dm7 7 a.getHarmonySeventh(2).printSimple // Em7 7 a.getHarmonySeventh(3).printSimple // FM7 7:w

Arguments:

Returns:

Returns the harmony/chord triad associated with the corresponding scale degree in numeric value (0-6).a = Tonality(0,"M") h = a.getHarmonyTriad(0) // Harmony h.print // CM a.getHarmonyTriad(1).printSimple // Dm a.getHarmonyTriad(2).printSimple // Em a.getHarmonyTriad(3).printSimple // FM

Arguments:

Returns:

Returns the type of seventh chord from an integer scale degree.a = Tonality(0,"M") h = a.getSeventhType(0) // M7 a.getSeventhType(1) // m7 a.getSeventhType(2) // m7 a.getSeventhType(3) // M7 a.getSeventhType(4) // D7 a.getSeventhType(5) // m7 a.getSeventhType(6) // o/7

Arguments:

Returns:

Returns the type of triad chord from an integer scale degree.a = Tonality(0,"M") a.getTriadType(0) // M a.getTriadType(1) // m a.getTriadType(2) // m a.getTriadType(3) // M a.getTriadType(4) // D a.getTriadType(5) // m a.getTriadType(6) // o

Arguments:

Returns:

Returns a list of Harmonies that belong to the tonality.

Returns:

Checks if a list of notes belongs to the tonality, true if all notes belong to the tonality, false if at least one note is not part of the tonality.a = Tonality(0,"M") a.notesTonality // -> [ 0, 2, 4, 5, 7, 9, 11 ] a.listNotesBelongs([0,2,1]) // false a.listNotesBelongs([0,2,4]) // true a.listNotesBelongs([7,9]) // true a.listNotesBelongs([]) // false

Arguments:

Returns:

Checks if a note belongs in the tonality.a = Tonality(0,"M") a.notesTonality // -> [ 0, 2, 4, 5, 7, 9, 11 ] a.noteBelongs(0) // true a.noteBelongs(1) // false

Arguments:

Returns:

Returns an integeger degree from the note numerical value, returns -1 if number is not part of the scale.a = Tonality(0,"M") a.notesTonality // -> [ 0, 2, 4, 5, 7, 9, 11 ] a.noteDegree(0) // 1 a.noteDegree(1) // 1 a.noteDegree(5) // 4 a.noteDegree(11) // 7

Arguments:

Returns:

Notes that are part of the tonality.a = Tonality(0,"M") a.notesTonality // -> [ 0, 2, 4, 5, 7, 9, 11 ] b = Tonality(9,"m") b.notesTonality // -> [ 9, 11, 0, 2, 4, 5, 8 ] c = Tonality(6,"M") c.notesTonality // -> [ 6, 8, 10, 11, 1, 3, 5 ]

Returns:

From a harmony, returns a list of the closest chords in the tonality to the reference ordered.a = Tonality(0,"M") a.possibleChords(Harmony([0,2,4,7])) // -> [ [ 1, CM ], [ 2, CM7 7 ], [ 2, Am7 7 ], [ 3, Dm ], [ 3, Em ], [ 3, Am ], [ 3, Bo ], [ 3, Dm6 6 ], [ 3, Do ], [ 3, Bo7 ], [ 4, FM ], [ 4, GM ], [ 4, Dm7 7 ], [ 4, Em7 7 ], [ 4, FM7 7 ], [ 4, GD7 7 ], [ 4, Em7 7 ], [ 4, Fm ], [ 4, GDM9*5 7 ], [ 4, GDm9*5 7 ], [ 4, G7b5 7 ], [ 4, G7#5 7 ], [ 4, GD7*5 7 ], [ 5, G9 7 ], [ 5, G7b9 7 ] ]

Arguments:

Returns:

Integer value with base of the chord 0-6.

String value with the type of the scale "M" for major and "m" for minor.