Awesome

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