HarmTrace.Base.Chord.PitchClass

Summary: this module provides some functions that transform notes and chords into pitch classes and pitch class sets. See for more info: http://en.wikipedia.org/wiki/Pitch_class

Documentation

data PCSet

We hide the constructors, such that a PCSet can only be constructed with toPitchClasses, this to overcome confusion between interval sets and pitch class sets, which are both IntSets

Instances

Eq PCSet

Methods

(==) :: PCSet -> PCSet -> Bool

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

Show PCSet

Methods

showsPrec :: Int -> PCSet -> ShowS

show :: PCSet -> String

showList :: [PCSet] -> ShowS

Generic PCSet

Associated Types

type Rep PCSet :: * -> *

Methods

from :: PCSet -> Rep PCSet x

to :: Rep PCSet x -> PCSet

Binary PCSet

Methods

put :: PCSet -> Put

get :: Get PCSet

putList :: [PCSet] -> Put

type Rep PCSet

type Rep PCSet = D1 (MetaData "PCSet" "HarmTrace.Base.Chord.PitchClass" "HarmTrace-Base-1.6.0.0-BLvMBN84kkFFjgsWeov2oZ" True) (C1 (MetaCons "PCSet" PrefixI True) (S1 (MetaSel (Just Symbol "pc") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 IntSet)))

pc :: PCSet -> IntSet

Pitch classes

toPitchClass :: Diatonic a => Note a -> Int

Returns the semitone value [0 .. 11] of a ScaleDegree where 0 = C, e.g. F# = 6. For the constructors N and X an error is thrown.

pcToRoot :: Int -> Root

The reverse of toPitchClass returning the 'Note DiatonicNatural' given a Integer [0..11] semitone, where 0 represents C. All pitch spelling is ignored and the the following twelve pitch names will be output: C, C#, D, Eb, E, F F#, G, Ab, A, Bb, B. When the integer is out of the range [0..11] an error is thrown.

Pitch classes applied to chords

toPitchClasses :: ChordLabel -> PCSet

Similar to toIntSet but returns Int pitch classes and includes the Root and the bass Note of the the Chord. toPitchClasses throws an error when applied to a NoChord or UndefChord.

rootPC :: ChordLabel -> Int

A short-cut applying toPitchClass to a Chord. rootPC throws an error when applied to a NoChord or UndefChord.

bassPC :: ChordLabel -> Int

A short-cut applying intValToPitchClss to a Chord. bassPC throws an error when applied to a NoChord or UndefChord.

ignorePitchSpelling :: ChordLabel -> ChordLabel

Ignores the pitch spelling of a chord by applying pcToRoot and toPitchClass to the root of a ChordLabel.

altPitchSpelling :: ChordLabel -> Maybe ChordLabel

Give the alternative pitch spelling of a chord (if it exists)

Pitch classes applied to keys

keyPitchClasses :: Key -> PCSet

Return the set of pitches for the given key.

Pitch classes applied to interval sets

intValToPitchClss :: Root -> Interval -> Int

As toIntervalClss, but returns the Int pitch class.

intSetToPC :: IntSet -> Root -> PCSet

Transforms an interval set to and a root into a PCSet

Enharmonic Equivalence

class EnHarEq a where

A class to compare datatypes that sound the same (they contain the same pitch class content): http://en.wikipedia.org/wiki/Enharmonic

Methods

(&==) :: a -> a -> Bool

(&/=) :: a -> a -> Bool

Instances

EnHarEq ChordLabel

Methods

(&==) :: ChordLabel -> ChordLabel -> Bool

(&/=) :: ChordLabel -> ChordLabel -> Bool

Diatonic a => EnHarEq (Note a)

Methods

(&==) :: Note a -> Note a -> Bool

(&/=) :: Note a -> Note a -> Bool

Diatonic Class

class (Generic a, Show a, Enum a, Bounded a) => Diatonic a

A class to mark certain datatypes to have a diatonic structure: http://en.wikipedia.org/wiki/Diatonic_and_chromatic

Instances

Diatonic DiatonicNatural

Diatonic DiatonicDegree