jC dZddlmZddlZddlmZddlmZddlmZddlmZddlm Z id d d d d ddddddddddddddddddddd d!d"d#d$d%d&d'd(id)d*d+d,d-d.d/d0d1d2d3dd4d5d6d7d8d9d:d;ddd?d@dAdBdCdDdEdFdGdHddIdJdKdLdMdNZ id d d d dd ddddddddddddddd dd"d!d$d#d&d%d(d'd*d)d,d+id.d-d0d/d2d1d5d4d7d6d9d8d;d:d=d<d@d?dBdAdDdCdFdEdHdGdIdOdJdPdKdQdLdRdMdSiZ iddTd dUddVddWddXddYddZdd[dd\dd]d%d^d'd_d)d`d1dad3dbd4dcd:dddedfdgdhdidjdkdldmdn Z doZ dpZdqZdrZdsZddvZddwZddxZddyZGdzd{ejZGd|d}ZGd~dejZegZedkrddlZejedSdS)zx Implementation of Walter Hewlett's base40 system for musical intervals. (See Hewlett and Ann K. Blombach 1989 article) ) annotationsN)common) exceptions21)interval)note)pitchzC--zC-CzC#zC##zD--zD- D zD# zD## zE--zE-EzE#zE##zF--zF-FzF#zF##zG--zG-GzG#zG##zA--zA- A!zA#"zA##zB--zB-BzB#zB##)#$%&'(r3r4r5r6r7P1A1d2m2M2A2d3m3M3A3d4P4A4d5P5A5d6m6M6A6d7m7M7A7d8P8) r)r*r+r/r0r2r3r6r7cd}|dkrd}t|dz} t|}tj|}n-#t$r t dt |zwxYwt|dz}|j}tj||j d|zzz}|j }t |j t |j z} tj| S)aZ 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) >>> musedata.base40.base40DeltaToInterval(11) >>> musedata.base40.base40DeltaToInterval(23) >>> musedata.base40.base40DeltaToInterval(-23) >>> musedata.base40.base40DeltaToInterval(52) >>> musedata.base40.base40DeltaToInterval(-52) >>> musedata.base40.base40DeltaToInterval(77) Traceback (most recent call last): music21.musedata.base40.Base40Exception: Interval not handled by Base40 37 r rr7zInterval not handled by Base40 r) absbase40IntervalTablerIntervalKeyErrorBase40ExceptionstrgenericGenericIntervalvaluediatonic specifier) delta direction simpleDeltasimpleIntervalNamesimpleInterval numOctavessgicgisdi newIntervals /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/musedata/base40.pybase40DeltaToIntervalrjs@I qyy e**r/KT0=!*+=>> TTT?#kBRBRRSSSTUr!J  C  "9 A N0J#K L LC  !Ccm$$s39~~5K  [ ) ))s !A*A*ctj}|dz dz dz|_|d|jdz zz }t|}| ||_|St dt |z)a 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) >>> musedata.base40.base40ToPitch(40) >>> 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) r r7N.Pitch name not assigned to this Base40 number )rPitchoctavebase40EquivalentnamerXrY) base40NumptableNum pitchNames ri base40ToPitchrusp&  AQ"$)AH2A..H *I JSQZ^^[ \ \\ct|trtj|}|jt vr$t |j}d|jdz z|z}|Std|jz)a] 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 r7r z Base40 cannot handle this pitch ) isinstancerYrrmrpbase40RepresentationrnrXnameWithOctave)pitchToConvertrsrqs ri pitchToBase40r|sw".#&&5^44222'(;<>0145A  <~?\\ ] ]]rvct|dz dzdz}t|dz dzdz}||z }|7|5tdt|zdzt|zdz|"tdt|zdz|"tdt|zdz|dkrG|d |d kr5td t|zdzt|zd zt|S) at 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) >>> musedata.base40.base40Interval(186, 174) # Descending M3 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 r r7Nz0Pitch name not assigned to these Base40 numbers z and z Interval does not existrlr rz'Base40 cannot compute interval between .)rorXrYrj) base40NumA base40NumBpitchApitchBr_s ribase40Intervalr shHzA~3a7 8F zA~3a7 8F  #E ~&.P #J029: #J02LMNN N~N #J02LMNN N ~N #J02LMNN N qyyVAY&)++G #J029:>> musedata.base40.base40ActualInterval(163, 191) >>> musedata.base40.base40ActualInterval(186, 174) # Descending M3 >>> musedata.base40.base40ActualInterval(1, 5) >>> musedata.base40.base40ActualInterval(1, 3) >>> 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 z0Unusual interval- Limitation of music21.interval)rurNoterrrV IndexErrorrX)rrrrnoteAnoteBs ribase40ActualIntervalrDs6: & &F : & &F IKKEEK IKKEEKR ... RRRPQQQRs A))BupTc"|dkrd}n|dkrd}ntd|g}tj|r"|}t|d}|d}nt |d}|||zdz}|dkrd}t|d}|d ur|t |d krd}|d}nH|d|dkrd}d}|D]}|d|dkrd}d}|||||S) zX Helper function for quickHigherEnharmonicString and quickLowerEnharmonicString rr downzNot a valid direction, Nr7rFr )rXrisNumrogetrylenappend)nameStrr`allowDoubleAccidentalsaddNum enharmonics base40num base40stres ri_quickEnharmonicStringrmsoD f  C CCDDDK |G< "&&y$77 ?I(,,Wd;;  '2- >>I$((D99 !U * *y/DYZ[I[I[I  II|wqz))    % %Q<1Q4'' $I $I$""9---)  , rvc&t|d|S)a 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--'] rr`rrrrs riquickHigherEnharmonicStringrs' "',09O Q Q QQrvc&t|d|S)a  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##'] rrrrs riquickLowerEnharmonicStringrs' "',29O Q Q QQrvclt||}|t|||S)a 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--'] )rextendr)rrharmonicStrings riquickEnharmonicStringrs:09OPPN5g?UVVWWW rvceZdZdS)rXN__name__ __module__ __qualname__rvrirXrXDrvrXceZdZddZdZdS)BaseNr c||_dS)N)order)selfrs ri__init__zBaseN.__init__s  rvcBg}dD]}t|jddD]}||d|zz||t|jD] }||d|dzzz!|dvr|d|S)N)r rrr r'r.r1rrS-#r )rr1)rangerr)r outLettersletteris rigenerateLetterszBaseN.generateLetterss 9 ( (F4:q"-- 4 4!!&37"23333   f % % %4:&& : :!!&3!a%="89999Z''!!$'''rvN)r )rrrrrrrvrirrs7     rvrceZdZdS)TestNrrrvrirrrrvr__main__)rT)T)__doc__ __future__runittestmusic21rrrrrroryrUrjrur|rrrrrrMusic21ExceptionrXrTestCaser _DOC_ORDERrmainTestrrvrirs#""""" (Au(t(s(t(u ( t ( u (t(s(((((((( !(("#($%(&'(()(*+(,-(./(01(23(45(67(89(:;(<=(>?(@A(BC((DO(((Z(q(a(Q(a(q ( q (a(Q(b(r(r(b(R(b( r!("r#($b%((&R'((b)(*r+(.r/(0b1(2R3(4b5(6r7(:r;(<b=(>R?(@bA(BrC(FrG(HbI(JRK(LbM((NrO((Z!q$!4!4!4 ! 4 ! 4 !D!D!D!D!D!D!D!"D#!$D%!&D'!*D+!,!        A!!!H5*5*5*p]]]<^^^87(7(7(t&R&R&RR****ZQQQQ(QQQQ($     l3   &     8    # #  zNNNGT rv