j* ddZddlmZgdZddlmZddlZddlZddl Z ddl m Z ddl m Z ddl mZdd l mZdd l mZdd l mZdd l mZdd lmZe jdZGdde jZGddejZGddZGddejZGddZGddejZGddejZGddejZ Gdd ejZ!Gd!d"e j"Z#e gZ$e%d#krddl Z e j&e#dSdS)$a **N.B. in Dec. 2014 MuseData access was removed from music21 because the rights conflicted with access computationally from music21. This module is retained for anyone who has such access, however it is completely untested now and errors cannot and will not be fixed.** Objects and resources for processing MuseData. MuseData conversion from a file or URL to a :class:`~music21.stream.Stream` is available through the music21 converter module's :func:`~music21.converter.parse` function. >>> #_DOCS_SHOW from music21 import * >>> #_DOCS_SHOW abcScore = converter.parse('d:/data/musedata/myScore.stage2') Low level MuseData conversion is facilitated by the objects in this module and :func:`music21.musedata.translate.museDataToStreamScore`. ) annotations) MuseDataDirectoryMuseDataException MuseDataFileMuseDataMeasureMuseDataMeasureIterator MuseDataPartMuseDataRecordMuseDataRecordIterator MuseDataWork base12_26base40 translate)IterableN) environment) exceptions21)r )r)r)common)prebase)OffsetQLmusedataceZdZdS)rN)__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/musedata/__init__.pyrrCsDrrceZdZdZ dd dZd!d Zd Zd Zd Zd Z dZ dZ dZ dZ d"d#dZdZdZdZd$dZdZdZdZdZdS)%r zp Object for extracting data from a Note or other related record, or a single line of musedata data. Nsrcstrcz||_||_|j|jjj|_nd|_i|_dSN)r parentstage_cacheselfr r$s r__init__zMuseDataRecord.__init__Ms=  ; "+1DJJDJ+- rreturnboolc:|jr|jddkrdSdS)a Return a boolean if this record is a rest. >>> mdr = musedata.MuseDataRecord('D4 1 s d ]]') >>> mdr.isRest() False >>> mdr = musedata.MuseDataRecord('measure 1 A') >>> mdr.isRest() False rrTFr r(s risRestzMuseDataRecord.isRest^s( 8  s**4urc|jdkr-t|jdkr|jddkrdSdSt|jdkr|jddkrdSdS)a  Return a boolean if this record is tied. >>> mdr = musedata.MuseDataRecord('D4 8- h d -') >>> mdr.isTied() True >>> mdr = musedata.MuseDataRecord('C4 1 s u [[') >>> mdr.isTied() False -TFr%lenr r/s risTiedzMuseDataRecord.isTiedmsi :??48}}q  TXa[C%7%7t548}}q  TXa[C%7%7t5rc6|jr|jddvrdSdS)NrABCDEFGTFr.r/s risNotezMuseDataRecord.isNotes& 8  y004urczt|jdkr"|jddkr|jddvrdSdS)z Chords are specified as additional note records following a main chord tone. The blank space defines this as chord tone. r2r r:TFr7r r/s risChordzMuseDataRecord.isChordsA tx==1  !!3!3 y8P8P4urc6|jr|jddvrdSdS)NrcgTFr.r/s r isCueOrGracezMuseDataRecord.isCueOrGraces& 8  t++4urc`t|jdkr|jdddkrdSdS)ze >>> mdr = musedata.MuseDataRecord('back 4') >>> mdr.isBack() True rbackTFr>r/s risBackzMuseDataRecord.isBacks5 tx==A  $(1Q3-6"9"94urc|r(|jddd}n_|s|r(|jddd}nt d|dg}d|vr|dnMd|vr|dn3d|vr|dnd |vr|d tj|\}}||d |S) aQ >>> mdr = musedata.MuseDataRecord('Ef4 1 s d ==') >>> mdr.isNote() True >>> mdr._getPitchParameters() 'E-4' >>> mdr = musedata.MuseDataRecord('F#4 1 s # d ==') >>> mdr.isNote() True >>> mdr._getPitchParameters() 'F#4' rNr2z4cannot get pitch parameters from this kind of record#z##fr4ffz--r) r;r splitrBr?rappendr getNumFromStrjoin)r(datapStrnumbersjunks r_getPitchParametersz"MuseDataRecord._getPitchParameterssE ;;== \8ABB<%%''*DD     \DLLNN \8ABB<%%''*DD#$Z[[ [Qy $;; KK     T\\ KK     D[[ KK     T\\ KK   ,T22  Gwwt}}rcBddlm}t|jdkrdS|jd}d}|dkr|d}n|dkr|d}n|d kr|d }n|d kr|d }no|d kr|d }nS|dkr|d}n7|dkr|d}n|dkr|d }|d|_d|_|S)a Return a music21 Accidental object for the representation. >>> mdr = musedata.MuseDataRecord('Ef4 1 s d ==') >>> mdr._getAccidentalObject() >>> mdr = musedata.MuseDataRecord('F#4 1 s # d ==') >>> mdr._getAccidentalObject() >>> mdr._getAccidentalObject().displayStatus == True True >>> mdr = musedata.MuseDataRecord('F#4 1 s ') >>> mdr._getAccidentalObject() is None True rpitchNrHsharpnnaturalrIflatxz double-sharpX&z double-flatSFalwaysT)music21rVr7r Accidental displayType displayStatus)r(rVrOaccs r_getAccidentalObjectz#MuseDataRecord._getAccidentalObjectsI "!!!!! tx==B  4x| 3;;""7++CC S[[""9--CC S[[""6**CC S[["">22CC S[["">22CC S[[""=11CC S[[""7++CC S[[""6**C ?'CO $C  rcPddlm}|}||}|jdkr|S|}|j d|j_|||_|j | r d|j_|S)a Get the Pitch object defined by this record. This may be a note, chord, or grace pitch. >>> mdr = musedata.MuseDataRecord('Ef4 1 s d ==') >>> p = mdr.getPitchObject() >>> p.nameWithOctave 'E-4' >>> mdr = musedata.MuseDataRecord('F#4 1 s # d ==') >>> p = mdr.getPitchObject() >>> p.nameWithOctave 'F#4' >>> p.accidental.displayStatus True Double sharps were giving octave problems. >>> mdr = musedata.MuseDataRecord('F##5 2 e x d') >>> p = mdr.getPitchObject() >>> p.nameWithOctave 'F##5' rrUr2NFT) rbrVrSPitchr%rg accidentalre _accidentalhasCautionaryAccidental)r(rVppprfs rgetPitchObjectzMuseDataRecord.getPitchObjects. "!!!!!  % % ' ' KKOO :??H++--C|'.3 * $ 9 9 ; ; |'D,H,H,J,J'-1 *HrdivisionsPerQuarterNote int | Nonerc |jdkrt|jdd}nt|jdd}|jdd}|dkr[ t|}|d|zz }td|jzd zn(#t$rt d|jzd zwxYw|j|jj}n||}nt d tj ||z S) a Gets the quarterLength of the note given the prevailing divisionsPerQuarterNote Here there is one division: >>> mdr = musedata.MuseDataRecord('Ef4 1 s d ==') >>> mdr.getQuarterLength(4) 0.25 >>> mdr.getQuarterLength(8) 0.125 >>> mdr = musedata.MuseDataRecord('Ef4 6 s d ==') >>> mdr.getQuarterLength(4) 1.5 >>> mdr = musedata.MuseDataRecord('back 4') >>> mdr.getQuarterLength(4) 1.0 r2r3r5rDr=dzError in parsing: z> Column 5 must be blank. Parsing as a part of the divisionsz Column 5 must be blank.NzMcannot access parent container of this record to obtain divisions per quarter) r%intr print ValueErrorrr$getDivisionsPerQuarterNoteropFrac)r(rp divisions shouldBeBlank divHundredsdpqs rgetQuarterLengthzMuseDataRecord.getQuarterLength)sP( :??DHQqSM**IIDHQqSM**I1 C   V!-00 S;.. *!YZ[[[[ V V V'(4836TTVVV V ; "+$??AACC $ 0)CC#%HII I}Y_---s 1B %B2c|jdkrdSt|jdkr&|jddkrdS|jddkrdSdS)Nr2.:rr6r/s rgetDotszMuseDataRecord.getDotsXsV :??448}}r!!8B<3&&18B<3&&11rcd}|jdkrdSt|jdkrdS|jdd}d|dD}|S)z Return lyrics as a list. >>> mdr = musedata.MuseDataRecord('D4 2 e u con-') >>> mdr.stage = 2 >>> mdr.getLyrics() ['con-'] Nr2,+c6g|]}|Sr)strip).0r\s r z,MuseDataRecord.getLyrics..s 666!AGGII666r|)r%r7r rK)r(rOraws r getLyricszMuseDataRecord.getLyricsnsd :??448}}r!!t(233-C66syy~~666D rcr|jdkrdS|jdd}|dkrdS|S)a Return complete span of characters defining beams. >>> mdr = musedata.MuseDataRecord('E2 1 s u =') >>> mdr.getBeams() '=' >>> mdr = musedata.MuseDataRecord('E2 1 s u ]') >>> mdr.getBeams() ']' >>> mdr = musedata.MuseDataRecord('E2 4 q u') >>> mdr.getBeams() is None True r2Nr)r%r rstripr(rOs rgetBeamszMuseDataRecord.getBeamss? :??48BrE?Drzzt;;== r str | Nonec |jdS#t$rYnwxYwt|jdkrd}ng}d}|dkr[|t|jkrC||j||dz }|dkr|t|jkCd|}||jd<|S)a Return an articulation string or None >>> mdr = musedata.MuseDataRecord('C4 12 e u [ .p') >>> mdr._getAdditionalNotations() '.p' >>> mdr = musedata.MuseDataRecord('C4 12 e u = .') >>> mdr._getAdditionalNotations() '.' >>> mdr = musedata.MuseDataRecord('G4 24 q u (') >>> mdr._getAdditionalNotations() '(' _getAdditionalNotationsrN*r2r)r&KeyErrorr7r rLrNr)r(rO data_listis rrz&MuseDataRecord._getAdditionalNotationss" ;89 9    D  tx==2  DDIAr''a#dh--//  !---Qr''a#dh--//779%%++--D15 -. s  c6ddlm}g}|}||S|D]t}|dkr(||1|dkr(||_|dkr(|||dkr(|||dkr(|||d kr)|||d kr)|| G|d kr'|| v|S) a Return a list of 0 or more music21 Articulation objects >>> mdr = musedata.MuseDataRecord('C4 12 e u [ .p') >>> mdr.getArticulationObjects() [] >>> mdr = musedata.MuseDataRecord('C4 12 e u [ .p>') >>> mdr.getArticulationObjects() [, ] r) articulationsNAV>r_=r,) rbrrrL StrongAccentAccentStaccatoTenutoDetachedLegatoSpiccato BreathMark)r(rpostrOchars rgetArticulationObjectsz%MuseDataRecord.getArticulationObjectss *)))))++-- <K 8 8Ds{{ M66889999 M66889999 M00223333 M22445555 M00223333 M88::;;;; M22445555 M4466777 rcddlm}g}|}||S|D]}|dkr(||0|dkr(||^|dkr(|||dkr(|||dkr'|||S) a Return a list of 0 or more music21 Articulation objects >>> mdr = musedata.MuseDataRecord('C4 12 e u [ t') >>> mdr.getExpressionObjects() [] >>> mdr = musedata.MuseDataRecord('C4 12 e u [ .p>F') >>> mdr.getExpressionObjects() [] r) expressionsNr`Etr-M)rbrrrLFermataTrillTurnMordent)r(rrrOrs rgetExpressionObjectsz#MuseDataRecord.getExpressionObjectss ('''''++-- <K 3 3Ds{{ K//112222 K//112222 K--//0000 K,,..//// K//11222 rcddlm}g}|}||Sd}|D],}||}|dkr|d|||t |zdz}|dvr)|||q|dkr)||d|dkr)||d |d kr)||d |d kr(||d .|S) a~ Return a list of 0 or more music21 Dynamic objects >>> mdr = musedata.MuseDataRecord('C5 12 e u ff') >>> mdr.getDynamicObjects() [] >>> mdr = musedata.MuseDataRecord('E4 48 h u (pp') >>> mdr.getDynamicObjects() [] r)dynamicsN) pppfffrmrJfpmpmfrnrImZZpR) rrrmrJrnrIrrrrrrsfrr)rbrrfindr7rLDynamic)r(rrrOtargetstargetposs rgetDynamicObjectsz MuseDataRecord.getDynamicObjects su %$$$$$++-- <K3 4 4F))F##CQww:S3v;;%6%7%7 88DOOO H,,V4455553 H,,T2233333 H,,T2233334 H,,T2233333 H,,T22333 rcB|}|dSd|vrdSdS)aU Return a boolean if this note has a cautionary accidental. >>> mdr = musedata.MuseDataRecord('F5 3 t n d ==[ (+') >>> mdr.hasCautionaryAccidental() True >>> mdr = musedata.MuseDataRecord('C4 12 e u [') >>> mdr.hasCautionaryAccidental() False NF+T)rrs rrlz&MuseDataRecord.hasCautionaryAccidental5s2++-- <5 $;;4ur)rN)r r!)r*r+r#)rprqr*r)r*r)rrr__doc__r)r0r8r;r?rBrFrSrgror~rrrrrrrrlrrrr r Hsi ....."    *  $$$L000d///b-.-.-.-.-.^   ,*!!!6""""H&&&P   D'''Rrr c$eZdZdZdZdZdZdS)r z; Create MuseDataRecord objects on demand, in order c0||_d|_||_dSNr)r indexr$r's rr)zMuseDataRecordIterator.__init__Rs  rc|Sr#rr/s r__iter__zMuseDataRecordIterator.__iter__W rc|jt|jkrtt |j|j|j}|xjdz c_|SNr2)rr7r StopIterationr r$r(mdrs r__next__zMuseDataRecordIterator.__next__ZsO :TX & &// !TXdj14;?? a  rNrrrrr)rrrrrr r MsK rr cDeZdZdZd dZdZdZdZdZdZ d Z d Z dS) ra A MuseDataMeasure is an abstraction of the data contained within a measure definitions. This needs to be an object to gracefully handle the following cases. Some Measures do not have any notes, for example, and the end of encoding where a final bar line is defined. Some measures do not have numbers or barlin definitions, such as pickup notes. Some measures define barline characteristics. Backup and forward presumably only is contained within a measure. Ncl|g}||_||_|j|jj|_dSd|_dSr#)r r$r%r's rr)zMuseDataMeasure.__init__ps= ;C ; "*DJJJDJJJrcdS)Nzsize={len(self.src)}rr/s r _reprInternalzMuseDataMeasure._reprInternal~s%%rcpddlm}|jd}|ddkrd}|dd}|dkrd}nD|d krd }n;|d krd }n2|d vrd }n+|dkrd}n"|dkrd}n|dvrd}nt d|||}t |dkr|dddkrc|dd}d|vr d}|d}||_n#d|vrd}|d}||_|S)z Return a configured music21 bar object. This can be used with the current Measure or applied to a previous Measure. r)barrmeasurer2r3easureregulardotteddoublez light-light)heavy1heavyrheavy2z light-heavyheavy3z heavy-light)heavy4heave4z heavy-heavyz$cannot process bar data definition: Nrz:|end) directionz|:start) rbrr rrBarliner7Repeattype)r(rrOdataBar barlineTypebldataFlagunused_repeatForms r getBarObjectzMuseDataMeasure.getBarObjects x{  "" 7c>>Dqs) h  #KK  "KK  'KK + + +!KK  'KK  'KK , , ,'KK#$T7$T$TUU U [[ % % t99r>>d233ioo//255BCCy((Hx$(!ZZ%Z00%!!$(!ZZ'Z22% rcddlm}|jd}|ddkrd}d}t |dkr7|ddd krt j|\}}|}||_ |d krt||_ |S) zO Return a configured music21 :class:`~music21.stream.Measure`. r)streamrr1 r5Nr) rbrr rr7rrMMeasurer leftBarlinerunumber)r(rrOmNumberrRrs rgetMeasureObjectz MuseDataMeasure.getMeasureObjects #"""""x{  "" 7c>>D t99>>d122hnn.."44"066MGT NN  ))++  b==7||AHrc8|jD]}|r |ddvrdSdS)z: Return True of if this Measure has Notes r ABCDEFGrgcTFr.r(lines rhasNoteszMuseDataMeasure.hasNotess8H  D Q<//tturcN|jD]}|r|drdSdS)z Return True of if this Measure defines one or more 'back' indication. Note: this does not instantiate MuseDataRecord instances. rETFr startswithrs r hasVoiceszMuseDataMeasure.hasVoicess= H  D // tturc,t|j|SzJ Iterating over this part returns MuseDataMeasure objects )r r r/s rrzMuseDataMeasure.__iter__s&dh555rc t|S)zX Return a list of all records stored in this measure as MuseDataRecord. listr/s r getRecordszMuseDataMeasure.getRecordsDzzrNN) rrrrr)rrrrr rrrrrrres    &&&...`4   666 rrc$eZdZdZdZdZdZdS)rz< Create MuseDataMeasure objects on demand, in order c>||_||_d|_||_dSr)r boundariesrr$)r(r rr$s rr)z MuseDataMeasureIterator.__init__s"$  rc|Sr#rr/s rrz MuseDataMeasureIterator.__iter__rrc|jt|jkrt|j|j\}}t |j||dz|j}|xjdz c_|Sr)rr7rrrr r$)r(rrmdms rrz MuseDataMeasureIterator.__next__si :T_-- - -// !_TZ0 sdhuS1W}5t{CC a  rNrrrrrrsK rrceZdZdZd%dZdZdZdZdZ d&d Z d Z d Z d Z d Z dZdZdZdZd'dZd'dZdZdZdZdZdZdZdZd(dZdZdZd Zd)d!Zd"Z d#Z!d$Z"dS)*r z; A MuseData part is defined by collection of lines Nc|g}||_g|_d|_d|_||_|j |jr||_|jdkr!||j|_dSdSr)r _measureBoundaries_divisionsPerQuarter_divisionsPerQuarterNoter%_determineStage _scrubStage1)r(r r%s rr)zMuseDataPart.__init__ s ;C#%$(!)-% : $( --//DJ :??((22DHHH ?rcdSNrrr/s rrzMuseDataPart._reprInternal rrcJ|jD]}|drdSdS)z Determine the stage of this file. This is done by looking for an attributes record starting with a $; if not found, it is stage 1. if it is found it is stage 2. $rr2r)r( attributes rrzMuseDataPart._determineStage#s<   I##C(( qq qrct|dkrtdd}g}|D]4}|r|dkrd}||5|S)z Some stage1 files start with a leading line of space. This needs to be removed, as each line matters. Provide a list of character lines. r2zcannot scrub empty sourceTrF)r7rrrL)r(r checkrrs rrzMuseDataPart._scrubStage1.sx s88q==#$?@@ @  D "::<<2%%!E KK     rcg}||vr||t|z}|t|kr||r|||nB||rn'||dvr|||nn|dz }|t|kd|S)a >>> mdp = musedata.MuseDataPart() >>> mdp._getDigitsFollowingTag('junk WK#:2345', 'WK#:') '2345' >>> mdp._getDigitsFollowingTag('junk WK#: 2345 junk', 'WK#:') '2345' >>> mdp._getDigitsFollowingTag('$ K:-3 Q:4 T:3/4 C:22', 'Q:') '4' >>> mdp._getDigitsFollowingTag('$ K:-3 Q:4 T:3/4 C:22', 'T:') '3/4' >>> mdp._getDigitsFollowingTag('$ K:-3 Q:4', 'T:') '' z-/r2r)rr7isdigitrLisspacerN)r(rtagrrs r_getDigitsFollowingTagz#MuseDataPart._getDigitsFollowingTagBs $;; #S)Ac$ii--7??$$KKQ((((!W__&&!W__KKQ((((Qc$ii--wwt}}rFc|s(|}|}g}||vr||t|z}|t|kr||r|||n|||r|sn_||r|r|||n'||dvr|||nn|dz }|t|kd|S)z >>> mdp = musedata.MuseDataPart() >>> mdp._getAlphasFollowingTag('Group memberships: sound, score', 'Group memberships:') 'sound,score' rr2r)lowerrr7isalpharLr*rN)r(rr+ keepSpacekeepCaserrs r_getAlphasFollowingTagz#MuseDataPart._getAlphasFollowingTag`s7 ::<>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getWorkNumber() '581' r2rrrDzWK#:)r%r rrKr,rs r getWorkNumberzMuseDataPart.getWorkNumber|so :??8A;qs#))++Dd{{zz#q)K..tx{FCC Crc|jdkr'|jdddS||jddS)a7 Returns a string, not an int. >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getMovementNumber() '3' r2r4NrDzMV#:)r%r rr,r/s rgetMovementNumberzMuseDataPart.getMovementNumbersK :??8A;qrr?((** *..tx{FCC Crc|jdkrdS|}||ddd}|dkrdS|S)a The directive field is generally used to store tempo indications. This indication, however, is frequently not provided. >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getDirective() is None True r2NzD:T)r0r1r)r%_getAttributesRecordr2r)r(ralphass r getDirectivezMuseDataPart.getDirectivesf :??4,,..D00tt:>1@@F||t||~~%rc|jdkrgg}|jd|jd|jdfD])}||*d|S|jdS)u Return the source (original print encoding) for the score. >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '03.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getSource() 'Breitkopf & Härtel, Vol. 13' Note that the publisher is Härtel. MuseData predates the standardization of encoding as UTF-8, so many MuseData files are in Windows (ISO-8859-1) encodings. Music21 tries first in utf-8 and if there are errors will try again in ISO-8859-1, and if it fails it will try to read ignoring any errors (leaving "Hrtel"). In this case, both UTF-8 and ISO-8859-1 support this character (Latin-1 space in Unicode). If you know the encoding you can pass that to MuseDataWork or MuseDataFile. It is not yet a property you can specify in converter. >>> mdw = musedata.MuseDataWork() >>> mdw.encoding = 'ISO-8859-1' >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getSource() 'Breitkopf & Härtel, Vol. 13' r2rrDrrs)r%r rLrrN)r(rOrs r getSourcezMuseDataPart.getSourcesu: :??D!dhqk48A;? * * DJJLL))))774== 8A; rcp|jdkr|jdS|jdS)aN For stage 1 just gets the catalogue number >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getWorkTitle() 'Clarinet Quintet' r2rr4r%r rr/s r getWorkTitlezMuseDataPart.getWorkTitles3 :??8A;$$&& &8A; rc6|jdkrdS|jdS)a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getMovementTitle() 'Trio II' r2Nr3)r%r r/s rgetMovementTitlezMuseDataPart.getMovementTitles  :??48A; rcZ|jdkrdS|jdS)a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getPartName() 'Clarinet in A' r2Nr5r@r/s r getPartNamezMuseDataPart.getPartNames, :??48A;$$&& &rc|jdkrgS||jdd}g}|dD]A}|dkr'||B|S)a! >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getGroupMemberships() ['sound', 'score'] r2 zgroup memberships:rr)r%r2r rKrrL)r(rrentrys rgetGroupMembershipsz MuseDataPart.getGroupMembershipss :??I--dhrl.BDDCD3 / /;;==B&&KK ...Krscorec|jdkr3t|jdddSd}d}|j|ds^|j|}||r||d}n%|dz }|j|d^|dSt|S) a >>> fp1 = str(common.getSourceFilePath() /'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getGroupMembershipsTotal() 5 r2rsr=r Nr$of)r%rur rKr r,r( membershiprrrs rgetGroupMembershipsTotalz%MuseDataPart.getGroupMembershipsTotal#s :??tx{((--a011 1AChqk,,S11 x{??:..55dDAACQ hqk,,S11  {t3xxrc|jdkr&|jdddSd}d}|j|ds^|j|}||r||d}n%|dz }|j|d^|dSt |S)a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getGroupMembershipNumber() 1 r2rsr=rLNr$part)r%r rKr r,rurNs rgetGroupMembershipNumberz%MuseDataPart.getGroupMembershipNumber=s :??8A;$$S))!, ,AChqk,,S11 x{??:..55dFCCCQ hqk,,S11  {t3xxrcH|jdkrD|jddz|jdz}|Sd}|j|ds%|dz }|j|d%|j|S)a The attributes record is not in a fixed position, but is the first line that starts with a $. >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0]._getAttributesRecord() '$ K:0 Q:6 T:3/4 X:-11 C:4' r2r4r=r3rLr$)r%r rr )r(recordrs rr9z!MuseDataPart._getAttributesRecordWs :??Xa[&&((3.!1B1B1D1DDFMAhqk,,S11 Qhqk,,S11 8A; rc|}|jdkr(t|ddSt||dS)a  >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getKeyParameters() 0 r2r=zK:r9r%rurKr,rs rgetKeyParameterszMuseDataPart.getKeyParametersns]((** :??tzz#q)** *t224>>?? ?rc\ddlm}||S)a; >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getKeySignature() r)key)rbrZ KeySignaturerX)r(rZs rgetKeySignaturezMuseDataPart.getKeySignature~s6  5 5 7 7888rc|}|jdkrQt|dd}t|dd}nJ||dd\}}t|t|}}|dkr|dks|dkrdS|d|S) a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getTimeSignatureParameters() '3/4' r2r=rDrszT:/rz4/4rW)r(rrYds rgetTimeSignatureParametersz'MuseDataPart.getTimeSignatureParameterss((** :??DJJsOOA&''ADJJsOOA&''AA..tT::@@EEDAqq663q66qA FFqAvv!q&&5::!:: rc\ddlm}||S)a3 >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getTimeSignatureObject() r)meter)rbrb TimeSignaturer`)r(rbs rgetTimeSignatureObjectz#MuseDataPart.getTimeSignatureObjects6 "!!!!!""4#B#B#D#DEEErc|jdkrdS|}||d}|dkrdSt|S)a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0]._getNumberOfStaves() 1 r2zS:r)r%r9r,rur(rrs r_getNumberOfStaveszMuseDataPart._getNumberOfStavessS :??1,,..D--dD99Cbyyq3xxrc|}|jdkr|dd}|gSg}||d}|dkr|||dkr]t d|dzD]7}||d|d}|dkr||8|S)a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0]._getClefParameters() ['4'] r2r=r5zC:rCr)r9r%rKr,rLrangerg)r(rrOrrrs r_getClefParameterszMuseDataPart._getClefParameterss((** :??::c??1%D6MD--dD99Cbyy C   byyq$"9"9";";a"?@@))A55dHHHHEECbyy C(((Krr2c|jdkrdS||dz }tt|}ddlm}|dkr|S|dkr|S|dkr|S|dkr| S|d kr| S|d kr| S|d kr| S|d kr| S|d kr|S|dkr|S|dkr|S|dkr|S|dkr|S|dkr|St)d|)aa Return a music21 clef object based on a two character clef definition. >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getClefObject().sign 'G' r2Nr)clef5434643111213141522235282zcannot determine clef from:)r%rkr!rurbrmFrenchViolinClef TrebleClef Treble8vbClef Treble8vaClef GSopranoClef CBaritoneClef TenorClefAltoClefMezzoSopranoClef SopranoClefBassClef FBaritoneClef Bass8vbClef Bass8vaClefr)r(voicecharPairrms r getClefObjectzMuseDataPart.getClefObjects :??4..00;H3x==))H $ $ $ $ $ $3,,...S(((T!!))+++T!!))+++S((***T!!))+++T!!~~'''T!!}}&T!!,,...T!!'')))T!!}}&T!!))+++T!!'')))T!!'')))'(ExPPPrc|}|jdkrdS||d}|dkrdSt|S)aP Get the transposition, if defined, from the Metadata header. >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> fp2 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '02.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.addFile(fp2) >>> mdw.getParts()[0]._getTranspositionParameters() -11 >>> mdw.getParts()[1]._getTranspositionParameters() is None True r2NzX:r)r9r%r,rurfs r_getTranspositionParametersz(MuseDataPart._getTranspositionParameterssS ((** :??4--dD99Cbyyt3xxrcZ|}|dStj|S)a/ If this part defines a transposition, return a corresponding Interval object. >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> fp2 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '02.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.addFile(fp2) >>> mdw.getParts()[0].getTranspositionIntervalObject() N)rrbase40DeltaToInterval)r(argss rgetTranspositionIntervalObjectz+MuseDataPart.getTranspositionIntervalObject6s0//11 <4/55 5rcN|j|}|jdkrQt|dd}|}||jjz |_n(t||d|_|jS)a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getDivisionsPerQuarterNote() 6 Nr2r=rzQ:) rr9r%rurKrd barDuration quarterLengthr,)r(rrOtss rrxz'MuseDataPart.getDivisionsPerQuarterNoteKs  ( 0,,..DzQ4::c??1-..002215r~7S0S-- 14//d;;1=1=-,,rc||j}g}g}d}t|dz }|jdkrHt|D]/\}}|dr||0|d}nfd}t|D]T\}}|dr|dz } |dkr||}|dr||Ud} |d|kr\t|dkr ||d|fd} nK||d|ddz fd} n"|||ddz fd} | }t | t|D]_}|t|dz kr||||f6|||||dzdz f`|S)a >>> mdp = musedata.MuseDataPart() >>> mdp.stage is None True >>> mdp._getMeasureBoundaryIndices(['$', 'A', 'B', 'm', 'C', 'm', 'D']) [(1, 2), (3, 4), (5, 6)] >>> mdp._getMeasureBoundaryIndices(['$', 'm', 'B', 'C', 'm', 'D', 'E', 'm', 'F', 'D']) [(1, 3), (4, 6), (7, 9)] >>> mdp._getMeasureBoundaryIndices(['$', 'B', 'C', 'm', 'D', 'E']) [(1, 2), (3, 5)] Nr2rrr$)r r7r% enumerater rLrj) r(r rmIndicesfirstPostAttributesIndex lastIndexrrmAttributeRecordCountstartIterIndexs r_getMeasureBoundaryIndicesz'MuseDataPart._getMeasureBoundaryIndicesks9 ;(C #' HHqL :??$S>> ' '4??3'''OOA&&&'/{ $ $%& !$S>> ' '4??3'')Q.)(1,,1I1Q/0,??3'''OOA&&& A;2 2 28}}!!!!8A; ":;;;!%!!8A; a"@AAA!"   7!qI J J JN  %>3x==99 J JH )))%%x{I&>????%%x{HQUOa4G&HIIIIrcj||_||_dS)z After setting the source string, this method must be called to configure the _measureNumberToLine method and set additional attributes. N)rxrrrr/s rupdatezMuseDataPart.updates2 %)$C$C$E$E!"&"A"A"C"Crc8t|j|j|Sr )rr rr/s rrzMuseDataPart.__iter__s'tx1H$OOOrc t|S)z_ Return a list of all measures stored in this part as MuseDataMeasure objects. rr/s r getMeasureszMuseDataPart.getMeasuresrrr)FF)rJ)r2r#)#rrrrr)rrrr,r2r5r7r;r>rArCrErIrPrSr9rXr\r`rdrgrkrrrrxrrrrrrrr r s53333(   (<;@(-8DDD,DDD"&&&0%%%N"    ' ' '(    4    4.@@@ 9 9 90 F F F   *   D5Q5Q5Q5Qn   4666*---@@@@@DDDDPPP rr c8eZdZdZd dZdZdZdZdZd Z d S) ra A MuseDataFile file may describe one or more MuseDataPart; a Score might need multiple files for complete definition. A MuseDataFile object can be created from a string. When read, one or more MuseDataPart objects are created and stored on self.parts. r*Nonec>g|_d|_d|_d|_dSNzutf-8)partsfilenamefileencodingr/s rr)zMuseDataFile.__init__s")+ "& %) $ rcdSr!rr/s rrzMuseDataFile._reprInternalr"rc>t|d|_||_dS)Nrb)openrr)r(rs rrzMuseDataFile.opensTNN  rc|j} ||j}n&#t$r|dd}YnwxYw||S)Nz ISO-8859-1ignore)rreaddecoderUnicodeDecodeErrorreadstr)r( fileContentss rrzMuseDataFile.readszy~~''  G'..t}==LL! G G G'..|XFFLLL G||L)))s6 AAc8|jdSr#)rcloser/s rrzMuseDataFile.closes rcd}g}|d}t|D]\}}|dr|rd}d}"|r%|r |ddkr4|ds|drVt|d krg}tt |}||j|g}|d r||d S) zC Read a string, dividing it into individual parts. F r^Tr@z/ENDENDr2z/eofN)rKrr r7r rrrL)r( input_str commentTogglelinessrcLinesrrmdps rrzMuseDataFile.readstrs8 ??4(( **! #! #GAts##  $)M$(M # #$q'S..(( #DOOE,B,B #u::??E"5))  !!#&&&(( # T""""C! #! #rNr*r) rrrrr)rrrrrrrrrrs}%%%% ***-#-#-#-#-#rrc.eZdZdZd dZd dZdZd Zd S) r z4 A work might consist of one or more files. r*rc"g|_d|_dSr)filesrr/s rr)zMuseDataWork.__init__s)+ $ rrstr | Iterable[str]cZtj|stjt|}|g}n|}|D]s}t }|j|_|||| |j |tdS)zr Open and read this file path or list of paths as MuseDataFile objects and set self.files N) r isIterablercastr!rrrrrrrL)r(r fp_singlefpListfpInnermdfs raddFilezMuseDataWork.addFile!s  $$ sBI[FFF # #G..C=CL HHW    HHJJJ IIKKK J  c " " " " # #rctj|s|g}n|}|D]?}t}|||j|@dS)a Add a string representation acting like a part file >>> mdw = musedata.MuseDataWork() >>> mdw.addString('WK#:581 MV#:3c\nBreitkopf & Hartel, Vol. 13\n' ... 'Clarinet Quintet\n' ... 'Trio II\n' ... '$ K:0 Q:6 T:3/4 X:-11 C:4\n' ... 'C5 3 e d [ (&0p\n' ... 'E5 3 e d ]') # TODO: Okay, so what? did we test this or demo anything? N)rrrrrrL)r(rstrList thisStringrs r addStringzMuseDataWork.addString6sr" ++  kGGG! # #J..C KK # # # J  c " " " " # #rc\g}|jD]!}|jD]}||"|S)z Get all parts contained in all files associated with this work. A list of MuseDataPart objects that were created in a MuseDataFile. )rrrL)r(rrrs rgetPartszMuseDataWork.getPartsSsJ: ! !Cy ! ! C     ! rNr)rrr*r)rrrrr)rrrrrrr r sd%%%%####*###:     rr c,eZdZdZdZdZdZddZdS)ra\ This class manages finding musedata files stored in a directory, comparing file names and examining subdirectories to determine which files are parts. Once found, a MuseDataWork, or a list of paths, can be returned A directory, or a list of file path stubs, such as that obtained within a zip file, can both be provided. cLg|_i|_||dSr#)pathsgroups_prepareGroups)r( dirOrLists rr)zMuseDataDirectory.__init__ms*   I&&&&&rcg}tj|r|}ntj|rXt tj|D]5}|tj||6ntd||D]r}tj |\}}| |s:tj |\}}|dkrX|j |sg}t|j dkrt|j D]n\} }tj |\}}tj |\}}|dkr*|dr|| o||D]} |j | n |j dS)Nz*cannot get files from the following entityrr2s)rrospathisdirsortedlistdirrLrNrrKisMusedataFilerMrr7rr reversepopsort) r(rallPathsfnrunused_directorynumStr nonNumStrpopListrs rrz MuseDataDirectory._prepareGroupsss   Y ' ' ]!HHW]]9 % % ]RZ 2233 = = Y ; ;<<<< =$$PR[\\ \ & &B#%7==#4#4 b&&r**  & 4R 8 8 FI|| !!"%%%% tz??Q  "4:.. & &2')w}}R'8'8$ "$*$8$<$<! R<r rArCrIrPrSrXr`rx)r(rmdwdirLibrmdpObjsrs rtestLoadFromFilezTest.testLoadFromFiles\ )++j8?J K Knnb(++?  Bfb))B KKOOOO,,.. Wq))) *,BCCC +-ABBB *,BCCC +-ABBB *,BCCC +-ABBB *,BCCC +-ABBB *,BCCC +-ABBBq N NA   WQZ5577 ? ? ?   WQZ99;;S A A A OOGAJ0022==kJJ K K K   WQZ44668J K K K   WQZ88::I F F F   WQZ;;==?Q R R R   WQZ@@II1 M M M   WQZ@@II1 M M M M <>@@%HHH >>@@!DDDDDrcvttjdz dz dz }t|}dS)Nrrr)r!rrr)r(fpDir unused_mdds rtestMuseDataDirectoryzTest.testMuseDataDirectoryGs;F,..;oMPXXYY&u-- rctd}d|_||dgtd}d|_||dgtd}d|_||ddgdS)Nz/D4 2 e u con-rzcon-z,F#4 2 e u aaz0F#4 2 e u a | bb)r r%rrrs r testGetLyricszTest.testGetLyricshsNOO  6(333KLL  3%000OPP  3*55555rN)rrrrrr rrrrrsG@9E9E9En...B 6 6 6 6 6rr__main__)'r __future__r__all__collections.abcrrtypingrunittestrbrrmusic21.musedatar rrrrmusic21.common.typesr Environment environLocalMusic21ExceptionrProtoM21Objectr r rrr rr rTestCaser _DOC_ORDERrmainTestrrrrs? #"""""   %$$$$$  &&&&&&######&&&&&&))))))&{&z22      5   @@@@@W+@@@J0DDDDDg,DDDP4x x x x x 7)x x x xQ#Q#Q#Q#Q#7)Q#Q#Q#jFFFFF7)FFFTiiiii.iii\c6c6c6c6c68 c6c6c6h^  zNNNGTr