Naively Programmable Module

    toscanini

    2.0.3 • Public • Published

    toscanini

    Arturo Toscanini was one of the greatest conductors of the 20th century. His photographic memory allowed him to answer his performers questions regarding their parts in entire performances, without physically examining the scores.

    Inspired by Arturo Toscanini's great ability and skill, we made this module to answer some of the most common questions about music scores, particularly with band directors, performers, and musicologists in mind. Currently, this module only supports MusicXML, though various other formats (Ex: Finale, Sibelius, etc) can be converted to MusicXML. See also https://github.com/MegaArman/musicxml-iterator

    Demo

    https://megaarman.github.io/toscanini/

    Installation

    npm install toscanini
    

    Example Usage

    const fs = require("fs");
    const Toscanini = require("toscanini"); //returns a factory function
     
    const musicXML = fs.readFileSync("myscore.xml").toString();
    const toscanini = Toscanini(musicXML); //create a Toscanini instance from a MusicXML string
    toscanini.getPitchRange("Flute"); //assuming there is a flute in the score, see getInstrumentNames()

    Currently supports the following queries:

    getInstrumentNames()

    returns the names of the instruments in the score as an array, ex:

    [ "Voice", "Piano" ]

    getPitchRange(instrumentName)

    returns an object to represent the lowest and highest pitch in terms of midi numbers for an instrument or the entire score if no instrumentName is provided, ex:

    {"minPitch": 30, "maxPitch": 72}

    getKeySignatures(instrumentName)

    returns the key signatures for a particular instrument as an array, or the entire score if no instrumentName is provided, ex:

    ["Ab", "Eb"]

    getTempos()

    returns an array containing all tempos in the score, ex:

    [105, 90]

    getTimeSignatures()

    returns an array of objects to represent the time signatures, ex:

    [{ beatType: 4, beats: 4}, {beatType: 8, beats: 9}] 

    to show the score has time signatures 4/4 and 9/8 (in any instrument part). Note that node.js may reorder keys in objects.

    getDynamics(instrumentName)

    returns an array of dynamics for a particular instrument, or for the score if no instrumentName is provided, ex:

    ["ff",  "f",  "mf"] 

    getRhythmComplexity(instrumentName)

    returns an array of objects representing the note types that appear for a particular instrument or for the entire score if no instrumentName is provided:

    [{dotted: 0, type: "whole"}, {dotted: 0, type: "half"}, {dotted: 1, type: "quarter"},
     {dotted: 1, type: "half"}, {dotted: 3, type: "quarter"}]

    We can see from this example that the part had whole notes, half notes, dotted quarters, dotted halfs, and triple dotted quarters (a very particular composer indeed).

    getNumberOfMeasures()

    returns the number of measures in a score.

    Install

    npm i toscanini

    DownloadsWeekly Downloads

    10

    Version

    2.0.3

    License

    MIT

    Unpacked Size

    10.4 kB

    Total Files

    4

    Last publish

    Collaborators

    • avatar
    • avatar