jdZddlmZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl m Z ddl mZdd l mZdd l mZdd l mZdd lmZdd lmZddlmZddlmZddlmZddZd dZGddZGddZeeeegZGdde jZGddejZ e!dkrddl Z e j"e dSdS)!aV This module, the heart of fbRealizer, is all about realizing a bass line of (bassNote, notationString) pairs. All it takes to create well-formed realizations of a bass line is a few lines of music21 code, from start to finish. See :class:`~music21.figuredBass.realizer.FiguredBassLine` for more details. >>> from music21.figuredBass import realizer >>> fbLine = realizer.FiguredBassLine() >>> fbLine.addElement(note.Note('C3')) >>> fbLine.addElement(note.Note('D3'), '4,3') >>> fbLine.addElement(note.Note('C3', quarterLength = 2.0)) >>> allSols = fbLine.realize() >>> allSols.getNumSolutions() 30 >>> #_DOCS_SHOW allSols.generateRandomRealizations(14).show() .. image:: images/figuredBass/fbRealizer_intro.* :width: 500 The same can be accomplished by taking the notes and notations from a :class:`~music21.stream.Stream`. See :meth:`~music21.figuredBass.realizer.figuredBassFromStream` for more details. >>> s = converter.parse('tinynotation: C4 D4_4,3 C2', makeNotation=False) >>> fbLine = realizer.figuredBassFromStream(s) >>> allSols2 = fbLine.realize() >>> allSols2.getNumSolutions() 30 ) annotationsN)chord)clef) exceptions21)key)meter)note)pitch)stream)checker)notation) realizerScale)rules)segment streamPart stream.StreamreturnFiguredBassLinec|}|tj}|tjx}r|}nP|tjx}r|d}nt jd}|tj x}r|}ntj d}t||}| r;| dd} tjr| J| j} | dkr| |_dfd |D]} | jrd} t'| jD]Q\} }|jdvrd|jvr|j} n| |j} | dzt+| jkr| dz } R|| | || |S)a Takes a :class:`~music21.stream.Part` (or another :class:`~music21.stream.Stream` subclass) and returns a :class:`~music21.figuredBass.realizer.FiguredBassLine` object whose bass notes have notations taken from the lyrics in the source stream. This method along with the :meth:`~music21.figuredBass.realizer.FiguredBassLine.realize` method provide the easiest way of converting from a notated version of a figured bass (such as in a MusicXML file) to a realized version of the same line. >>> s = converter.parse('tinynotation: 4/4 C4 D8_6 E8_6 F4 G4_7 c1', makeNotation=False) >>> fb = figuredBass.realizer.figuredBassFromStream(s) >>> fb >>> fbRules = figuredBass.rules.Rules() >>> fbRules.partMovementLimits = [(1, 2), (2, 12), (3, 12)] >>> fbRealization = fb.realize(fbRules) >>> fbRealization.getNumSolutions() 13 >>> #_DOCS_SHOW fbRealization.generateRandomRealizations(8).show() .. image:: images/figuredBass/fbRealizer_fbStreamPart.* :width: 500 * Changed in v7.3: multiple figures in same lyric (e.g. '64') now supported. majorC4/4rT)indicesNotNumbersNannotationStringstr inputTextrcd}|ddvr0t|dkr|drd}n|drd}nd}||d|z }||dr|dz }|||d}|S)z Continue building the working `annotationString` based on some `inputText` that has yet to be processed. Called recursively until `inputText` is exhausted or contains unexpected characters. r+#bniN, )len isnumeric)rrstop_index_exclusiveupdateAnnotationStrings /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/figuredBass/realizer.pyr&z5figuredBassFromStream..updateAnnotationStringts%& Q<6 ! !c)nnq&8&8Yq\=S=S=U=U&8#$ q\ # # % % (#$ $( I&;';&;<< )** + D  $ 55 ),@,A,A"B D D )Nr),r r")rrrrrr)flattengetElementsByClassr NoterKeyfirst KeySignatureasKeyr TimeSignaturer hasMeasuresmeasuret TYPE_CHECKING paddingLeft _paddingLeftlyrics enumeratetextr# addElement)rsfsfnfirstKeymyKeyfirstKeySignaturefirst_tstsfbm_firstr7nri lyric_liner&s @r'figuredBassFromStreamrI?s/6     B   * *Ccg;$$&&&x !1288:: : !''00 e)*00222x(    ' '  # #B*$$Q$$?? ? '&&&) #  )BO      . 8 $& !*18!4!4 - - :?j00*/))(2$$(>'=>NPZP_'`'`$q53qx==(($,$ MM!- . . . . MM!     Ir(c$g|_tj|}|jsdSt d|jD}|jD]E}d}t |t |z D]}|dz }|||zdFdS)a Takes in a bassNote and a corresponding notationString as arguments. Adds the parsed notationString as lyrics to the bassNote, which is useful when displaying the figured bass in external software. >>> from music21.figuredBass import realizer >>> n1 = note.Note('G3') >>> realizer.addLyricsToBassNote(n1, '6,4') >>> n1.lyrics[0].text '6' >>> n1.lyrics[1].text '4' >>> #_DOCS_SHOW n1.show() .. image:: images/figuredBass/fbRealizer_lyrics.* :width: 100 Nc,g|]}t|S)r#).0fss r' z'addLyricsToBassNote..s777SWW777r(r) T)applyRaw)r9r Notation figureStringsmaxranger#addLyric)bassNotenotationStringrF maxLengthrN spacesInFrontrGs r'addLyricsToBassNoter[s$HO.))A ?77q77788Io== y3r77*++ ! !A S MM-",t<<<< ==r(cdeZdZUdZgdZdddZded<dd Zddd Zd Z ddZ dZ ddZ dZ dS)ra A FiguredBassLine is an interface for realization of a line of (bassNote, notationString) pairs. Currently, only 1:1 realization is supported, meaning that every bassNote is realized and the :attr:`~music21.note.GeneralNote.quarterLength` or duration of a realization above a bassNote is identical to that of the bassNote. `inKey` defaults to C major. `inTime` defaults to 4/4. >>> from music21.figuredBass import realizer >>> fbLine = realizer.FiguredBassLine(key.Key('B'), meter.TimeSignature('3/4')) >>> fbLine.inKey >>> fbLine.inTime )r<generateBassLinerealizez A :class:`~music21.key.Key` which implies a scale value, scale mode, and key signature for a :class:`~music21.figuredBass.realizerScale.FiguredBassScale`. z A :class:`~music21.meter.TimeSignature` which specifies the time signature of realizations outputted to a :class:`~music21.stream.Score`. )inKeyinTimedict[str, str] _DOC_ATTRNc*|tjd}|tjd}||_||_d|_tj|_ tj | d|j |_g|_dS)Nrrrr )rr.rr2r_r`r8r Part_overlaidPartsrFiguredBassScalepitchFromDegreemode_fbScale_fbList)selfr_r`s r'__init__zFiguredBassLine.__init__s~ =GCLLE >(//F  $kmm%6u7L7LQ7O7OQVQ[\\  r( bassObject note.Notec||j_|j}d|vr.|j||ft ||dSd|vsd|vr|j|dSt d|)a Use this method to add (bassNote, notationString) pairs to the bass line. Elements are realized in the order they are added. >>> from music21.figuredBass import realizer >>> fbLine = realizer.FiguredBassLine(key.Key('B'), meter.TimeSignature('3/4')) >>> fbLine.addElement(note.Note('B2')) >>> fbLine.addElement(note.Note('C#3'), '6') >>> fbLine.addElement(note.Note('D#3'), '6') >>> #_DOCS_SHOW fbLine.generateBassLine().show() .. image:: images/figuredBass/fbRealizer_bassLine.* :width: 200 OMIT_FROM_DOCS >>> fbLine = realizer.FiguredBassLine(key.Key('C'), meter.TimeSignature('4/4')) >>> fbLine.addElement(harmony.ChordSymbol('C')) >>> fbLine.addElement(harmony.ChordSymbol('G')) >>> fbLine = realizer.FiguredBassLine(key.Key('C'), meter.TimeSignature('4/4')) >>> fbLine.addElement(roman.RomanNumeral('I')) >>> fbLine.addElement(roman.RomanNumeral('V')) r- RomanNumeral ChordSymbolzcNot a valid bassObject (only note.Note, harmony.ChordSymbol, and roman.RomanNumeral supported) was N) editorialrXclassesrjappendr[FiguredBassLineException)rkrmrXcs r'r<zFiguredBassLine.addElements2/= +   Q;; L  ^ < = = =  N ; ; ; ; ; q MQ$6$6 L   + + + + +*]NX]] r(c2tj}|tj|t j|jj|tj |j d}|j dkr/tj|j }|||jD]\}}|||dd}||tj}||tj||S)a Generates the bass line as a :class:`~music21.stream.Score`. >>> from music21.figuredBass import realizer >>> fbLine = realizer.FiguredBassLine(key.Key('B'), meter.TimeSignature('3/4')) >>> fbLine.addElement(note.Note('B2')) >>> fbLine.addElement(note.Note('C#3'), '6') >>> fbLine.addElement(note.Note('D#3'), '6') >>> #_DOCS_SHOW fbLine.generateBassLine().show() .. image:: images/figuredBass/fbRealizer_bassLine.* :width: 200 >>> sBach = corpus.parse('bach/bwv307') >>> sBach.parts.last().measure(0).show('text') {0.0} ... {0.0} {0.0} {0.0} {0.0} {0.5} >>> fbLine = realizer.figuredBassFromStream(sBach.parts.last()) >>> fbLine.generateBassLine().measure(1).show('text') {0.0} {0.0} {0.0} {3.0} {3.5} Nr quarterLengthFinPlacecautionaryNotImmediateRepeat)r rdrtrBassClefrr0r_sharpscopydeepcopyr`r8r Restrj makeNotationr,Measurer/removepadAsAnacrusis)rkbassLinerrWunused_notationStringbl2m0s r'r]z FiguredBassLine.generateBassLinesQ>;== (((():;;<<< dk22333    # # (9:::A OOA   15 & & -X, OOH % % % %##EPU#VV =''77==??B IIb++DI66<<>> ? ? ?       r(c |tj}|tjd}g}|}t |jdkr4|j|tj |j}ntj |}t| }| j}d}||} ||dd} tj| | jj|j|||} | j| _|| |ddD])} | \} }|| d} tj| | jj|j|||}t+dt || D]4}|| |dz }|jj||f5| | j| jzkr|dz }||} | j|_nOt+t || |dzD]!}| jj|"d|_|||} +|S)z generates the segmentList from an fbList, including any overlaid Segments if fbRules is None, creates a new rules.Rules() object if maxPitch is None, uses pitch.Pitch('B5') NB5r rr)rRulesr Pitchr]r#rertr extractHarmoniescreateOffsetMappingsortedkeysr+notesrOverlaidSegmentrrrXriryrUfbRules_partPitchLimitsoffset _partsToCheck)rkrnumPartsmaxPitch segmentListrcurrentMappingallKeys bassNoteIndexpreviousBassNoterWpreviousSegmentk startTimeunused_endTimecurrentSegment partNumber upperPitchs r'retrieveSegmentsz FiguredBassLine.retrieveSegmentsEs ?kmmG  {4((H ((** t" # #q ( (   & &x 0 0 0$5d6IJJNN$8BBN,,..//##%%+ #M2!'!*-b1!1(H!+<'='=>> Y Y +A.zA~> &7>> J?WXXXX,36F6TTTT" #+M#: /?/M,,"'N1,=(>(>1 "M"MMMJ#+9@@LLLL03,   ~ . . .,OOr(c:|j|dSN)rert)rk music21Parts r' overlayPartzFiguredBassLine.overlayPartys "";/////r(c V|tj}|tjd}g}d}|jD]-} |j}n#t $rYwxYwd|vrn d|vsd|vrd}n.|r|jD]}g} |jD]} | | j i} | D]} | | | <| } d}tj | j||jj }t#j||j|||| }||jj|_||n||||}t+|d krt-t+|d z D]}||}||d z}||}t1jt4|_t5|}|D]%\}}|j||&||nSt+|d kr/|d }t5||_n|st?dtA||j!|j"|j#d d|j$S)aA Creates a :class:`~music21.figuredBass.segment.Segment` for each (bassNote, notationString) pair added using :meth:`~music21.figuredBass.realizer.FiguredBassLine.addElement`. Each Segment is associated with the :class:`~music21.figuredBass.rules.Rules` object provided, meaning that rules are universally applied across all Segments. The number of parts in a realization (including the bass) can be controlled through numParts, and the maximum pitch can likewise be controlled through maxPitch. Returns a :class:`~music21.figuredBass.realizer.Realization`. If this method is called without having provided any (bassNote, notationString) pairs, a FiguredBassLineException is raised. If only one pair is provided, the Realization will contain :meth:`~music21.figuredBass.segment.Segment.allCorrectConsecutivePossibilities` for the one note. if `fbRules` is None, creates a new rules.Rules() object if `maxPitch` is None, uses pitch.Pitch('B5') >>> from music21.figuredBass import realizer >>> from music21.figuredBass import rules >>> fbLine = realizer.FiguredBassLine(key.Key('B'), meter.TimeSignature('3/4')) >>> fbLine.addElement(note.Note('B2')) >>> fbLine.addElement(note.Note('C#3'), '6') >>> fbLine.addElement(note.Note('D#3'), '6') >>> fbRules = rules.Rules() >>> r1 = fbLine.realize(fbRules) >>> r1.getNumSolutions() 208 >>> fbRules.forbidVoiceOverlap = False >>> r2 = fbLine.realize(fbRules) >>> r2.getNumSolutions() 7908 OMIT_FROM_DOCS >>> fbLine3 = realizer.FiguredBassLine(key.Key('C'), meter.TimeSignature('2/4')) >>> h1 = harmony.ChordSymbol('C') >>> h1.bass().octave = 4 >>> fbLine3.addElement(h1) >>> h2 = harmony.ChordSymbol('G') >>> h2.bass().octave = 4 >>> fbLine3.addElement(h2) >>> r3 = fbLine3.realize() >>> r3.getNumSolutions() 13 >>> fbLine4 = realizer.FiguredBassLine(key.Key('C'), meter.TimeSignature('2/4')) >>> fbLine4.addElement(roman.RomanNumeral('I')) >>> fbLine4.addElement(roman.RomanNumeral('IV')) >>> r4 = fbLine4.realize() >>> r4.getNumSolutions() 13 NrFr-rprqTc|dkr|ndS)Nrg?rL)ys r'gz"FiguredBassLine.realize..gs !S11c1r(rx)rWfbScalerrr listOfPitchesr!r rz/No (bassNote, notationString) pairs to realize.r)realizedSegmentListr_r` overlaidPartsr7)%rrr rrjrsAttributeErrorpitchesrtnamevaluesr r-bassnameWithOctavedurationryrSegmentrirr#rU"allCorrectConsecutivePossibilities collections defaultdictlist movements_trimAllMovementsallCorrectSinglePossibilitiescorrectAru Realizationr_r`rer8)rkrrrrlistOfHarmonyObjectsitemrv harmonyObjectlistOfPitchesJustNames thisPitchdx outputListr passedNotecorrespondingSegment segmentIndexsegmentAsegmentB correctABlistABpossibApossibBs r'r^zFiguredBassLine.realize|sOp ?kmmG  {4((H $L  D L!    {{""mq&8&8'+$'9  M!% 9 9 )+&!.!6BBI*11).AAAA/AAaDDXXZZ 222"Y}'9'9';';'J56Q}7M7[5\5\^^^ '. ?C}?F@H@HEO (Q(Q(Q$ 67Q}7M7[5\5\$2""#78888- 92//8LLK {  q %c+&6&6&: ; ; @ @ &|4&|a'78$GGQQ %0%z3FiguredBassLine._trimAllMovements..s [1Hr()r#reverserUrritemsfilter) rkr movementsABrr possibCListr possibBListrs @r'rz!FiguredBassLine._trimAllMovementss {  q C $4$4$9$94    " "    ! ! !K %a[)9)9A)= > > Y Y ),*:;E ),7A .2;3D3D3F3F.G.G11*Wk&1'0.2;3D3D3F3F.G.GYY*Wk+/IIII;WW,Y,YK((Y+/{/@/@/B/B*C*C - -&+"-#G,    ! ! !4)# "r()NNr)rmrn)NrN)__name__ __module__ __qualname____doc__ _DOC_ORDERrb__annotations__rlr<r]rrr^rrLr(r'rrs"?>>J  ! !I        %%%%%N000d2222h000z:z:z:z:x!!!!!r(c`eZdZUdZgdZddiZded<dZdZd Z d Z d Z d Z d Z ddZdS)ra@ Returned by :class:`~music21.figuredBass.realizer.FiguredBassLine` after calling :meth:`~music21.figuredBass.realizer.FiguredBassLine.realize`. Allows for the generation of realizations as a :class:`~music21.stream.Score`. * See the :mod:`~music21.figuredBass.examples` module for examples on the generation of realizations. * A possibility progression is a valid progression through a string of :class:`~music21.figuredBass.segment.Segment` instances. See :mod:`~music21.figuredBass.possibility` for more details on possibilities. )getNumSolutionsgenerateRandomRealizationgenerateRandomRealizationsgenerateAllRealizationsgetAllPossibilityProgressionsgetRandomPossibilityProgression-generateRealizationFromPossibilityProgressionkeyboardStyleOutputa  True by default. If True, generated realizations are represented in keyboard style, with two staves. If False, realizations are represented in chorale style with n staves, where n is the number of parts. SATB if n = 4.rarbc d|vr |d|_d|vr0|d|_tj|jj|_d|vr |d|_d|vr |d|_d|vr |d|_d|_ dS)Nrr_r`rr7T) _segmentList_inKeyrr0r~_keySig_inTimerer8r)rk fbLineOutputss r'rlzRealization.__init__4s M 1 1 -.C DD  m # #'0DK+DK,>??DL } $ $(2DL m + +"/"@D  M ) ) -m >> from music21.figuredBass import examples >>> fbLine = examples.exampleB() >>> fbRealization = fbLine.realize() >>> fbRealization.getNumSolutions() 422 >>> fbLine2 = examples.exampleC() >>> fbRealization2 = fbLine2.realize() >>> fbRealization2.getNumSolutions() 833 r r)r#rrrrUr) rkpathListrr newPathListr prevValuer numSolutionss r'rzRealization.getNumSolutionsCsW" t ! !Q & &t(+455 5 !!###!!S):%;%;<< # #L(6HK 5'1LLG+.x/A'/J+K+KK((L (155G !I#+#5g#>77!Xg%66 +4K(("HH  . .G HW- -LL !!###r(cg}t|jdkr-|jdjD]}||g|S|jdj}|D]&}||}|D]}|||g't dt|jdz D]}|j|j}t t|D]h}|d}|d}||D]@} tj|} | | || Ai|S)a Compiles each unique possibility progression, adding it to a master list. Returns the master list. .. warning:: This method is unoptimized, and may take a prohibitive amount of time for a Realization which has more than 200,000 solutions. r rr)r#rrrtrrUpopr) rk progressionsr currMovementsrrrunused_progressionIndex progressionpossibCnewProgressions r'rz)Realization.getAllPossibilityProgressionsms t ! !Q & &,Q/8 / /##WI.... )!,6 $ 8 8G'0K& 8 8##Wg$67777 8"!S):%;%;a%?@@ 8 8L -l;EM+0\1B1B+C+C 8 8'*..q11 %b/,W588G%)Y{%;%;N"))'222 ''77778 8r(cg}t|jdkrBtj|jdjdd}|||S|jdj}|dkrtdtj| dd}||tt|jdz D]L}|j|j}tj||dd}|||}M|S)zB Returns a random unique possibility progression. r rZero solutions) r#rrandomsamplerrtrrrurrU)rkrrr prevPossibr nextPossibs r'rz+Realization.getRandomPossibilityProgressions9 t ! !Q & &mD$5a$8$A1EEaHG   w ' ' ' )!,6    ! !Q & &*+;<< <]=#5#5#7#7;;A> :&&&!#d&7"8"81"<== $ $L -l;EM}Z'@!DDQGJ   z * * *#JJr(cj tj}tj}|t j|jt j|jgd}|jdkrAtj |j}|t j||j rtj}| d||t j|jt j|jg|'|t j|tt|jD]}||}|j|j}|t j||dd} t#j| } |j|j| _|| | dt)j|dd|5|dd |dn)g} tt|dd z D]} tj} | d| | t j|jt j|jg|'| t j|| | tt|jD]}||}|j|j}|t j|tt|d z D]N}tj||}|j|j|_| ||O| D]}}t)j|dd }| d||dd|5|dd |d~| dt)j|dd|5|dd |d| d||S) zn Generates a realization as a :class:`~music21.stream.Score` given a possibility progression. NrrxrrTFrzrr )allowTreble8vbrecurse)r Scorerdrtrrrrr8r rrinsertrUr#rrWrChordryr TrebleClefrrrr-bestClefr})rkpossibilityProgressionsolrr rightHandrrrW rhPitchesrhChord upperParts _partNumberfbPartrn1 upperPartrvs r'rz9Realization.generateRealizationFromPossibilityProgressionslnn;==t|44dmDL6Q6QRSSS    # # (9:::A OODM!,, - - -  #0 2 I JJsI & & &   dmDL994=;V;VW X X X}  q!1!1222 %c$*;&<&< = = * * 0>,\:C h 7 7888#AbDM +i00(,(9,(G(U%  ))))   S$/"3"3 4 4 4  " "4e " T T T}!   ###! ++---J$S)?)B%C%Ca%GHH * *  3''' t}T\::DM$,,\:C h 7 7888"'G q(8"9"966J7:#677B'+'8'F'TB$z*11"55556 ( 2 2 M)D$OOO  a(((&&tRW&XXX=aL$$Q'''aL//111T]__---dOOO = QKOOA    QK & & ( ( ( 3!!! r(ctj}|}|std||d}|D]}||t dt|D]b}|||}t t|D](}||D]}|||)c|S)z Generates all unique realizations as a :class:`~music21.stream.Score`. .. warning:: This method is unoptimized, and may take a prohibitive amount of time for a Realization which has more than 100 solutions. rrr )r rrrurrtrUr#) rkallSolspossibilityProgressionssol0r possibIndexsolX partIndexmusic21Measures r'rz#Realization.generateAllRealizationss,.."&"D"D"F"F& =*+;<< <AABYZ[B\]] ( (K NN; ' ' ' ' C(?$@$@AA > >KEE' 466D"3t99-- > > &*9o>>NI&--n====> >r(cT|}||S)z\ Generates a random unique realization as a :class:`~music21.stream.Score`. )rr)rkrs r'rz%Realization.generateRandomRealizations+"&!E!E!G!GAABXYYYr(c||kr|Stj}|}|D]}||t d|D][}|}t t|D](}||D]}|||)\|S)z Generates *amountToGenerate* unique realizations as a :class:`~music21.stream.Score`. .. warning:: This method is unoptimized, and may take a prohibitive amount of time if amountToGenerate is more than 100. r )rrr rrrtrUr#) rkamountToGeneraterr!runused_counter_solutionr#r$r%s r'rz&Realization.generateRandomRealizations s d2244 4 4//11 1,..--// ( (K NN; ' ' ' '',Q0@'A'A > > #1133D"3t99-- > > &*9o>>NI&--n====> >r(N)r')rrrrrrbrrlrrrrrrrrLr(r'rrs  CCCJ  >!I ( ( ((((T@0EEEN0ZZZr(rceZdZdS)ruN)rrrrLr(r'ruru'sDr(ruceZdZdZdS)Testcddlm}|dd}|tjd}||jdt|}||jj dd |_t|}||jj d d |_t|}||jj d d |_t|}||jj ddD]f}| |5||_t|}||jj |dddn #1swxYwYgdS)Nr) converterz#tinynotation: 4/4 C4 F4 G4_64 G4 C1F)rr!64z6, 4z#6#42z #6, #4, 2z#64#2z #6, 4, #2z6 4r) single_symbol) music21r/parser r- assertEquallyricrIrrrXsubTest)rkr/s third_note unused_fbr1s r'testMultipleFiguresInLyriczTest.testMultipleFiguresInLyric.s%%%%%% OOAPUO V Vty\!_  )4000)!,,  -rCs|<#"""""  ''''''((((((------%%%%%%''''''____D==== zNNNGTr(