Source code for music21.musedata.base40

# ------------------------------------------------------------------------------
# Name:         base40.py
# Purpose:      Base40/Music21 Pitch/Interval Translator
#
# Authors:      Jose Cabal-Ugaz
#
# Copyright:    Copyright © 2009-2010 Michael Scott Asato Cuthbert
# License:      BSD, see license.txt
# ------------------------------------------------------------------------------
'''
Implementation of Walter Hewlett's base40 system for musical intervals.
(See Hewlett and Ann K. Blombach 1989 article)
'''
from __future__ import annotations

import unittest

from music21 import common
from music21 import exceptions21
from music21 import interval
from music21 import note
from music21 import pitch

# Key => Base40 pitch number
# Value => Music21 Pitch name
base40Equivalent = {1: 'C--',
                    2: 'C-',
                    3: 'C',
                    4: 'C#',
                    5: 'C##',
                    6: None,
                    7: 'D--',
                    8: 'D-',
                    9: 'D',
                    10: 'D#',
                    11: 'D##',
                    12: None,
                    13: 'E--',
                    14: 'E-',
                    15: 'E',
                    16: 'E#',
                    17: 'E##',
                    18: 'F--',
                    19: 'F-',
                    20: 'F',
                    21: 'F#',
                    22: 'F##',
                    23: None,
                    24: 'G--',
                    25: 'G-',
                    26: 'G',
                    27: 'G#',
                    28: 'G##',
                    29: None,
                    30: 'A--',
                    31: 'A-',
                    32: 'A',
                    33: 'A#',
                    34: 'A##',
                    35: None,
                    36: 'B--',
                    37: 'B-',
                    38: 'B',
                    39: 'B#',
                    40: 'B##',
                    }


# Key => Music21 Pitch name
# Value => Base40 pitch number
base40Representation = {'C--': 1,
                        'C-': 2,
                        'C': 3,
                        'C#': 4,
                        'C##': 5,
                        # empty
                        'D--': 7,
                        'D-': 8,
                        'D': 9,
                        'D#': 10,
                        'D##': 11,
                        # empty
                        'E--': 13,
                        'E-': 14,
                        'E': 15,
                        'E#': 16,
                        'E##': 17,
                        'F--': 18,
                        'F-': 19,
                        'F': 20,
                        'F#': 21,
                        'F##': 22,
                        # empty
                        'G--': 24,
                        'G-': 25,
                        'G': 26,
                        'G#': 27,
                        'G##': 28,
                        # empty
                        'A--': 30,
                        'A-': 31,
                        'A': 32,
                        'A#': 33,
                        'A##': 34,
                        # empty
                        'B--': 36,
                        'B-': 37,
                        'B': 38,
                        'B#': 39,
                        'B##': 40,
                        }


# Key => Base40 delta (difference between two Base40 pitch numbers)
# Value => Corresponding music21 Interval
base40IntervalTable = {0: 'P1',
                        1: 'A1',

                        4: 'd2',
                        5: 'm2',
                        6: 'M2',
                        7: 'A2',

                        10: 'd3',
                        11: 'm3',
                        12: 'M3',
                        13: 'A3',

                        16: 'd4',
                        17: 'P4',
                        18: 'A4',

                        22: 'd5',
                        23: 'P5',
                        24: 'A5',

                        27: 'd6',
                        28: 'm6',
                        29: 'M6',
                        30: 'A6',

                        33: 'd7',
                        34: 'm7',
                        35: 'M7',
                        36: 'A7',

                        39: 'd8',
                        40: 'P8',  # wraps around
                       }


[docs] def base40DeltaToInterval(delta): ''' Returns a music21 Interval between two Base40 pitch numbers given the delta (difference) between them. Raises a Base40 Exception if the interval is not handled by Base40. Base40 can only handle major, minor, perfect, augmented, and diminished intervals. Although not for certain, it seems that the engineers that designed this system assumed that other intervals (doubly augmented intervals, for instance) would be of a very rare occurrence, and extreme intervals which would trigger an incorrect answer (C-- to C##, for instance, would return a diminished second, even though it's a quadruplely augmented unison) just would not occur. >>> musedata.base40.base40DeltaToInterval(4) <music21.interval.Interval d2> >>> musedata.base40.base40DeltaToInterval(11) <music21.interval.Interval m3> >>> musedata.base40.base40DeltaToInterval(23) <music21.interval.Interval P5> >>> musedata.base40.base40DeltaToInterval(-23) <music21.interval.Interval P-5> >>> musedata.base40.base40DeltaToInterval(52) <music21.interval.Interval M10> >>> musedata.base40.base40DeltaToInterval(-52) <music21.interval.Interval M-10> >>> musedata.base40.base40DeltaToInterval(77) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Interval not handled by Base40 37 ''' direction = 1 if delta < 0: direction = -1 simpleDelta = abs(delta) % 40 try: simpleIntervalName = base40IntervalTable[simpleDelta] simpleInterval = interval.Interval(simpleIntervalName) except KeyError: raise Base40Exception('Interval not handled by Base40 ' + str(simpleDelta)) numOctaves = abs(delta) // 40 sgi = simpleInterval.generic # Simple generic interval # Compound generic interval cgi = interval.GenericInterval(direction * (sgi.value + 7 * numOctaves)) sdi = simpleInterval.diatonic # Simple diatonic interval newInterval = str(sdi.specifier) + str(cgi.value) return interval.Interval(newInterval)
[docs] def base40ToPitch(base40Num): ''' Converts a Base40 pitch number into a music21 Pitch. The Base40 number is octave specific. Raises a Base40 Exception if the Base40 pitch number given doesn't have an associated pitch name. There is one unassigned number each time the interval between two letters is a whole step. >>> musedata.base40.base40ToPitch(1) <music21.pitch.Pitch C--1> >>> musedata.base40.base40ToPitch(40) <music21.pitch.Pitch B##1> >>> musedata.base40.base40ToPitch(23) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Pitch name not assigned to this Base40 number 23 >>> musedata.base40.base40ToPitch(186) <music21.pitch.Pitch G5> ''' p = pitch.Pitch() p.octave = ((base40Num - 1) / 40) + 1 tableNum = base40Num - 40 * (p.octave - 1) pitchName = base40Equivalent[tableNum] if pitchName is not None: p.name = pitchName return p raise Base40Exception('Pitch name not assigned to this Base40 number ' + str(base40Num))
[docs] def pitchToBase40(pitchToConvert): ''' Converts a pitch string or a music21 Pitch into a Base40 pitch number. The Base40 number is octave specific. Raises a Base40 Exception if the pitch to convert is outside the set of pitches that Base40 can handle; for example, half flats and half sharps or triple flats and triple sharps. >>> musedata.base40.pitchToBase40(pitch.Pitch('C--5')) 161 >>> musedata.base40.pitchToBase40('F##4') 142 >>> musedata.base40.pitchToBase40('F###4') Traceback (most recent call last): music21.musedata.base40.Base40Exception: Base40 cannot handle this pitch F###4 ''' if isinstance(pitchToConvert, str): pitchToConvert = pitch.Pitch(pitchToConvert) if pitchToConvert.name in base40Representation: tableNum = base40Representation[pitchToConvert.name] base40Num = (40 * (pitchToConvert.octave - 1)) + tableNum return base40Num # raise ValueError('Base40 cannot handle this pitch.') raise Base40Exception('Base40 cannot handle this pitch ' + pitchToConvert.nameWithOctave)
[docs] def base40Interval(base40NumA, base40NumB): ''' Returns a music21 Interval between two base40 pitch numbers, using their delta (difference) as defined in Base40. The interval provided is without direction. Raises a Base40 Exception if the delta doesn't correspond to an interval in Base40, or if either base40 pitch number doesn't correspond to a pitch name. >>> musedata.base40.base40Interval(163, 191) <music21.interval.Interval m6> >>> musedata.base40.base40Interval(186, 174) # Descending M3 <music21.interval.Interval M-3> Base40 has limitations for intervals smaller than diminished or bigger than augmented. >>> musedata.base40.base40Interval(1, 5) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Base40 cannot compute interval between 1 and 5. >>> musedata.base40.base40Interval(1, 3) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Interval not handled by Base40 2 >>> musedata.base40.base40Interval(2, 6) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Pitch name not assigned to this Base40 number 6 Interval does not exist >>> musedata.base40.base40Interval(12, 6) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Pitch name not assigned to these Base40 numbers 12 and 6 Interval does not exist ''' pitchA = base40Equivalent[(base40NumA - 1) % 40 + 1] pitchB = base40Equivalent[(base40NumB - 1) % 40 + 1] delta = base40NumB - base40NumA if pitchA is None and pitchB is None: raise Base40Exception('Pitch name not assigned to these Base40 numbers ' + str(base40NumA) + ' and ' + str(base40NumB) + ' Interval does not exist') if pitchA is None: raise Base40Exception('Pitch name not assigned to this Base40 number ' + str(base40NumA) + ' Interval does not exist') if pitchB is None: raise Base40Exception('Pitch name not assigned to this Base40 number ' + str(base40NumB) + ' Interval does not exist') if delta > 3 and pitchA[0] == pitchB[0]: raise Base40Exception('Base40 cannot compute interval between ' + str(base40NumA) + ' and ' + str(base40NumB) + '.') return base40DeltaToInterval(delta)
[docs] def base40ActualInterval(base40NumA, base40NumB): ''' Calculates a music21 Interval between two Base40 pitch numbers, as calculated using the music21.interval module. Raises a Base40 Exception if (a) Either of the Base40 pitch numbers does not correspond to a pitch name or (b) If an unusual interval is encountered that can't be handled by music21. >>> musedata.base40.base40ActualInterval(163, 191) <music21.interval.Interval m6> >>> musedata.base40.base40ActualInterval(186, 174) # Descending M3 <music21.interval.Interval M-3> >>> musedata.base40.base40ActualInterval(1, 5) <music21.interval.Interval AAAA1> >>> musedata.base40.base40ActualInterval(1, 3) <music21.interval.Interval AA1> >>> musedata.base40.base40ActualInterval(2, 6) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Pitch name not assigned to this Base40 number 6 OMIT_FROM_DOCS >>> musedata.base40.base40ActualInterval(12, 6) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Pitch name not assigned to this Base40 number 12 ''' pitchA = base40ToPitch(base40NumA) pitchB = base40ToPitch(base40NumB) noteA = note.Note() noteA.pitch = pitchA noteB = note.Note() noteB.pitch = pitchB try: return interval.Interval(noteA, noteB) except IndexError: raise Base40Exception('Unusual interval- Limitation of music21.interval')
def _quickEnharmonicString(nameStr, direction='up', allowDoubleAccidentals=True): ''' Helper function for quickHigherEnharmonicString and quickLowerEnharmonicString ''' if direction == 'up': addNum = 4 elif direction == 'down': addNum = -4 else: raise Base40Exception(f'Not a valid direction, {direction}') enharmonics = [] if common.isNum(nameStr): base40num = nameStr nameStr = base40Equivalent.get(base40num, None) if nameStr is None: base40num = None else: base40num = base40Representation.get(nameStr, None) while base40num is not None: base40num = (base40num + addNum) % 40 if base40num == 0: base40num = 40 base40str = base40Equivalent.get(base40num, None) if allowDoubleAccidentals is False and base40str is not None and len(base40str) > 2: base40str = None if base40str is None: base40num = None else: if base40str[0] == nameStr[0]: base40num = None base40str = None for e in enharmonics: if base40str[0] == e[0]: base40num = None base40str = None if base40str is not None: enharmonics.append(base40str) return enharmonics
[docs] def quickHigherEnharmonicString(nameStr, allowDoubleAccidentals=True): ''' Takes a name of a string and returns a list of the quick higher enharmonics, limited to double sharps and double flats (or to single sharps and single flats if allowDoubleAccidentals is False) >>> musedata.base40.quickHigherEnharmonicString('F#') ['G-'] >>> musedata.base40.quickHigherEnharmonicString('C##') ['D', 'E--'] >>> musedata.base40.quickHigherEnharmonicString('C##', allowDoubleAccidentals=False) ['D'] >>> musedata.base40.quickHigherEnharmonicString('B#') ['C', 'D--'] ''' return _quickEnharmonicString(nameStr, direction='up', allowDoubleAccidentals=allowDoubleAccidentals)
[docs] def quickLowerEnharmonicString(nameStr, allowDoubleAccidentals=True): ''' Takes a name of a string and returns a list of the quick lower enharmonics, limited to double sharps and double flats (or to single sharps and single flats if allowDoubleAccidentals is False) >>> musedata.base40.quickLowerEnharmonicString('B-') ['A#'] >>> musedata.base40.quickLowerEnharmonicString('G-') ['F#', 'E##'] >>> musedata.base40.quickLowerEnharmonicString('G-', allowDoubleAccidentals=False) ['F#'] >>> musedata.base40.quickLowerEnharmonicString('C-') ['B', 'A##'] ''' return _quickEnharmonicString(nameStr, direction='down', allowDoubleAccidentals=allowDoubleAccidentals)
[docs] def quickEnharmonicString(nameStr, allowDoubleAccidentals=True): ''' Takes a name of a string and returns a list of the quick lower and higher enharmonics, limited to double sharps and double flats (or to single sharps and single flats if allowDoubleAccidentals is False) >>> musedata.base40.quickEnharmonicString('C') ['B#', 'D--'] >>> musedata.base40.quickEnharmonicString('C', allowDoubleAccidentals=False) ['B#'] >>> musedata.base40.quickEnharmonicString('G') ['F##', 'A--'] ''' harmonicString = quickLowerEnharmonicString(nameStr, allowDoubleAccidentals) harmonicString.extend(quickHigherEnharmonicString(nameStr, allowDoubleAccidentals)) return harmonicString
class Base40Exception(exceptions21.Music21Exception): pass
[docs] class BaseN: def __init__(self, order=2): self.order = order
[docs] def generateLetters(self): outLetters = [] for letter in ('C', 'D', 'E', 'F', 'G', 'A', 'B'): for i in range(self.order, 0, -1): outLetters.append(letter + '-' * i) outLetters.append(letter) for i in range(self.order): outLetters.append(letter + '#' * (i + 1)) if letter not in ('E', 'B'): outLetters.append(None) return outLetters
# ------------------------------------------------------------------------------ class Test(unittest.TestCase): pass # ------------------------------------------------------------------------------ _DOC_ORDER = [base40ActualInterval] if __name__ == '__main__': # bn = BaseN(3) # print(bn.generateLetters()) import music21 music21.mainTest(Test)