rhNSrSSKJr SSKrSSKrSSKrSSKJr SSK J r SSK J r SSK J r SSK J r SS K Jr SS K Jr \R (aSS K Jr \ R$"S 5r"S S\ R(5r"SS\ R,5r"SS\\ R05r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS \5r "S!S"\5r!"S#S$\5r""S%S&\5r#"S'S(\5r$"S)S*\5r%\"5\"5\"5\"5\ "5\!"5\""5\#"5\$"5\%"5/ r&S?S+S,.S@S-jjjr'S+S,.S.jr(S+S/S0.S1jr)"S2S3\ R,5r*"S4S5\RV\5r,"S6S7\ R,5r-"S8S9\ R,5r."S:S;\ R,5r/"S<S=5r0\\\\\\\\ \!\"\#\$\%\0/r1\2S>:XaSSK r \ Rf"5 gg)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)stylestreamrepeatc\rSrSrSrSrg) RepeatMark*as 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('Stream has %s repeat(s) in it' % (len(repeats))) Stream has 1 repeat(s) in it N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__rH/home/james-whalen/.local/lib/python3.13/site-packages/music21/repeat.pyrr*srrc\rSrSrSrg)RepeatExpressionExceptionGrNrrrrrrrrrrGrrcr^\rSrSrSr\R rU4SjrSr Sr Sr S Sjr Sr S rS rS rU=r$) RepeatExpressionKa 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 >[TU]"S0UD6 SUl/UlSURlSUlSURlg)NcenterFr)super__init___textExpression_textAlternativesr justify useSymbol absoluteYselfkeywords __class__s rr&RepeatExpression.__init__\sD $8$#!#%  " rcUR5nUb [U5S:a[USSS-5$Ub [U5$g)Nz...)getTextlenrepr)r-contents r _reprInternalRepeatExpression._reprInternaljsG,,.  3w<"#4 u,- -  = rc.URR$)z( Get the text used for this expression. )r'r7r-s rr4RepeatExpression.getTextss##+++rcURcG[R"U5UlURURlUR 5 gXRlg)zx Set the text of this repeat expression. This is also the primary way that the stored TextExpression object is created. N)r'rTextExpressionr applyTextFormattingr7r-values rsetTextRepeatExpression.setTextysM    '#.#=#=e#DD )-D &  $ $ &+0 (rctUc URnUb%URRURlU$)zQ Apply the default text formatting to the text expression version of this repeat )r'r r))r-tes rr?$RepeatExpression.applyTextFormattings4 :%%B >#zz11BHH  rc[U[R5(d[SU35eXlUR 5 g)z' Directly set a TextExpression object. z,must set with a TextExpression object, not: N) isinstancerr>rr'r?r@s rsetTextExpression"RepeatExpression.setTextExpressionsB%!;!;<<+>ugFH H$   "rc^URcg[R"UR5$)z< Return a copy of the TextExpression stored in this object. N)r'copydeepcopyr;s rgetTextExpression"RepeatExpression.getTextExpressions(    '==!5!56 6rc^SnURHnU"U5nU"U5nX:XdM g g)zT Return True or False if the supplied text could be used for this RepeatExpression. cUR5nURSS5nURSS5nUR5nU$)N r3.)stripreplacelower)ss r stripText/RepeatExpression.isValidText..stripTexts= A #r"A #r"A AHrTFr()r-rArX candidates r isValidTextRepeatExpression.isValidTexts; //I!),Ie$E! 0 r)r(r'r*N)rrrrrr TextStyle _styleClassr&r8r4rBr?rIrNr\r __classcell__r/s@rr r Ks@ //K ", 1 #7rr c,^\rSrSrSrU4SjrSrU=r$)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 H>[TU]"S0UD6 SURlg)Nr#r)r%r&r r)r,s rr&RepeatExpressionMarker.__init__s $8$% rrrrrrrr&rrarbs@rrdrds &&rrdc0^\rSrSrSrSU4SjjrSrU=r$)CodazR The coda symbol, or the word coda, as placed in a score. >>> rm = repeat.Coda() c >[TU]"S0UD6 SURl/SQUlUb/UR U5(aUR U5 SUlgUR URS5 SUlg)Nr#)rjzto Codazal CodaFrTr)r%r&r r)r(r\rBr*r-textr.r/s rr& Coda.__init__sn $8$% !?   0 0 6 6 LL "DN LL//2 3!DNrr(r*r^rhrbs@rrjrjs " "rrjc,^\rSrSrSrU4SjrSrU=r$)SegnozU The segno sign as placed in a score. >>> rm = repeat.Segno() >>> rm.useSymbol True c >[TU]"S0UD6 S/UlURURS5 SUlg)NrrrTr)r%r&r(rBr*r,s rr&Segno.__init__s; $8$") T++A./rrprhrbs@rrrrrsrrrc,^\rSrSrSrU4SjrSrU=r$)Finez= The fine word as placed in a score. >>> rm = repeat.Fine() c >[TU]"S0UD6 S/UlURURS5 SURlg)Nfinerrightr)r%r&r(rBr r)r,s rr& Fine.__init__s@ $8$"( T++A./$ rrZrhrbs@rrwrws %%rrwc,^\rSrSrSrU4SjrSrU=r$)RepeatExpressionCommandzu Some repeat expressions are commands, instructing the reader to go somewhere else. DaCapo and related are examples. c V>[TU]"S0UD6 SUlSURlg)NFr{r)r%r&repeatAfterJumpr r)r,s rr& RepeatExpressionCommand.__init__s) $8$$% r)rrhrbs@rr~r~s %%rr~c0^\rSrSrSrSU4SjjrSrU=r$)DaCapoi z 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 >[TU]"S0UD6 SS/UlUb(URU5(aUR U5 gUR URS5 g)NzDa CapozD.C.rrr%r&r(r\rBrms rr&DaCapo.__init__sY $8$"+V!4   0 0 6 6 LL  LL//2 3rrZr^rhrbs@rrr s 44rrc0^\rSrSrSrSU4SjjrSrU=r$) DaCapoAlFineia 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 >[TU]"S0UD6 SS/UlUb(URU5(aUR U5 gUR URS5 g)NzDa Capo al finez D.C. al finerrrrms rr&DaCapoAlFine.__init__%Y $8$"3^!D   0 0 6 6 LL  LL//2 3rrZr^rhrbs@rrrs 44rrc0^\rSrSrSrSU4SjjrSrU=r$) DaCapoAlCodai/a_ 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 >[TU]"S0UD6 SS/UlUb(URU5(aUR U5 gUR URS5 g)NzDa Capo al Codaz D.C. al Codarrrrms rr&DaCapoAlCoda.__init__=rrrZr^rhrbs@rrr/s 44rrc0^\rSrSrSrSU4SjjrSrU=r$)AlSegnoiGzW Jump to the sign. Presumably a forward jump, not a repeat. >>> rm = repeat.AlSegno() c >[TU]"S0UD6 S/UlUb(URU5(aUR U5 gUR URS5 g)Nzal Segnorrrrms rr&AlSegno.__init__MsV $8$",   0 0 6 6 LL  LL//2 3rrZr^rhrbs@rrrGs 44rrc0^\rSrSrSrSU4SjjrSrU=r$)DalSegnoiVz 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 >[TU]"S0UD6 SS/UlUb(URU5(aUR U5 gUR URS5 g)Nz Dal SegnozD.S.rrrrms rr&DalSegno.__init___sY $8$"-v!6   0 0 6 6 LL  LL//2 3rrZr^rhrbs@rrrVs44rrc0^\rSrSrSrSU4SjjrSrU=r$)DalSegnoAlFineiha 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 >[TU]"S0UD6 SS/UlUb(URU5(aUR U5 gUR URS5 g)NzDal Segno al finez D.S. al finerrrrms rr&DalSegnoAlFine.__init__rY $8$"5~!F   0 0 6 6 LL  LL//2 3rrZr^rhrbs@rrrhs44rrc0^\rSrSrSrSU4SjjrSrU=r$)DalSegnoAlCodai{aa 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 >[TU]"S0UD6 SS/UlUb(URU5(aUR U5 gUR URS5 g)NzDal Segno al Codaz D.S. al Codarrrrms rr&DalSegnoAlCoda.__init__rrrZr^rhrbs@rrr{s 44rrFinPlacec U(dURS5 UcgUR5(d(URHn[XQX#SS9 M U(agU$[ XS-5Vs/sHo`R U5PM nn[ R"XsS9nUSRU5n URX5 USLagU$s snf)a 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) rWstartend endingNumberrpartimeasuresrbrbOffsets rrrs:  34y ==??GGD tCt L  H&+E7&;<&; ! &;H<   x =B{**1-HHHX$=s*CcUcgU(dURS5 UR5(d(URHn[XAUSS9 M U(agU$SSKJn UR SSS 9URU5lUS :wd[U5R5S:wa#UR S S 9URU5l U(agU$) 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)rWrrrrrs rrrsH y  ~. ==??GGD c4 8  H"%**uA*"FAIIcN z\!_DDF!K'*zzGz'D %$rTrcorrectMeasureNumbersc,SSKJn UcgU(dURS5nUR5(a2UH+nUR U5nUcMURU5 M- O)URHn[UUSUS9 M U(agU$U(aV[URUR55nU(a+USRn U S;aSn UHn Xl U S- n M U(agU$![ R a SnNf=f) af 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) rWtoDeleterrr mNumberremoveMerrrrs rrrsZy  " "#3 4}}G 99W-#" GGD 4##'1F H H,,V^^<=  ""A#!"Q$C 00  sC::DDc\rSrSrSrg)ExpanderExceptionirNrrrrrrrrrc\rSrSrSrSSjrSSSjjrS SjrS!SjrS"Sjr Sr S r S r S r S rS rSrSrS#SjrSrSrS$SjrS%SjrSrS&SjrS'SjrSrSS/rSrg)(Expanderia 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 cSSKJn XlURRUR5R5UlURR 5R[R5R5Ul [UR 5Ul URS:Xa [S5eUR R 5R[5R5n[UR[55Ul[UR[ 55Ul[UR[$55Ul[UR[(55Ul[UR[,55Ul[UR[055Ul[UR[455Ul[UR[855Ul[UR[<55Ul[UR[@55Ul!g)Nrr z5no measures found in the source stream to be expanded)"rr _srcrr_srcMeasureStreamflattenr r_repeatBracketsr5_srcMeasureCountrr rj _codaCountrr _segnoCountrw _fineCountr_dcCountr _dcafCountr _dcacCountr_asCountr_dsCountr _dsafCountr _dsacCount)r- streamObjr reStreams rr&Expander.__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:UR5nUSLa [S5eUSLaURRS5nO URnUc[R "[ U5$[R"UR5Ul UH=nURRRURRU5 M? UR5nUcURU5nOUR!U5nUR#U5 U$)at 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) isExpandablerrrtcastrrLrMr spannerBundlereplaceSpannedElement derivationorigin_daCapoOrSegno_processRecursiveRepeatBars"_processRepeatExpressionAndRepeatsmergeAttributes)r-rM canExpand srcStreammhasDaCapoOrSegnoposts rprocessExpander.processs%%'  #RT T 5 ..CCOTI..I  66*i0 0 $}}T-A-ABA  . . D D ##Q ( ..0  #33I>D::9ED Y' rcBSSKJn /n/nUR5nUn[UR UR 55H?upxUR UR55 UR UR5 MA US:XaU$0n 0n [UR5H%upxXyUR5'XzUR'M' /n [U5Hup|U R X5 M U $![a U R XU5 MBf=f)a 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 measureMapExpander.measureMap0s%2 #$&!||~#' 6II&..YZDA  $ $Q%>%>%@ A % , ,QXX 6[  ($ $$&!d445DA=>a779 :23ahh /6  *34E*F &A Z  !2!KL+G  Z  !:UV;W!XY Zs!C:: DDcSSKJn URnURnUb&SUR;aUR U5UlUb(SUR;aUR U5Ulggg)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_stripRepeatBarlinesExpander._stripRepeatBarlinesgsc ]] ^^ >2bkkAKK0AM >2bkkA [[1ANB>rc.SSKJn UR5(dU/nO$[UR UR 55nUHLn/nUR [ 5HnURU5 M UHnURU5 M MN g)zW Given a Stream of measures or a Measure, strip all RepeatExpression objects in place. rr N) rr rrrrr rr)r-rr mListrres r_stripRepeatExpressions Expander._stripRepeatExpressionsvs| #$$&&KE55fnnEFEAF))*:; a <  rcLSnSnSnURHnURnURnUbUSUR;aEURS:Xa US- nUS- nO*URS:XaUS:Xa US- nUS- nUS- nUS-nUcMxSUR;dMURS:XaUS:Xa US- nUS- nUS- nUS-nM[ SUSU35e US;a[ RS U3/5 g XUS- 4;a[ RS U<S U<3/5 g g )zG Check that all repeat bars are paired properly. Returns True or False rr rrrz3a 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 rrepeatBarsAreCoherentExpander.repeatBarsAreCoherentsg  ''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\~%^$_ ` 1 5 5  # #H&&%' (rcURUR-UR-nURUR-UR -UR -nUS:Xa US:Xa[$US:Xa US:Xa[$g)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) rrrrrrrrrr)r-sumDcsumDss rrExpander._daCapoOrSegnosw /$//A??#??#==! A:%1*M aZEQJLrcURS:XagURS:XagURS:XagURS:XagURS:XagUR S:XagUR S:Xag[S 5e) 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. rrrrrrrrzno repeat command found)rrrrrrrrr;s r_getRepeatExpressionCommandType(Expander._getRepeatExpressionCommandTypesy ==A  __ !! __ !! ]]a  ]]a  __ !# __ !##$=> >rcdUR5R[5R5$)zC Get the instance found in this stream; assumes that there is one. )rrr~first)r-rs r_getRepeatExpressionCommand$Expander._getRepeatExpressionCommands(  "556MNTTVVrc$URUR-UR-nUS:agURS:XaURS:XagURS:XaURS:XagURS:XaURS:Xagg)z& Check of a DC statement is coherent. rFrTr)rrrrr)r-r#s r_daCapoIsCoherentExpander._daCapoIsCoherents  /$//A 19 ==A $//Q"6__ !doo&:__ !doo&:rc@URUR-UR-UR-nUS:agURS:Xa!URS:XaUR S:XagURS:Xa!URS:XaUR S:XagURS:Xa1UR S:Xa!URS:XaUR S:XagURS:Xa1UR S:Xa!URS:XaUR S:Xagg)z, Check of a sa segno statement is coherent. rFrTr)rrrrrrr)r-r$s r_dalSegnoIsCoherentExpander._dalSegnoIsCoherents ==!??#??# 19 MMQ $$)OOq( MMQ $$)OOq(oo"OOq($$)OOq(oo"OOq($$)OOq(rc/n[[U55n/n//S.nSnU[U5:GaXnURHnUR U5(dMUR SU;aUR U5 /n//S.nXHR - nUSR U5 UR5n UHgupX:a.[U 5[U 5:waUSR U 5 M8[U 5[U 5:XdMRUSR U 5 M M US- nU[U5:aGMU(aUR U5 U$)a 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': [>]}] )repeatBracketsmeasureIndicesrr4r5r) rrr5risFirst numberRangergetLastid) r-rgroups mEnumeratedfoundRBNumbers groupIndicesrrrmLastiSubmSubs r_groupRepeatBracketIndices#Expander._groupRepeatBracketIndices0sP89Y/0     #i.  A**::a==~~a(N: l3)+:()9:AA$GY"T(2()9:AA$G "'2!+@ FAG#i. H  MM, ' rc URUR5GHinUSnU(d g[U5S:XaOl[U5S:a]/nUHnX4R- nM [ [ S[ U5S-55nXS:wa[RSUSU3/5 g/n[U5HuptUR5nUR5HFn[U5U;a[RS/5 gUR[U55 MH URn U bSU R;dM[U5S:XdU[U5S- :dM[RS /5 g GMl g) zr Check if repeat brackets are coherent. This must be done for each group of brackets, not for the entire Stream. r4Trz0repeat brackets are not numbered consecutively: rFz!found overlapping repeat bracketsrz8repeat brackets are not terminated with a repeat barline)rArr5r7rrmaxrrrr8getSpannedElementsr9rrclasses) r-group rBracketstargetrmatchspannedMeasureIdsrbCountrrightBars r_repeatBracketsAreCoherent#Expander._repeatBracketsAreCoherents 44T5K5KLE./I9~"Y!##B nn,F $ U1c&kAo67? ++J5'QSTZS[\-^_ " (3 JJL..0A!u 11$//1T0UV$%,,RU3 1 >>#xx7G7G'GI!+&Y!);;$//V1 %+ 4?Mjrc[[U55H]nXnURnURnUbSUR;a gUcM9SUR;dMKUR S:XdM] g g)zL Return True if this Stream of Measures has a repeat pair still to process. r TrF)rr5rrrr)r-rrrrrs r _hasRepeatExpander._hasRepeatsk s9~&A ABB, ;, ; -'rc*/n/n[[U55HnXnURnURnUbgSUR ;aWUR S:XaURU5 O5UR S:Xa%U(d [U5n Og[USU5n OVUcMSUR ;dMUR S:XdMU(d[US-5n O[USUS-5n O [U5$![a Mf=f)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] r rrr) rr5rrAttributeErrorrrrr)r-r startIndicesbarRepeatIndicesrrrrs rfindInnermostRepeatIndices#Expander.findInnermostRepeatIndicess4 s9~&A A ]]^^~"6"++"E<<7* ''*\\U*'+08(+0b1A1+E(, ; -$',QU|$',\"-=q1u'E$C'D$%%9"  sD DDctXnURnUb/SUR;aURS:XaUnURnOnU[ U5S- :a[ SU35eXS-nUR nUb-SUR;aURS:Xa URnO [ S5eUcSnX5U4$)aJ 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. r rrz3cannot find an end Repeat bar after the given end: z6cannot find an end Repeat bar in the expected positionr)rrrrr5rr)r-rindexr>r mEndBarline repeatTimesrs r_getEndRepeatBarExpander._getEndRepeatBars     N(BKK7LLE)K((KI**'I%QSS$AI.K((B, ; - hh '(`aa  K;..rNcx[RnUR5nSnUcURU5nOSnSnSn Sn U [ U5:GaQU(dU$XS:XaSn Sn UR UUS5upn UcU n[U5Hn UH~n[R"X5nXSUS4;aURU5 US:aXS- :aURU5 U S:waX]S- S-Ul URU5 M M XLaSnUSS-n OfU(dZ[R"X5nXnU(a&URU5 URX5 SnURU5 U S- n U [ U5:aGMQU$![ a U(deGN9f=f) 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} FNTrrTrr)stringascii_lowercaser/rXr5r^rrrLrMrr numberSuffixr)r-r repeatIndicesr]returnExpansionOnlylowercase_alphabetnew forcedIndicesstripFirstNextMeasurerrepeatTimesFoundr\r>rjr@junkrs rprocessInnermostRepeatBars#Expander.processInnermostRepeatBars<sh$33!!#   ;;IFM M!& #i.  X O!$$" ;?;P;PQZQ^_aQb A:0BAIQSCS0TD- 4(!+ 00+,0)!"%)+  ==6D" A -11!411),?05-JJqMQY#i. \ C)()s'F##F98F9cUc0nURU5nU(dURU5$URU5nSnUHnnU(dM USnXSnXSn UHDn [U 5U;a O4U R U5(dU R U 5(aUn OMF UcMn O UcURU5$USnUSUSn /n Sn /nUGHFn X[U 5'USnU R 5nU R 5nSnSn[U5H<unn[U5[U5:XaUn[U5[U5:XdM:UnM> UbUc [S5eURnUb)SUR;a[[UUS-55nO[[UUS-55n[[UUS-55nUb.UH(nUSHnUU;dM URU5 M M* U UUS .nURU5 GMI UHWnUS cM [US R 5nURUUS US S 9nU RU5 [#US 5n MY UR%5nU HnURU5 M U H.nUH%nUR'U5 URU5 M' M0 XS-SnUHnURU5 M U$)z 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 Nr4rrTz6failed to find start or end index of bracket expansionr rbracketIndices) repeatBracket validIndicesrqrsrrT)rer]rf)rArnrXr9hasSpannedElementgetFirstr8rrrrrrrrr5r7rDr/r) r-rrepeatBracketsMemor: innermost groupFocusrGrHmStartmEndr streamObjPrestreamBracketRepeatshighestIndexRepeated boundaries startIndexmFirstr>endIndexbracketStartIndexrr mLastRightBarindicesrqdataqr]outrhsub streamObjPosts r#_processInnermostRepeatsAndBrackets,Expander._processInnermostRepeatsAndBracketssk  %!#  00;229= = 33I>  E./I|,Fr]+Db6//))&11R5I5I$5O5O!&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 ( "":";< A JJqM rc /n[U5HjupEUR[5HLnX&R;d)[ U[ 5(aM)[ Xb5(dM;UR U5 MN Ml U(aU$g)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)rrr rFrHstrr)r-rrIrrrrs rgetRepeatExpressionIndex!Expander.getRepeatExpressionIndexsi"i(DA))*:;ii' *63 7 7Jq ?..00  # #$F G  --// ++,=> 0 %//11 ++,=> rcUSLa[R"U5n0nSnUS:a7US- nURUUS9nURU5(aOU$US:aM7U$)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)rv)rLrMrrQ)r-r makeDeepCopyrv maxProcessess rr$Expander._processRecursiveRepeatBarss 4  i0I Q'!+L@@#5A7I y)) #Q"rcUR5nUR5nURU5nURX5SnU[LaSnO*U[ LaURUS5SnO [ S5eUS;aURUS5SnO[U5S- nUS;aURUS5nUSn USn OS n S n /n U RSU/5 US;a2U RXi/5 U RU [U5S- /5 OU RXg/5 UR5n USRn U cSn [U 5HupUR5n[USUSS-5H9n[R"UU5nU Ul URU5 U S- n M; URU5(aTUS:XaUR (dO#UR#U5nUS RS-n UHnUR%US S 9 M UHnU RU5 M M UR'U 5 U $) zi Process and return a new Stream of Measures, likely a Part. Expand any repeat expressions found within. rrrzMust be DaCapo or Segno)rrrwr)rrrjNrTdouble)r)rr'r+rrrr ValueErrorr5rr/rrrrLrMrQrrrr)r-r capoOrSegnorecTyperecObjjumpBackrrcodascodaJump codaStart indexSegmentsrhrsubCountr subStreamrrs rr+Expander._processRepeatExpressionAndRepeatssp))+ 66811)<00DQG & E E !11)WEaHE67 7 8 8// 6B1ECi.1$C 8 811)VDEQxHaIHI a]+ 8 8  %!2 3  )S^a-?!@ A  % .!!#1$$ >F'}5MH!++-I3q63q6A:.MM)A,/!  #!  / y))q=)?)? $ @ @ KI&r]11A5F"A--a-B# 1 166 $$S) rrr )rrrrrrrrrrrrrr)rr)T)rMboolreturnr)r[)r)r stream.Stream)rrrr)NNFr^)rz bool | NoneF)rrrrrr&rr rrr rr'r+r.r1rArNrQrXr^rnrrrrr _DOC_ORDERrrrrrrsFN$KL3j5n 2&,\*?.W 6*XN`;z,@&D%/R26/37< Yz@DWv8!F D[z\*Jrrc\rSrSrSrg)UnequalPartsLengthExceptioniurNrrrrrrurrrc\rSrSrSrg)InsufficientLengthExceptioniyrNrrrrrryrrrc\rSrSrSrg)NoInternalStreamExceptioni}rNrrrrrr}rrrc\rSrSr%Sr/SQrSSSS.rS\S 'SS jrS r S r Sr Sr SSjr SSS.SjjrSSjrSrg )ria 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) defaultHashrWrzdict[str, str] _DOC_ATTRNc|SSKJn XlUcURUlOX lSUlSUlSUlg)Nr)searchT)rrrWtranslateStreamToStringr_mList_mGroupsr)r- inpStreamdefaultMeasureHashFunctionrs rr&RepeatFinder.__init__s:" % -%==D 9   %)"rcrURc [S5eURR5(a URnOURRSn[ UR 5R 55n[U5S:a [S5eUSUS- nUSUS- nX4-$)a 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) rWrrrrmeasureOffsetMapkeysr5r)r-s2mOffsetspickup normMeasures rr,RepeatFinder.getQuarterLengthOfPickupMeasuresN 66>+@  66    BaB++-2245 x=1 -O !x{*qkHQK/ ##rcXURc [S5eUR5S:g$)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)rWrrr;s rrRepeatFinder.hasPickups.@ 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.rTr3)rr rWrrrrrrrzipr5rr notesAndRestsrjoinrextend)r-r hashFunctionrWmListspmThismNextrrltempDict_resmHashs rr%RepeatFinder.getMeasureSimilarityList sX # 66>+,\] ] ;; ";; '' FF ==??**6>>:;FDEGGLGq**6>>:GFL qr 3LE5zSZ'1GII4s6{#As69~..AVYq\778.FI$c6l#!V-.-ar-.s6{QB/AGGFI&E  ho. c5/23 UO0  WM/s$G1!G62 G;cX#4U;agUS-XS-;aURXS-US-XE5nU/U/4nUSRUS5 USRUS5 USSUSS:a SXRS-US-4'O=USSUSS:a$USSSUSSS4nUSSUSS:aM$OU/U/4nXtX#4'SXRU4'U$)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. NrrrTFT)_getSimilarMeasuresHelperr)r-rsourcecompareresDictuseDictnextOners rr&RepeatFinder._getSimilarMeasuresHelpers0D   '  q[HaZ0 044Xz7UV;6=HG8gY'C FMM'!* % FMM'!* %1vbzCF1I%6;!Wq[12!fRjCF1I-q6#2;As 4C!fRjCF1I-8gY'C%(!"%)!" rFc [U(+5n0n0n[[U55H!nXHnURXXtU5 M M# [ U5HnXX(aMXH M /n UR 5HDn U SVs/sHowU-PM snU SV s/sHoU-PM sn 4n U R U 5 MF XlU $s snfs sn f)aS 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)intrr5rrvaluesrr) r-rrpickupCorrectionrusefulrrkrealResmTuplerl appendTups r_getSimilarMeasureTuples%RepeatFinder._getSimilarMeasureTuplessv9}-s5z"AX..uH# cA99FjjlF8>q B 1.. B8>q B 1.. BDI NN9 %#   CBs C Crc fUR5nURX@R55n0n[USS9nU(a URnOURR S5nUc [ S5e/n/n /n UGH)n Sn U SU S-n U H nX;dM S n O U (aM,U SSU SS - S- n[S [U S5S - S-5n[U S5U:a>US:Xa8U SSU SS nnU RUU45 U RU S5 On[U S5U:aYUUs=:aS:aLO OIU SSnU SS S-nU SSS- nUUU4nURU5 U RU S5 OGMU HnS Xn'M GM, UHEunnn[UUUS S 9 UU- S-nUU- S-nUU-n[UUUSS S 9 [UUUU-SS S 9 MG U Hunn[UUUS S 9 M [UU S URS9 U(dU$g)aD 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 cBS[US5-USSUSS4$NrTrrr5xs r'RepeatFinder.simplify.. s'S1Y!Q1a'IrkeyzRepeatFinder.simplifyNzGThis function only works when RepeatFinder is initialized with a streamFrrTrTg0@g@rrr)rrrsortedrWrrminr5rrrrrr)r-repeatThresholdrepeatEndingThresholdrrmGroups processedrWrepeatEndingBarsr repeatBarsmGroupalreadyProcessedmeasureNumbersmNumdistancemaxAcceptableDistancestartBarendBar startingBarfirstEndingBar repeatSignBartoProcessTuplelengthOfRepeatEndinglengthOfRepeatedSectionstartOfSecondEndings rrRepeatFinder.simplify= sb--///~~7GH I A++,CDA 9+Y  F$ #AY2N&$'+$' 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 Hrc8URcJURcUR5nO URnURX R 55nO URnUVs/sHn[ US5U:dMUPM nn[ USS9nU$s snf)a9 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. rcBS[US5-USSUSS4$rrrs rr6RepeatFinder.getSimilarMeasureGroups..( s'c!A$i1a!A$q'0Rrr)rrrrrr5r)r- thresholdrrrs rr$RepeatFinder.getSimilarMeasureGroups s: == {{"557 33E>>;KLGmmG%@gQqTi)?1g@&RSAs (BB)rrrrrW)NNr)rr)rrrrrrr__annotations__r&rrrrrrrrrrrrrsf>JLQ!V !XI~X *9$v#=JhT?Bpdvevp4rr__main__r)rr)4r __future__rrLrbtypingrmusic21.common.typesrrrrrrr r TYPE_CHECKINGr EnvironmentrProtoM21Objectrrr Expressionr rdrjrrrwr~rrrrrrrrepeatExpressionReferencerrrrGenericrrrrrrrmainTestrrrr"s8 # + ??&&x0 '': = = hz;#9#9hV &- &" !", "$ % ! % %. %4 $4"4*4*4*40 4% 44&4$4,4&4,42 FEGTVVX|~NGIxz>+;^=M 666r,1<~,1Zp 55 c+qyy$c+P' ,"?"?  ,"?"?  = = f f X 6eT%v|GX~~|]  z r