rh hSrSSKJr SSKJr SSKrSSKrSSKrSSK J r SSK J r SSK J r SSK Jr SS K Jr SS K Jr SS K Jr \ R$"S 5r"S S\ R(5r"SS\R,5r"SS5r"SS\R,5r"SS5r"SS\R,5r"SS\R,5r"SS\R,5r"SS\R,5r"SS \R>5r \/r!\"S!:XaSSK r \ RF"\ 5 gg)"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)IterableN) environment) exceptions21) base12_26)base40) translate)common)prebasemusedatac\rSrSrSrg)MuseDataException4N)__name__ __module__ __qualname____firstlineno____static_attributes__rS/home/james-whalen/.local/lib/python3.13/site-packages/music21/musedata/__init__.pyrr4srrc\rSrSrSrSSSjjrSSjrSrSrSr S r S r S r S r S rSSjrSrSrSrSSjrSrSrSrSrSrg)MuseDataRecord9zd Object for extracting data from a Note or other related record, or a single line of musedata data. NcXlX lURb&URRRUlOSUl0UlgN)srcparentstage_cacheselfrrs r__init__MuseDataRecord.__init__>s=  ;; "++11DJDJ+- rcNUR(aURSS:Xagg)z 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 rrTFrr"s risRestMuseDataRecord.isRestOs  88 s*rcURS:Xa.[UR5S:aURSS:Xagg[UR5S:aURSS:Xagg)z 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 -TFrlenrr(s risTiedMuseDataRecord.isTied^sY ::?488}q TXXa[C%7488}q TXXa[C%7rcNUR(aURSS;agg)NrABCDEFGTFr'r(s risNoteMuseDataRecord.isNotets 88 y0rc[UR5S:a'URSS:XaURSS;agg)zz Chords are specified as additional note records following a main chord tone. The blank space defines this as chord tone. r,r r5TFr1rr(s risChordMuseDataRecord.isChordys8 txx=1 !!3 y8PrcNUR(aURSS;agg)NrcgTFr'r(s r isCueOrGraceMuseDataRecord.isCueOrGraces 88 t+rc^[UR5S:aURSSS:Xagg)zE >>> mdr = musedata.MuseDataRecord('back 4') >>> mdr.isBack() True rbackTFr:r(s risBackMuseDataRecord.isBacks+ txx=A $((1Q-6"9rcXUR5(a!URSSR5SnOVUR5(dUR 5(a!URSSR5SnO [ S5eUS/nSU;aUR S5 OGSU;aUR S5 O/SU;aUR S5 OS U;aUR S 5 [R"U5up4UR U5 S RU5$) z >>> 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' rNr,z4cannot get pitch parameters from this kind of record#z##fr.ffz--) r6rsplitr?r;rappendr getNumFromStrjoin)r"datapStrnumbersjunks r_getPitchParameters"MuseDataRecord._getPitchParameterss ;;==88AB<%%'*D    DLLNN88AB<%%'*D#$Z[ [Qy $; KK  T\ KK  D[ KK  T\ KK ,,T2  Gwwt}rcSSKJn [UR5S::agURSnSnUS:XaUR S5nOUS:XaUR S5nOUS :XaUR S 5nOwUS :XaUR S 5nO_US :XaUR S 5nOGUS:XaUR S5nO/US:XaUR S5nOUS:XaUR S 5nUbSUlSUlU$)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 rpitchNrGsharpnnaturalrHflatxz double-sharpX&z double-flatSFalwaysT)music21rWr1r Accidental displayType displayStatus)r"rWrOaccs r_getAccidentalObject#MuseDataRecord._getAccidentalObjects " txx=B xx| 3;""7+C S[""9-C S[""6*C S["">2C S["">2C S[""=1C S[""7+C S[""6*C ?'CO $C  rcjSSKJn UR5nURU5nURS:XaU$UR 5nUR bSUR lUbUR 5UlUR b&UR5(aSUR lU$)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' rrVr,FT) rcrWrSPitchrrh accidentalrf _accidentalhasCautionaryAccidental)r"rWppprgs rgetPitchObjectMuseDataRecord.getPitchObjects0 "  % % ' KKO ::?H++-C||'.3 * $ 9 9 ; ||'D,H,H,J,J-1 *HrcURS:Xa[URSS5nO[URSS5nURSSnUS:wa/[U5nUSU-- n[SUR-S -5 UR b(UR R R5nX%- $UbUnX%- $[ S 5e![a [ SUR-S -5ef=f) 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 r,r-r/rBr9dzError in parsing: z> Column 5 must be blank. Parsing as a part of the divisionsz Column 5 must be blank.zMcannot access parent container of this record to obtain divisions per quarter)rintrprint ValueErrorrrgetDivisionsPerQuarterNote)r"divisionsPerQuarterNote divisions shouldBeBlank divHundredsdpqs rgetQuarterLengthMuseDataRecord.getQuarterLengths( ::?DHHQqM*IDHHQqM*I1 C  V!-0 S;.. *!YZ[ ;; "++$$??AC  % 0)C$%HI I V'(48836TTVV Vs .C&C5cURS:Xag[UR5S:a(URSS:XagURSS:Xagg)Nr,.:rr0r(s rgetDotsMuseDataRecord.getDotsKsI ::?488}r!88B<3&88B<3&rcSnURS:Xag[UR5S:agURSSnURS5Vs/sHo3R 5PM nnU$s snf)z Return lyrics as a list. >>> mdr = musedata.MuseDataRecord('D4 2 e u con-') >>> mdr.stage = 2 >>> mdr.getLyrics() ['con-'] Nr,,+|)rr1rrKstrip)r"rOrawr]s r getLyricsMuseDataRecord.getLyricsase ::?488}r!((23-C'*yy~6~!GGI~D6 7sA-cpURS:XagURSSnUS:XagUR5$)aA 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 r,NrJ)rrrstripr"rOs rgetBeamsMuseDataRecord.getBeamsvs7 ::?88Br?Drz;;= rcURS$![a Of=f[UR5S:aSnO/nSnUS::a]U[UR5:aDUR URU5 US- nUS::aU[UR5:aMDSR U5R 5nXRS'U$)ar 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*r,rJ)r KeyErrorr1rrLrNr)r"rO data_listis rr&MuseDataRecord._getAdditionalNotationss" ;;89 9    txx=2 DIAr'a#dhh-/  !-Qr'a#dhh-/779%++-D15 -. s  cSSKJn /nUR5nUcU$UGH>nUS:Xa!URUR 55 M+US:Xa!URUR 55 MRUS:Xa!URUR 55 MyUS:Xa!URUR 55 MUS:Xa!URUR55 MUS:Xa!URUR55 MUS :Xa"URUR55 GMUS :XdGMURUR55 GMA U$) au 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) articulationsAV>r_=r,) rcrrrL StrongAccentAccentStaccatoTenutoDetachedLegatoSpiccato BreathMark)r"rpostrOchars rgetArticulationObjects%MuseDataRecord.getArticulationObjectss *++- <KDs{ M6689 M6689 M0023 M2245 M0023 M88:; M2245 M4467'( rcSSKJn /nUR5nUcU$UHnUS:Xa!URUR 55 M*US:Xa!URUR 55 MQUS:Xa!URUR 55 MxUS:Xa!URUR 55 MUS:XdMURUR55 M U$)aI 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) expressionsraEtr&M)rcrrrLFermataTrillTurnMordent)r"rrrOrs rgetExpressionObjects#MuseDataRecord.getExpressionObjectss (++- <KDs{ K//12 K//12 K--/0 K,,./ K//12 rcDSSKJn /nUR5nUcU$SnUHnURU5nUS:aMUSUX6[ U5-S-nUS;a"UR UR U55 MZUS:Xa"UR UR S55 MUS:Xa"UR UR S 55 MUS :Xa"UR UR S 55 MUS :XdMUR UR S 55 M U$) 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) pppfffrorIfpmpmfrprHmZZpR) rrrorIrprHrrrrrrsfrr)rcrrfindr1rLDynamic)r"rrrOtargetstargetposs rgetDynamicObjects MuseDataRecord.getDynamicObjectss  %++- <K3F))F#CQw:3v;%6%7 88DOO H,,V453 H,,T233 H,,T234 H,,T233 H,,T23!$ rc:UR5nUcgSU;agg)a 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 F+T)rrs rrn&MuseDataRecord.hasCautionaryAccidental(s'++- < $;r)r rrr)rJN)rstr)returnboolr)rz str | None)rrrr__doc__r#r)r2r6r;r?rDrSrhrqrrrrrrrrrnrrrrrr9s~ . ." ,  $L0d0d-^ ,*!6"H&P D'Rrrc*\rSrSrSrSrSrSrSrg)MuseDataRecordIteratori@z3 Create MuseDataRecord objects on demand, in order c*XlSUlX lgNr)rindexrr!s rr#MuseDataRecordIterator.__init__Es  rcU$rrr(s r__iter__MuseDataRecordIterator.__iter__J rcUR[UR5:a[e[ URURUR 5nU=RS- slU$Nr,)rr1r StopIterationrrr"mdrs r__next__MuseDataRecordIterator.__next__MsK ::TXX & TXXdjj14;;? a  r)rrrN rrrrrr#rrrrrrrr@s rrcL\rSrSrSrS SjrSrSrSrSr S r S r S r S r g)MuseDataMeasureiXa 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. NcUc/nXlX lURbURRUlgSUlgr)rrrr!s rr#MuseDataMeasure.__init__cs8 ;C ;; "**DJDJrcg)Nzsize={len(self.src)}rr(s r _reprInternalMuseDataMeasure._reprInternalqs%rcSSKJn URSR5nUSS:waSnUSSnUS:XaSnODUS :XaS nO;US :XaS nO2US ;aS nO)US:XaSnO US:XaSnOUS;aSnO[ SU35eUR U5n[ U5S:afUSSR5S:waOUSSR5nSU;aSnURSS9nXElU$SU;aSnURSS9nXElU$)zu Return a configured music21 bar object. This can be used with the current Measure or applied to a previous Measure. r)barrmeasurer,r-easureregulardotteddoublez light-light)heavy1heavyrheavy2z light-heavyheavy3z heavy-light)heavy4heave4z heavy-heavyz$cannot process bar data definition: NrJz:|end) directionz|:start) rcrrrrBarliner1Repeattype)r"rrOdataBar barlineTypebldataFlagunused_repeatForms r getBarObjectMuseDataMeasure.getBarObjectts= xx{  " 7c>Dq) h #K  "K  'K + +!K  'K  'K , ,'K#&J7)$TU U [[ % t9r>d23ioo/25BCy(Hx$(!ZZ%Z0%  !$(!ZZ'Z2% rcXSSKJn URSR5nUSS:waSnSn[ U5S:a/USSR5S :wa[ R "U5up4UR5nUR5Ul US :wa[U5Ul U$) z? Return a configured music21 :class:`~music21.stream.Measure`. r)streamrr1 r/NrJ) rcr rrr1r rMMeasurer leftBarlinervnumber)r"r rOmNumberrRrs rgetMeasureObject MuseDataMeasure.getMeasureObjects #xx{  " 7c>D t9>d12hnn."4"006MG NN ))+  b=7|AHrcRURHnU(dM USS;dM g g)z* Return True of if this Measure has Notes r ABCDEFGrgcTFr'r"lines rhasNotesMuseDataMeasure.hasNotess*HHDtQ</rclURH$nU(dM URS5(dM$ g g)z Return True of if this Measure defines one or more 'back' indication. Note: this does not instantiate MuseDataRecord instances. rCTFr startswithrs r hasVoicesMuseDataMeasure.hasVoicess- HHDt//rc.[URU5$z: Iterating over this part returns MuseDataMeasure objects )rrr(s rrMuseDataMeasure.__iter__s&dhh55rc[U5$)zH Return a list of all records stored in this measure as MuseDataRecord. listr(s r getRecordsMuseDataMeasure.getRecordsDzr)rrrNN)rrrrrr#rrrrrrr%rrrrrrXs0 &.`4 6 rrc*\rSrSrSrSrSrSrSrg)MuseDataMeasureIteratoriz4 Create MuseDataMeasure objects on demand, in order c6XlX lSUlX0lgr)r boundariesrr)r"rr,rs rr# MuseDataMeasureIterator.__init__s$  rcU$rrr(s rr MuseDataMeasureIterator.__iter__rrcUR[UR5:a[eURURup[ UR XS-UR 5nU=RS- slU$r)rr1r,rrrr)r"rrmdms rr MuseDataMeasureIterator.__next__s` ::T__- - __TZZ0 dhhu1W5t{{C a  r)r,rrrNrrrrr*r*s rr*c\rSrSrSrS$SjrSrSrSrSr S%S jr S r S r S r S rSrSrSrSrS&SjrS&SjrSrSrSrSrSrSrSrS'SjrSrSrSrS(Sjr S r!S!r"S"r#S#r$g)) MuseDataPartiz3 A MuseData part is defined by collection of lines NcUc/nXl/UlSUlSUlX lURc&UR(aUR 5UlURS:Xa!UR UR5Ulggr)r_measureBoundaries_divisionsPerQuarter_divisionsPerQuarterNoter_determineStage _scrubStage1)r"rrs rr#MuseDataPart.__init__sx ;C#%$(!)-% :: $((--/DJ ::?((2DH rcgNrJrr(s rrMuseDataPart._reprInternalrcZURHnURS5(dM g g)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. $rr,r)r" attributes rr9MuseDataPart._determineStages+ I##C(("rc[U5S::a [S5eSn/nUH3nU(aUR5S:XaM SnURU5 M5 U$)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. r,zcannot scrub empty sourceTrJF)r1rrrL)r"rcheckrrs rr:MuseDataPart._scrubStage1!s[ s8q=#$?@ @D::<2%!E KK   rcv/nX!;aURU5[U5-nU[U5:avXR5(aURX5 O5XR 5(aOXS;aURX5 OOUS- nU[U5:aMvSR U5$)ar >>> 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-/r,rJ)rr1isdigitrLisspacerN)r"rtagrrs r_getDigitsFollowingTag#MuseDataPart._getDigitsFollowingTag5s ; #S)Ac$i-7??$$KK(W__&&W_KK(Qc$i-wwt}rc6U(d UR5nUR5n/nX!;aURU5[U5-nU[U5:aXR5(aUR X5 OnXR 5(aU(dOOXR 5(aU(aUR X5 OXS;aUR X5 OOUS- nU[U5:aMSR U5$)z >>> mdp = musedata.MuseDataPart() >>> mdp._getAlphasFollowingTag('Group memberships: sound, score', 'Group memberships:') 'sound,score' rr,rJ)lowerrr1isalpharLrIrN)r"rrJ keepSpacekeepCaserrs r_getAlphasFollowingTag#MuseDataPart._getAlphasFollowingTagSs::>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getWorkNumber() '581' r,rrrBzWK#:)rrrrKrKrs r getWorkNumberMuseDataPart.getWorkNumberosg ::?88A;q#))+Dd{zz#q)K..txx{FC CrcURS:Xa URSSSR5$URURSS5$)z 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' r,rUNrBzMV#:)rrrrKr(s rgetMovementNumberMuseDataPart.getMovementNumbersG ::?88A;qr?((* *..txx{FC CrcURS:XagUR5nURUSSSS9nUS:XagUR5$)aU 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 r,NzD:T)rPrQrJ)r_getAttributesRecordrRr)r"ralphass r getDirectiveMuseDataPart.getDirectivesU ::?,,.D00tt:>1@F|||~%rc URS:Xae/nURSURSURS4H"nURUR55 M$ SR U5$URS$)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' r,rrBrJrt)rrrLrrN)r"rOrs r getSourceMuseDataPart.getSourcesn: ::?D!dhhqk488A;? DJJL)@774= 88A; rczURS:XaURSR5$URS$)a 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' r,rrUrrrr(s r getWorkTitleMuseDataPart.getWorkTitles4 ::?88A;$$& &88A; rcBURS:XagURS$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getMovementTitle() 'Trio II' r,Nr-)rrr(s rgetMovementTitleMuseDataPart.getMovementTitles  ::?88A; rc^URS:XagURSR5$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getPartName() 'Clarinet in A' r,Nr/rer(s r getPartNameMuseDataPart.getPartNames) ::?88A;$$& &rcURS:Xa/$URURSS5n/nURS5H8nUR 5S:wdMUR UR 55 M: U$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getGroupMemberships() ['sound', 'score'] r, zgroup memberships:rrJ)rrRrrKrrL)r"rrentrys rgetGroupMemberships MuseDataPart.getGroupMembershipssp ::?I--dhhrl.BDCD3;;=B&KK .(KrcURS:Xa*[URSRS5S5$SnSnURUR S5(dbURUnUR U5(aUR US5nO*US- nURUR S5(dMbUcg[U5$) z >>> fp1 = str(common.getSourceFilePath() /'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getGroupMembershipsTotal() 5 r,rtr9r NrAof)rrvrrKrrKr" membershiprrrs rgetGroupMembershipsTotal%MuseDataPart.getGroupMembershipsTotals ::?txx{((-a01 1AChhqk,,S11xx{??:..55dDACQ hhqk,,S11 {3xrcURS:Xa!URSRS5S$SnSnURURS5(dbURUnURU5(aUR US5nO*US- nURURS5(dMbUcg[ U5$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getGroupMembershipNumber() 1 r,rtr9rtNrApart)rrrKrrKrvrvs rgetGroupMembershipNumber%MuseDataPart.getGroupMembershipNumber0s ::?88A;$$S)!, ,AChhqk,,S11xx{??:..55dFCCQ hhqk,,S11 {3xrc^URS:Xa@URSR5S-URSR5-nU$SnURURS5(d*US- nURURS5(dM*URU$)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' r,rUr9r-rtrA)rrrr)r"recordrs rr\!MuseDataPart._getAttributesRecordJs ::?XXa[&&(3.!1B1B1DDFMAhhqk,,S11Qhhqk,,S1188A; rcUR5nURS:Xa[URS5S5$[UR US55$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getKeyParameters() 0 r,r9zK:r\rrvrKrKrs rgetKeyParametersMuseDataPart.getKeyParametersbsO((* ::?tzz#q)* *t224>? ?rcLSSKJn URUR55$)a >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getKeySignature() r)key)rcr KeySignaturer)r"rs rgetKeySignatureMuseDataPart.getKeySignaturers!  5 5 788rc\UR5nURS:Xa;[URS5S5n[URS5S5nO8UR US5RS5up#[U5[U5p2US:XaUS:XdUS:XagUSU3$) z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getTimeSignatureParameters() '3/4' r,r9rBrtzT:/rz4/4r)r"rrZds rgetTimeSignatureParameters'MuseDataPart.getTimeSignatureParameters~s((* ::?DJJsOA&'ADJJsOA&'A..tT:@@EDAq63q6q FqAv!q&S!: rcLSSKJn URUR55$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getTimeSignatureObject() r)meter)rcr TimeSignaturer)r"rs rgetTimeSignatureObject#MuseDataPart.getTimeSignatureObjects! """4#B#B#DEErcURS:XagUR5nURUS5nUS:Xag[U5$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0]._getNumberOfStaves() 1 r,zS:rJ)rr\rKrvr"rrs r_getNumberOfStavesMuseDataPart._getNumberOfStavessE ::?,,.D--dD9Cby3xrc|UR5nURS:XaURS5SnU/$/nURUS5nUS:waUR U5 US:XaS[ SUR 5S-5H2nURUSUS35nUS:wdM!UR U5 M4 U$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0]._getClefParameters() ['4'] r,r9r/zC:rJCr)r\rrKrKrLranger)r"rrOrrrs r_getClefParametersMuseDataPart._getClefParameterss((* ::?::c?1%D6MD--dD9Cby C byq$"9"9";a"?@A55das!HECby C(AKrcURS:XagUR5US- n[[U55nSSKJn US:XaUR 5$US:XaUR5$US:XaUR5$US:XaUR5$US :XaUR5$US :XaUR5$US :XaUR5$US :XaUR5$US :XaUR5$US:XaUR5$US:XaUR!5$US:XaUR#5$US:XaUR%5$US:XaUR'5$[)SU5e)a! 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' r,Nr)clef5434643111213141522235282zcannot determine clef from:)rrrrvrcrFrenchViolinClef TrebleClef Treble8vbClef Treble8vaClef GSopranoClef CBaritoneClef TenorClefAltoClefMezzoSopranoClef SopranoClefBassClef FBaritoneClef Bass8vbClef Bass8vaClefr)r"voicecharPairrs r getClefObjectMuseDataPart.getClefObjects ::?..0;H3x=)H $3,,..S((T!))++T!))++S((**T!))++T!~~''T!}}&T!,,..T!''))T!}}&T!))++T!''))T!''))'(ExPPrcUR5nURS:XagURUS5nUS:Xag[U5$)a 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 r,NzX:rJ)r\rrKrvrs r_getTranspositionParameters(MuseDataPart._getTranspositionParameterssE"((* ::?--dD9Cby3xrcVUR5nUcg[R"U5$)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 rgetTranspositionIntervalObject+MuseDataPart.getTranspositionIntervalObject+s+//1 <//5 5rc`URcUR5nURS:XaV[UR S5S5nUR 5nX#R R- UlUR$[URUS55UlUR$)z >>> fp1 = (common.getSourceFilePath() / 'musedata' / 'testPrimitive' ... / 'test01' / '01.md') >>> mdw = musedata.MuseDataWork() >>> mdw.addFile(fp1) >>> mdw.getParts()[0].getDivisionsPerQuarterNote() 6 r,r9rzQ:) r8r\rrvrKr barDuration quarterLengthrK)r"rrOtss rry'MuseDataPart.getDivisionsPerQuarterNote@s  ( ( 0,,.DzzQ4::c?1-.00215~~7S7S0S-,,,14//d;1=-,,,rcbUc URn/n/nSn[U5S- nURS:XaC[U5H.upgUR S5(dMUR U5 M0 USnOgSn[U5HVupgUR S5(aUS- nM"US:aUcUnUR S5(dMEUR U5 MX Sn USU:XaG[U5S:XaUR USU45 Sn O9UR USUSS- 45 Sn OUR XCSS- 45 Sn U bb[ U [U55HInU[U5S- :XaUR X6U45 M,UR X6X6S-S- 45 MK U$)ad >>> 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)] Nr,rrrA)rr1r enumeraterrLr) r"rr,mIndicesfirstPostAttributesIndex lastIndexrrmAttributeRecordCountstartIterIndexs r_getMeasureBoundaryIndices'MuseDataPart._getMeasureBoundaryIndices`s ;((C #' HqL ::?$S>??3''OOA&*(0{ $%& !$S>??3'')Q.)(1,1I1Q/0,??3''OOA&* A;2 28}!!!8A; ":;!%!!8A; a"@A!"   7!qI JN  %>3x=9H ))%%x{I&>?%%x{HUOa4G&HI :rcXUR5UlUR5Ulg)z After setting the source string, this method must be called to configure the _measureNumberToLine method and set additional attributes. N)ryr7rr6r(s rupdateMuseDataPart.updates& %)$C$C$E!"&"A"A"CrcD[URURU5$r )r*rr6r(s rrMuseDataPart.__iter__s'txx1H1H$OOrc[U5$)zO Return a list of all measures stored in this part as MuseDataMeasure objects. r#r(s r getMeasuresMuseDataPart.getMeasuresr'r)r7r8r6rrr()FF)score)r,r)%rrrrrr#rr9r:rKrRrVrYr^rbrfrirlrqrxr|r\rrrrrrrrrryrrrrrrrrr4r4s3( (<;@(-8D,D"&0%N"  '( 4 40@ 90 F * D5Qn 66*-@@DDP rr4c@\rSrSrSrS SjrSrSrSrSr Sr S r g ) MuseDataFileiz 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. c</UlSUlSUlSUlgNzutf-8)partsfilenamefileencodingr(s rr#MuseDataFile.__init__s)+ "& %) $ rcgr=rr(s rrMuseDataFile._reprInternalr?rc2[US5UlXlg)Nrb)openrr)r"rs rrMuseDataFile.opensTN  rcURR5nURUR5nUR U5$![a URSS5nN/f=f)Nz ISO-8859-1ignore)rreaddecoderUnicodeDecodeErrorreadstr)r" fileContentss rrMuseDataFile.readsbyy~~'  G'..t}}=L||L))" G'..|XFL GsAA'&A'c8URR5 gr)rcloser(s rrMuseDataFile.closes rcSn/nURS5n[U5HupVURS5(aU(aSnM&SnM*U(aM3U(a USS:XaMEURS5(dURS5(aM[U5S ::a/nM[ U5nUR 5 UR RU5 /nMURS 5(aMURU5 M g ) z3 Read a string, dividing it into individual parts. F r_Tr@z/ENDENDr,z/eofN)rKrrr1r4rrrL)r" input_str commentTogglelinessrcLinesrrmdps rrMuseDataFile.readstrs ??4( *GAs## $)M$(M$q'S.((DOOE,B,Bu:?E"5)  !!#&(( T"C+r)rrrrNrNone) rrrrrr#rrrrrrrrrrrs%% *-#rrc8\rSrSrSrS SjrS SjrSrSrSr g) MuseDataWorki z, A work might consist of one or more files. c /UlSUlgr)filesrr(s rr#MuseDataWork.__init__s)+ $ rc\[R"U5(d[R"[U5nU/nOUnUHjn[ 5nUR UlURU5 UR5 UR5 URRU5 Ml g)zZ Open and read this file path or list of paths as MuseDataFile objects and set self.files N) r isIterablercastrrrrrrrrL)r"r fp_singlefpListfpInnermdfs raddFileMuseDataWork.addFiles|   $$sBI[FFG.C==CL HHW  HHJ IIK JJ  c "rc[R"U5(dU/nOUnUH9n[5nURU5 URR U5 M; g)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)r r rrrrL)r"rstrList thisStringrs r addStringMuseDataWork.addString+sP"  ++ kGG!J.C KK # JJ  c ""rcx/nURH'nURHnURU5 M M) U$)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 rgetPartsMuseDataWork.getPartsHs8::Cyy C ! r)rrNr)rzstr | Iterable[str]rr) rrrrrr#rrrrrrrrr s%#*#: rrc4\rSrSrSrSrSrSrS SjrSr g) MuseDataDirectoryiWaD 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. cB/Ul0UlURU5 gr)pathsgroups_prepareGroups)r" dirOrLists rr#MuseDataDirectory.__init__bs   I&rc./n[R"U5(aUnO[RR U5(aU[ [R "U55H1nUR[RRX55 M3 O [SU5eUHwn[RRU5upSURU5(dM<[R"U5upgUS:XaM\URRU5 My /n[UR5S:a[UR5Houp[RRU5upS[R"U5upgUS:wdMFUR!S5(dM^URU 5 Mq UR#5 UHn URR%U 5 M OURR'5 g)Nz*cannot get files from the following entityrJr,s)r r ospathisdirsortedlistdirrLrNrrKisMusedataFilerMrr1rrreversepopsort) r"r allPathsfnrunused_directorynumStr nonNumStrpopListrs rr MuseDataDirectory._prepareGroupshs   Y ' '!HWW]]9 % %RZZ 23 Y ;<4$$PR[\ \B#%77==#4 &&r** & 4 4R 8 F| !!"% tzz?Q "4::.')ww}}R'8$ $*$8$8$<!R>@%H >>@!Drch[[R"5S- S- S- 5n[U5ng)Nr rArB)rr rGr)r"fpDir unused_mdds rtestMuseDataDirectoryTest.testMuseDataDirectory<s1F,,.;oMPXXY&u- rc8[S5nSUlURUR5S/5 [S5nSUlURUR5S/5 [S5nSUlURUR5SS/5 g)Nz/D4 2 e u con-rzcon-z,F#4 2 e u aaz0F#4 2 e u a | bb)rrrHrrs r testGetLyricsTest.testGetLyrics]sNO  6(3KL  3%0OP  3*5rrN)rrrrrMrRrWrrrrr?r?s@9En.B 6rr?__main__)$r __future__rcollections.abcrr$typingrunittestrcrrmusic21.musedatarrr r r Environment environLocalMusic21ExceptionrProtoM21Objectrrrr*r4rrrTestCaser? _DOC_ORDERrmainTestrrrrfs" #$  &#&&&z2  55 BW++BN0Dg,,DP4z 7))z |Q#7))Q#jF7))FTi..i\c68  c6h^  z Tr