3j8dZddlmZddlZddlZddlZddlmZddl m Z ddl m Z ddl m Z ddl m Z dd l mZdd l mZej rdd l mZe j$d ZGd de j(ZGdde j,ZGddee j0ZGddeZGddeZGddeZGddeZGddeZGddeZGdd eZ Gd!d"eZ!Gd#d$eZ"Gd%d&eZ#Gd'd(eZ$Gd)d*eZ%eeeee e!e"e#e$e%g Z&d?d+d,d@d-Z'd+d,d.Z(d+d/d0d1Z)Gd2d3e j,Z*Gd4d5ejVeZ,Gd6d7e j,Z-Gd8d9e j,Z.Gd:d;e j,Z/Gd<d=Z0eeeeeeee e!e"e#e$e%e0gZ1e2d>k(rddl Z e jfyy)Aa This module provides the base class for all RepeatMark objects: entities that denote repeats. Some RepeatMark objects are Expression objects; others are Bar objects. See for instance, the :class:`~music21.bar.Repeat` which represents a normal barline repeat. ) annotationsN) StreamType) environment) exceptions21) expressions)prebase)spanner)stylestreamrepeatceZdZdZy) RepeatMarka Base class of all repeat objects, including RepeatExpression objects and Repeat (Barline) objects. This object is used for multiple-inheritance of such objects and to filter by class in order to get all things that mark repeats. The RepeatMark is not itself a :class:`~music21.base.Music21Object` so you should use multiple inheritance to put these things in Streams. The following demonstration shows how a user might see if a Stream has any repeats in it. >>> class PartialRepeat(repeat.RepeatMark, base.Music21Object): ... def __init__(self, **keywords): ... super().__init__(**keywords) >>> s = stream.Stream() >>> s.append(note.Note()) >>> s.append(PartialRepeat()) >>> repeats = s.getElementsByClass('RepeatMark') # not a Music21Object, so use quotes >>> if repeats: ... print(f'Stream has {len(repeats)} repeat(s) in it') Stream has 1 repeat(s) in it N)__name__ __module__ __qualname____doc__;/DATA/.local/lib/python3.12/site-packages/music21/repeat.pyrr)srrc eZdZy)RepeatExpressionExceptionNrrrrrrrrErrcfeZdZdZej ZfdZdZdZ dZ d dZ dZ dZ d ZxZS) RepeatExpressiona' This class models any mark added to a Score to mark repeat start and end points that are designated by text expressions or symbols, such as D.S. Al Coda, etc. N.B. Repeat(Barline) objects are not RepeatExpression objects, but both are RepeatMark subclasses. This class stores internally a :class:`~music21.expressions.TextExpression`. This object is used for rendering text output in translation. A properly configured TextExpression object can also be used to create an instance of a RepeatExpressions. c t|di|d|_g|_d|j_d|_d|j_y)NcenterFr)super__init___textExpression_textAlternativesr justify useSymbol absoluteYselfkeywords __class__s rr!zRepeatExpression.__init__ZsD $8$#!#%  " rc|j}|t|dkDrt|dddzS| t|Sy)Nz...)getTextlenrepr)r(contents r _reprInternalzRepeatExpression._reprInternalhsG,,.  3w<"#4 u,- -  = rc.|jjS)z8 Get the text used for this expression. )r"r1r(s rr.zRepeatExpression.getTextqs##+++rc|jFtj||_|j|j_|j y||j_y)z Set the text of this repeat expression. This is also the primary way that the stored TextExpression object is created. N)r"rTextExpressionr applyTextFormattingr1r(values rsetTextzRepeatExpression.setTextwsO    '#.#=#=e#DD )-D &  $ $ &+0D (rcp| |j}|%|jj|j_|S)za Apply the default text formatting to the text expression version of this repeat )r"r r$)r(tes rr7z$RepeatExpression.applyTextFormattings4 :%%B >#zz11BHH  rct|tjstd|||_|j y)z7 Directly set a TextExpression object. z,must set with a TextExpression object, not: N) isinstancerr6rr"r7r8s rsetTextExpressionz"RepeatExpression.setTextExpressionsA%!;!;<+>ugFH H$   "rcZ|jytj|jS)zL Return a copy of the TextExpression stored in this object. N)r"copydeepcopyr4s rgetTextExpressionz"RepeatExpression.getTextExpressions(    '==!5!56 6rcZd}|jD]}||}||}||k(syy)zd Return True or False if the supplied text could be used for this RepeatExpression. c|j}|jdd}|jdd}|j}|S)N r-.)stripreplacelower)ss r stripTextz/RepeatExpression.isValidText..stripTexts= A #r"A #r"A AHrTF)r#)r(r9rL candidates r isValidTextzRepeatExpression.isValidTexts= //I!),Ie$E ! 0 rN)rrrrr TextStyle _styleClassr!r2r.r:r7r?rCrN __classcell__r*s@rrrIs; //K ", 1 #7rrc"eZdZdZfdZxZS)RepeatExpressionMarkerz Some repeat expressions are markers of positions in the score to jump to; these classes model those makers, such as Coda, Segno, and Fine, which are subclassed below. c Ft|di|d|j_y)Nrr)r r!r r$r's rr!zRepeatExpressionMarker.__init__s $8$% rrrrrr!rRrSs@rrUrUs &&rrUc$eZdZdZdfd ZxZS)Codaz^ The coda symbol, or the word coda, as placed in a score. >>> rm = repeat.Coda() c t|di|d|j_gd|_|*|j |r|j |d|_y|j |jdd|_y)Nr)rYzto Codazal CodaFrTr)r r!r r$r#rNr:r%r(textr)r*s rr!z Coda.__init__sk $8$% !?   0 0 6 LL "DN LL//2 3!DNrrOrWrSs@rrYrYs " "rrYc"eZdZdZfdZxZS)Segnozi The segno sign as placed in a score. >>> rm = repeat.Segno() >>> rm.useSymbol True c ~t|di|dg|_|j|jdd|_y)Nr^rTr)r r!r#r:r%r's rr!zSegno.__init__s; $8$") T++A./rrWrSs@rr^r^srr^c"eZdZdZfdZxZS)FinezI The fine word as placed in a score. >>> rm = repeat.Fine() c t|di|dg|_|j|jdd|j_y)Nfinerrightr)r r!r#r:r r$r's rr!z Fine.__init__s@ $8$"( T++A./$ rrWrSs@rraras %%rrac"eZdZdZfdZxZS)RepeatExpressionCommandz Some repeat expressions are commands, instructing the reader to go somewhere else. DaCapo and related are examples. c Tt|di|d|_d|j_y)NFrdr)r r!repeatAfterJumpr r$r's rr!z RepeatExpressionCommand.__init__s) $8$$% rrWrSs@rrfrfs %%rrfc$eZdZdZdfd ZxZS)DaCapoz The Da Capo command, indicating a return to the beginning and a continuation to the end. By default, `repeatAfterJump` is False, indicating that any repeats encountered on the Da Capo repeat not be repeated. c t|di|ddg|_|#|j|r|j |y|j |jdy)NzDa CapozD.C.rrr r!r#rNr:r[s rr!zDaCapo.__init__sV $8$"+V!4   0 0 6 LL  LL//2 3rrOrWrSs@rrjrjs 44rrjc$eZdZdZdfd ZxZS) DaCapoAlFinea: The Da Capo al Fine command, indicating a return to the beginning and a continuation to the :class:`~music21.repeat.Fine` object. By default, `repeatAfterJump` is False, indicating that any repeats encountered on the Da Capo repeat not be repeated. >>> rm = repeat.DaCapoAlFine() c t|di|ddg|_|#|j|r|j |y|j |jdy)NzDa Capo al finez D.C. al finerrrlr[s rr!zDaCapoAlFine.__init__#V $8$"3^!D   0 0 6 LL  LL//2 3rrOrWrSs@rrnrns 44rrnc$eZdZdZdfd ZxZS) DaCapoAlCodaa The Da Capo al Coda command, indicating a return to the beginning and a continuation to the :class:`~music21.repeat.Coda` object. The music resumes at a second :class:`~music21.repeat.Coda` object. By default, `repeatAfterJump` is False, indicating that any repeats encountered on the Da Capo repeat not be repeated. >>> rm = repeat.DaCapoAlCoda() c t|di|ddg|_|#|j|r|j |y|j |jdy)NzDa Capo al Codaz D.C. al Codarrrlr[s rr!zDaCapoAlCoda.__init__:rprrOrWrSs@rrrrr-s 44rrrc$eZdZdZdfd ZxZS)AlSegnozc Jump to the sign. Presumably a forward jump, not a repeat. >>> rm = repeat.AlSegno() c t|di|dg|_|#|j|r|j |y|j |jdy)Nzal Segnorrrlr[s rr!zAlSegno.__init__JsS $8$",   0 0 6 LL  LL//2 3rrOrWrSs@rruruDs 44rruc$eZdZdZdfd ZxZS)DalSegnoa The Dal Segno command, indicating a return to the segno and a continuation to the end. By default, `repeatAfterJump` is False, indicating that any repeats encountered on the Da Capo repeat not be repeated. >>> rm = repeat.DaCapoAlFine() c t|di|ddg|_|#|j|r|j |y|j |jdy)Nz Dal SegnozD.S.rrrlr[s rr!zDalSegno.__init__\sV $8$"-v!6   0 0 6 LL  LL//2 3rrOrWrSs@rrxrxSs44rrxc$eZdZdZdfd ZxZS)DalSegnoAlFinea6 The Dal Segno al Fine command, indicating a return to the segno and a continuation to the :class:`~music21.repeat.Fine` object. By default, `repeatAfterJump` is False, indicating that any repeats encountered on the Dal Segno repeat not be repeated. >>> rm = repeat.DaCapoAlFine() c t|di|ddg|_|#|j|r|j |y|j |jdy)NzDal Segno al finez D.S. al finerrrlr[s rr!zDalSegnoAlFine.__init__oV $8$"5~!F   0 0 6 LL  LL//2 3rrOrWrSs@rr{r{es44rr{c$eZdZdZdfd ZxZS)DalSegnoAlCodaa The Dal Segno al Coda command, indicating a return to the beginning and a continuation to the :class:`~music21.repeat.Coda` object. The music resumes at a second :class:`~music21.repeat.Coda` object. By default, `repeatAfterJump` is False, indicating that any repeats encountered on the Da Segno repeat not be repeated. >>> rm = repeat.DaCapoAlCoda() c t|di|ddg|_|#|j|r|j |y|j |jdy)NzDal Segno al Codaz D.S. al Codarrrlr[s rr!zDalSegnoAlCoda.__init__r}rrOrWrSs@rrrxs 44rrFinPlacec|s|jd|y|js&|jD]}t||||d|ry|St ||dzDcgc]}|j |}}t j||}|dj|} |j| ||dury|Scc}w)a5 Designates a range of measures as being repeated endings (i.e. first and second endings) within a stream s, where s either contains measures, or contains parts which contain measures. Start and end are integers corresponding to the first and last measure number of the "repeatNum" ending. e.g. if start=6, end=7, and repeatNum=2, the method adds a second ending from measures 6 to 7. Does not (yet) add a :class:`~music21.repeat.RepeatMark` to the end of the first ending. Example: create first and second endings over measures 4-6 and measures 11-13 of a chorale, respectively. >>> c1 = corpus.parse('bwv10.7.mxl') >>> repeat.insertRepeatEnding(c1, 4, 6, 1, inPlace=True) >>> repeat.insertRepeatEnding(c1, 11, 13, 2, inPlace=True) We now have 8 repeatBrackets since each part gets its own first and second ending. >>> repeatBrackets = c1.flatten().getElementsByClass(spanner.RepeatBracket) >>> len(repeatBrackets) 8 >>> len(c1.parts.first().getElementsByClass(spanner.RepeatBracket)) 2 insertRepeatEndingNTr)numberr) coreCopyAsDerivation hasMeasurespartsrrangemeasurer RepeatBracketgetOffsetBySiteinsert) rKstartend endingNumberrpartimeasuresrbrbOffsets rrrs8  34y ==?GGD tUCt L  H&+E37&;<&; ! &;H<   x =B{**1-HHHXr$=sB<c|y|s|jd|js%|jD]}t|||d|ry|Sddlm}|j dd |j|_|d k7st|jdk7r&|j d |j|_ |ry|S) a Given a stream s, inserts a start-repeat at the beginning of the bar specified by start and inserts an end-repeat at the bar specified by barEnd. Only alters the stream s if inPlace=True. >>> from copy import deepcopy >>> chorale1 = corpus.parse('bwv10.7.mxl') >>> s = repeat.insertRepeat(chorale1, 3, 6, inPlace=False) >>> m4 = search.translateStreamToString( chorale1.parts[1].measure(4).notesAndRests) >>> resm4 = search.translateStreamToString( s.parts[1].measure(4).notesAndRests) >>> m6 = search.translateStreamToString( chorale1.parts[1].measure(4).notesAndRests) >>> resm6 = search.translateStreamToString( s.parts[1].measure(4).notesAndRests) >>> m7 = search.translateStreamToString( chorale1.parts[1].measure(4).notesAndRests) >>> resm7 = search.translateStreamToString( s.parts[1].measure(4).notesAndRests) >>> m4 == resm4 True >>> m6 == resm6 True >>> m7 == resm7 True We should have 2 repeats in each part (a start and end) for a total of 8 repeats >>> len(s.parts[0].flatten().getElementsByClass(bar.Repeat)) 2 >>> len(s[bar.Repeat]) 8 >>> s.parts[0].measure(3).leftBarline.direction 'start' >>> s.parts[0].measure(6).rightBarline.direction 'end' N insertRepeatTrrbarr) directiontimesrr)r) rrrrmusic21rRepeatr rightBarline RepeatFindergetQuarterLengthOfPickupMeasure leftBarline)rKrrrrrs rrrsH y  ~. ==?GGD uc4 8  H"%**uA*"FAIIcN z\!_DDF!K'*zzGz'D %$rTrcorrectMeasureNumberscddlm}|y|s|jd}|jr.|D](} |j |}||j|*n%|jD]}t||d||ry|S|rNt|j|j}|r(|dj} | dvrd} |D]} | | _ | dz } |ry|S#t j $rd}YwxYw) a Given a Stream `s` and a list of numbers, toDelete, removes each measure with a number corresponding to a number in toDelete and then renumbers the remaining measures in the Stream. TODO: Move to someplace more appropriate. >>> from copy import deepcopy >>> chorale1 = corpus.parse('bwv10.7.mxl') >>> s = deepcopy(chorale1) >>> repeat.deleteMeasures(s, [6, 3, 4], inPlace=True) >>> m2 = search.translateStreamToString(chorale1.parts[1].measure(2).notesAndRests) >>> resm2 = search.translateStreamToString(s.parts[1].measure(2).notesAndRests) >>> m2 == resm2 True >>> m5 = search.translateStreamToString(chorale1.parts[1].measure(5).notesAndRests) >>> resm3 = search.translateStreamToString(s.parts[1].measure(3).notesAndRests) >>> m5 == resm3 True >>> m7 = search.translateStreamToString(chorale1.parts[1].measure(7).notesAndRests) >>> resm4 = search.translateStreamToString(s.parts[1].measure(4).notesAndRests) >>> m7 == resm4 True >>> lenS = len(s.parts[0].getElementsByClass(stream.Measure)) >>> lenChorale1 = len(chorale1.parts[0].getElementsByClass(stream.Measure)) >>> lenS + 3 == lenChorale1 True OMIT_FROM_DOCS >>> chorale3 = corpus.parse('bwv102.7.mxl') >>> s = repeat.deleteMeasures(chorale3, [2, 3]) >>> (len(s.parts[2].getElementsByClass(stream.Measure)) == ... len(chorale3.parts[2].getElementsByClass(stream.Measure)) - 2) True >>> s = repeat.deleteMeasures(chorale3, [2, 3]) >>> (len(s.parts[2].getElementsByClass(stream.Measure)) == ... len(chorale3.parts[2].getElementsByClass(stream.Measure)) - 2) True >>> s = repeat.deleteMeasures(chorale3, [999, 1001001]) >>> len(s.parts[2]) == len(chorale3.parts[2]) True rr NdeleteMeasuresTrrrr)rr rrrrMusic21ExceptionremoverrlistgetElementsByClassMeasurer) rKtoDeleterrr mNumberremoveMerrrrs rrr sZy  " "#3 4}}G 99W-#" GGD 4##'1F H H,,V^^<=  ""A#!"Q$C 00  sCC-,C-c eZdZy)ExpanderExceptionNrrrrrrrrrceZdZdZddZdddZddZddZd dZdZ dZ d Z d Z d Z d Zd ZdZd!dZdZdZ d"dZ d#dZdZd$dZd%dZdZddgZy)&Expandera The Expander object can expand a single Part or Part-like Stream with repeats. Nested repeats given with :class:`~music21.bar.Repeat` objects, or repeats and sections designated with :class:`~music21.repeat.RepeatExpression` objects, are all expanded. This class is a utility processor. Direct usage is more commonly from the :meth:`~music21.stream.Stream.expandRepeats` method. To use this object directly, call :meth:`~music21.repeat.Expander.process` on the score >>> s = converter.parse('tinynotation: 3/4 A2. C4 D E F2.') >>> s.makeMeasures(inPlace=True) >>> s.measure(2).leftBarline = bar.Repeat(direction='start') >>> s.measure(2).rightBarline = bar.Repeat(direction='end', times=3) >>> s.show('text') {0.0} {0.0} {0.0} {0.0} {3.0} {0.0} {0.0} {1.0} {2.0} {3.0} {6.0} {0.0} {3.0} >>> e = repeat.Expander(s) >>> e.repeatBarsAreCoherent() True >>> s2 = e.process() >>> s2.show('text') {0.0} {0.0} {0.0} {0.0} {3.0} {0.0} {0.0} {1.0} {2.0} {3.0} {6.0} {0.0} {0.0} {1.0} {2.0} {3.0} {9.0} {0.0} {0.0} {1.0} {2.0} {3.0} {12.0} {0.0} {3.0} * Changed in v9: Expander must be initialized with a Stream object. OMIT_FROM_DOCS TODO: Note bug: barline style = double for each! Clefs and TimesSignatures should only be in first one! THIS IS IN OMIT cddlm}||_|jj|jj|_|jj jtjj|_ t|j |_ |jdk(r td|j j jtj}t|jt|_t|jt |_t|jt$|_t|jt(|_t|jt,|_t|jt0|_t|jt4|_t|jt8|_t|jt<|_t|jt@|_!y)Nrr z5no measures found in the source stream to be expanded)"rr _srcrr_srcMeasureStreamflattenr r_repeatBracketsr/_srcMeasureCountrrrY _codaCountr^ _segnoCountra _fineCountrj_dcCountrn _dcafCountrr _dcacCountru_asCountrx_dsCountr{ _dsafCountr _dsacCount)r( streamObjr reStreams rr!zExpander.__init__s" ) AE @\@\ NNA &(  II    2 273H3H I P P R &))?)?%@  A %#$[\ \  " " * * , ? ?@P Q X X Z h99$?@x::5ABh99$?@H77?@ h99,GHh99,GHH77@A H77AB h99.IJh99.IJrc*|j}|dur td|dur|jjd}n |j}|t j t |Stj|j|_ |D]<}|jjj|jj|>|j}||j|}n|j!|}|j#||S)a This is the main call for Expander Processes all repeats. Note that this processing only happens for Measures contained in the given Stream. Other objects in that Stream are neither processed nor copied. if deepcopy is False then it will leave the stream in an unusual state, but acceptable if the source stream has already been deep-copied and will be discarded later Fz@cannot expand Stream: badly formed repeats or repeat expressions expandRepeats) isExpandablerrrtcastrrArBr spannerBundlereplaceSpannedElement derivationorigin_daCapoOrSegno_processRecursiveRepeatBars"_processRepeatExpressionAndRepeatsmergeAttributes)r(rB canExpand srcStreammhasDaCapoOrSegnoposts rprocesszExpander.processs%%'  #RT T 5 ..CCOTI..I  66*i0 0 $}}T-A-ABA  . . D D ##Q ( ..0  #33I>D::9ED Y' rc>ddlm}g}g}|j}|}t|j |j D]?\}}|j |j|j |jA|dk(r|Si} i} t|jD]'\}}|| |j<|| |j<)g} t|D]\}} | j | | | S#t$r| j | ||YAwxYw)al returns a list where for each measure in the expanded stream, the index of the measure in the original stream is given. if returnType = 'measureNumber' then the str(measureNumber) of the original instead of the index of the original is used -- suffixes are important here for endings etc.. Inefficient, because the entire stream is expanded before making this call, rather than just seeing what needs to be expanded and returning that. >>> s = converter.parse('tinynotation: 3/4 A2. C4 D E F2. G4 a b c2.') >>> s.makeMeasures(inPlace=True) >>> s.measure(2).leftBarline = bar.Repeat(direction='start') >>> s.measure(2).rightBarline = bar.Repeat(direction='end', times=3) >>> s.measure(4).leftBarline = bar.Repeat(direction='start') >>> s.measure(4).rightBarline = bar.Repeat(direction='end', times=2) >>> e = repeat.Expander(s) >>> e.measureMap() [0, 1, 1, 1, 2, 3, 3, 4] >>> e.measureMap(returnType='measureNumber') ['1', '2', '2a', '2b', '3', '4', '4a', '5'] rr measureNumber) rr r enumeraterrappendmeasureNumberWithSuffixrrKeyError) r( returnTyper measureNumberListmeasureNumberNoSuffixListrmeasureContainingStreamsrrmeasureNumberDictmeasureNumberNoSuffixDict indexListrs r measureMapzExpander.measureMap,s80 #$&!||~#' 6II&..YZDAq  $ $Q%>%>%@ A % , ,QXX 6[  ($ $$&!d445DAq=> a779 :23 %ahh /6  *34E*F &A& Z  !23J!KL+G  Z  !:;TUV;W!XY Zs!C99 DDcddlm}|j}|j}|$d|jvr|j ||_|&d|jvr|j ||_yyy)z Given a measure, strip barlines if they are repeats, and replace with Barlines that are of the same style. Modify in place. rrNmusic21.bar.Repeat)rrrrclassSetBarline)r(rnewTyperlbrs r_stripRepeatBarlineszExpander._stripRepeatBarlinesbsc ]] ^^ >2bkkAKK0AM >2bkkA [[1ANB>rcddlm}|js|g}n$t|j |j }|D]G}g}|j t D]}|j||D]}|j|Iy)zo Given a Stream of measures or a Measure, strip all RepeatExpression objects in place. rr N) rr rrrrrrr)r(rr mListrres r_stripRepeatExpressionsz Expander._stripRepeatExpressionsqsy #$$&KE55fnnEFEAF))*:; a <  rc$d}d}d}|jD]}|j}|j}|Pd|jvrB|jdk(r |dz }|dz }n(|jdk(r|dk(r |dz }|dz }|dz }|dz}|pd|jvs|jdk(r|dk(r |dz }|dz }|dz }|dz}t d|d||dvrt jd |gy |||dz fvrt jd |d |gy y )zW Check that all repeat bars are paired properly. Returns True or False rrrrrz3a right barline is found that cannot be processed: , rz(Repeats are not balanced: countBalance: Fz'start count not the same as end count: z / T)rrrrrr environLocal printDebug)r( startCountendCount countBalancerrrs rrepeatBarsAreCoherentzExpander.repeatBarsAreCoherentst  ''ABB~"6"++"E<<7*!OJ A%L\\U*#q("a $) MH A%L~"6"++"E<<5($q("a $) MH A%L+MaSPRSURVW3(8 v %  # #'OP\~%^$_ ` h1 5 5  # #9,c(-%  rc|j|jz|jz}|j|jz|j z|j z}|dk(r |dk(rtS|dk(r |dk(rtSy)z Return a DaCapo object if this piece uses any form of DaCapo; return a Segno object if this piece uses any form of Segno. Returns None if incoherent or the piece uses neither. rrN) rrrrrrrrjr^)r(sumDcsumDss rrzExpander._daCapoOrSegnosw /$//A??#??#==! A:%1*M aZEQJLrc|jdk(ry|jdk(ry|jdk(ry|jdk(ry|jdk(ry|j dk(ry|j dk(rytd ) z Return the class of the repeat expression command. This should only be called if it has been determined that there is one repeat command in this Stream. rrjrrrnrurxrr{zno repeat command found)rrrrrrrrr4s r_getRepeatExpressionCommandTypez(Expander._getRepeatExpressionCommandTypesy ==A  __ !! __ !! ]]a  ]]a  __ !# __ !##$=> >rcd|jjtjS)zS Get the instance found in this stream; assumes that there is one. )rrrffirst)r(rs r_getRepeatExpressionCommandz$Expander._getRepeatExpressionCommands(  "556MNTTVVrc|j|jz|jz}|dkDry|jdk(r|jdk(ry|jdk(r|jdk(ry|jdk(r|jdk(ryy)z6 Check of a DC statement is coherent. rFrTr)rrrrr)r(rs r_daCapoIsCoherentzExpander._daCapoIsCoherents  /$//A 19 ==A $//Q"6__ !doo&:__ !doo&:rc"|j|jz|jz|jz}|dkDry|jdk(r|jdk(r|j dk(ry|jdk(r|jdk(r|j dk(ry|jdk(r.|j dk(r|jdk(r|j dk(ry|jdk(r.|j dk(r|jdk(r|j dk(ryy)z< Check of a sa segno statement is coherent. rFrTr)rrrrrrr)r(rs r_dalSegnoIsCoherentzExpander._dalSegnoIsCoherents ==!??#??# 19 MMQ $$)OOq( MMQ $$)OOq(oo"OOq($$)OOq(oo"OOq($$)OOq(rcg}tt|}g}ggd}d}|t|kr||}|jD]}|j |s|j d|vr|j |g}ggd}||j z }|dj ||j} |D]c\} } | |k\r,t| t| k7r|dj | 7t| t| k(sO|dj | |dz }|t|kr|r|j ||S)aZ Return a list of dictionaries that contains two entries: one for all indices that are involved with a collection of repeat bracket, and the repeat brackets themselves. This is used to handle when there are more than one group of repeat brackets per Stream. >>> s = converter.parse('tinynotation: 3/4 A2. C4 D E F2. G4 a b c2.') >>> s.makeMeasures(inPlace=True) >>> s.measure(2).leftBarline = bar.Repeat(direction='start') >>> s.measure(2).rightBarline = bar.Repeat(direction='end', times=3) >>> rb = spanner.RepeatBracket(s.measure(2)) >>> s.insert(0, rb) >>> s.measure(4).leftBarline = bar.Repeat(direction='start') >>> s.measure(4).rightBarline = bar.Repeat(direction='end', times=2) >>> e = repeat.Expander(s) >>> from pprint import pprint as pp >>> pp(e._groupRepeatBracketIndices(s)) [{'measureIndices': [2], 'repeatBrackets': [>]}] )repeatBracketsmeasureIndicesrrr r) rrr/risFirst numberRangergetLastid) r(rgroups mEnumeratedfoundRBNumbers groupIndicesrrrmLastiSubmSubs r_groupRepeatBracketIndicesz#Expander._groupRepeatBracketIndices/sV69Y/0     #i. ! A**::a=~~a(N: l3)+:()9:AA$GY"T(2()9:AA$G "'2!+@ FAG#i. H  MM, ' rc |j|jD]U}|d}|syt|dk(rnjt|dkDr\g}|D]}||jz }t t dt |dz}||k7rtjd|d|gyg}t|D]\}}|j}|jD]C}t||vrtjdgy|jt|E|j} | d| jvst|dk(s|t|dz kstjd gyXy) z Check if repeat brackets are coherent. This must be done for each group of brackets, not for the entire Stream. rTrz0repeat brackets are not numbered consecutively: rFz!found overlapping repeat bracketsrz8repeat brackets are not terminated with a repeat barline)rrr/r rrmaxrrrr getSpannedElementsr rrclasses) r(group rBracketstargetrmatchspannedMeasureIdsrbCountrrightBars r_repeatBracketsAreCoherentz#Expander._repeatBracketsAreCoherent~s 44T5K5KLE./I9~"Y!##B bnn,F $ U1c&kAo67F? ++J5'QSTZS[\-^_ " (3 JJL..0A!u 11$//1T0UV$%,,RU3 1 >>#xx7G7G'GI!+&Y!);;$//V1 %+ 4?Mjrctt|D]T}||}|j}|j}|d|jvry|5d|jvsD|j dk(sTyy)zd Return True if this Stream of Measures has a repeat pair still to process. rTrF)rr/rrrr)r(rrrrrs r _hasRepeatzExpander._hasRepeatsm s9~&A! ABB, ;, ; -'rcLg}g}tt|D]}||} |j}|j}|rd|j vrd|j dk(r|j|nC|j dk(r4|st|}t|St|d|}t|S|d|j vs|j dk(s|st|dz}t|St|d|dz}t|St|S#t$rY wxYw)a Find the innermost repeat bars. Return raw index values. For a single measure, this could be [2] For many contiguous measures, this might be [2, 3, 4, 5] The provided Stream must be a Stream only of Measures. >>> s = converter.parse('tinynotation: 3/4 A2. C4 D E F2. G4 a b c2.') >>> s.makeMeasures(inPlace=True) >>> s.measure(2).leftBarline = bar.Repeat(direction='start') >>> s.measure(2).rightBarline = bar.Repeat(direction='end', times=3) >>> s.measure(4).leftBarline = bar.Repeat(direction='start') >>> s.measure(4).rightBarline = bar.Repeat(direction='end', times=2) >>> e = repeat.Expander(s) >>> e.findInnermostRepeatIndices(s) [1] >>> s.measure(2).rightBarline = None >>> s.measure(4).leftBarline = None >>> e2 = repeat.Expander(s) >>> e2.findInnermostRepeatIndices(s) [1, 2, 3] rrrr) rr/rrAttributeErrorrrrr)r(r startIndicesbarRepeatIndicesrrrrs rfindInnermostRepeatIndicesz#Expander.findInnermostRepeatIndicessP2 s9~&A! A ]]^^~"6"++"E<<7* ''*\\U*'+08($%%,1b1A1+E($%%, ; -$',QU|$$%%(-\"-=q1u'E$$%%E'D$%%9"  sD D#"D#cf||}|j}|,d|jvr|jdk(r|}|j}nj|t |dz k\rt d|||dz}|j }|*d|jvr|jdk(r |j}n t d|d}|||fS)a Get the last measure to be processed in the repeat, as well as the measure that has the end barline. These may not be the same: if an end repeat bar is placed on the left of a measure that is not actually being copied. The `index` parameter is the index of the last measure to be copied. The streamObj must only have Measures. rrrz3cannot find an end Repeat bar after the given end: z6cannot find an end Repeat bar in the expected positionr)rrrrr/rr)r(rindexrr mEndBarline repeatTimesrs r_getEndRepeatBarzExpander._getEndRepeatBars%     N(BKK7LLE)K((KI**'I%QSS$EAI.K((B, ; - hh '(`aa  Kk;..rNc>tj}|j}d}||j|}nd}d}d} d} | t |kr<|s |S| |dk(rd} d} |j ||d\} } } || }t|D]} |D]{}tj||}||d|dfvr|j||dk\r| |dz kr|j|| dk7r|| dz dz|_ |j|}| | urd}|ddz} n^|sWtj|| }|| }|r'|j||j|| d}|j|| dz } | t |kr<|S#t $r|sY"wxYw) a Process and return a new Stream of Measures, likely a Part. If `repeatIndices` are given, only these indices will be copied. All the included indices must be listed, not just the start and end. If `returnExpansionOnly` is True, only the expanded portion is returned, the rest of the Stream is not retained. >>> s = converter.parse('tinynotation: 3/4 A2. C4 D E F2. G4 a b c2.') >>> s.makeMeasures(inPlace=True) >>> s.measure(2).leftBarline = bar.Repeat(direction='start') >>> s.measure(2).rightBarline = bar.Repeat(direction='end', times=3) >>> s.measure(4).leftBarline = bar.Repeat(direction='start') >>> s.measure(4).rightBarline = bar.Repeat(direction='end', times=2) processInnermostRepeatBars only will expand the first set of repeats. >>> e = repeat.Expander(s) >>> s2 = e.processInnermostRepeatBars(s) >>> s2.show('text') {0.0} {0.0} {0.0} {0.0} {3.0} {0.0} {0.0} {1.0} {2.0} {3.0} {6.0} {0.0} {0.0} {1.0} {2.0} {3.0} {9.0} {0.0} {0.0} {1.0} {2.0} {3.0} {12.0} {0.0} {15.0} {0.0} {0.0} {1.0} {2.0} {3.0} {18.0} {0.0} {3.0} Calling it again will complete the job, as .process() does >>> s3 = e.processInnermostRepeatBars(s2) >>> s3.show('text') {0.0} ... {3.0} ... {6.0} ... {9.0} ... {12.0} ... {15.0} {0.0} {0.0} {1.0} {2.0} {3.0} {18.0} {0.0} {0.0} {1.0} {2.0} {3.0} {21.0} ... Should work even if no start repeat is given: >>> s = converter.parse('tinynotation: 3/4 A2. C4 D E F2. G4 a b c2.') >>> s.makeMeasures(inPlace=True) >>> s.measure(2).rightBarline = bar.Repeat(direction='end') >>> e = repeat.Expander(s) >>> s2 = e.processInnermostRepeatBars(s) >>> s2.show('text') {0.0} ... {3.0} ... {6.0} ... {9.0} ... {3.0} {12.0} ... {15.0} ... {18.0} ... {3.0} FNTrr%rr)stringascii_lowercaser*r)r/r.rrrArBrr numberSuffixr)r(r repeatIndicesr-returnExpansionOnlylowercase_alphabetnew forcedIndicesstripFirstNextMeasurerrepeatTimesFoundr,rrjrjunkrs rprocessInnermostRepeatBarsz#Expander.processInnermostRepeatBars8sd$33!!#   ;;IFM M!& #i.  X OM!$$" ;?;P;PQZQ^_aQb A:0BEAIQSCS0TD- 4(!+ 00 +,0)!"%)+  ==16D"! A -11!411)A,?05-JJqMQY#i. \ C)()s F FFc|i}|j|}|s|j|S|j|}d}|D]Z}|s|d}||d}||d} |D]7} t| |vrn(| j |s| j | r|}n9|Zn||j|S|d}|d|d} g} d} g}|D]4} | |t| <|d}| j }| j }d}d}t|D]8\}}t|t|k(r|}t|t|k(s7|}:|| td|j}|'d|jvrtt||dz}ntt||dz}tt||dz}|'|D]"}|dD]}||vs|j|$| ||d }|j|7|D]W}|d  t|d j }|j||d |d }| j|t#|d } Y|j%}| D]}|j|| D]+}|D]$}|j'||j|&-|| dzd}|D]}|j||S)a# Return a new complete Stream with repeats and brackets expanded. The `repeatBracketsMemo` is a dictionary that stores id(rb): rb entries for all RepeatBrackets. This is not recursively applied here, but done in __processRecursiveRepeatBars Nrrr%z6failed to find start or end index of bracket expansionrrbracketIndices) repeatBracket validIndicesr?rAr@T)r4r-r5)rr=r)r hasSpannedElementgetFirstr rrrrrrrrr/r rr*r) r(rrepeatBracketsMemor innermost groupFocusrrmStartmEndr streamObjPrestreamBracketRepeatshighestIndexRepeated boundaries startIndexmFirstrendIndexbracketStartIndexrr mLastRightBarindicesr?dataqr-outr7sub streamObjPosts r#_processInnermostRepeatsAndBracketsz,Expander._processInnermostRepeatsAndBracketsso  %!#  00;229= = 33I>  E./Iy|,FYr]+Db6//))&1R5I5I$5O!&J %).  229= =/0  )A,/ ! $ B)+ r"v &"1J[[]FJJLEH $ !),1a5BuI% Ha5BvJ&()% -#4#<'LNN"..M), 0F0FFuZA>?uZA>?"%(98a<"HIN"&D!"23<#NN1-4' &(&46D   d #WZDN#/!$"7"C"CD 55"&~"6 +(, 6%++C0'*4+?'@$/2!!#A JJqM'C))!, 1 ( ""6":";< A JJqM rcg}t|D]\\}}|jtD]?}||jvst |t r"t ||s/|j |A^|r|Sy)a Return a list of index positions of a Measure given a stream of measures. This requires the provided stream to only have measures. >>> s = converter.parse('tinynotation: 3/4 A2. C4 D E F2.') >>> s.makeMeasures(inPlace=True) >>> s.measure(3).append(repeat.Segno()) >>> e = repeat.Expander(s) getRepeatExpressionIndex returns the measureIndex not measure number >>> e.getRepeatExpressionIndex(s.getElementsByClass(stream.Measure), 'Segno') [2] N)rrrrr>strr)r(rrrrrrs rgetRepeatExpressionIndexz!Expander.getRepeatExpressionIndexsi"i(DAq))*:;aii' *63 7Jq& ?..0  # #$F G  --/ ++,=>  %//1 ++,=> rc|durtj|}i}d}|dkDr3|dz }|j||}|j|rn |S|dkDr3|S)z Recursively expand any number of nested repeat bars. Will also expand all repeat brackets. if makeDeepCopy is True, then it will make a deepcopy of the stream. Otherwise assumes it has already been done. Tdrr)rD)rArBrXr#)r(r makeDeepCopyrD maxProcessess rrz$Expander._processRecursiveRepeatBarss 4  i0I Q'!+L@@#5A7I y) #Q"rc|j}|j}|j|}|j||d}|turd}n)|t ur|j|dd}n t d|dvr|j|dd}nt|dz }|dvr|j|d}|d} |d} nd } d } g} | jd|g|dvr3| j|| g| j| t|dz gn| j||g|j} |dj} | d} t| D]\}}|j}t|d|ddzD]7}tj||}| |_ |j|| dz } 9|j|rO|dk(r |j sn#|j#|}|d jdz} |D]}|j%|d |D]}| j||j'| | S) z Process and return a new Stream of Measures, likely a Part. Expand any repeat expressions found within. rr^zMust be DaCapo or Segno)rnr{rar)rrrrYNr%double)r)rrrr[rjr^ ValueErrorr/rr*rrrrArBr#rhrrr)r(r capoOrSegnorecTyperecObjjumpBackrrcodascodaJump codaStart indexSegmentsr7rsubCountrV subStreamrrs rrz+Expander._processRepeatExpressionAndRepeats su))+ 66811)<00GDQG & E E !11)WEaHE67 7 8 8// 6B1ECi.1$C 8 811)VDEQxHaIHI a]+ 8 8  %!2 3  )S^a-?!@ A  % .!!#1$$ >F'}5MHc!++-I3q63q6A:.MM)A,/!  #!  / y)q=)?)? $ @ @ KI&r]11A5F"A--a-B# 1 166 $$S) rrr)rr)T)rBboolreturnr)r+)rb)r stream.Stream)rrprorn)NNFrO)roz bool | NoneF)rrrrr!rrrrrrrrrrrr!r#r)r.r=rXr[rrr _DOC_ORDERrrrrrsFN$KL3j4l 2&0d*?.W 6*XM^;z,?&B$/P26/37< Wv@DWv8!F D[z\*Jrrc eZdZy)UnequalPartsLengthExceptionNrrrrrtrtorrrtc eZdZy)InsufficientLengthExceptionNrrrrrvrvsrrrvc eZdZy)NoInternalStreamExceptionNrrrrrxrxwrrrxcneZdZUdZgdZddddZded<dd Zd Zd Z d Z dZ ddZ ddddZ ddZy )raL An object for finding and simplifying repeated sections of music. Must be passed a stream which contains either measures or parts containing measures. To collapse a repeated section, call RepeatFinder.simplify() and to see which sections of a piece are repeated, call either RepeatFinder.getMeasureSimilarityList() or RepeatFinder.getSimilarMeasureGroups (see below for full documentation). If the internal stream passed to RepeatFinder is altered in any way (e.g. if you call simplify() with inplace=True) then to ensure proper functionality, you should use a new RepeatFinder object. Below is an example of calling simplify on a Bach chorale. >>> chorale = corpus.parse('bwv117.4.mxl') >>> #_DOCS_SHOW chorale.show() Only the first 8 bars are displayed below .. image:: images/repeat-SimplifyExample_Chorale.* :width: 600 >>> #_DOCS_SHOW repeat.RepeatFinder(chorale).simplify().show() The same chorale as before, but simplified .. image:: images/repeat-SimplifyExample_ChoraleSimplified.* :width: 600 )simplifygetMeasureSimilarityListgetSimilarMeasureGroupsr hasPickupaA function that takes a stream of notes and rests and returns a string or an integer such that two measures are equal if their hashes are equal under the '==' operatorzAThe internal stream which is being analyzed for repeated sectionsz3boolean whether measure numbers should be corrected) defaultHashrKrzdict[str, str] _DOC_ATTRNc~ddlm}||_||j|_n||_d|_d|_d|_y)Nr)searchT)rrrKtranslateStreamToStringr~_mList_mGroupsr)r( inpStreamdefaultMeasureHashFunctionrs rr!zRepeatFinder.__init__s>" % -%==D 9D   %)"rcf|j td|jjr |j}n|jjd}t |j j }t|dkr td|d|dz }|d|dz }||zS)ai Looks at RepeatFinder's internal stream and returns the duration of the pickup bar in quarterLengths. If there is no pickup, returns 0.0. Raises an exception if RepeatFinder's internal stream is too short (i.e. fewer than 3 measures long) >>> noPickup = corpus.parse('bwv10.7.mxl') >>> repeat.RepeatFinder(noPickup).getQuarterLengthOfPickupMeasure() 0.0 >>> #_DOCS_SHOW noPickup.parts[0].measures(0, 5).show() .. image:: images/repeat-rf_noPickup.* :width: 600 >>> hasPickup = corpus.parse('bwv101.7.mxl') >>> repeat.RepeatFinder(hasPickup).getQuarterLengthOfPickupMeasure() 1.0 >>> #_DOCS_SHOW hasPickup.parts[0].measures(0, 2).show() .. image:: images/repeat-rf_hasPickup.* :width: 600 >>> tooShort = noPickup.parts[0].measures(1, 2) >>> repeat.RepeatFinder(tooShort).getQuarterLengthOfPickupMeasure() Traceback (most recent call last): music21.repeat.InsufficientLengthException: Cannot determine length of pickup given fewer than 3 measures OMIT_FROM_DOCS >>> repeat.RepeatFinder().getQuarterLengthOfPickupMeasure() Traceback (most recent call last): music21.repeat.NoInternalStreamException: RepeatFinder must be initialized with a stream .RepeatFinder must be initialized with a streamrz=Cannot determine length of pickup given fewer than 3 measuresrr) rKrxrrrmeasureOffsetMapkeysr/rv)r(s2mOffsetspickup normMeasures rrz,RepeatFinder.getQuarterLengthOfPickupMeasuresL 66>+@  66   BaB++-2245 x=1 -O !x{*qkHQK/  ##rcV|j td|jdk7S)a Returns True when the RepeatFinder's internal stream has a pickup bar. Raises an exception if the internal stream is too short (i.e. fewer than 3 bars long). >>> noPickup = corpus.parse('bwv10.7.mxl') >>> repeat.RepeatFinder(noPickup).hasPickup() False >>> #_DOCS_SHOW noPickup.parts[0].measures(0, 5).show() .. image:: images/repeat-rf_noPickup.* :width: 600 >>> hasPickup = corpus.parse('bwv101.7.mxl') >>> repeat.RepeatFinder(hasPickup).hasPickup() True >>> #_DOCS_SHOW hasPickup.parts[0].measures(0, 2).show() .. image:: images/repeat-rf_hasPickup.* :width: 600 OMIT_FROM_DOCS >>> repeat.RepeatFinder(noPickup.parts[0].measures(1, 2)).hasPickup() Traceback (most recent call last): music21.repeat.InsufficientLengthException: Cannot determine length of pickup given fewer than 3 measures >>> repeat.RepeatFinder().hasPickup() Traceback (most recent call last): music21.repeat.NoInternalStreamException: RepeatFinder must be initialized with a stream rg)rKrxrr4s rr}zRepeatFinder.hasPickups.B 66>+,\] ]335<>> chorale = corpus.parse('bwv154.3.mxl') Expand the repeats: >>> chorale = repeat.Expander(chorale.parts[0]).process() Search for similarity: >>> repeat.RepeatFinder(chorale).getMeasureSimilarityList() [[4, 12], [5, 13], [6], [7], [12], [13], [], [], [], [], [], [], [], [], [], []] >>> chorale2 = corpus.parse('bwv153.5.mxl') >>> chorale2 = repeat.Expander(chorale2.parts[0]).process() >>> repeat.RepeatFinder(chorale2).getMeasureSimilarityList() # bwv153.5 has a pickup [[5], [6], [7], [8], [9], [], [], [], [], [], [15], [], [], [], [19], [], [], [], [], []] >>> hashFunction = lambda m : str(len(m)) >>> repeat.RepeatFinder(chorale.measures(1, 8), ... defaultMeasureHashFunction=hashFunction).getMeasureSimilarityList() [[1, 2, 4, 5, 6, 8, 10], [2, 4, 5, 6, 8, 10], [4, 5, 6, 8, 10], [7, 9, 11], [5, 6, 8, 10], [6, 8, 10], [8, 10], [9, 11], [10], [11], [], []] OMIT_FROM_DOCS >>> repeat.RepeatFinder().getMeasureSimilarityList() Traceback (most recent call last): music21.repeat.NoInternalStreamException: RepeatFinder must be initialized with a stream rr Nrrz1Parts must each have the same number of measures.r%r-)rr rKrxrr~rrrrzipr/rtr notesAndRestsrjoinrextend)r(r hashFunctionrKmListspmThismNextrr;tempDict_resmHashs rr{z%RepeatFinder.getMeasureSimilarityListsZ # 66>+,\] ] ;; ";; '' FF ==?**6>>:;FDEGGLGqa**6>>:GFL qr 3LE55zSZ'1GII4s6{#As6!9~..AVAYq\778.F1I$c6l#!V-.-ar-.s6{QB/AGGF1I&E A huo.A c(5/23 HUO0  WM/s "G&G+& G0c||f|vry|dz||dzvr|j||dz|dz||}|g|gf}|dj|d|dj|d|dd|ddkrd||dz|dzf<n:|dd|ddk\r)|ddd|dddf}|dd|ddk\r"n|g|gf}||||f<d|||f<|S)a Recursive helper function used by getSimilarMeasureGroupsFromList. Should only be called if the "source" measure of a piece is the same as the "compare" measure. When called, updates resDict such that resDict[(source, compare)] is equal to ( sourceList=[source, source + 1, source + 2, ...], compareList=[compare, compare + 1, compare + 2, ...]), where measure sourceList[i] is the same as measure compareList[i] Inputs:: measures - A list returned from getMeasureSimilarityList. source - The measure number which you are considering compare - The measure number which is compared to the source measure (this is a repeat of the source measure) resDict - A dictionary of memoized results where for each key (i,j), there is stored a tuple ([i, i + 1, i + 2, ...], [j, j + 1, j + 2, ...]) where measures i and j are equal, and measure i + 1 and j + 1 are equal, and measures i + 2 and j + 2 are equal, etc. useDict - A dictionary for each input that maps to False if and only if the function calls the same input m and i. Has the result that if resDict((i, j)) maps to something like ([i, i + 1, i + 2...], [j, j + 1, j + 2, ...]), then useDict(i,j) is only False if resDict(i - 1, j - 1) is something like ([i - 1, i, i + 1, ...], [j - 1, j, j + 1, ..]) See getSimilarMeasureGroupsFromList documentation for tests. Nrrr%FT)_getSimilarMeasuresHelperr)r(rsourcecompareresDictuseDictnextOners rrz&RepeatFinder._getSimilarMeasuresHelpers?F G  '  q[HVaZ0 044Xvz7UV;6=wHG8gY'C FMM'!* % FMM'!* %1vbzCF1I%6;!Wq[12!fRjCF1I-q6#2;As 4C!fRjCF1I-8gY'C%(!"%)!" rFc t| }i}i}tt|D]!}||D]}|j|||||#t |D] }||r ||= g} |j D]?} | dDcgc]}||z c}| dD cgc]} | |z c} f} | j | A| |_| Scc}wcc} w)a Input is a list formatted as the output described in getMeasureSimilarityList(). Output is a list of tuples of the form (l1, l2), where l1 and l2 are lists of measure numbers such that measure l1[i] is identical to measure l2[i] and l1[-1] < l2[0] For all tuples t1 and t2, it is guaranteed that we never have t1.l1 contains t2.l1 or t2.l2 contains t2.l2 >>> mList = [[5, 6], [7], [8], [9], [11, 12], [6, 13], ... [], [], [], [], [], [12], [], []] >>> res1 = repeat.RepeatFinder()._getSimilarMeasureTuples(mList, False) >>> ([1, 2, 3, 4], [7, 8, 9, 10]) in res1 True >>> ([1], [6]) in res1 True >>> ([5],[12]) in res1 True >>> ([5, 6], [13, 14]) in res1 True >>> ([6],[7]) in res1 True >>> ([12],[13]) in res1 True >>> len(res1) 6 >>> mList = [[], [5, 10], [6, 11], [7, 12], [8, 13], ... [10], [11], [12], [13], [], [], [], [], []] >>> res2 = repeat.RepeatFinder()._getSimilarMeasureTuples(mList, True) >>> ([1, 2, 3, 4], [5, 6, 7, 8]) in res2 True >>> ([1, 2, 3, 4], [10, 11, 12, 13]) in res2 True >>> ([5, 6, 7, 8], [10, 11, 12, 13]) in res2 True >>> len(res2) 3 >>> s = stream.Stream() >>> n1 = note.Note('C') >>> n2 = note.Note('D') >>> n3 = note.Note('E') >>> n4 = note.Note('F') >>> for i in range(3): ... m = stream.Measure() ... s.append(m) ... m.append(n1) ... m.append(n2) ... m.append(n3) ... m.append(n4) >>> rf = repeat.RepeatFinder() >>> res3 = rf._getSimilarMeasureTuples([[1, 2], [2], []], False) >>> ([1], [2]) in res3 True >>> ([2], [3]) in res3 True >>> ([1], [3]) in res3 True >>> len(res3) 3 >>> s = stream.Stream() >>> n1 = note.Note('C') >>> n2 = note.Note('D') >>> n3 = note.Note('E') >>> n4 = note.Note('F') >>> for i in range(5): ... m = stream.Measure() ... s.append(m) ... m.append(n1) ... m.append(n2) ... m.append(n3) ... m.append(n4) >>> rf = repeat.RepeatFinder() >>> res3 = rf._getSimilarMeasureTuples([[1, 2, 3, 4], [2, 3, 4], [3, 4], [4], []], False) >>> ([1, 2], [3, 4]) in res3 True >>> ([1, 2], [4, 5]) in res3 True >>> ([2, 3], [4, 5]) in res3 True >>> ([1],[3]) in res3 False >>> ([1],[4]) in res3 False >>> ([1],[5]) in res3 True rr)intrr/rrvaluesrr) r(rr}pickupCorrectionrusefulrrkrealResmTupler; appendTups r_getSimilarMeasureTuplesz%RepeatFinder._getSimilarMeasureTuplessv9}-s5z"A1X..uaCH# cA!9FjjlF8>q B 1!.. B8>q B 1!.. BDI NN9 %#    CBs > B? CrcJ|j}|j||j}i}t|d}|r |j}n|jj d}| t dg}g} g} |D]} d} | d| dz} | D] }||vsd } n| r#| dd| dd z dz }td t| dd z dz}t| d|k\r=|dk(r8| dd| dd }}| j||f| j| dnjt| d|k\rW||cxk\rdkDrLnnI| dd}| dd dz}| dddz }|||f}|j|| j| dn | D]}d ||< |D]M\}}}t|||d ||z dz}||z dz}||z}t|||dd t||||zdd O| D]\}}t|||d t|| d |j|s|Sy)aH Takes the piece stored in the RepeatFinder object and collapses repeated sections by replacing them with repeat signs. Includes first and second endings where appropriate. Only detects repeated sections which are repeatThreshold bars long and only detects repeat endings where the repeated sections is more than repeatEndingThreshold bars long. If inPlace is True, does not return a new music21 object, but instead alters the stream passed to the RepeatFinder object. In the below example, we have an 8-measure stream where the last four measures are identical to the first four. >>> s = stream.Stream() >>> notes = [note.Note('D'), note.Note('E-'), note.Note('C'), note.Note('B3'), ... note.Note('D'), note.Note('E-'), note.Note('C'), note.Note('B3')] >>> for i in range(8): ... m = stream.Measure() ... m.number = i + 1 ... myNote = notes[i] ... myNote.duration.quarterLength = 4.0 ... m.append(myNote) ... s.append(m) >>> #_DOCS_SHOW s.show() .. image:: images/repeat-RepeatFinderDSCH.* :width: 600 >>> s2 = repeat.RepeatFinder(s).simplify() >>> #_DOCS_SHOW s2.show() .. image:: images/repeat-RepeatFinderDSCHsimplified.* :width: 600 OMIT_FROM_DOCS >>> c1 = corpus.parse('bwv115.6.mxl') # has a repeated section >>> c1p0 = repeat.Expander(c1.parts[0]).process() >>> c1simple = repeat.RepeatFinder(c1p0).simplify() >>> m4 = search.translateStreamToString(c1p0.measure(3).notesAndRests) >>> m5 = search.translateStreamToString(c1p0.measure(4).notesAndRests) >>> m9 = search.translateStreamToString( ... c1p0.getElementsByClass(stream.Measure)[7].notesAndRests) >>> resm4 = search.translateStreamToString(c1simple.measure(3).notesAndRests) >>> resm5 = search.translateStreamToString(c1simple.measure(4).notesAndRests) >>> m4 == resm4 True >>> m5 == resm5 True >>> m9 == resm5 True >>> initialRepeats = c1p0[bar.Repeat] >>> len(initialRepeats) 0 >>> resRepeats = c1simple[bar.Repeat] >>> len(resRepeats) 1 >>> s = stream.Stream() >>> for i in range(1, 6): ... m = stream.Measure() ... s.append(m) ... m.number = i ... m.append(note.Note('D')) ... m.append(note.Note('E-')) ... m.append(note.Note('C')) ... m.append(note.Note('B3')) >>> s2 = repeat.RepeatFinder(s).simplify(repeatThreshold=2) >>> len(s2.getElementsByClass(stream.Measure)) 3 >>> len(s2.flatten().getElementsByClass(bar.Repeat)) 1 cBdt|dz|dd|ddfSNr%rrr/xs rz'RepeatFinder.simplify.. s'S1Y!Q1a'IrkeyzRepeatFinder.simplifyNzGThis function only works when RepeatFinder is initialized with a streamFrrTr%g0@g@rrr)r{rr}sortedrKrrxminr/rrrrrr)r(repeatThresholdrepeatEndingThresholdrrmGroups processedrKrepeatEndingBarsr repeatBarsmGroupalreadyProcessedmeasureNumbersmNumdistancemaxAcceptableDistancestartBarendBar startingBarfirstEndingBar repeatSignBartoProcessTuplelengthOfRepeatEndinglengthOfRepeatedSectionstartOfSecondEndings rrzzRepeatFinder.simplify9 sZ--///t~~7GH I A++,CDA 9+Y  F$ #AY2N&9$'+$' ay|fQim3a7H$'c&)ns.BQ.F$G !6!9~0X]#)!9Q<2&!!8V"45q *fQi.$99+x;!;$Qil !'2!2 &q ! q 0 "-~}!M ''7q *'"& $'GL;K 6K K E#0>#AA#E &4{&BQ&F #"/2I"I  q-, '+  - q225II '+  -;K"!+ Hf Hfd ;!+ q#-1-G-G I Hrc2|jJ|j|j}n |j}|j||j }n |j}|Dcgc]}t |d|k\s|}}t |d}|Scc}w)a Returns a list of tuples containing information on repeated groups of measures. Specifically, returns a list of tuples of the form (l1, l2) where l1 and l2 are lists of measure numbers such that measure l1[i] is the same as measure l2[i]. >>> chorale = corpus.parse('bwv117.4.mxl') Expand repeats >>> chorale = repeat.Expander(chorale.parts[0]).process() >>> #_DOCS_SHOW chorale.show() Measures 0-4 are the same as measures 5-9. .. image:: images/repeat-SimplifyExample_Chorale.* :width: 600 >>> repeat.RepeatFinder(chorale).getSimilarMeasureGroups() [([0, 1, 2, 3, 4], [5, 6, 7, 8, 9]), ([1, 2, 3, 4, 5], [6, 7, 8, 9, 10]), ([0], [10])] Notice that although measures 2-3 are the same as measures 6-7, we don't have ([2, 3], [6, 7]) in our result, since ([1, 2, 3], [5, 6, 7]) already contains that information. rcBdt|dz|dd|ddfSrrrs rrz6RepeatFinder.getSimilarMeasureGroups.. s'c!A$i1a!A$q'0Rrr)rrr{rr}r/r)r( thresholdrrrs rr|z$RepeatFinder.getSimilarMeasureGroups s: == {{"557 33E4>>;KLGmmG%@gQqTi)?1g@&RSAs 'B>B)NNrq)rr)rrrrrrr__annotations__r!rr}r{rrrzr|rrrrr}sg>JLQ!V !XI~X *8$t$=LiV@Dpdrerh4rr__main__r)rr)4r __future__rrAr1typingrmusic21.common.typesrrrrrrr r TYPE_CHECKINGr EnvironmentrProtoM21Objectrrr ExpressionrrUrYr^rarfrjrnrrrurxr{rrepeatExpressionReferencerrrrGenericrrtrvrxrrrrmainTestrrrrs7 # + ??'{&&x0 ''8 = = hz;#9#9hV &- &" !", "$ % ! % %. %4 $4"4*4*4*4. 4% 44&4$4,4&4,42 FEGTVVX|~NGIxz>+;^=M 55p,1<~,1Zp 55 a+qyy$a+L' ,"?"?  ,"?"?  = = d d T 6eT%v|GX~~|]  zGr