jdZddlmZddlZddlZddlZddlZddlmZddlm Z ddlm Z ddlm Z ddlm Z e j d Zejd Zejd Zejd Zejd ZejdZejdZejdZejdZejdZejdZejdZejdZGdde jZGdde jZGdde jZGdde j Z!Gdde!Z"Gd d!e!Z#Gd"d#e!Z$Gd$d%e$Z%Gd&d'e$Z&Gd(d)e$Z'Gd*d+e$Z(Gd,d-e(Z)Gd.d/e(Z*Gd0d1e$Z+Gd2d3e$Z,Gd4d5e$Z-Gd6d7e$Z.Gd8d9e$Z/Gd:d;e$Z0Gd<d=e0Z1Gd>d?e0Z2Gd@dAe0Z3GdBdCe$Z4GdDdEe4Z5GdFdGe4Z6GdHdIZ7GdJdKe j Z8GdLdMej9Z:e;dNkrddlZej<e:dSdS)Oz Translation routines for roman numeral analysis text files, as defined and demonstrated by Dmitri Tymoczko, Mark Gotham, Michael Scott Cuthbert, and Christopher Ariza in ISMIR 2019. ) annotationsN)common) exceptions21) environment)key)prebasezromanText.rtObjectszm[0-9]+[a-h]*-*[0-9]*[a-h]*z var[0-9]+z var([A-Z]+)z\?\([A-Ga-g]+[b#]*:z\?\)[A-Ga-g]+[b#]*:?z[A-Ga-g]+[b#]*;:z[A-Ga-g]+[b#]*:z KS-?[0-7]zb[1-9.]+z\|\|:z:\|\|z (NC|N.C.|nc)ceZdZdS)RomanTextExceptionN__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/romanText/rtObjects.pyr r 5Drr ceZdZdS)RTTokenExceptionNr rrrrr9rrrceZdZdS)RTHandlerExceptionNr rrrrr=rrrczeZdZdZddZdZdZdZdZdZ d Z d Z d Z d Z d ZdZdZdZdZdZdZdS)RTTokena Stores each linear, logical entity of a RomanText. A multi-pass parsing procedure is likely necessary, as RomanText permits variety of groupings and markings. >>> rtt = romanText.rtObjects.RTToken('||:') >>> rtt A standard RTToken returns `False` for all the following. >>> rtt.isComposer() or rtt.isTitle() or rtt.isPiece() False >>> rtt.isAnalyst() or rtt.isProofreader() False >>> rtt.isTimeSignature() or rtt.isKeySignature() or rtt.isNote() False >>> rtt.isForm() or rtt.isPedal() or rtt.isMeasure() or rtt.isWork() False >>> rtt.isMovement() or rtt.isVersion() or rtt.isAtom() False c"||_d|_dSNr)src lineNumberselfrs r__init__zRTToken.__init__\src*t|jSN)reprrrs r _reprInternalzRTToken._reprInternal`sDH~~rcdSNFrr$s r isComposerzRTToken.isComposercurcdSr'rr$s risTitlezRTToken.isTitlefr)rcdSr'rr$s risPiecezRTToken.isPieceir)rcdSr'rr$s r isAnalystzRTToken.isAnalystlr)rcdSr'rr$s r isProofreaderzRTToken.isProofreaderor)rcdSr'rr$s risTimeSignaturezRTToken.isTimeSignaturerr)rcdSr'rr$s risKeySignaturezRTToken.isKeySignatureur)rcdSr'rr$s risNotezRTToken.isNotexr)rcdS)z/ Occasionally found in header. Frr$s risFormzRTToken.isForm{s urcdSr'rr$s r isMeasurezRTToken.isMeasurer)rcdSr'rr$s risPedalzRTToken.isPedalr)rcdSr'rr$s risWorkzRTToken.isWorkr)rcdSr'rr$s r isMovementzRTToken.isMovementr)rcdSr'rr$s r isVersionzRTToken.isVersionr)rcdS)zh Atoms are any untagged data; generally only found inside a measure definition. Frr$s risAtomzRTToken.isAtoms urNr)r r r__doc__r r%r(r+r-r/r1r3r5r7r9r;r=r?rArCrErrrrrCs"0 rrc~eZdZdZdfd ZdZdZdZdZdZ d Z d Z d Z d Z d ZdZdZdZdZdZxZS)RTTaggeda In romanText, some data elements are tags, that is a tag name, a colon, optional whitespace, and data. In non-RTTagged elements, there is just data. All tagged tokens are subclasses of this class. Examples are: Title: Die Jahrzeiten Composer: Fanny Mendelssohn >>> rtTag = romanText.rtObjects.RTTagged('Title: Die Jahrzeiten') >>> rtTag.tag 'Title' >>> rtTag.data 'Die Jahrzeiten' >>> rtTag.isTitle() True >>> rtTag.isComposer() False rc4t|d|_d|_d|vr\|d}|d||_||dzd|_dS||_dS)Nr:)superr tagdatafindstrip)rriFirst __class__s rr zRTTagged.__init__s  #::XXc]]F7F7|))++DHFQJKK(..00DIIIDIIIrcD|jdkrdSdS)a3 True is the tag represents a composer. >>> rth = romanText.rtObjects.RTTagged('Composer: Claudio Monteverdi') >>> rth.isComposer() True >>> rth.isTitle() False >>> rth.isWork() False >>> rth.data 'Claudio Monteverdi' composerTFrNlowerr$s rr(zRTTagged.isComposers% 8>>  z ) )4urcD|jdkrdSdS)a( True if tag represents a title, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Title: This is a title.') >>> tag.isTitle() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isTitle() False titleTFrVr$s rr+zRTTagged.isTitle% 8>>  w & &4urcD|jdkrdSdS)a( True if tag represents a piece, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Piece: This is a piece.') >>> tag.isPiece() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isPiece() False pieceTFrVr$s rr-zRTTagged.isPiecerZrcD|jdkrdSdS)a4 True if tag represents an analyst, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Analyst: This is an analyst.') >>> tag.isAnalyst() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isAnalyst() False analystTFrVr$s rr/zRTTagged.isAnalysts% 8>>  y ( (4urc@|jdvrdSdS)aF True if tag represents a proofreader, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Proofreader: This is a proofreader.') >>> tag.isProofreader() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isProofreader() False ) proofreaderz proof readerTFrVr$s rr1zRTTagged.isProofreaders& 8>>  > > >4urc@|jdvrdSdS)a True if tag represents a time signature, otherwise False. >>> tag = romanText.rtObjects.RTTagged('TimeSignature: This is a time signature.') >>> tag.isTimeSignature() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isTimeSignature() False TimeSignature header data can be found intermingled with measures. ) timesignatureztime signatureTFrVr$s rr3zRTTagged.isTimeSignature s& 8>>  B B B4urc@|jdvrdSdS)a True if tag represents a key signature, otherwise False. >>> tag = romanText.rtObjects.RTTagged('KeySignature: This is a key signature.') >>> tag.isKeySignature() True >>> tag.data 'This is a key signature.' KeySignatures are a type of tagged data found outside of measures, such as "Key Signature: -1" meaning one flat. Key signatures are generally numbers representing the number of sharps (or negative for flats). Non-standard key signatures are not supported. >>> tag = romanText.rtObjects.RTTagged('KeySignature: -3') >>> tag.data '-3' music21 supports one legacy key signature type: `KeySignature: Bb` which represents a one-flat signature. Important to note: no other key signatures of this type are supported. (For instance, `KeySignature: Ab` has no effect) >>> tag = romanText.rtObjects.RTTagged('KeySignature: Bb') >>> tag.data 'Bb' Testing that `.isKeySignature` returns `False` for non-key signatures: >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isKeySignature() False N.B.: this is not the same as a key definition found inside a Measure. These are represented by RTKey rtObjects, defined below, and are not RTTagged rtObjects, but RTAtom subclasses. ) keysignaturez key signatureTFrVr$s rr5zRTTagged.isKeySignatures'L 8>>  @ @ @45rcD|jdkrdSdS)a# True if tag represents a note, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Note: This is a note.') >>> tag.isNote() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isNote() False noteTFrVr$s rr7zRTTagged.isNoteJ% 8>>  v % %4urcD|jdkrdSdS)a# True if tag represents a form, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Form: This is a form.') >>> tag.isForm() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isForm() False formTFrVr$s rr9zRTTagged.isFormZrgrc@|jdvrdSdS)a( True if tag represents a pedal, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Pedal: This is a pedal.') >>> tag.isPedal() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isPedal() False )pedalTFrVr$s rr=zRTTagged.isPedaljs% 8>>  y ( (4urcD|jdkrdSdS)a True if tag defines the version of RomanText standard used, otherwise False. Pieces without the tag are defined to conform to RomanText 1.0, the version described in the ISMIR publication. >>> rth = romanText.rtObjects.RTTagged('RTVersion: 1.0') >>> rth.isTitle() False >>> rth.isVersion() True >>> rth.tag 'RTVersion' >>> rth.data '1.0' rtversionTFrVr$s rrCzRTTagged.isVersionzs%$ 8>>  { * *45rc@|jdvrdSdS)a True if tag represents a work, otherwise False. The "work" is not defined as a header tag, but is used to represent all tags, often placed after Composer, for the work or pieces designation. >>> rth = romanText.rtObjects.RTTagged('Work: BWV232') >>> rth.isWork() True >>> rth.tag 'Work' >>> rth.data 'BWV232' For historical reasons, the tag 'Madrigal' also designates a work. >>> rth = romanText.rtObjects.RTTagged('Madrigal: 4.12') >>> rth.isTitle() False >>> rth.isWork() True >>> rth.tag 'Madrigal' >>> rth.data '4.12' )workmadrigalTFrVr$s rr?zRTTagged.isWorks&6 8>>  3 3 345rcD|jdkrdSdS)a7 True if tag represents a movement, otherwise False. >>> tag = romanText.rtObjects.RTTagged('Movement: This is a movement.') >>> tag.isMovement() True >>> tag = romanText.rtObjects.RTTagged('Nothing: Nothing at all.') >>> tag.isMovement() False movementTFrVr$s rrAzRTTagged.isMovements% 8>>  z ) )4urc8|jdvS)z True if tag represents a configuration setting for setting vi/vio/VI in minor >>> tag = romanText.rtObjects.RTTagged('Sixth Minor: Flat') >>> tag.isSixthMinor() True >>> tag.data 'Flat' ) sixthminorz sixth minorrVr$s r isSixthMinorzRTTagged.isSixthMinorsx~~#@@@rc8|jdvS)a True if tag represents a configuration setting for setting vii/viio/VII in minor >>> tag = romanText.rtObjects.RTTagged('Seventh Minor: Courtesy') >>> tag.isSeventhMinor() True >>> tag.data 'Courtesy' ) seventhminorz seventh minorrVr$s risSeventhMinorzRTTagged.isSeventhMinorsx~~#DDDrrF)r r rrGr r(r+r-r/r1r3r5r7r9r=rCr?rArurx __classcell__rSs@rrIrIs4*      $    $)))V   .@ A A A E E E E E E ErrIcBeZdZdZd fd ZdZdZdZdZdZ xZ S) RTMeasurea  In RomanText, measures are given one per line and always start with 'm'. For instance: m4 i b3 v b4 VI m5 b2 g: IV b4 V m6 i m7 D: V Measure ranges can be used and copied, such as: m8-m9=m4-m5 RTMeasure objects can also define variant readings for a measure: m1 ii m1var1 ii b2 ii6 b3 IV Variants are not part of the tag, but are read into an attribute. Endings are indicated by a single letter after the measure number, such as "a" for first ending. >>> rtm = romanText.rtObjects.RTMeasure('m15a V6 b1.5 V6/5 b2 I b3 viio6') >>> rtm.data 'V6 b1.5 V6/5 b2 I b3 viio6' >>> rtm.number [15] >>> rtm.repeatLetter ['a'] >>> rtm.isMeasure() True rct|d|_d|_g|_g|_d|_d|_d|_g|_ |r| |dSdS)NrF) rMr rNrOnumber repeatLetter variantNumber variantLetterisCopyDefinitionatoms_parseAttributes)rrrSs rr zRTMeasure.__init__s   !" %  '  ! !# & & & & & ' 'rc,d|vr|d\}}||g}n|g}g}g}|D]f}tj|\}} |t || dd} || g||fS)a. Return the number of numbers as a list, as well as any repeat indications. >>> rtm = romanText.rtObjects.RTMeasure() >>> rtm._getMeasureNumberData('m77') ([77], ['']) >>> rtm._getMeasureNumberData('m123b-432b') ([123, 432], ['b', 'b']) -mr)splitr getNumFromStrappendintreplace) rrmnStartmnEndprocr~rmnnumStralphaStrs r_getMeasureNumberDatazRTMeasure._getMeasureNumberDatas #:: YYs^^NGUU#DD5D  * *B%3B77 FH MM#f++ & & &''R00H    ) ) ) )|##rct|}|td||}|d|}||_||d}||\|_|_t|}|u| d}ttj |d|_||d|_n||_t |}|O| d}||_||d|_|jdr d|_dSdS)Nzfound no measure tag: rrL=T) reMeasureTagmatchrendrQrNrr~r reVariantgrouprrrrrOreVariantLetterr startswithr)rrgiEndrawTagrawDatavarStrs rrzRTMeasure._parseAttributes/s   s # # 9$%Cc%C%CDD DuuwwUdU!!##dee*""$$*.)C)CF)K)K& T& OOG $ $ =WWQZZF!$V%9&%A%A!%D!E!ED )//11DIIDI  ! !' * * =WWQZZF!'D )//11DI 9   $ $ )$(D ! ! ! ) )rct|jdkrt|jd}n|jdd|jd}|S)NrLrr)lenr~str)r numberStrs rr%zRTMeasure._reprInternalMsQ t{  q DKN++II;q><>> rtm = romanText.rtObjects.RTMeasure('m35-36 = m29-30') >>> rtm.number [35, 36] >>> rtm.getCopyTarget() ([29, 30], ['', '']) >>> rtm = romanText.rtObjects.RTMeasure('m4 = m1') >>> rtm.number [4] >>> rtm.getCopyTarget() ([1], ['']) rr)rOrrQr)rrs r getCopyTargetzRTMeasure.getCopyTargetWs;$)##C,,2244))'222rrF) r r rrGr rrr%r;rryrzs@rr|r|s""H''''''&$$$:)))<3333333rr|c*eZdZdZdfd ZdZxZS)RTAtoma In RomanText, definitions of chords, phrases boundaries, open/close parenthesis, beat indicators, etc. appear within measures (RTMeasure objects). These individual elements will be called Atoms, as they are data that is not tagged. Each atom store a reference to its container (normally an RTMeasure). >>> chordIV = romanText.rtObjects.RTAtom('IV') >>> beat4 = romanText.rtObjects.RTAtom('b4') >>> beat4 >>> beat4.isAtom() True However, see RTChord, RTBeat, etc. which are subclasses of RTAtom specifically for storing chords, beats, etc. rNcXt|||_dSr")rMr containerrrrrSs rr zRTAtom.__init__s& "rcdSrrr$s rrEz RTAtom.isAtomrrrN)r r rrGr rEryrzs@rrrmsV&###### rrc$eZdZdZdfd ZxZS)RTChordz An RTAtom subclass that defines a chord. Also contains a reference to the container. >>> chordIV = romanText.rtObjects.RTChord('IV') >>> chordIV rNcht||d|_d|_dSr"rMr offset quarterLengthrs rr zRTChord.__init__4 i((( !rrr r rrGr ryrzs@rrrsG""""""""""rrc$eZdZdZdfd ZxZS) RTNoChorda An RTAtom subclass that defines absence of a chord. Also contains a reference to the container. >>> chordNC = romanText.rtObjects.RTNoChord('NC') >>> chordNC >>> rth = romanText.rtObjects.RTHandler() >>> rth.tokenizeAtoms('nc NC N.C.') [, , ] rNcht||d|_d|_dSr"rrs rr zRTNoChord.__init__rrrrrzs@rrrsG  """"""""""rrceZdZdZdZdZdS)RTBeatz An RTAtom subclass that defines a beat definition. Also contains a reference to the container. >>> beatFour = romanText.rtObjects.RTBeat('b4') >>> beatFour c|jdd}|d}t|d}t |dkrt jd|dz}nd}t |dkrntd|dz}t|trtj |}|j }t j d||z z }nd}t |d kr:td |jgt!d |jt j ||z|z}|S) a  Gets the beat number as a float or fraction. Time signature independent >>> RTB = romanText.rtObjects.RTBeat Simple ones: >>> RTB('b1').getBeatFloatOrFrac() 1.0 >>> RTB('b2').getBeatFloatOrFrac() 2.0 etc. with easy float: >>> RTB('b1.5').getBeatFloatOrFrac() 1.5 >>> RTB('b1.25').getBeatFloatOrFrac() 1.25 with harder: >>> RTB('b1.33').getBeatFloatOrFrac() Fraction(4, 3) >>> RTB('b2.66').getBeatFloatOrFrac() Fraction(8, 3) >>> RTB('b1.2').getBeatFloatOrFrac() Fraction(6, 5) A third digit of 0.5 adds 1/2 of 1/DENOM of before. Here DENOM is 3 (in 5/3) so we add 1/6 to 5/3 to get 11/6: >>> RTB('b1.66').getBeatFloatOrFrac() Fraction(5, 3) >>> RTB('b1.66.5').getBeatFloatOrFrac() Fraction(11, 6) Similarly 0.25 adds 1/4 of 1/DENOM, to get 21/12 or 7/4 or 1.75: >>> RTB('b1.66.25').getBeatFloatOrFrac() 1.75 And 0.75 adds 3/4 of 1/DENOM to get 23/12: >>> RTB('b1.66.75').getBeatFloatOrFrac() Fraction(23, 12) A weird way of writing 'b1.5': >>> RTB('b1.33.5').getBeatFloatOrFrac() 1.5 br.rrLg?zgot unexpected beat: zcannot handle specification: )rrrrrraddFloatPrecisionfloat isinstance fractionsFraction from_float denominatoropFrac environLocal printDebugr) rbeatStrpartsmainBeatfracPartfracPartDivisordenom fracBeatFracbeats rgetBeatFloatOrFraczRTBeat.getBeatFloatOrFracsIr(""3++ c""uQx== u::>>/eAh??HHH u::>>#C%(N33O(E** C$-88BB(E!=u/F)GHHLLL u::>>  # #%GTX%G%G$H I I I"#M48#M#MNN N}X0<?@@ rc|} ||}n=#tj$r+td|jd|gd}YnwxYw|S)a  Given a time signature, return the offset position specified by this beat. >>> rtb = romanText.rtObjects.RTBeat('b1.5') >>> rtb.getOffset(meter.TimeSignature('3/4')) 0.5 >>> rtb.getOffset(meter.TimeSignature('6/8')) 0.75 >>> rtb.getOffset(meter.TimeSignature('2/2')) 1.0 >>> rtb = romanText.rtObjects.RTBeat('b2') >>> rtb.getOffset(meter.TimeSignature('3/4')) 1.0 >>> rtb.getOffset(meter.TimeSignature('6/8')) 1.5 >>> rtb = romanText.rtObjects.RTBeat('b1.66') >>> rtb.getOffset(meter.TimeSignature('6/8')) 1.0 >>> rtc = romanText.rtObjects.RTBeat('b1.66.5') >>> rtc.getOffset(meter.TimeSignature('6/8')) 1.25 zbad beat specification: z in a meter of r)rgetOffsetFromBeatrTimeSignatureExceptionrrr)r timeSignaturerposts r getOffsetzRTBeat.getOffsets4&&((  22488DD2     # #<8<<,9<<%   DDD   s,7A&%A&N)r r rrGrrrrrrrs@QQQf'''''rrc"eZdZdZdZdZdZdS) RTKeyTypeAtoma9 RTKeyTypeAtoms contain utility functions for all Key-type tokens, i.e. RTKey, RTAnalyticKey, but not KeySignature. >>> gMinor = romanText.rtObjects.RTKeyTypeAtom('g;:') >>> gMinor >>> gMinor.getKey() ;:c|j|j}tj|}tj|S)z? This returns a Key, not a KeySignature object )rrstrip footerStripr"convertKeyStringToMusic21KeyStringKeyrmyKeys rgetKeyzRTKeyTypeAtom.getKeyLs8 0116u==wu~~rc\|}tj|jS)z, Get a KeySignature object. )rr KeySignaturesharpsrs rgetKeySignaturezRTKeyTypeAtom.getKeySignatureTs$  ---rN)r r rrGrrrrrrrr?sC  K.....rrceZdZdZdZdS)RTKeya An RTKey(RTAtom) defines both a change in KeySignature and a change in the analyzed Key. They are defined by ";:" after the Key. >>> gMinor = romanText.rtObjects.RTKey('g;:') >>> gMinor >>> gMinor.getKey() >>> bMinor = romanText.rtObjects.RTKey('bb;:') >>> bMinor >>> bMinor.getKey() >>> bMinor.getKeySignature() >>> eFlatMajor = romanText.rtObjects.RTKey('Eb;:') >>> eFlatMajor >>> eFlatMajor.getKey() rNr r rrGrrrrrr\s4KKKrrceZdZdZdZdS) RTAnalyticKeya An RTAnalyticKey(RTKeyTypeAtom) only defines a change in the key being analyzed. It does not in itself create a :class:`~music21.key.Key` object. >>> gMinor = romanText.rtObjects.RTAnalyticKey('g:') >>> gMinor >>> gMinor.getKey() >>> bMinor = romanText.rtObjects.RTAnalyticKey('bb:') >>> bMinor >>> bMinor.getKey() rKNrrrrrrzs$KKKrrceZdZdZdZdS)RTKeySignatureah An RTKeySignature(RTAtom) only defines a change in the KeySignature. It does not in itself create a :class:`~music21.key.Key` object, nor does it change the analysis taking place. The number after KS defines the number of sharps (negative for flats). >>> gMinor = romanText.rtObjects.RTKeySignature('KS-2') >>> gMinor >>> gMinor.getKeySignature() >>> aMajor = romanText.rtObjects.RTKeySignature('KS3') >>> aMajor.getKeySignature() cbt|jdd}tj|S)Nr)rrrr)r numSharpss rrzRTKeySignature.getKeySignatures* %%  ***rN)r r rrGrrrrrrs-$+++++rrc$eZdZdZdfd ZxZS) RTOpenParensz A simple open parenthesis Atom with a sensible default >>> romanText.rtObjects.RTOpenParens('(') (NcLt||dSr"rMr rs rr zRTOpenParens.__init__# i(((((r)rNrrzs@rrrG))))))))))rrc$eZdZdZdfd ZxZS) RTCloseParensz A simple close parenthesis Atom with a sensible default >>> romanText.rtObjects.RTCloseParens(')') )NcLt||dSr"rrs rr zRTCloseParens.__init__rr)rNrrzs@rrrrrrceZdZdZdZdS)RTOptionalKeyOpena Marks the beginning of an optional Key area which does not affect the roman numeral analysis. (For instance, it is possible to analyze in Bb major, while remaining in g minor) >>> possibleKey = romanText.rtObjects.RTOptionalKeyOpen('?(Bb:') >>> possibleKey >>> possibleKey.getKey() c"|jdkrtjdS|jdd}|dd}|dd}|dd}tj|S)Nz?(b:rrrKr?rrrrrrkeyStrs rrzRTOptionalKeyOpen.getKeys{ 8v  73<< X%%c3//F^^C,,F^^C,,F^^C,,F76?? "rNr r rrGrrrrrrs-   # # # # #rrceZdZdZdZdS)RTOptionalKeyClosea Marks the end of an optional Key area which does not affect the roman numeral analysis. For example, it is possible to analyze in Bb major, while remaining in g minor. >>> possibleKey = romanText.rtObjects.RTOptionalKeyClose('?)Bb:') >>> possibleKey >>> possibleKey.getKey() c|jdvrtjdS|jdd}|dd}|dd}|dd}tj|S)N)z?)b:z?)brrrKrrrrrs rrzRTOptionalKeyClose.getKeys{ 8 & &73<< X%%c3//F^^C,,F^^C,,F^^C,,F76?? "rNrrrrr r s-   # # # # #rr ceZdZdZdS)RTPhraseMarkerz A Phrase Marker: >>> rtPhraseMarker = romanText.rtObjects.RTPhraseMarker('') >>> rtPhraseMarker Nr r rrGrrrr r srr c$eZdZdZdfd ZxZS)RTPhraseBoundaryz >>> phrase = romanText.rtObjects.RTPhraseBoundary('||') >>> phrase ||NcLt||dSr"rrs rr zRTPhraseBoundary.__init__rr)rNrrzs@rrrG ))))))))))rrc$eZdZdZdfd ZxZS)RTEllisonStartz >>> phrase = romanText.rtObjects.RTEllisonStart('|*') >>> phrase |*NcLt||dSr"rrs rr zRTEllisonStart.__init__rr)rNrrzs@rrr rrrc$eZdZdZdfd ZxZS) RTEllisonStopz >>> phrase = romanText.rtObjects.RTEllisonStop('*|') >>> phrase *|NcLt||dSr"rrs rr zRTEllisonStop.__init__rr)rNrrzs@rrrrrrceZdZdZdS)RTRepeatzz >>> repeat = romanText.rtObjects.RTRepeat('||:') >>> repeat Nrrrrrr!srrc$eZdZdZdfd ZxZS) RTRepeatStartz >>> repeat = romanText.rtObjects.RTRepeatStart() >>> repeat ||:NcLt||dSr"rrs rr zRTRepeatStart.__init__0rr)r Nrrzs@rrr)rrrc$eZdZdZdfd ZxZS) RTRepeatStopz >>> repeat = romanText.rtObjects.RTRepeatStop() >>> repeat :||NcLt||dSr"rrs rr zRTRepeatStop.__init__;rr)r$Nrrzs@rr#r#4rrr#ceZdZdZdZdZdZddZdZdZ dd Z d Z dd Z e dZejdZdZdZdS) RTHandlerc"g|_d|_dSr)_tokenscurrentLineNumberr$s rr zRTHandler.__init__Ds !"rcd}t|D]5\}}t||}n6|t d||d|||dfS)a! Divide string into header and non-header; this is done before tokenization. >>> rth = romanText.rtObjects.RTHandler() >>> rth.splitAtHeader(['Title: s', 'Time Signature:', '', 'm1 g: i']) (['Title: s', 'Time Signature:', ''], ['m1 g: i']) NzKCannot find the first measure definition in this file. Dumping contexts: %s) enumeraterrrQr )rlines iStartBodyilines r splitAtHeaderzRTHandler.splitAtHeaderKs  ''  GAt!!$**,,//; <  $&>?DFF F[j[!5#555rcg}t|D]N\}}|}|dkr t|}|dz|_||Ot |dz|_|S)z In the header, we only have :class:`~music21.romanText.base.RTTagged` tokens. We can this process these all as the same class. rrL)r,rQrIrrrr*)rr-rr/r0rtts rtokenizeHeaderzRTHandler.tokenizeHeader`s  ''  GAt::<>> rth = romanText.rtObjects.RTHandler() >>> rth.tokenizeAtoms('IV b3 ii7 b4 ii') [, , , , ] >>> rth.tokenizeAtoms('V7 b2 V13 b3 V7 iio6/5[no5]') [, , , , , ] >>> tokenList = rth.tokenizeAtoms('I b2 I b2.25 V/ii b2.5 bVII b2.75 V g: IV') >>> tokenList [, , , , , , , , , , ] >>> tokenList[-2].getKey() >>> rth.tokenizeAtoms('= m3') [] >>> tokenList = rth.tokenizeAtoms('g;: ||: V b2 ?(Bb: VII7 b3 III b4 ?)Bb: i :||') >>> tokenList [, , , , , , , , , , , ]  rrrrr)rrQrrrr reBeatAtomrrreOptKeyOpenAtomrreOptKeyCloseAtomr  reKeyAtomrreAnalyticKeyAtomrreKeySignatureAtomrreRepeatStartAtomrreRepeatStopAtomr# reNoChordAtomrr)rr0rrwords rr6zRTHandler.tokenizeAtomsspJJsOO! 6! 6D::<>>> Ly99:::: M$ ::;;;;!!$''3 F4334444!''--9 -dI>>????"((..: .tY??@@@@&&2 E$ 223333"((..: M$ ::;;;;#))$//; N4;;<<<<"((..: M$ ::;;;;!''--9 Ly99::::$$T**6 IdI667777 GD)445555 rc|d}||\}}|xj||z c_|xj||z c_dS)zJ Walk the RT string, creating RT rtObjects along the way.  N)rr1r)r4r?)rrr- linesHeader linesBodys rtokenizezRTHandler.tokenizesk  $!%!3!3E!:!: Y ++K888  )))444 rc>g|_||dS)z Given an entire specification as a single source string, strSrc, tokenize it. This is usually provided in a file. N)r)rPrs rprocesszRTHandler.processs#   crrc|jstdd}|jD]$}|r|dz }||krdS%dS)aP Return True if more than one movement is defined in a RT file. >>> rth = romanText.rtObjects.RTHandler() >>> rth.process('Movement: 1 \n Movement: 2 \n \n m1') >>> rth.definesMovements() True >>> rth.process('Movement: 1 \n m1') >>> rth.definesMovements() False zmust create tokens firstrrLTF)r)rrA)r countRequiredcountts rdefinesMovementszRTHandler.definesMovementsse| A$%?@@ @  A||~~  M))44urc.|dS)a Return True if this handler has 1 or more movement. >>> rth = romanText.rtObjects.RTHandler() >>> rth.process('Movement: 1 \n \n m1') >>> rth.definesMovements() False >>> rth.definesMovement() True rL)rT)rWr$s rdefinesMovementzRTHandler.definesMovements$$1$555rTcg}g}|jD]W}|r,t}||_||g}||X|r*t}||_|||rVg}|ds |d}d}nd}d}||dD]} ||| z} || |}|S)a If we have movements defined, return a list of RTHandler rtObjects, representing header information and each movement, in order. >>> rth = romanText.rtObjects.RTHandler() >>> rth.process('Title: Test \n Movement: 1 \n m1 \n Movement: 2 \n m1') >>> post = rth.splitByMovement(False) >>> len(post) 3 >>> len(post[0]) 1 >>> post[0].__class__ >>> len(post[1]), len(post[2]) (2, 2) >>> post = rth.splitByMovement(duplicateHeader=True) >>> len(post) 2 >>> len(post[0]), len(post[1]) (3, 3) rrLN)r)rAr'tokensrrY) rduplicateHeaderrsubrVrthalt handlerHeadiStarths rsplitByMovementzRTHandler.splitByMovement)s6  A||~~  kk   C    JJqMMMM  ++CCJ KK     C7**,, "1g " &'']  *#aA 1 D rc<|jstd|jS)z5 Get or set tokens for this Handler. z(must process tokens before calling split)r)rr$s rr[zRTHandler.tokensjs& | Q$%OPP P|rc||_dS)z0 Assign tokens to this Handler. N)r))rr[s rr[zRTHandler.tokensss  rc*t|jSr")rr)r$s r__len__zRTHandler.__len__zs4<   rcV|}|j|jz|_|S)z@ Return a new handler adding the tokens in both )rSr)r[)rotherr^s r__add__zRTHandler.__add__}s(nn\EM1  rr")r)T)r r rr r1r4r?r6rPrRrWrYrcpropertyr[setterrgrjrrrr'r'As###666*""""H\\\\| 5 5 5, 6 6 6<<<<BX ]] !!!rr'c<eZdZdZdZdZdZdZdZdZ dZ d S) RTFilez! Roman Text File access. c"d|_d|_dSr")filefilenamer$s rr zRTFile.__init__s  rc@dD]7} tj|||_|jn(#t$rY4wxYw|jUdD]8} tj||d|_|jn)#t$rY5wxYw|jt d|d||_dS) z Open a file for reading, trying a variety of encodings and then trying them again with an "ignore" flag if it is not possible. )utf-8 macintoshlatin-1utf-16)encodingN)rsrtrurvNignore)rwerrorszCannot parse file z, possibly a broken codec?)ioopenrpUnicodeDecodeErrorr rq)rrqrws rr{z RTFile.opens D  H GHx@@@ 9(E)%     9 M   "8H U U UDIy,-)Dy (MMMMOOO! s"+ 88#A-- A:9A:c||_dS)zp Assign a file-like object, such as those provided by StringIO, as an open file object. N)rp)rfileLikes r openFileLikezRTFile.openFileLikes  rcdS)Nrrr$s rr%zRTFile._reprInternalsrrc8|jdSr")rpcloser$s rrz RTFile.closes rcZ||jS)z Read a file. Note that this calls readstr, which processes all tokens. If `number` is given, a work number will be extracted if possible. )readstrrpreadr$s rrz RTFile.reads" ||DINN,,---rcLt}|||S)zV Read a string and process all Tokens. Returns a ABCHandler instance. )r'rR)rstrSrchandlers rrzRTFile.readstrs$++rN) r r rrGr r{rr%rrrrrrrnrns!!!8...rrnc&eZdZdZdZdZdZdS)Testclddlm}|jD]%}t}||}&dS)Nr testFiles)music21.romanTextrALLrnr)rrfileStrf unused_rths r testBasicAzTest.testBasicAsK////// } , ,GA7++JJ , ,rcD td}||d||dd|tddtd}||d||d||ddtd }||dd td }||dd td }||ddtd}||ddt d}||ddtd}||ddtd}||ddtd}||ddtd}||ddtd}||ddtd}||dd|tdd|tddtd}||ddtd}||dtd}||dddS)Nz m1 g: V b2 irrm1zTime Signature: 2/2z m3-4=m1-2m3-4zm123-432=m1120-24234zm123-432zm231a IV6 b4 C: Vm231azm123b-432b=m1120a-24234az m123b-432bzm231var1 IV6 b4 C: Vm231zvar1 IV6 b4 C: Vvar1zBb:zF#:zf#:zb:zbb:zg:b2zb2.5bVIIzb1.66.5) rr assertEqualrrstartrrFrErB)rrs rtestReAz Test.testReAs   ~ . . !$$$ T*** ++,ABBDIII   { + + !$$$ A&&& V,,,   5 6 6 Z000   2 3 3 W---   9 : : \222   5 6 6 V,,, OO. / / V,,,  # #E * * U+++  # #E * * U+++  # #E * * U+++  # #D ) ) T***  # #E * * U+++  # #D ) ) T*** ..555 00$777   V $ $ V,,,   V $ $ D!!!   Y ' ' Y/////rc:td}||jd||jdg||jd||jdtd}||jd||jdtd}||jd ||jd g||jd ||jd||jtd }||jd ||jdg||jd||jd||jtd}||jd||jdg||jd||jd| |jtd}||jd||jddg||jd||jd| |jdS)Nz$m17var1 vi b2 IV b2.5 viio6/4 b3.5 Izvi b2 IV b2.5 viio6/4 b3.5 Im17rLz$m17varC vi b2 IV b2.5 viio6/4 b3.5 ICzm20 vi b2 ii6/5 b3 V b3.5 V7zvi b2 ii6/5 b3 V b3.5 V7m20z m0 b3 G: Izb3 G: Irm0z m59 = m57z= m57;m59z m3-4 = m1-2z= m1-2rrr) r|rrOr~rNrr assertFalser assertTrue)rr;s rtestMeasureAttributeProcessingz#Test.testMeasureAttributeProcessing s>?? #ABBB bT*** %((( *A...>?? #ABBB *C000677 #=>>> bT*** %((( *D111 -... %% 9--- aS))) $''' *D111 -... $$ 7+++ bT*** %((( *D111 ,--- && 8,,, aV,,, &))) *D111 ,-----rc6ddlm}t}||jd}|jD]}|r|dz }||d||jd}|jD]}| r|dz }||dd}|jD]:}| r$|j D]}t|tr|dz };||ddS)NrrrLr) rrr'rR mozartK279r)rArriemenschneider001r;rrr)rrr^rUrVr<s rtestTokenDefinitionzTest.testTokenDefinition4sC//////kk I()))  A||~~   """ I0111  A{{}}    +++ # #A{{}} ###A!!]33#  """""rN)r r rrrrrrrrrrsR,,, 505050n%.%.%.N#####rr__main__)=rG __future__rrrzreunittestmusic21rrrrr EnvironmentrcompilerrrrCrDrErFrGrBrHrIrJMusic21Exceptionr rrProtoM21ObjectrrIr|rrrrrrrrrrrr r rrrrrr#r'rnTestCaserr mainTestrrrrs #"""""  &{&'<== rz899 BJ| $ $ "*^,,2:455BJ677 BJ) * * BJ011RZ -- RZ $ $ BJx((2:h'' >**      6        |4        6   RRRRRg$RRRjEEEEEwEEED P3P3P3P3P3P3P3P3fW>"""""f"""&""""""""2DDDDDVDDDN.....F...:M<M,+++++V+++0 ) ) ) ) )6 ) ) ) ) ) ) ) )F ) ) )########4########8V)))))~))))))))^))))))))N)))v)))))H))))))))8)))BBBBBBBBN AAAAAW #AAALB#B#B#B#B#8 B#B#B#R zNNNGTr