Harmony

Extension

Creates a new Harmony instance, it takes an array of integer numbers. Can be called with the shorthand notationa = Harmony.new([0,4,7]) b = Harmony([0,4,7])

Creates a four voice harmony instance from the fundamental note and chord type from the list in ChordsDefinition where you can select triads, sevenths and ninth chords among others. For example// C minor chord [0,3,7,12] a = Harmony.create(0,"m") // A major chord [9,13,16,21] b = Harmony.create(9,"M") // G diminished seventh chord [7,10,13,16] c = Harmony.create(7,"o7") // D dominant seventh [2,6,9,12] d = Harmony.create(2,"D7") // B major ninth with fourth suspended [11,13,16,18,22] e = Harmony.create(11,"M9sus4")

Arguments:

Checks if two chords have the same chord and type, regardless of number of voices and order or octave.a= Harmony([4,7,12,0]) b= Harmony.create(12,"M") c= Harmony([0,4,7]) d= Harmony([0,3,7]) a.equivalent(b) // true a.equivalent(c) // true a.equivalent(d) // false

Fundamental interger value of a chord.a= Harmony([0,4,9]) // A minor chord a.fundamental // 9, which is the A value of the A minor chord

Fundamental string value of a chord.a= Harmony([0,4,9]) // A minor chord a.fundamentalString // "A"

String value of the harmony typea= Harmony([0,4,9]) // A minor chord a.harmonyTypeStr // "m", which is the kinf of chord of A minor

Numerical value of the inversion of the chord, CM in root value would be [0,4,7] would have value 0, first inversion [4,7,12] would have value 1, and so on.a= Harmony([0,4,7]) // A minor chord a.inversion // "0", root position of C Major chord a= Harmony([4,7,12]) // A minor chord a.inversion // "1", first inversion oc C Major chord a= Harmony([7,12,12+4]) // A minor chord a.inversion // "2", first inversion oc C Major chord

String value of the inversion of the chord, CM in root value would be [0,4,7,11] would have value "7" as a seventh chord in root position, first inversion [4,7,12] would have value "6,5". Other inversions would have "6,4", "4,3", "2". This method works for triads and seventh chords.a= Harmony([0,4,7,11,12]) a.inversionStr // "7", root position of C M7 chord b= Harmony([7,4,11,12,7+12]) b.inversionStr // "6,5", first inversion of C M7 chord c= Harmony([7,11,12,12+4]) c.inversionStr // "4,3", second inversion of C M7 chord

Array with the sorted notes in the harmony.b= Harmony([7,4,12,19,11,4]) b.notesHarmony // [ 4, 4, 7, 11, 12, 19 ]

Array with simplified version of the array of notes. Notes are converted to pitch class module 12, duplicates are removed and elements are sorted ascending.b= Harmony([7,4,12,11,4,19]) b.notesSimplified // [ 0,4,7,11 ]

String with fundamental letter value an type of chord string valueb= Harmony([7,4,12,11,4,19]) b.nameHarmonyNoInversionStr // CM7

String with fundamental letter value an type of chord string value with inversion string added.b= Harmony([7,4,12,11,4,19]) b.nameHarmonyString // CM7 6,5

Degree of each chord with respect to chord type, for example for C Major seventh chord [0,4,7,11], 0 would be the fundamental 1, 4 would be the and interval of third, 7 an interval of fifth and 11 the seventh interval.a= Harmony([0,4,7,11]) // CM7 a.notesInterval // [1,3,5,7] b= Harmony([7,4,12,11,4,19]) // CM7 b.notesInterval // [ 3, 3, 5, 7, 1, 5 ]

Prints information about the harmony: Fundamental string, type, inversion, notes, simplified notes and interval typesa= Harmony([0,4,7,11]) // CM7 a.print // Fundamental: C M7 7 // Notes: [ 0, 4, 7, 11 ] // Simplified Notes[ 0, 4, 7, 11 ] // Interval types[ 1, 3, 5, 7 ]

Prints simplifiedinformation about the harmony: Fundamental string, type and inversion.a= Harmony([0,4,7,11]) // CM7 a.printSimple // CM7 7