elm-maestro
This library provides music theory abstractions and functionalities.
Alpha stage: this library is not considered stable yet, and could be subject to API changes in the future.
Installation
elm-package oleiade/elm-maestroor add the dependency in your elm-package.json file directly
"oleiade/elm-maestro": "0.1.0 <= v < 0.2.0"Usage
Types and abstractions
Tone
The Maestro.Tone module exposes the following types:
type alias Tone =
{ key : Key, adjustment : Adjustment }
type Key
= C
| D
| E
| F
| G
| A
| B
type Adjustment
= Natural
| Sharp
| Flat
| SharpSharp
| FlatFlatin order to represent pitches/tones as follows:
import Maestro.Tone exposing(Key(..), Adjustment(..))
cNatural = newTone C Natural
dSharp = newTone D Sharp
bFlat = newTone B FlatNote
The Maestro.Note module exposes the following types:
type alias Note =
{ tone : Tone
, octave : Octave
}
type alias Octave =
Intin order to represent notes as follows:
import Maestro.Tone exposing (Tone, Key(..), Adjustment(..))
import Maestro.Note exposing (newNote)
e3Natural = newNote E Natural 3
f4Sharp = newNote F Sharp 4
a1Flat = newNote A Flat 1Interval
The Maestro.Interval module exposes the following type:
type Interval
= Unison
| MinorSecond
| MajorSecond
| MinorThird
| MajorThird
| PerfectFourth
| PerfectFifth
| MinorSixth
| MajorSixth
| MinorSeventh
| MajorSeventh
| PerfectOctave
| MinorNinth
| MajorNinth
| MinorTenth
| MajorTenth
| PerfectEleventh
| AugmentedEleventh
| PerfectTwelfth
| MinorThirteen
| MajorThirteen
| MinorFourteenth
| MajorFourteenth
| DoubleOctaveand will allow you to find the note at interval from a start note like follows:
import Maestro.Tone exposing (Key(..), Adjustment(..), newTone)
import Maestro.Interval exposing (Interval(..), addInterval)
example : Note
example =
addInterval (newNote C Natural 3) MajorThirdScale
A Scale is represented as a list of Tone. It is built from a pitch and a mode as follows:
import Maestro.Tone exposing (newTone, Key(..), Adjustment(..))
import Maestro.Scale exposing (scale, Mode(..))
example : Scale
example =
doSomethingWith <| scale (newTone C Natural) Major
