rhZ%SrSSKJr SSKrSSKrSSKrSSKrSSKrSSK r SSK J r SSK J r SSK Jr SSK Jr SSK Jr SS K Jr SS K Jr SS K Jr SS K Jr SS K Jr SSK Jr SSK Jr \R0(aSSK Jr \R4"S5rSrSrSrSrSr Sr!"SS\RD5r#"SS\RH5r%"SS\RD5r&"SS\RH5r'"S S!\ RP5r)"S"S#\ RP5r*\%\'/r+S$\,S%'\-S&:XaSSK r \ R\"\)5 gg)'z Parses the de Clercq-Temperley popular music flavor of RomanText. The Clercq-Temperley file format and additional rock corpus analysis information may be located at https://rockcorpus.midside.com ) annotationsN) OrderedDict)common) environment) exceptions21)key)metadata)meter)note)prebase)roman)stream)tie)chordzromanText.clercqTemperleyz % Blitzkrieg Bop BP: I | IV V | %THIS IS A COMMENT In: $BP*3 I IV | I | $BP*3 I IV | I | R |*4 I |*4 Vr: $BP*3 I IV | I | Br: IV | | I | IV I | IV | | ii | IV V | Co: R |*4 I |*4 S: [A] $In $Vr $Vr $Br $Vr $Vr $Br $Vr $Vr $Co a % Rock Around the Clock % just a general comment In: I | | | | | | V | | Vr: I | | | | IVd7 | | I | | V7 | | I | | %a comment on verse Vrf: I | | | | IVd7 | | I | | V7 | | I | IV iv | V | . I | S: [A] $In $Vr $Vr $Vr $Vr $Vr $Vr $Vrf % 3rd and 6th verses are instrumental zj % Simple Gifts % A wonderful shaker melody Vr: I | I | %incomplete verse S: [A] $Vr % Not quite finished!z % A Change is Gonna Come Vr: I | | ii7 | vi | I | ii7 . IV V/vi | vi | I | Br: ii7 | I | ii7 | vi | ii7 | vi | V7/V | V7 | In: I V6 vi I64 | ii65 V43/ii ii vi6 | bVIId7 . VId7 . | V | S: [Bb] [12/8] $In $Vr $Vr $Vr $Br $Vr I | z % Brown-Eyed Girl VP: I | IV | I | V | In: $VP*2 Vr: $VP*4 IV | V | I | vi | IV | V | I | V | % Second half could be called chorus Ch: V | | $VP*2 I |*4 Ch2: V | | $VP*3 % Fadeout S: [G] $In $Vr $Vr $Ch $VP $Vr $Ch2 a % Ring Of Fire In: [3/4] I . IV | [4/4] I | [3/4] . . V7 | [4/4] I | Vr: I . . IV | [3/4] I . IV | [4/4] I | . . . V | [3/4] I . V | [4/4] I | I . . IV | [3/4] I . IV | [4/4] I | [3/4] . . V | [4/4] I | Vr2: I . . IV | [3/4] I . IV | [4/4] I | . . . V | [3/4] I . V | [4/4] I | I . IV I | . . . IV | I | . . . V | I | % Or (alternate barring) | [3/4] I . IV | [2/4] I | [3/4] . . IV | [4/4] I | . . . V | I | Ch: V | IV I | V | IV I | [2/4] | [4/4] . . . V | I . . V | I | % Or the 2/4 measure could be one measure later Fadeout: I . . V | I . . V | I . . V | Co: [2/4] I | [4/4] . . . V | I . . V | $Fadeout S: [G] $In $Vr $Ch $In*2 $Ch $Vr2 $Ch $Ch $Co c\rSrSrSrg)CTSongExceptionkN__name__ __module__ __qualname____firstlineno____static_attributes__r[/home/james-whalen/.local/lib/python3.13/site-packages/music21/romanText/clercqTemperley.pyrrkrrc\rSrSr%Sr/SQrSS0rS\S'SSSjjrS r SS jr \ S 5r \ S 5r \ S 5r\ S5r\ S5rSSSjjrSSSjjrSrg)CTSongoa This parser is an object-oriented approach to parsing clercqTemperley text files into music. It is an advanced method. Most people should just run: >>> #_DOCS_SHOW p = converter.parse('clercqTemperley/dt/BrownEyedGirl.cttxt') or if the file ends in .txt then give the format explicitly as either 'clerqTemperley' or 'cttxt': >>> #_DOCS_SHOW p = converter.parse('BrownEyedGirl.txt', format='clercqTemperley') Advanced: if you want access to a CTSong object itself (for manipulating the input before converting to a string, etc. then create a CTSong object with one of the following inputs: 1. by passing in the string, with newline characters (\\n) at the end of each line 2. by passing in the filename as a string or path, and have Python open the file and read the text Given this file, you could create a CTSong object with: >>> exampleClercqTemperley = ''' ... % Brown-Eyed Girl ... VP: I | IV | I | V | ... In: $VP*2 ... Vr: $VP*4 IV | V | I | vi | IV | V | I | V | % Second half could be called chorus ... Ch: V | | $VP*2 I |*4 ... Ch2: V | | $VP*3 % Fadeout ... S: [G] $In $Vr $Vr $Ch $VP $Vr $Ch2 ... ''' >>> exCT = romanText.clercqTemperley.exampleClercqTemperley #_DOCS_HIDE >>> s = romanText.clercqTemperley.CTSong(exCT) #_DOCS_HIDE Or: >>> #_DOCS_SHOW s = romanText.clercqTemperley.CTSong('C:/Brown-Eyed_Girl.txt') When you call the .toPart() method on the newly created CTSong object, the code extracts meaningful properties (such as title, text, comments, year, rules, home time Signature, and home Key Signature) from the text file and returns a new Part object. It also makes these properties available on the CTSong object. The toPart() method has two optional labeling parameters, labelRomanNumerals and labelSubsectionsOnScore. Both are set to True by default. Thus, the created score will have labels (on the chord's lyric) for each roman numeral as well as for each section in the song (LHS). In case of a recursive definition (a rule contains a reference to another rule), both labels are printed, with the deepest reference on the smallest lyric line. >>> p = s.toPart() >>> #_DOCS_SHOW p.show() .. image:: images/ClercqTemperleyExbrown-eyed_girl.png :width: 500 >>> firstRN = p[roman.RomanNumeral][0] >>> firstRN.lyric 'I\nVP\nIn' All roman numerals mark which formal division they are in: >>> 'formalDivision' in firstRN.editorial True >>> firstRN.editorial.formalDivision ['VP', 'In'] The second RomanNumeral is at the start of no formal divisions >>> secondRN = p[roman.RomanNumeral][1] >>> secondRN.lyric 'IV' >>> secondRN.editorial.formalDivision [] >>> s.title 'Brown-Eyed Girl' >>> s.homeTimeSig >>> s.homeKey >>> s.comments [['Vr:', 'Second half could be called chorus'], ['Ch2:', 'Fadeout']] Year is not defined as part of the Clercq-Temperley format, but it will be helpful to have it as a property. So let's assign a year to this song: >>> s.year = 1967 >>> s.year 1967 Upon calling toPart(), CTRule objects are also created. CTRule objects are the individual rules that make up the song object. For example, >>> s.rules OrderedDict([('VP', ), ('In', ), ('Vr', ), ('Ch', ), ('Ch2', ), ('S', )]) The parser extracts meaningful properties to each rule, such as sectionName, home time signature of that rule, home key of that rule, and of course the individual stream from the song corresponding to the rule. The following examples display the instantiated properties of the second rule (list indexes start at one) as created above. >>> rule = s.rules['In'] >>> rule.text 'In: $VP*2' >>> rule.sectionName 'Introduction' With this object-oriented approach to parsing the clercq-temperley text file format, we now have the ability to analyze a large corpus (200 files) of popular music using the full suite of harmonic tools of music21. We can not only analyze each song as a whole, as presented in Clercq and Temperley's research, but we can also analyze each individual section (or rule) of a song. This may provide interesting insight into popular music beyond our current understanding. Examples used throughout this class utilize the following Clercq-Temperley text file >>> BlitzkriegBopCT = ''' ... % Blitzkrieg Bop ... BP: I | IV V | %THIS IS A COMMENT ... In: $BP*3 I IV | I | $BP*3 I IV | I | R |*4 I |*4 ... Vr: $BP*3 I IV | I | ... Br: IV | | I | IV I | IV | | ii | IV V | ... Co: R |*4 I |*4 ... S: [A] $In $Vr $Vr $Br $Vr $Vr $Br $Vr $Vr $Co ... ''' Another example using a different Clercq-Temperley file RockClockCT = % Rock Around the Clock % just a general comment In: I | | | | | | V | | Vr: I | | | | IVd7 | | I | | V7 | | I | | %a comment on verse Vrf: I | | | | IVd7 | | I | | V7 | | I | IV iv | V | . I | S: [A] $In $Vr $Vr $Vr $Vr $Vr $Vr $Vrf % 3rd and 6th verses are instrumental >>> s = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.RockClockCT) >>> part = s.toPart() >>> part.highestTime 376.0 >>> s.title 'Rock Around the Clock' >>> s.homeTimeSig >>> s.homeKey >>> s.comments [['just a general comment'], ['Vr:', 'a comment on verse'], ['S:', '3rd and 6th verses are instrumental']] >>> s.year = 1952 >>> s.year 1952 >>> s.rules OrderedDict([('In', ), ('Vr', ), ('Vrf', ), ('S', )]) >>> rule = s.rules['In'] >>> rule.text 'In: I | | | | | | V | |' >>> rule.sectionName 'Introduction' OMIT_FROM_DOCS one more example, which is the bane of this parser's existence:: % Ring Of Fire In: [3/4] I . IV | [4/4] I | [3/4] . . V7 | [4/4] I | Vr: I . . IV | [3/4] I . IV | [4/4] I | . . . V | [3/4] I . V | [4/4] I | I . . IV | [3/4] I . IV | [4/4] I | [3/4] . . V | [4/4] I | Vr2: I . . IV | [3/4] I . IV | [4/4] I | . . . V | [3/4] I . V | [4/4] I | I . IV I | . . . IV | I | . . . V | I | % Or (alternate barring) | [3/4] I . IV | [2/4] I | [3/4] . . IV | [4/4] I | . . . V | I | Ch: V | IV I | V | IV I | [2/4] | [4/4] . . . V | I . . V | I | % Or the 2/4 measure could be one measure later Fadeout: I . . V | I . . V | I . . V | Co: [2/4] I | [4/4] . . . V | I . . V | $Fadeout S: [G] $In $Vr $Ch $In*2 $Ch $Vr2 $Ch $Ch $Co )texttoParttitle homeTimeSighomeKeycommentsrulesyearzr The year of the CTSong; not formally defined by the Clercq-Temperley format. dict[str, str] _DOC_ATTRc JSUlSUl/Ul[5Ul/Ul/Ul[R"5Ul SUl SUl SUl SUl SUlUHnUS:XaX0lUS:XdMX0l M URU5 g)NTr#r()_titler!linesr_rules keyObjListtsListrPart_partObjr( _homeTimeSig_homeKeylabelRomanNumeralslabelSubsectionsOnScoreparse)selftextFilekeywordskws r__init__CTSong.__init__Ts  " )4 )+13      "&'+$BW} V|  8rc<SUR<SUR3$)Nztitle=z year=)r#r(r9s r _reprInternalCTSong._reprInternalps ~VDII;77rc[U[5(aSU;aSU;aURS5nO1[R"USSSS9nUR 5nSSS5 WVs/sH$n[U5S :wdMUR5PM& nnX l SRU5nXPl g!,(df  N]=f![ a [S U35e[a [S U35ef=fs snf) a Called when a CTSong is created by passing a string or filename; in the second case, it opens the file and removes all blank lines, and adds in new line characters returns pieceString that CTSong can call .expand() on. >>> exCT = romanText.clercqTemperley.exampleClercqTemperley This calls parse implicitly: >>> s = romanText.clercqTemperley.CTSong(exCT) >>> print(s.text) % Brown-Eyed Girl VP: I | IV | I | V | In: $VP*2 Vr: $VP*4 IV | V | I | vi | IV | V | I | V | % Second half could be called chorus Ch: V | | $VP*2 I |*4 Ch2: V | | $VP*3 % Fadeout S: [G] $In $Vr $Vr $Ch $VP $Vr $Ch2 >>> s.lines[0] '% Brown-Eyed Girl' >>> s.lines[-1] 'S: [G] $In $Vr $Vr $Ch $VP $Vr $Ch2' |S: rzutf-8replace)encodingerrorsNzCannot find file: z2Invalid File Format; must be string or text file: r) isinstancestrsplitioopen readlinesFileNotFoundErrorr Exceptionlenstripr.joinr!)r9r:r. fileOpenede pieceStrings rr8 CTSong.parsets8 h $ $TX=MNN4(E UWWXsWYOS]&002EP%*9EqSVq[E9 ii&  PO$ G%(:8*&EFF U%H SUU U:s5C B4C)C8C84 C>CC0C5cURS;a UR$URSnURSS5R5nX lU$)at Get or set the title of the CTSong. If not specified explicitly but the clercq-Temperley text exists, this attribute searches first few lines of text file for title (a string preceded by a '%') if found, sets title attribute to this string and returns this title) >>> s = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.textString) >>> s.title 'Simple Gifts' )Nr,r%r,)r-r.rHrT)r9liner#s rr# CTSong.titlesJ ;;j (;; zz!} S"%++-  rc/nURSSHnSU;dM UR5SRS5(aHURUR5SX"R S5S-SR 5/5 MzURX"R S5S-SR 5/5 M U$)a Get the comments list of all CTRule objects. comments are stored as a list of comments, each comment on a line as a list. If the comment is on a rule line, the list contains both the line's LHS (like "In:") and the comment if the comment is on a line of its own, only the comment is appended as a list of length one. The title is not a comment. The title is stored under self.title #_DOCS_HIDE Please note: the backslashes included in the file #_DOCS_HIDE below are for sphinx documentation #_DOCS_HIDE purposes only. They are not permitted in the clercq-temperley file format | textString = ''' | %Simple Gifts | % A wonderful shaker melody | Vr: I \| I \| %incomplete verse | S: [A] $Vr % Not quite finished!''' >>> s = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.textString) >>> s >>> s.comments [['A wonderful shaker melody'], ['Vr:', 'incomplete verse'], ['S:', 'Not quite finished!']] Nr[r:)r.rMendswithappendindexrT)r9r&r\s rr&CTSong.commentss8JJqrNDd{::<?++C00OOTZZ\!_&*::c?Q+>+?&@&F&F&H%KLOOT**S/A*=*>%?%E%E%G$HI #rc$UR(a UR$URHXnUR5nU(dMUSRS5(dM7[ XS9nX0RUR 'MZ UR$)a Get the rules of a CTSong. the Rules is an OrderedDict of objects of type CTRule. If only a text file provided, this goes through text file and creates the rule object out of each line containing an LHS including the Song line, which should always be last. >>> s = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.BlitzkriegBopCT) >>> len(s.rules) 6 >>> for rule in s.rules: ... (rule, s.rules[rule]) ('BP', ) ('In', ) ('Vr', ) ('Br', ) ('Co', ) ('S', ) Rules S is where we begin: >>> s.rules['S'] rr`)parent)r/r.rMraCTRuleLHS)r9r\lsrules rr' CTSong.rulesslD ;;;; JJDBrbennS))d0(, DHH%  {{rc UR(a UR$UR(aSUR;aURRS5nUHnURS5(dMUR5SSHhnSU;a+[R "S5UlURs s $SU;a.[R "USS5UlURs s $Mj M UR$) a] gets the initial, or 'home', time signature in a song by looking at the 'S' substring and returning the provided time signature. If not present, returns a default music21 time signature of 4/4 >>> s = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.textString) >>> s.homeTimeSig >>> change = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.changeIsGonnaCome) >>> change.homeTimeSig >>> change.homeTimeSig.beatSequence rErFr_[4/4/)r4r!rM startswithr TimeSignature)r9r.r\atoms rr$CTSong.homeTimeSig s"   $$ $ 99*IIOOD)E??4(( $ Qq 1d?050C0CE0JD-#'#4#44 D[050C0CD2J0OD-#'#4#44 !2   rc8UR(a UR$UR(aSUR;aURRS5nUHnURS5(dMUR5SSH~nSU;a+[R "S5UlURs s $SU;aD[R "USS5n[R "U5UlURs s $M M UR$) z gets the initial, or 'home', Key by looking at the music text and locating the key signature at the start of the S: rule. >>> s = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.textString) >>> s.homeKey rErFr_rmrnCrprq)r5r!rMrrrKey"convertKeyStringToMusic21KeyString)r9r.r\rt m21keyStrs rr%CTSong.homeKey-s ====  99*IIOOD)E??4(( $ Qq 1d?,/GGCLDM#'==0 _(+(N(NtTUVXz(ZI,/GGI,>DM#'==0 !2}}rcXlX lUR[RR 5(a UR$[R "5nURSnUR5n[U5HupgUS-Ul M URU5 URS[R"55 URURlX0lU$)a creates a Part object out of a from CTSong and also creates CTRule objects in the process, filling their .streamFromCTSong attribute with the corresponding smaller inner stream. Individual attributes of a rule are defined by the entire CTSong, such as meter and time signature, so creation of CTRule objects typically occurs only from this method and directly from the clercqTemperley text. >>> s = romanText.clercqTemperley.CTSong(romanText.clercqTemperley.BlitzkriegBopCT) >>> partObj = s.toPart() >>> partObj.highestOffset 380.0 Sr_r)r6r7r3rMeasurefirstr2r'expand enumeratenumberrbinsertr Metadatar#)r9r6r7partObj startRulemeasuresims rr" CTSong.toPartKs#5'>$ == ( . . 0 0== ++-JJsO ##%h'DA1uAH(x q(++-.!% rc"URUUS9$)zI DEPRECATED: use .toPart() instead. This method will be removed in v.10 )r6r7)r")r9r6r7s rtoScoreCTSong.toScorejs"{{.@3JL Lr) r5r4r3r/r-r0r6r7r.r!r1r(N)r,)r:zstr | pathlib.Path)TT)returnz stream.Part)rrrr__doc__ _DOC_ORDERr*__annotations__r=rAr8propertyr#r&r'r$r%r"rrrrrrrosZv\J!I~88, \&##J**X!!!!F:>LLrrc\rSrSrSrg)CTRuleExceptioniqrNrrrrrrqrrrc\rSrSr%Sr/SQrSS0rS\S'\R"S5r \R"S 5r S"S#S jjr S r S rSr\"\\SS9rS$S%SjjrS&SjrS&SjrS'SjrS(SjrS)SjrS*SjrS+SjrS,SjrSr\"\\SS9r\S-Sj5rS.SjrS,Sjr\"\\SS9r \S 5r!S!r"g )/rgiua CTRule objects correspond to the individual lines defined in a :class:`~music21.romanText.clercqTemperley.CTSong` object. They are typically created by the parser after a CTSong object has been created and the .toPart() method has been called on that object. The usefulness of each CTRule object is that each has a :meth:`~music21.romanText.clercqTemperley.CTRUle.streamFromCTSong` attribute, which is the stream from the entire score that the rule corresponds to. To parse, put the text into the )rh sectionName musicTextr$r%r&r!zR The full text of the CTRule, including the LHS, chords, and comments.r)r*z (\|\*?\d*)z\*(\d+)NcSUlUbX lUR(aURROS=(d [R"S5UlUR(aURR OS=(d [R"S5Ul Xl SUl SUl /Ul SUlSUlSUlg)Nrorwr,F)_parentrfr$r rstsr%rrxkeyObjr! _musicText_LHSrlastRegularAtom lastChord_lastChordIsInSameMeasure)r9r!rfs rr=CTRule.__init__s   K.2kk4;;**tbH[H[\aHb.2kkt{{**tTPS    .0 $&+//4&rc"SUR<3$)Nztext=)r!r@s rrACTRule._reprInternalstyym$$rcB[R"UR5$N)r unwrapWeakrefrr@s r _getParentCTRule._getParents##DLL11rc:[R"U5Ulgr)r wrapWeakrefr)r9rfs r _setParentCTRule._setParents))&1 rzE A reference to the CTSong object housing the CTRule if any. )docc URnURnU(aXlU(aX lURR5 UR 5HcupVnUS:XaUR XW5 MUS:XaUR XW5 M8[RSU<SU<SUR<35 Me UR(aURHnUR5Rn U (dM&URbURRSLdMNURS:wdM`U Sn [U R 5S -n U R R#[$R&"URU S 95 U R(R*R#UR5 O X0lX@lUR$) z The meat of it all -- expand one rule completely and return a list of Measure objects. Parses within the local time signature context and key context. $rDz%Rule found without | or $, ignoring: ,z: in Tr}rr_r)rrrclear_measureGroupsexpandExpansionContentexpandSimpleContent environLocalwarnr!recursenotesrfr7rhrSlyricsrbr Lyric editorialformalDivision) r9 tsContext keyContextsaveTssaveKeycontentsepnumRepsrnoteIterrnlyricNums rr CTRule.expandsj++ G $K %)%8%8%: !G'cz++G=((:!!;G;aweTXT]T]S`ac &; ==]]99;,,H![[0 $ C Ct K HHO!!B"299~1HII$$TZZ%JKLL//66txx@# }}rcUR(aXRR;a[SUSU35eURRUn[U5HnUR UR UR 5nURUSUR UR 5 UVs/sH"nUR[R5PM$ snH8nXpR LdM[R"UR 5UlM: URRU5 M gs snf)z` Expand a rule that contains an expansion (i.e., a $) in it. Requires CTSong parent to be set. zCannot expand rule z in rN)rfr'rrangerrr insertKsTsgetElementsByClassr rscopydeepcopyrextend)r9rrrjrreturnedMeasuresr returnedTss rrCTRule.expandExpansionContents{{g[[->->>!$7yTF"KL L{{  )wA#{{477DKK@  OO,Q/$++ F(8:(81 !33E4G4GH(8: WW,"mmDGG4DG : MM !1 2 :s7)D?cSn[R"5nUR5n/nUHnURS5(a|USSnUS:Xa[R "S5UlMASU;a[R "U5UlMd[R"[R"U55Ul MUS:Xa<UR(d[S U35eURUR5 MU(dMURU5 Xpl M [U5n U S :XagURX@R UR5 [ R""UR R$R&U - 5n UGHXnUS :XaA[(R*"U S 9n /U R,lSUlSnURU 5 MKUR3U5n[4R6"XpR5n /U R,lUR9XR05(agU(a`[:R<(aUR0ceUR0R>=R&U - slURA5 GMXR>lURCXR05 XlS nURU 5 GM[ URDRU5 [GSU5Hcn [HRJ"U5nURM[R [R/5 URDRU5 Me g)NFrnr_rq0rorp.z . w/o previous atom: rR) quarterLengthT)'rr~rMrrr rsrrrxryrrrrbrSrropFrac barDurationrr RestrrrfixupChordAtomr RomanNumeralisSamet TYPE_CHECKINGdurationcoreElementsChangedaddOptionalTieAndLyricsrrrr removeByClass)r9rrlastChordIsInSameMeasureratoms regularAtomsrt atomContentnumAtoms atomLengthrestrrnewMs rrCTRule.expandSimpleContents $) NN  "$ Ds##"1Rj #%#11%8DGK'#11+>DG"%''#*P*PQ\*]"^DK++),B4&*IJJ##D$8$89##D)'+$+,|$ q=  77DKK0]]477#6#6#D#Dx#OP  Ds{yyz:02-!%+0(**40''kk:.0 +;;r>>227O#~~999NN++99ZG9))+0:KK-00^^D%'N/3,HHRL+!, Qq'"A==#D    3 3SWW= > MM  &#rc/n/n/nURRUR5n[S[ U5S5HQnXER 5nUS-[ U5:aXES-nOSnUS:wdUS:wdM?UR Xg45 MS UGHmupgUR5n/n UHn U RS5(aU (a%UR SRU 5SS45 /n URRU 5n U b7[U RS55n URRSU 5n OSn UR U SSSU 45 MU R U 5 M URRU5n U b7[U RS55n URRSU5nOSn U (d US :XdGMKUR SRU 5X}45 GMp UHqupgn UR5nUS :Xa:[S U55(a#SRU5nU(aUS- nUS - nOUS:XaS nUR XgU 45 Ms U$) aM Returns a list of 3-tuples where each tuple consists of the str content, either "|" (a normal measure ) or "$" (an expansion), and the number of repetitions. Comments are stripped. >>> rs = ('In: [A] [4/4] $Vr $BP*3 I IV | I | ' + ... '$BP*3 I IV | I | | R |*4 I |*4 % This is a comment') >>> s = romanText.clercqTemperley.CTRule(rs) >>> s._measureGroups() [('[A] [4/4]', '|', 1), ('Vr', '$', 1), ('BP', '$', 3), ('I IV', '|', 1), ('I', '|', 1), ('BP', '$', 3), ('I IV', '|', 1), ('I', '|', 1), ('.', '|', 1), ('R', '|', 4), ('I', '|', 4)] >>> r = romanText.clercqTemperley.CTRule('In: $IP*3 I | | | $BP*2') >>> r._measureGroups() [('IP', '$', 3), ('I', '|', 1), ('.', '|', 1), ('.', '|', 1), ('BP', '$', 2)] >>> r = romanText.clercqTemperley.CTRule('In: [4/4] I V | | | IV |') >>> r._measureGroups() [('[4/4] I V', '|', 1), ('.', '|', 1), ('.', '|', 1), ('IV', '|', 1)] >>> measures = r.expand() >>> measures[2].show('text') {0.0} {0.0} {0.0} >>> r = romanText.clercqTemperley.CTRule('Vr: [4/4] bVII | IV | | [2/4] |') >>> r._measureGroups() [('[4/4] bVII', '|', 1), ('IV', '|', 1), ('.', '|', 1), ('[2/4] .', '|', 1)] >>> measures = r.expand() >>> measures[2].show('text') {0.0} {0.0} {0.0} >>> measures[3].show('text') {0.0} {0.0} {0.0} >>> measures[3][-1].quarterLength 2.0 rr_r,r ?NrDc3Z# UH!oRS5=(d US:Hv M# g7f)rnr,N)rr).0ys r (CTRule._measureGroups..s#!U 1,,s"3">qBw"> s)+r) SPLITMEASURESrMrrrSrTrbrrrU REPETITIONsearchintgroupsuball)r9measureGroups1measureGroups2measureGroups3measureGroupTemprrr contentList contentOutrt repetitions expandRepsr contentSplits rrCTRule._measureGroups5sXV135757&*&8&8&>&>t~~&Nq#./3A&)//1G1us+,,&1u-"}r %%wn54+LG!--/K$&J#??3''!&--sxx /CS!.LM%' "&//"8"8">K".%():):1)=%> #222t<%& "))48S**EF%%d+$"//005K&k//23oo))"c2SCZ%%sxx ';S&JK;+@&4 !G'"==?Lczc!U !UUU((<0sNG3  ! !7"9 :&4rcUcSnU$URVs/sHoDRPM nnURVs/sHoDRPM nnXV:XaSnU$SnU$s snfs snf)z Returns True if the pitches of the RomanNumeral are the same as the pitches of lastChord. Returns False if lastChord is None. FT)pitchesnameWithOctave)r9rrsameprnPlcPs rr CTRule.isSamesy  D .0ZZ8Z##ZC8-6->->?->##->C?z  9?s AA$cXURX5nUSLa!UbURbSURlUSLa^URbURRSLa8UR R [R"URSS95 USLaGUbDURc7[R"S5Ul[R"S5UlgUSLa?Ub;URb-SURl[R"S5Ulgggg) zL Adds ties to chords that are the same. Adds lyrics to chords that change. FNstopTr_rstartcontinue) rrtyperfr6rrbr rfigureTie)r9rrr s rrCTRule.addOptionalTieAndLyricss{{2) 5=Y2y}}7P!'IMM  5=dkk1T[[5S5SW[5[ II  TZZ !< = 4>> s = romanText.clercqTemperley.CTRule() >>> s.fixupChordAtom('iix') 'iio' >>> s.fixupChordAtom('viih7') 'vii/o7' >>> s.fixupChordAtom('iia') 'ii+' xohz/ora+)rHislower)r9rts rrCTRule.fixupChordAtoms^ $;<<S)D $;<<T*D 7??  <<S)D rc$[U5Ulgr)rLrr9values r _setMusicTextCTRule._setMusicTexts e*rc$UR(a UR$UR(dgUR[UR5S-SnSU;aUR S5nUSUnUR 5UlUR$)Nr,r_r[r)rr!rSrhrcrT)r9r!commentStartIndexs r _getMusicTextCTRule._getMusicTextst ???? "yyyyTXX*+, $; $ 3 +,D**,ra Gets just the music text of the CTRule, excluding the left hand side and comments >>> rs = 'In: $BP*3 I IV | I | $BP*3 I IV | I | R |*4 I |*4 % This is a comment' >>> s = romanText.clercqTemperley.CTRule(rs) >>> s.text 'In: $BP*3 I IV | I | $BP*3 I IV | I | R |*4 I |*4 % This is a comment' >>> s.musicText '$BP*3 I IV | I | $BP*3 I IV | I | R |*4 I |*4' cSUR;a9URURRS5S-SR5$g)z Get the comment of a CTRule object. >>> rs = 'In: $BP*3 I IV | I | $BP*3 I IV | I | R |*4 I |*4 % This is a comment' >>> s = romanText.clercqTemperley.CTRule(rs) >>> s.comment 'This is a comment' r[r_N)r!rcrTr@s rcommentCTRule.comment s@ $)) 99TYY__S1A567==? ?rcHUR(a UR$SnUR(arURR5SRS5(aAURH0nUS:Xa#UR 5UlURs $X-nM2 gg)Nr,rr`)rr!rMrarT)r9rhchars r_getLHSCTRule._getLHSsz 9999  99*1-66s;; 3; # DI99$j " rc$[U5Ulgr)rLrr$s r_setLHSCTRule._setLHS)s J raZ Get the LHS (Left Hand Side) of the CTRule. If not specified explicitly but CTtext present, searches first characters up until ':' for rule and returns string) >>> rs = 'In: $BP*3 I IV | R |*4 I |*4 % This is a comment' >>> s = romanText.clercqTemperley.CTRule(rs) >>> s.LHS 'In' cSnSUR;aSURSS-nU$SUR;aSURSS-nU$SUR;aS URSS-nU$S UR;aS URSS-nU$S UR;aS URSS-nU$URS:XaSURSS-nU$URS:XaSnU$URnU$)a] Returns the expanded version of the Left-hand side (LHS) such as Introduction, Verse, etc. if text is present (uses LHS to expand) Currently supported abbreviations: * In: Introduction * Br: Bridge * Vr: Verse * Ch: Chorus * Fadeout: Fadeout * S: Song >>> s = romanText.clercqTemperley.CTRule('Vr2: $BP*3 I IV | I |') >>> s.sectionName 'Verse2' r,In IntroductionrNBrBridgeVrVerseChChorusTgTagr}Songr_Fadeout)rh)r9rs rrCTRule.sectionName7s.( 488 (488AB<7KTXX "TXXab\1KTXX !DHHQRL0KTXX "TXXab\1KTXX $((12,.K XX_ 488AB</K  XX "#K((Kr) rrrrrrrrrfr!r)r,N)rfz CTSong | None)NN)rzmeter.TimeSignature | Nonerzkey.Key | Nonerzlist[stream.Measure])rrLrrrNone)rzlist[tuple[str, str, int]])rroman.RomanNumeralrchord.Chord | Nonerbool)rrErrFrrD)rzstream.Measurerzmeter.TimeSignaturerzkey.KeyrrD)rtrLrrL)r%rLrrD)rz str | None)rrL)#rrrrrrr*rrecompilerrr=rArrrrfrrrrrrrrr&r*rr-r1r4rhrrrrrrgrgus [JU!I~ JJ}-MJ'J5$%22j*3 F/3#'-+-!-  -^333  30B'B'B'  B'HdN % %$%  %*2$2*2#2(,2.,%  <  I    7G * C$$rrgc\rSrSrSrg)Testi`rNrrrrrKrK`rrrKc$\rSrSrSrSrSrSrg) TestExternalidTcSSKJn UR[5nUR 5nUR (aUR 5 gg)Nr)clercqTemperley)music21.romanTextrOrBlitzkriegBopCTr"show)r9rOsrs rtestBTestExternal.testBgs55  " "? 3((* 99 LLN rcgrrr@s rx_testATestExternal.x_testAns rrN)rrrrrRrTrWrrrrrMrMds D rrMz list[type]r__main__)/r __future__rrrNpathlibrHtypingrunittest collectionsrmusic21rrrrr r r r r rrrr EnvironmentrrQ RockClockCT textStringchangeIsGonnaComeexampleClercqTemperley RingFireCTMusic21ExceptionrProtoM21ObjectrrrgTestCaserKrMrrrmainTestrrrrjs0 #  # ??&&'BC   $   " l33 @LW # #@LD l33 gW # #gV 8     8$$  \!&) J) z Tr