rhC SrSSKJr SSKrSSKJr SSKJr SSKJr SSKJr SSKJ r 0S S _S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS _S!S"_S#S$_S%S&_S'S(_0S)S*_S+S,_S-S._S/S0_S1S2_S3S_S4S5_S6S7_S8S9_S:S;_SS_S?S@_SASB_SCSD_SESF_SGSH_ESSISJSKSLSMSN.Er 0S S _S S _SS _SS_SS_SS_SS_SS_SS_SS_S S_S"S!_S$S#_S&S%_S(S'_S*S)_S,S+_0S.S-_S0S/_S2S1_S5S4_S7S6_S9S8_S;S:_S=S<_S@S?_SBSA_SDSC_SFSE_SHSG_SISO_SJSP_SKSQ_SLSR_ESMSS0Er 0SST_S SU_SSV_SSW_SSX_SSY_SSZ_SS[_SS\_SS]_S%S^_S'S__S)S`_S1Sa_S3Sb_S4Sc_S:Sd_SeSfSgShSiSjSkSlSmSn. Er Sor SprSqrSrrSsrSStjrSSujrSSvjrSSwjr"SxSy\R,5r"SzS{5r"S|S}\R25r\/r\S~:XaSSKr\R:"\5 gg)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/r0r2r3r6r7cSnUS:aSn[U5S-n[Un[R"U5n[U5S-nURn[R"XRSU---5nURn[ UR5[ UR5-n [R"U 5$![a [ S[ U5-5ef=f)a 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 Q/home/james-whalen/.local/lib/python3.13/site-packages/music21/musedata/base40.pybase40DeltaToIntervalrjsBI qy e*r/KT0=!**+=>Ur!J  C  " "9 A N0J#K LC  ! !Ccmm$s399~5K   [ )) T?#kBRRSSTs C"C*c[R"5nUS- S- S-UlUSURS- -- n[UnUbX1lU$[ S[ U5-5e)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 r7.Pitch name not assigned to this Base40 number )rPitchoctavebase40EquivalentnamerXrY) base40NumptableNum pitchNames ri base40ToPitchrusk(  AQ"$)AH2A..H *I JSQZ^[ \\c[U[5(a[R"U5nUR[ ;a*[ URnSUR S- -U-nU$[SUR-5e)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$.#&&^422'(;(;<>00145A  <~?\?\\ ]]rvc[US- S-S-n[US- S-S-nX- nUc,Uc)[S[U5-S-[U5-S-5eUc[S[U5-S-5eUc[S[U5-S-5eUS:a5USUS:Xa)[S [U5-S-[U5-S -5e[U5$) a 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 r7z0Pitch name not assigned to these Base40 numbers z and z Interval does not existrlr rz'Base40 cannot compute interval between .)rorXrYrj) base40NumA base40NumBpitchApitchBr_s ribase40Intervalrs:LzA~3a7 8F zA~3a7 8F  #E ~&.P #J029: #J02LMN N~N #J02LMN N ~N #J02LMN N qyVAY&)+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 ribase40ActualIntervalrJsl8: &F : &F IIKEK IIKEKR  .. RPQQRs A$$A:cUS:XaSnOUS:XaSnO[SU35e/n[R"U5(aUn[R US5nUcSnO[ R US5nUbXS-S-nUS:XaSn[R US5nUS LaUb[ U5S :aSnUcSnO?USUS:XaSnSnUHnUSUS:XdMSnSnM UbURU5 UbMU$) zP Helper function for quickHigherEnharmonicString and quickLowerEnharmonicString upr downzNot a valid direction, Nr7rFr )rXrisNumrogetrylenappend)nameStrr`allowDoubleAccidentalsaddNum enharmonics base40num base40stres ri_quickEnharmonicStringrts7D f  7 {CDDK ||G "&&y$7 ?I(,,Wd;  '2- >I$((D9 !U *y/DYZ[I[I  I|wqz)   Q<1Q4' $I $I!$""9-)  , rvc[USUS9$)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 QQrvc[USUS9$)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 QQrvcP[X5nUR[X55 U$)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(0PN5gVW rvc\rSrSrSrg)rXiN__name__ __module__ __qualname____firstlineno____static_attributes__rrvrirXrXrvrXc$\rSrSrSSjrSrSrg)BaseNicXlg)Norder)selfrs ri__init__BaseN.__init__s rvcF/nSHn[URSS5HnURUSU--5 M URU5 [UR5HnURUSUS---5 M US;dMURS5 M U$)N)r rrr r'r.r1rrS-#r )rr1)rangerr)r outLettersletteris rigenerateLettersBaseN.generateLetterss 9F4::q"-!!&37"23.   f %4::&!!&3!a%="89'Z'!!$':rvrN)r )rrrrrrrrrvrirrs  rvrc\rSrSrSrg)TestirNrrrvrirrrrvr__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!H6*r]>^:9(x'RT*ZQ(Q($ l33 & 8   # #  z T rv