zazate.js

Zazate.js is music theory and notation package or module for Javascript, can be used by programmers, musicians, composers and researchers to make and investigate music. Zazate.js is integrated with a big numbers of functions related to find notes, chords and intervals.

Features

• Work with notes, intervals, chords, scales, keys and meters in a simple and theoretically sound way.
• Generate natural diatonic intervals (seconds, thirds, fourths, etc) and absolute intervals (minors second, perfect fifths, etc.)
• Generate natural diatonic triads, seventh chords, and absolute chords directly or from shorthand (min7, m/M7, etc). zazate.js also knows about inversions, slashed chords and polychords.
• Refer to chords by their diatonic function (tonic, subtonic, etc. or I, ii, iii, IV, etc).
• Work with diatonic scales and their modes (ionian, mixolydian, etc.), generate the minor (natural, harmonic and melodic) and chromatic or whole note scales.
• Recognize intervals, scales and hundreds of chords from lists of notes.
• Recognize the harmonic functions of chords.

Installation

via npm:

$ npm install zazate.js

Usage

var zazate = require('zazate.js');
var result = zazate.notes.augment('C');
console.log(result); // print 'C#'

Use this syntax

var zazate = require('zazate.js');
zazate.<library>.<function>(arg1, arg2...);

In zazatz.js, there are the following libraries:

• notes
• diatonic
• intervals
• chords
• scales
• meter
• values (need documentation)
• progressions (not full yet)

See functions of each library in documentation below.

Documentation

Index

• notes
  • fifths - attribute
  • augment(note) - function
  • diminish(note) - function
  • is_enharmonic(note1, note2) - function
  • is_valid_note(note) - function
  • note_to_int(note) - function
  • int_to_note(note_int) - function
  • remove_redundant_accidentals(note) - function
  • to_major(note) - function
  • to_minor(note) - function
• diatonic
  • basic_keys - attribute
  • get_notes(key) - function
  • int_to_note(note_int, key) - function
  • interval(key, start_note, interval) - function
• intervals
  • augmented_unison(note1, note2, shorthand) - function
  • determine(note1, note2, shorthand) - function
  • fifth(note, key) - function
  • fourth(note, key) - function
  • from_shorthand(note, interval, up) - function
  • get_interval(note, interval, key) - function
  • interval(interval) - function
  • is_consonant(note1, note2, include_fourths) - function
  • is_dissonant(note1, note2, include_fourths) - function
  • is_imperfect_consonant(note1, note2) - function
  • is_perfect_consonant(note1, note2, include_fourths) - function
  • major_fifth(note) - function
  • major_fourth(note) - function
  • major_second(note) - function
  • major_seventh(note) - function
  • major_sixth(note) - function
  • major_third(note) - function
  • major_unison(note) - function
  • measure(note1, note2) - function
  • minor_fifth(note) - function
  • minor_fourth(note) - function
  • minor_second(note) - function
  • minor_seventh(note) - function
  • minor_sixth(note) - function
  • minor_third(note) - function
  • minor_unison(note) - function
  • perfect_fifth(note) - function
  • perfect_fourth(note) - function
  • second(note, key) - function
  • seventh(note, key) - function
  • sixth(note, key) - function
  • third(note, key) - function
  • unison(note, key) - function
• chords
  • I(key) - function
  • I7(key) - function
  • II(key) - function
  • II7(key) - function
  • III(key) - function
  • III7(key) - function
  • IV(key) - function
  • IV7(key) - function
  • V(key) - function
  • V7(key) - function
  • VI(key) - function
  • VI7(key) - function
  • VII(key) - function
  • VII7(key) - function
  • augmented_major_seventh(note) - function
  • augmented_minor_seventh(note) - function
  • augmented_triad(note) - function
  • determine(chord, shorthand, no_inversions, no_polychords) - function
  • determine_extended_chord5(chord, shorthand, no_inversions, no_polychords) - function
  • determine_extended_chord6(chord, shorthand, no_inversions, no_polychords) - function
  • determine_extended_chord7(chord, shorthand, no_inversions, no_polychords) - function
  • determine_polychords(chord, shorthand) - function
  • determine_seventh(seventh, shorthand, no_inversion, no_polychords) - function
  • diminished_seventh(note) - function
  • diminished_triad(note) - function
  • dominant(key) - function
  • dominant7(key) - function
  • dominant_flat_five(note) - function
  • dominant_flat_ninth(note) - function
  • dominant_ninth(note) - function
  • dominant_seventh(note) - function
  • dominant_sharp_ninth(note) - function
  • dominant_sixth(note) - function
  • dominant_thirteenth(note) - function
  • eleventh(note) - function
  • first_inversion(chord) - function
  • from_shorthand(shorthand_string, slash) - function
  • half_diminished_seventh(note) - function
  • hendrix_chord(note) - function
  • ii(key) - function
  • ii7(key) - function
  • iii(key) - function
  • iii7(key) - function
  • int_desc(tries) - function
  • invert(chord) - function
  • lydian_dominant_seventh(note) - function
  • major_ninth(note) - function
  • major_seventh(note) - function
  • major_sixth(note) - function
  • major_thirteenth(note) - function
  • major_triad(note) - function
  • mediant(key) - function
  • mediant7(key) - function
  • minor_eleventh(note) - function
  • minor_major_seventh(note) - function
  • minor_ninth(note) - function
  • minor_seventh(note) - function
  • minor_seventh_flat_five(note) - function
  • minor_sixth(note) - function
  • minor_thirteenth(note) - function
  • minor_triad(note) - function
  • second_inversion(chord) - function
  • seventh(note, key) - function
  • sevenths(key) - function
  • sixth_ninth(note) - function
  • subdominant(key) - function
  • subdominant7(key) - function
  • submediant(key) - function
  • submediant7(key) - function
  • subtonic(key) - function
  • subtonic7(key) - function
  • supertonic(key) - function
  • supertonic7(key) - function
  • suspended_fourth_ninth(note) - function
  • suspended_fourth_triad(note) - function
  • suspended_second_triad(note) - function
  • suspended_seventh(note) - function
  • suspended_triad(note) - function
  • third_inversion(chord) - function
  • tonic(key) - function
  • tonic7(key) - function
  • triad(note, key) - function
  • triads(key) - function
  • vi(key) - function
  • vi7(key) - function
  • vii(key) - function
  • vii7(key) - function
• scales
  • aeolian(note) - function
  • chromatic(note) - function
  • determine(scale) - function
  • diatonic(note) - function
  • diminished(note) - function
  • dorian(note) - function
  • get_notes(key) - function
  • harmonic_minor(note) - function
  • ionian(note) - function
  • locrian(note) - function
  • lydian(note) - function
  • melodic_minor(note) - function
  • mixolydian(note) - function
  • natural_minor(note) - function
  • phrygian(note) - function
  • whole_note(note) - function
• meter
  • common_time - attribute
  • cut_time - attribute
  • is_asymmetrical(meter) - function
  • is_compound(meter) - function
  • is_simple(meter) - function
  • is_valid(meter) - function
  • valid_beat_duration(duration) - function

More documentation is coming soon!!

zazate.intervals.determine("C", "E"); // return 'major third'
zazate.intervals.determine("C", "Eb"); // return 'minor third'
zazate.intervals.determine("C", "E#"); // return 'augmented third'
zazate.intervals.determine("C", "Ebb"); // return 'diminished third'
zazate.intervals.determine("C", "G"); // return 'perfect fifth'
zazate.intervals.determine("C", "F"); // return 'perfect fourth'

zazate.intervals.from_shorthand("A", "b3"); // return 'C'
zazate.intervals.from_shorthand("D", "2"); // return 'A'
zazate.intervals.from_shorthand("E", "2", false); // return 'D'

zazate.intervals.unison("C"); // return 'C'

Can determine major, minor, diminished and suspended triads. Also knows about invertions.

zazate.chords.determine_triad(["A", "C", "E"]) // 'A minor triad'
zazate.chords.determine_triad(["C", "E", "A"]) // 'A minor triad, first inversion'
zazate.chordsdetermine_triad(["A", "C", "E"], true) // 'Am'

zazate.chords.from_shorthand("Amin") // ["A", "C", "E"]
zazate.chords.from_shorthand("Am/M7") // ["F", "Ab", "C", "E"]
zazate.chords.from_shorthand("A") // ["A", "C#", "E"]
zazate.chords.from_shorthand("A/G") // ["G", "A", "C#", "E"]
zazate.chords.from_shorthand("Dm|G") // ["G", "B", "D", "F", "A"]

Recognised abbreviations: the letters m and M in the following abbreviations can always be substituted by respectively min, mi or - and maj or ma (eg. from_shorthand("Amin7") == from_shorthand("Am7"), etc.).

• Triads: 'm', 'M' or '', 'dim'.
• Sevenths: 'm7', 'M7', '7', 'm7b5', 'dim7', 'm/M7' or 'mM7'
• Augmented chords: 'aug' or '+', '7#5' or 'M7+5', 'M7+', 'm7+', '7+'
• Suspended chords: 'sus4', 'sus2', 'sus47', 'sus', '11', 'sus4b9' or 'susb9'
• Sixths: '6', 'm6', 'M6', '6/7' or '67', 6/9 or 69
• Ninths: '9', 'M9', 'm9', '7b9', '7#9'
• Elevenths: '11', '7#11', 'm11'
• Thirteenths: '13', 'M13', 'm13'
• Altered chords: '7b5', '7b9', '7#9', '67' or '6/7'
• Special: '5', 'NC', 'hendrix'

Returns true if meter is an asymmetrical meter, false otherwise.

zazate.meter.is_asymmetrical([3,4]) // true
zazate.meter.is_asymmetrical([3,4]) // false