3jdZddlmZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl m Z ddl mZdd l mZdd l mZdd l mZdd lmZdd lmZddlmZddlmZddlmZddZddZGddZGddZeeeegZGdde j:ZGddej>Z e!dk(rddl Z e jDe yy)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)segmentFiguredBassLinec|j}|jtj}|tj j x}r|}nJ|tjj x}r|jd}nt j d}|tjj x}r|}ntjd}t||}|jr?|jdd} tjr| J| j } | dk7r| |_dfd |D]} | j$rd } t'| j$D]c\} }|j(d vrd |j(vr |j(} n| |j(} | d zt+| j$ks_| d z } e|j-| | |j-| |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)indicesNotNumberscd}|ddvr$t|dkDr|djrd}n|djrd}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)annotationString inputTextstop_index_exclusiveupdateAnnotationStrings I/DATA/.local/lib/python3.12/site-packages/music21/figuredBass/realizer.pyr"z5figuredBassFromStream..updateAnnotationStringts%& Q<6 !c)nq&8Yq\=S=S=U#$ q\ # # %#$ $( I&;';<< )* +  $ 5 ),@,A"B D )Nr%,rr)rstrr r'returnr')flattengetElementsByClassr NoterKeyfirst KeySignatureasKeyr TimeSignaturer hasMeasuresmeasuret TYPE_CHECKING paddingLeft _paddingLeftlyrics enumeratetextr addElement) streamPartsfsfnfirstKeymyKeyfirstKeySignaturefirst_tstsfbm_firstr5nri lyric_liner"s @r#figuredBassFromStreamrH?s6    B   *Ccgg;$$&&x& !1!1288: :  :!''0 e))*0022x2    '  #B$$Q$$? ??& &&)) # )BO . 88$& !*188!4 :??j0*//)(2$(>>NPZP_P_'`$q53qxx=($,$"5 MM!- . MM! #& Ir$cLg|_tj|}|jsyt |jDcgc] }t |c}}|jD];}d}t |t |z D]}|dz } |j||zd=ycc}w)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 Nr% T)applyRaw)r7r Notation figureStringsmaxrrangeaddLyric)bassNotenotationStringrEfs maxLength spacesInFrontrFs r#addLyricsToBassNoterVs$HO.)A ??q7SW78Ioo y3r7*+A S M,-",t< 8sB!cbeZdZUdZgdZdddZded<dd Zddd Zd Z dd Z d Z ddZ dZ y)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_ATTRNc2|tjd}|tjd}||_||_d|_tj|_ tj|jd|j|_g|_y)Nrrrr)rr,rr0rZr[r6r Part_overlaidPartsrFiguredBassScalepitchFromDegreemode_fbScale_fbList)selfrZr[s r#__init__zFiguredBassLine.__init__sz =GGCLE >((/F  $kkm%66u7L7LQ7OQVQ[Q[\  r$c||j_|j}d|vr*|jj ||ft ||yd|vsd|vr|jj |yt 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) editorialrRclassesreappendrVFiguredBassLineException)rf bassObjectrRcs r#r:zFiguredBassLine.addElements2/= +    Q; LL  ^ < =  N ; q MQ$6 LL   +*NNX^] r$c*tj}|jtj|jt j |jj|jtj|jd}|jdk7r1tj|j}|j||jD]\}}|j||j!dd}|y|j#tj$j'}|j)|j#tjj'|j+|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 r_rmrBassClefrr.rZsharpscopydeepcopyr[r6r Restre makeNotationr*Measurer-removepadAsAnacrusis)rfbassLinerrQunused_notationStringbl2m0s r#rXz FiguredBassLine.generateBassLines>;;= ((():):;< dkk23     # (9(9:A OOA 15 -X, OOH %2>##EPU#V =''7==?B IIb++DII6<<> ?     r$c |tj}|tjd}g}|j }t |j dk\r;|j j|tj|j }ntj|}t|j}|jj}d}||} ||dd} tj | | j"j$|j&|||} | j(| _|j| |ddD].} | \} }|| d} tj | | j"j$|j&|||}t+dt || D]4}|| |dz }|j,j.j||f6| | j0| j(zk(r|dz }||} | j(|_nLt+t || |dzD]'}| j,j2j|)d|_|j||} 1|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') NB5rrr)rRulesr PitchrXrr`rmr extractHarmoniescreateOffsetMappingsortedkeysr)notesrOverlaidSegmentrkrRrdrsrOfbRules_partPitchLimitsoffset _partsToCheck)rfrnumPartsmaxPitch segmentListrcurrentMappingallKeys bassNoteIndexpreviousBassNoterQpreviousSegmentk startTimeunused_endTimecurrentSegment partNumber upperPitchs r#retrieveSegmentsz FiguredBassLine.retrieveSegmentsEse ?kkmG  {{4(H ((* t"" #q (    & &x 0$55d6I6IJN$88BN,,./##%++ #M2!'!*-b1!11(H!+<'=> +A.zA~> &&77>> J?WX?,336F6T6TTT" #+M#: /?/M/M,"'N1,=(>1 "MJ#++99@@L#N03,   ~ .,O)*r$c:|jj|yN)r`rm)rf music21Parts r# overlayPartzFiguredBassLine.overlayPartys "";/r$c \|tj}|tjd}g}d}|jD]!} |j }d|vrnd|vsd|vsd}n|r|jD]}g} |jD]} | j| ji} | D]} | | | < | j} d}tj|jj||jj }t#j$||j&|||| }||jj |_|j|n|j)|||}t+|d k\rt-t+|d z D]q}||}||d z}|j/|}t1j2t4|_t5|}|D]#\}}|j6|j|%s|j9|n?t+|d k(r$|d }t5|j;|_n |s t?d tA||jB|jD|jFd d|jHS#t $rYlwxYw)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 rFr+rirjTc|dk7r|SdS)Nrg?)ys r#gz"FiguredBassLine.realize..gs !S11c1r$rr)rQfbScalerrr listOfPitchesrrrz/No (bassNote, notationString) pairs to realize.r)realizedSegmentListrZr[ overlaidPartsr5)%rrr rrerlAttributeErrorpitchesrmnamevaluesr r+bassnameWithOctavedurationrsrSegmentrdrrrO"allCorrectConsecutivePossibilities collections defaultdictlist movements_trimAllMovementsallCorrectSinglePossibilitiescorrectArn RealizationrZr[r`r6)rfrrrrlistOfHarmonyObjectsitemrp harmonyObjectlistOfPitchesJustNames thisPitchdx outputListr passedNotecorrespondingSegment segmentIndexsegmentAsegmentB correctABlistABpossibApossibBs r#rYzFiguredBassLine.realize|sp ?kkmG  {{4(H $LLD LL{"mq&8'+$! !% )+&!.!6!6I*11)..A"7/AAaD0XXZ 2"YY}'9'9';'J'J56}7M7M7[7[5\^ '. ?C}}?F@H@HEO (Q$ 67}7M7M7[7[5\$2""#78-".2//8LK { q %c+&6&: ; &|4&|a'78$GGQ %0%<%z3FiguredBassLine._trimAllMovements..s [1Hr$)rreverserOrritemsfilter) rfr movementsABrr possibCListr possibBListrs @r#rz!FiguredBassLine._trimAllMovementss$ { q C $4$9   "    !K %a[)9A)= > ),*:;EE ),7AA .2;3D3D3F.G*Wk&'0/H/3;3D3D3F.G*Wk+/I;W,YK(/H!?+/{/@/@/B*C&+"#G,+D    !)#r$)NNr)roz note.Note)NN)__name__ __module__ __qualname____doc__ _DOC_ORDERr]__annotations__rgr:rXrrrYrrr$r#rrsN"?J  !I~  %N0d2h0z:x!r$c^eZdZUdZgdZddiZded<dZdZd Z d Z d Z d Z d Z ddZy)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.r\r]c d|vr |d|_d|vr8|d|_tj|jj|_d|vr |d|_d|vr |d|_d|vr |d|_d|_ y)NrrZr[rr5T) _segmentList_inKeyrr.rx_keySig_inTimer`r6r)rf fbLineOutputss r#rgzRealization.__init__4s M 1 -.C DD  m #'0DK++DKK,>,>?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 rr)rrrrrOr) rfpathListrr newPathListr prevValuer numSolutionss r#rzRealization.getNumSolutionsCs," t  !Q &t((+445 5 !!#!!S):):%;!Xg%66 $?+4K( 2 #H= G HW- -L  !!#r$c|g}t|jdk(r2|jdjD]}|j|g|S|jdj}|D]!}||}|D]}|j||g#t dt|jdz D]}|j|j}t t|D]Y}|j d}|d}||D]9} tj|} | j| |j| ;[|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. rrr)rrrrmrrOpopry) rf progressionsr currMovementsrrrunused_progressionIndex progressionpossibCnewProgressions r#rz)Realization.getAllPossibilityProgressionsms> t  !Q &,,Q/88##WI.9 ))!,66 $G'0K&##Wg$67'% "!S):):%;a%?@L --l;EEM+0\1B+C'*..q1 %b/,W5G%)YY{%;N"))'2 ''7 6,DAr$czg}t|jdk(rCtj|jdjdd}|j ||S|jdj }|jdk(r tdtj|jdd}|j |tt|jdz D]J}|j|j }tj||dd}|j ||}L|S)zB Returns a random unique possibility progression. rrZero solutions) rrrandomsamplerrmrrrnrrO)rfrrr prevPossibr nextPossibs r#rz+Realization.getRandomPossibilityProgressions t  !Q &mmD$5$5a$8$A$A1EaHG   w ' ))!,66    !Q &*+;< <]]=#5#5#7;A> :&!#d&7&7"81"<=L --l;EEM}Z'@!DQGJ   z *#J > r$c tj}tj}|jt j |j t j |jgd}|jdk7rDtj|j}|jt j ||jrtj}|jd||jt j |j t j |jg|$|jt j |tt|jD]}||}|j|j }|jt j ||dd} t#j$| } |j|j&| _|j| |jdt)j*|j-dd|-|dj/d |dj1ng} tt|dd z D]} tj} |jd| | jt j |j t j |jg|$| jt j || j| tt|jD]}||}|j|j }|jt j |tt|d z D]L}tj2||}|j|j&|_| |j|N| D]i}t)j4|dd }|jd||j-dd|C|dj/d |dj1k|jdt)j6|j-dd|'|dj/d |dj1|jd||S) zn Generates a realization as a :class:`~music21.stream.Score` given a possibility progression. NrrrrrTFrtrr)allowTreble8vbrecurse)r Scorer_rmryrzrrr6r r{rinsertrOrrrQrChordrsr TrebleClefr|rrr+bestClefrw)rfpossibilityProgressionsolrr rightHandrrrQ rhPitchesrhChord upperParts _partNumberfbPartrn1 upperPartrps r#rz9Realization.generateRealizationFromPossibilityProgressionslln;;=t||4dmmDLL6QRS     # (9(9:A OODMM!, -  # # I JJsI &   dmmDLL94==;VW X}  q!12 %c$*;*;&< = 0>,,\:CC h 78#AbM ++i0(,(9(9,(G(U(U%  )!>   S$//"3 4  " "4e " T}!   #! ++-J$S)?)B%Ca%GH  3' t}}T\\:DMM$,,,,\:CC h 78"'G q(8"9J7:#67B'+'8'8'F'T'TB$z*11"5#: !>( MM)D$O  a(&&tRW&X=aL$$Q'aL//1 ( T]]_-dO = QKOOA  QK & & ( 3! r$ctj}|j}|s td|j |d}|D]}|j |t dt|D]M}|j ||}t t|D] }||D]}||j |"O|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 r rrnrrmrOr) rfallSolspossibilityProgressionssol0r possibIndexsolX partIndexmusic21Measures r#rz#Realization.generateAllRealizationss,,."&"D"D"F&*+;< <AABYZ[B\]K NN; ' !C(?$@AKEE' 46D"3t9- &*9oNI&--n='6.Br$cD|j}|j|S)z\ Generates a random unique realization as a :class:`~music21.stream.Score`. )rr)rfrs r#rz%Realization.generateRandomRealizations%"&!E!E!GAABXYYr$ct||jkDr|jStj}|j }|D]}|j |t d|D]I}|j }t t|D] }||D]}||j |"K|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 r rrmrOr) rfamountToGeneraterrrunused_counter_solutionrrr s r#rz&Realization.generateRandomRealizations s d224 4//1 1,,.--/K NN; ' (-Q0@'A #113D"3t9- &*9oNI&--n='6.(B r$N))rrrrrr]rrgrrrrrrrrr$r#rrsT CJ  >!I~ ((T@0EN0Zr$rc eZdZy)rnN)rrrrr$r#rnrn'sr$rnceZdZdZy)Testcddlm}|jdd}|tjd}|j |j dt|}|j |jjdd |_t|}|j |jjd d |_t|}|j |jjd d |_t|}|j |jjddD]U}|j|5||_t|}|j |jj|dddWy#1swYbxYw)Nr) converterz#tinynotation: 4/4 C4 F4 G4_64 G4 C1F)r|r64z6, 4z#6#42z #6, #4, 2z#64#2z #6, 4, #2z6 4r) single_symbol) music21r*parser r+ assertEquallyricrHrkrRsubTest)rfr*s third_note unused_fbr,s r#testMultipleFiguresInLyriczTest.testMultipleFiguresInLyric.sI% OOAPUO Vtyy\!_  ))40)!,  --<r>s<#  '(-%'_D= zGTr$