Music.Theory.Key

Common music keys.

Documentation

data Mode

Enumeration of common music notation modes.

Constructors

Minor_Mode

Major_Mode

Instances

Show Mode

Defined in Music.Theory.Key

Methods

showsPrec :: Int -> Mode -> ShowS

show :: Mode -> String

showList :: [Mode] -> ShowS

Eq Mode

Defined in Music.Theory.Key

Methods

(==) :: Mode -> Mode -> Bool

(/=) :: Mode -> Mode -> Bool

Ord Mode

Defined in Music.Theory.Key

Methods

compare :: Mode -> Mode -> Ordering

(<) :: Mode -> Mode -> Bool

(<=) :: Mode -> Mode -> Bool

(>) :: Mode -> Mode -> Bool

(>=) :: Mode -> Mode -> Bool

max :: Mode -> Mode -> Mode

min :: Mode -> Mode -> Mode

mode_pp :: Mode -> String

Pretty printer for Mode.

mode_identifier_pp :: Mode -> String

Lower-cased mode_pp.

mode_parallel :: Mode -> Mode

There are two modes, given one return the other.

mode_pc_seq :: Num t => Mode -> [t]

type Key = (Note, Alteration, Mode)

A common music notation key is a Note, Alteration, Mode triple.

key_mode :: Key -> Mode

Mode of Key.

key_sequence_42 :: [Key]

Enumeration of 42 CMN keys.

length key_sequence_42 == 7 * 3 * 2

key_sequence_30 :: [Key]

Subset of key_sequence not including very eccentric keys (where there are more than 7 alterations).

length key_sequence_30 == 30

key_parallel :: Key -> Key

Parallel key, ie. mode_parallel of Key.

key_transpose :: Key -> Int -> Key

Transposition of Key.

key_relative :: Key -> Key

Relative key (ie. mode_parallel with the same number of and type of alterations.

let k = [(T.C,T.Natural,Major_Mode),(T.E,T.Natural,Minor_Mode)]
in map (key_lc_uc_pp . key_relative) k == ["a♮","G♮"]

key_mediant :: Key -> Maybe Key

Mediant minor of major key.

key_mediant (T.C,T.Natural,Major_Mode) == Just (T.E,T.Natural,Minor_Mode)

key_pc_set :: Integral i => Key -> [i]

key_lc_pp :: (Alteration -> String) -> Key -> String

Pretty-printer where Minor_Mode is written in lower case (lc) and alteration symbol is shown using indicated function.

key_lc_uc_pp :: Key -> String

key_lc_pp with unicode (uc) alteration.

map key_lc_uc_pp [(C,Sharp,Minor_Mode),(E,Flat,Major_Mode)] == ["c♯","E♭"]

key_lc_iso_pp :: Key -> String

key_lc_pp with ISO alteration.

key_lc_tonh_pp :: Key -> String

key_lc_pp with tonh alteration.

map key_lc_tonh_pp [(T.C,T.Sharp,Minor_Mode),(T.E,T.Flat,Major_Mode)]

key_identifier_pp :: (Show a, Show a1) => (a, a1, Mode) -> [Char]

note_char_to_key :: Char -> Maybe Key

key_lc_uc_parse :: String -> Maybe Key

Parse Key from lc-uc string.

let k = mapMaybe key_lc_uc_parse ["c","E","f♯","ab","G#"]
map key_lc_uc_pp k == ["c♮","E♮","f♯","a♭","G♯"]

key_fifths :: Key -> Maybe Int

Distance along circle of fifths path of indicated Key. A positive number indicates the number of sharps, a negative number the number of flats.

key_fifths (T.A,T.Natural,Minor_Mode) == Just 0
key_fifths (T.A,T.Natural,Major_Mode) == Just 3
key_fifths (T.C,T.Natural,Minor_Mode) == Just (-3)
key_fifths (T.B,T.Sharp,Minor_Mode) == Just 9
key_fifths (T.E,T.Sharp,Major_Mode) == Just 11
key_fifths (T.B,T.Sharp,Major_Mode) == Nothing

zip (map key_lc_iso_pp key_sequence_42) (map key_fifths key_sequence_42)

key_fifths_tbl :: [(Key, Int)]

Table mapping Key to key_fifths value.

fifths_to_key :: Mode -> Int -> Maybe Key

Lookup key_fifths value in key_fifths_tbl.

let a = [0,1,-1,2,-2,3,-3,4,-4,5,-5]
let f md = map key_lc_iso_pp . mapMaybe (fifths_to_key md)
f Minor_Mode a
f Major_Mode a

implied_key :: Integral i => Mode -> [i] -> Maybe Key

Given sorted pitch-class set, find simplest implied key in given mode.

mapMaybe (implied_key Major_Mode) [[0,2,4],[1,3],[4,10],[3,9],[8,9]]
map (implied_key Major_Mode) [[0,1,2],[0,1,3,4]] == [Nothing,Nothing]

implied_fifths :: Integral i => Mode -> [i] -> Maybe Int

key_fifths of implied_key.

implied_key_err :: Integral i => Mode -> [i] -> Key

implied_fifths_err :: Integral i => Mode -> [i] -> Int