rhSrSSKJr SSKrSSKrSSKrSSKrSSKrSSK J r SSK J r SSK J r SSK J r SSK Jr SS K Jr SS K Jr SS K Jr SS K Jr SS K Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSKJ r SSKJ!r! SSKJ"r" \RF(aSSK$r$\RJ"S5r&SS0r'/SQr("S S!\RR5r*"S"S#\RV5r,"S$S%\,5r-"S&S'5r."S(S)\.5r/"S*S+\.5r0"S,S-\.5r1"S.S/\RV5r2"S0S1\RV5r3"S2S3\35r4"S4S5\35r5"S6S7\35r6"S8S9\RV5r7"S:S;\RV5r8"S<S=5r9S>r:SNS?jr;S@r<"SASB\ Rz5r>"SCSD\ Rz5r?"SESF\ Rz5r@"SGSH\ Rz5rA"SISJ\R5rC"SKSL\R5rD\ESM:XaSSK r \ R"\C5 gg)Oa music21.humdrum.spineParser is a collection of utilities for changing native humdrum code into music21 streams. Most music21 users will simply want to call: >>> #_DOCS_SHOW myFile = converter.parse('myFile.krn') >>> #_DOCS_SHOW myFile.show() The methods in here are documented for developers wishing to expand music21's ability to parse humdrum. SpineParsing consists of several steps. * The data file is read in and all events are sliced horizontally (EventCollections) and vertically (Protospines) * Protospines are parsed into HumdrumSpines by following Spine Path Indicators (:samp:`*^` and :samp:`*v` especially) Protospines that separate become new Protospines with their parentSpine indicated. Protospines that merge again then followed by the same Protospine as before. This will cause problems if a voice re-merges with another staff, but in practice I have not seen a .krn file that does this and should be avoided in any case. * HumdrumSpines are reclassed according to their exclusive definition. :samp:`**kern` becomes KernSpines, etc. * All reclassed HumdrumSpines are filled with music21 objects in their .stream property. Measures are put into the spine but are empty containers. The resulting HumdrumSpine.stream objects look like Stream.semiFlat versions in many ways. * For HumdrumSpines with parent spines their .stream contents are then inserted into their parent spines with voice tagged as a music21 Group property. * Lyrics and Dynamics are placed into their corresponding HumdrumSpine.stream objects * Stream elements are moved into their measures within a Stream * Measures are searched for elements with voice groups and Voice objects are created ) annotationsN) articulations)bar)base)chord)clef)common)dynamics)duration) environment) exceptions21) expressions) instrument)key)note)meter)metadata)roman)prebase)stream)tempo)tie) testFiles) harmparser) instrumentszhumdrum.spineParserJRPF)z*+*-*^*v*x*c\rSrSrSrSrg)HumdrumExceptionZz: General Exception class for problems relating to Humdrum N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r%U/home/james-whalen/.local/lib/python3.13/site-packages/music21/humdrum/spineParser.pyr#r#Zs  r,r#ch\rSrSrSrSSjrSrSrSSjrSr SS jr S r SS jr S r SS jrSrg)HumdrumDataCollectionaa A HumdrumDataCollection takes in a mandatory list where each element is a line of humdrum data. Together this list represents a collection of spines. Essentially it's the contents of a humdrum file. Usually you will probably want to use HumdrumFile which can read in a file directly. This class exists in case you have your Humdrum data in another format (database, from the web, etc.) and already have it as a string. You are probably better off running humdrum.parseFile("filename") which returns a humdrum.SpineCollection directly, or even better, converter.parse('file.krn') which will just give you a stream.Score instead. LIMITATIONS: (1) Spines cannot change definition (\*\*exclusive interpretations) mid-spine. So if you start off with \*\*kern, the rest of the spine needs to be \*\*kern (actually, the first exclusive interpretation for a spine is used throughout) Note that, even though changing exclusive interpretations mid-spine seems to be legal by the humdrum definition, it looks like none of the conventional humdrum parsing tools allow for changing definitions mid-spine, so I don't think this limitation is a problem. (Craig Stuart Sapp confirmed this to me) The Aarden/Miller Palestrina dataset uses `\*-` followed by `\*\*kern` at the changes of sections thus some parsing of multiple exclusive interpretations in a protospine may be necessary. (2) Split spines are assumed to be voices in a single spine staff. NcSUlSUlSUlSUlSUlSUlSUlUbU(d[S[U5-5eUc/nO%[U[5(aUR5nXl SUl g)NzAdataStream is not optional, specify some lines: dataStream was: ) eventList maxSpinesparsePositionInStream fileLength protoSpineseventCollectionsspineCollectionr#repr isinstancestr splitlines dataStreamr)selfr=s r-__init__HumdrumDataCollection.__init__s%)" $#  !*"$8:>z:J$KL L  J  C ( (#..0J$ r,cURnUc [S5eURU5up#USLaURU5$UR U5$)z Parse a list (dataStream) of lines into a HumdrumSpineCollection (which contains HumdrumSpines) and set it in self.spineCollection if dataStream is None, look for it in self.dataStream. If that's None too, return an exception. +Need a list of lines (dataStream) to parse!T)r=r#determineIfDataStreamIsOpusparseOpusDataCollections parseNonOpus)r>r=hasOpusdataCollectionss r-parseHumdrumDataCollection.parses[__  "#PQ Q#'#C#CJ#O  d?00A A$$Z0 0r,c[R"5UlSUlSUlUR U5 URUR :XdeUR5 UR5Ul URR5 UR5 URH*nS[UR5-URlM, URHInURbMUR S:XdM$URR#UR5 MK UR%5 g![ a [S5ef=f)z8 The main parse function for non-opus data collections. rzr= thisSpines r-rE"HumdrumDataCollection.parseNonOpuss%lln &'" ))*5 c--@ @@ 002#779 113 !--I"*S->">I   .--I$$,1D1D1N ""9#3#34.  c"#ab b cs E E!cUc URn/n/n[U5HsupEUR5n[R"SU5(aUR U5 MD[R"SU5(dMbUR U5 Mu [ U5S:agUSUS:aOUR [ U55 /n[[ U55H{nUS:XaX4nUR USUS-5 M&U[ U5S- :XaX4S- S-nUR XS5 MWX4S- S-nX4S-nUR XU5 M} [ U5S:aS U4$[S 5e) a Some Humdrum files contain multiple pieces in one file which are better represented as :class:`~music21.stream.Opus` file containing multiple scores. This method examines that dataStream (or self.dataStream) and if it only has a single piece then it returns (False, None). If it has multiple pieces, it returns True and a list of dataStreams. >>> from pprint import pprint as pp >>> mps = humdrum.testFiles.multipartSanctus >>> hdc = humdrum.spineParser.HumdrumDataCollection(mps) >>> (hasOpus, dataCollections) = hdc.determineIfDataStreamIsOpus() >>> hasOpus True >>> pp(dataCollections) [['!!!COM: Palestrina, Giovanni Perluigi da', '**kern\t**kern\t**kern\t**kern', '*Ibass\t*Itenor\t*Icalto\t*Icant', '!Bassus\t!Tenor\t!Altus\t!Cantus', '*clefF4\t*clefGv2\t*clefG2\t*clefG2', '*M4/2\t*M4/2\t*M4/2\t*M4/2', '=1\t=1\t=1\t=1', '0r\t0r\t1g\t1r', '.\t.\t1a\t1cc', '=2\t=2\t=2\t=2', '0r\t0r\t1g\t1dd', '.\t.\t1r\t1cc', '*-\t*-\t*-\t*-'], ['!! Pleni', '**kern\t**kern\t**kern', '*Ibass\t*Itenor\t*Icalto', '*clefF4\t*clefGv2\t*clefG2', '*M4/2\t*M4/2\t*M4/2', '=3\t=3\t=3', '1G\t1r\t0r', '1A\t1c\t.', '=4\t=4\t=4', '1B\t1d\t1r', '1c\t1e\t1g', '*-\t*-\t*-'], ['!! Hosanna', '**kern\t**kern\t**kern\t**kern', '*Ibass\t*Itenor\t*Icalto\t*Icant', '*clefF4\t*clefGv2\t*clefG2\t*clefG2', '*M3/2\t*M3/2\t*M3/2\t*M3/2', '=5\t=5\t=5\t=5', '1r\t1r\t1g\t1r', '2r\t2r\t[2a\t[2cc', '=5\t=5\t=5\t=5', '1r\t1r\t2a]\t2cc]', '.\t.\t2f\t1dd', '2r\t2r\t2g\t.', '*-\t*-\t*-\t*-']] Nz ^(\*-\t)*\*-$z^(\*\*\w+\t)*\*\*\w+$)FNrTzMalformed humdrum data: possibly multiple **tags without closing information. Or a *tandem tag accidentally encoded as a **spine tag.) r= enumeraterstripresearchappendlenranger#) r>r=startPositions endPositionsilinerGendPosstartPoss r-rC1HumdrumDataCollection.determineIfDataStreamIsOpussv  J  ,GA;;=Dyy)400##A&3T::%%a( - ~  "  nR0 0    J 0s<()AAv%&&z+6A:'>?c,'!++'A.2&&z)'<=(A.2%1,&&z6'BC*  ! #/* *";< >> mps = humdrum.testFiles.multipartSanctus >>> hdc = humdrum.spineParser.HumdrumDataCollection(mps) >>> (hasOpus, dataCollections) = hdc.determineIfDataStreamIsOpus() >>> if hasOpus is True: ... op = hdc.parseOpusDataCollections(dataCollections) ... print(len(op.scores)) ... for sc in op.scores: ... print(sc) 3 section_r^r) rOpusr_r/rHr;rTrnumberrccopydeepcopyscores)r>rGopusrhdchdcscs r-rD.HumdrumDataCollection.parseOpusDataCollections4s&{{}/EA'+C IIKBQU+BE!"QBKK  KKO 0  MM$++a.*A*ABDM#$DMM   r,cUcURnUc [S5eSUl/UlUGHnUR 5nUS:XaM[ R "SU5(a0URR[URU55 O[ R "SU5(a0URR[URU55 OV[URU5n[URUR5Ul URRU5 U=RS- slGM" URUlUR$)a Sets self.eventList from a dataStream (that is, a list of lines). It sets self.maxSpines to the largest number of spine events found on any line in the file. It sets self.fileLength to the number of lines (excluding totally blank lines) in the file. The difference between the dataStream and self.eventList are the following: * Blank lines are skipped. * !!! lines become :class:`~music21.humdrum.spineParser.GlobalReferenceLine` objects * !! lines become :class:`~music21.humdrum.spineParser.GlobalCommentLine` objects * all other lines become :class:`~music21.humdrum.spineParser.SpineLine` objects Returns eventList in addition to setting it as self.eventList. >>> eventString = ('!!! COM: Beethoven, Ludwig van\n' + ... '!! Not really a piece by Beethoven\n' + ... '**kern\t**dynam\n' + ... 'C4\tpp\n' + ... 'D8\t.\n') >>> hdc = humdrum.spineParser.HumdrumDataCollection(eventString) >>> hdc.maxSpines = 2 >>> eList = hdc.parseEventListFromDataStream() >>> eList is hdc.eventList True >>> for e in eList: ... print(e) >>> print(eList[0].value) Beethoven, Ludwig van >>> print(eList[3].spineData) ['C4', 'pp'] rBrz!!!!!r^)r=r#r4r2r`ramatchrcGlobalReferenceLineGlobalCommentLine SpineLinemaxr3 numSpinesr5)r>r=rithisLines r-rN2HumdrumDataCollection.parseEventListFromDataStreamWs!V  J!&'TUU%&"D;;=Drz&$''%%&9$:T:TVZ&[\%&&%%&78R8RTX&YZ$T%?%?F!$T^^X5G5G!H%%h/  & &! + & &44~~r,c^^^TR(dTR5 /n/m/mUUU4Sjn[TR5Hmn/m[TR5H5nUS:Xa$TR [ TR55 U"XC5 M7 UR [T55 Mo UTlTTl UT4$)a Run after :meth:`~music21.humdrum.spineParser.HumdrumDataCollection.parseEventListFromDataStream()` to take self.eventList and slice it horizontally to get self.eventCollections, which is a list of EventCollection objects, or things that happen simultaneously. And, more importantly, this method slices self.eventList vertically to get self.protoSpines which is a list of ProtoSpines, that is a vertical slice of everything that happens in a column, regardless of spine-path indicators. EventCollection objects store global events at the position. ProtoSpines do not. So self.eventCollections and self.protoSpines can each be thought of as a two-dimensional sheet of cells, but where the first index of the former is the vertical position in the dataStream and the first index of the latter is the horizontal position in the dataStream. The contents of each cell is a SpineEvent object or None (if there's no data at that point). Even '.' (continuation events) get translated into SpineEvent objects. Calls :meth:`~music21.humdrum.spineParser.parseEventListFromDataStream` if it hasn't already been called. returns a tuple of protoSpines and eventCollections in addition to setting it in the calling object. >>> eventString = ('!!!COM: Beethoven, Ludwig van\n' + ... '!! Not really a piece by Beethoven\n' + ... '**kern\t**dynam\n' + ... 'C4\tpp\n' + ... 'D8\t.\n') >>> hdc = humdrum.spineParser.HumdrumDataCollection(eventString) >>> hdc.maxSpines = 2 >>> hdc.fileLength = 5 >>> protoSpines, eventCollections = hdc.parseProtoSpinesAndEventCollections() >>> protoSpines is hdc.protoSpines True >>> eventCollections is hdc.eventCollections True Looking at individual slices is unlikely to tell you much. >>> for thisSlice in eventCollections: ... print(thisSlice) >>> for thisSlice in protoSpines: ... print(thisSlice) But looking at the individual slices is revealing: >>> eventCollections[4].getAllOccurring() [, ] cR>TUnTRURSLGa'[TRUR5U:a[ TRURU5nXlXlUR[;aSUl TRU5 URX5 URS:XaHUS:aATUS- RUnUb(URUTUS- RU55 gggg[ S5nXlXlURX5 TRS5 gUS:XaURTRU5 [ S5nXlXlURX5 TRS5 g)NT.rr^)r2 isSpineLinerd spineData SpineEventposition protoSpineIdcontentsspinePathIndicators spinePathDatarc addSpineEventeventsaddLastSpineEventgetSpineOccurringaddGlobalEvent)rhjthisEventCollection thisEvent lastEventprotoSpineEventListreturnEventCollectionsr>s r- doOneCellLHumdrumDataCollection.parseProtoSpinesAndEventCollections..doOneCells"8"; ~~a ,,4t~~a(223a7!+4>>!+<+F+Fq+I JI)*&-.* ))-@@<@+9'..y9'55aC ))S0QU$:1q5$A$H$H$K $0/AA ! 6q1u = O OPQ R16;0!+4 0I)*&-.*'55aC'..t46'66t~~a7HI&t, %&")*&#11!?#**40r,r) r2rNrer3r5rcEventCollection ProtoSpiner6r7)r>returnProtoSpinesrrrhrrs` @@r-rP9HumdrumDataCollection.parseProtoSpinesAndEventCollectionssD~~  - - /!# ' 1Tt~~&A"$ 4??+6*11/$..2QR! ,  $ $Z0C%D E'- 6!#9::r,c UbUcURnURn[U5n[R"S5n[ 5n[ UR5GHnX&n[ U5H\nXRUn U cMXHn U cUR5n Xjl XU'U RU 5 U RU l M^ URSLaM[R"S5n Sn Sn [ U5GH=nXRUn XHn U cU bU RU 5 M2U cM7U RS:XaXjlMOU RS:XaUR["R$S9nUS-Ul XlSUlUR["R$S9nUS-Ul XlXjlU R*RU5 U R*RU5 X4U R,U'U RU5 U RU5 GM1U RS :XaU SLa%U R&b U R&n OSn XjlGMkXjlU R&bU RU R&5 OLU SLaU RU 5 O5UR["R.S9nUUl U RU5 Sn GMU RS :Xa1U SLaU n GMU RU 5 U RU 5 Sn GM,U RU 5 GM@ U SLa[1S S US UR2S3-5eU nGM U$)a Takes the data from the object's protoSpines and eventCollections and returns a :class:`~music21.humdrum.spineParser.SpineCollection` object that contains HumdrumSpine() objects. A HumdrumSpine object differs from a ProtoSpine in that it follows spinePathData -- a ProtoSpine records all data in a given tab position, and thus might consist of data from several spines that move around. HumdrumSpines are smart enough not to have this limitation. When we check for spinePathData we look for the following spine path indicators (from HumdrumDoc):: *+ add a new spine (to the right of the current spine) *- terminate a current spine *^ split a spine (into two) *v join (two or more) spines into one *x exchange the position of two spines * do nothing cgNr%r%r,r-;HumdrumDataCollection.createHumdrumSpines..=dr,Fcgrr%r%r,r-rr^rr,rr streamClassr^Trr z4ProtoSpine found with unpaired exchange instruction zat line z [])r6r7rdr defaultlistSpineCollectionrer5r2addSpine insertPointrcrTrrrendingPositionrVoicerU isFirstVoice childSpineschildSpineInsertPointsPartr#r)r>r6r7r3currentSpineListr8rhrrr currentSpine newSpineList mergerActiveexchangeActive newSpine1 newSpine2ss r-rQ)HumdrumDataCollection.createHumdrumSpines ss,  "2":**K#44  $ "--l;)+t'A"2"5 9%'N44Q7 $/2 '$3#;#;#=L/0,*6Q'##I.)5 &!&&#00E9"--l;L L"N9%'N44Q7 /2 $)A '' 5&''4/23/''4/ / 8 8V\\ 8 RI,-EI),8)-1I* / 8 8V\\ 8 RI,-EI),8)23/ ,,33I> ,,33I>>G=SL77: '' 2 '' 2''4/$u,'33?+7+C+CL+/L673783'33?(// 0H0HI)5(// =!0 8 8V[[ 8 QA,-AM(//2', ''4/%.)5%++L9$++N;). '' 5I&LU*&']+3A3b9L9S9S8TTU)V(WXX+ S(Vr,cRURR5nURn[U5nSn/n/n[ U5HupxUR SLaUS- nSn Sn [ US-U5H+n X;dM XSn XSSRS- U-n O URSLa![URUR5n O[UR5n XlU cURU 5 MX4n URU 5 MSnM UH upURRX5 M" U(aURR!5 UHn URR#U 5 M U(aURR!5 gg)a Insert the Global Events (GlobalReferenceLines and GlobalCommentLines) into an appropriate place in the outer Stream. Run after self.spineCollection.createMusic21Streams(). Is run automatically by self.parse(). uses self.spineCollection.getOffsetsAndPrioritiesByPosition() rFr^N(T)r8!getOffsetsAndPrioritiesByPositionr2rdr_rrepriority isReferenceGlobalReferencecodevalue GlobalCommentrcr coreInsertcoreElementsChanged coreAppend)r> positionDictr2 maxEventListnumberOfGlobalEventsInARow insertList appendListrhevent insertOffsetinsertPriorityrel insertTupleoffsets r-rS(HumdrumDataCollection.insertGlobalEventss++MMO NN 9~ %&"  !),HA  E)*a/*# !"q1ul3A('3q'9 *6/!*rmd grToRemovegrs r-rX#HumdrumDataCollection.parseMetadataso 9 A      O$B   b !   b !%  HHZH . r,) r=r7r2r5r3r4r6r8rr)NN)r&r'r(r)r*r?rHrErCrDrNrPrQrSrXr+r%r,r-r/r/asD#J*1*:d[TU]5 Xlgr)superr?filename)r>r __class__s r-r?HumdrumFile.__init__s  r,cUc URnUc [S5e[USS9nURU5UlSSS5 g!,(df  g=f)Nz-Cannot parse humdrum file without a filename!zlatin-1)encoding)rr#openparseFileHandler2)r>rhumFHs r- parseFilenameHumdrumFile.parseFilenamesM  }}H  "#RS S (Y /5!11%8DN0 / /s A Acf/nUHnURU5 M X lUR5$)zG takes a fileHandle and returns a HumdrumCollection by calling parse() )rcr=rH)r> fileHandlespineDataCollectionris r-rHumdrumFile.parseFileHandle&s3!D  & &t ,-zz|r,)r=r2rr)rzstr | pathlib.Path | None) r&r'r(r)r*r?rrr+ __classcell__rs@r-rrs! !!9r,rc(\rSrSrSrSrSrSrSrSr g) HumdrumLinei1a HumdrumLine is a dummy class for subclassing :class:`~music21.humdrum.spineParser.SpineLine`, :class:`~music21.humdrum.spineParser.GlobalCommentLine`, and :class:`~music21.humdrum.spineParser.GlobalReferenceLine` classes all of which represent one horizontal line of text in a :class:`~music21.humdrum.spineParser.HumdrumDataCollection` that is aware of its position in the file. See the documentation for the specific classes mentioned above for more details. Frr%N) r&r'r(r)r*risGlobal isCommentrr+r%r,r-rr1s KHIHr,rc6\rSrSrSrSrSrSrSrS S Sjjr Sr g) riEa A SpineLine is any horizontal line of a Humdrum file that contains one or more spine elements (separated by tabs) and not Global elements. Takes in a position (line number in file, excluding blank lines) and a string of contents. >>> hsl = humdrum.spineParser.SpineLine( ... position = 7, contents='C4\t!local comment\t*M[4/4]\t.\n') >>> hsl.position 7 >>> hsl.numSpines 4 >>> hsl.spineData ['C4', '!local comment', '*M[4/4]', '.'] rrzTcXlUR5n[R"SU5n[ U5UlX lX0lg)Nz +)rr`rasplitrdrrr)r>rr returnLists r-r?SpineLine.__init__]s8 ??$XXeX. Z #r,)rrrrNrrzrintrr;) r&r'r(r)r*rrrrr?r+r%r,r-rrEs'$HHKI$$r,rcB\rSrSrSrSrSrSrSrSr Sr Sr S S Sjjr Sr g ) r}ifa A GlobalReferenceLine is a type of HumdrumLine that contains information about the humdrum document. In humdrum it is represented by three exclamation points followed by non-whitespace followed by a colon. Examples:: !!!COM: Stravinsky, Igor Fyodorovich !!!CDT: 1882/6/17/-1971/4/6 !!!ODT: 1911//-1913//; 1947// !!!OPT@@RUS: Vesna svyashchennaya !!!OPT@FRE: Le sacre du printemps The GlobalReferenceLine object takes two inputs:: position line number in the humdrum file contents string of contents And stores them as three attributes:: position: as above code: non-whitespace code (usually three letters) value: its value >>> gr = humdrum.spineParser.GlobalReferenceLine( ... position = 20, contents = '!!!COM: Stravinsky, Igor Fyodorovich\n') >>> gr.position 20 >>> gr.code 'COM' >>> gr.value 'Stravinsky, Igor Fyodorovich' TODO: add parsing of three-digit Kern comment codes into fuller metadata rrzTFcXl[R"SSU5nURSS5upEUR 5nUc[ SSUS3-5eX lX@lXPl g![ a [ SS US3-5ef=f) N^!!!+rz:r^z/GlobalReferenceLine (!!!) found without a code z$listed; this is probably a problem!  z7GlobalReferenceLine (!!!) found without a code listed; zthis is probably a problem! ) rrasubrstripr# IndexErrorrrr)r>rr noExclaimrrs r-r?GlobalReferenceLine.__init__s FF8R2  Q%OOC3MTKKME|&'X+OPXzYZ)[(\]]!    Q"#\'CH:Q%O$PQ Q Qs 9A--B )rrrrN)rz !!! NUL: Noner)r&r'r(r)r*rrrrrrrr?r+r%r,r-r}r}fs7#HHHHKIKIr,r}cF\rSrSrSrSrSrSrSrSr Sr Sr Sr S S Sjjr Srg ) r~ia A GlobalCommentLine is a humdrum comment that pertains to all spines In humdrum it is represented by two exclamation points (and usually one space) The GlobalComment object takes two inputs and stores them as attributes:: position (line number in the humdrum file) contents (string of contents) value (contents minus !!) The constructor can be passed (position, contents) if contents begins with bangs, they are removed along with up to one space directly afterwards >>> com1 = humdrum.spineParser.GlobalCommentLine( ... position = 4, contents='!! this comment is global') >>> com1.position 4 >>> com1.contents '!! this comment is global' >>> com1.value 'this comment is global' rrzTFcXXl[R"SSU5nX lX0lg)N^!!+\s?rz)rrarrr)r>rrrs r-r?GlobalCommentLine.__init__s# z2x0  r,)rrrNrr)r&r'r(r)r*rrrrrrrrr?r+r%r,r-r~r~s;.HH EHKIKIr,r~c"\rSrSrSrSSjrSrg)ria A ProtoSpine is a collection of events arranged vertically. It differs from a HumdrumSpine in that spine paths are not followed. So ProtoSpine(1) would be everything in the 2nd column of a Humdrum file regardless of whether the 2nd column was at some point an independent Spine or if it later became a split from the first spine. See :meth:`~music21.humdrum.spineParser.parseProtoSpinesAndEventCollections` for more details on how ProtoSpine objects are created. NcUc/nXlgrr2)r>r2s r-r?ProtoSpine.__init__s  I"r,rr)r&r'r(r)r*r?r+r%r,r-rrs  #r,rc\rSrSrSrSS\R 4SSjjrSrSr Sr S r S r SS jr \"\ \ 5rS rS rSrSSjr\"\\5rSrSrSrg) HumdrumSpineiar A HumdrumSpine is a representation of a generic HumdrumSpine regardless of \*\*definition after spine path indicators have been simplified. A HumdrumSpine is a collection of events arranged vertically that have a connection to each other. Each HumdrumSpine MUST have an id (numeric or string) attached to it. >>> SE = humdrum.spineParser.SpineEvent >>> spineEvents = [SE('**kern'), SE('c,4'), SE('d#8')] >>> spine1Id = 5 >>> spine1 = humdrum.spineParser.HumdrumSpine(spine1Id, spineEvents) >>> spine1.insertPoint = 5 >>> spine1.endingPosition = 6 >>> spine1.parentSpine = 3 # spine 3 is the previous spine leading to this one >>> spine1.childSpines = [7, 8] # the spine ends by being split into spines 7 and 8 we keep weak references to the spineCollection so that we don't have circular references >>> spineCollection1 = humdrum.spineParser.SpineCollection() >>> spine1.spineCollection = spineCollection1 The spineType property searches the EventList or parentSpine to figure out the spineType >>> spine1.spineType 'kern' Spines can be iterated through: >>> for e in spine1: ... print(e) **kern c,4 d#8 If you'd eventually like this spine to be converted to a class other than :class:`~music21.stream.Stream`, pass its classname in as the streamClass argument: >>> spine2 = humdrum.spineParser.HumdrumSpine(streamClass=stream.Part) >>> spine2.stream rNc XlUc/nUH nXlM X lU"5UlSUlSUlSUlSUlSUl/Ul 0Ul SUl SUl SUl SUlSUlSUlSUlgNrF)rTspineIdr2rrrrUnewSpine isLastSpinerrparsed measuresMovedinsertionsDone_spineCollection _spineTyper iterIndex)r>rr2rrs r-r?HumdrumSpine.__init__s  IE#M#!m   /1KM# "# $'+r,c:S[UR5-nUR(a(US[URR5-S-- nUR(a8US- nURHnU[UR5S-- nM US- nU$)N: z [child of: rz [parent of: rz ])r;rTrUr)r>representationrs r- _reprInternalHumdrumSpine._reprInternal/sDGG ,    ns43C3C3F3F/GG#M MN    o -N%%#add)c/1& d "Nr,c:URRU5 g)z add an item to this Spine N)r2rc)r>rs r-rcHumdrumSpine.append:s e$r,cSUlU$)z6 Resets the counter to 0 so that iteration is correct r)rr>s r-__iter__HumdrumSpine.__iter__@s r,cUR[UR5:Xa[eURURnU=RS- slU$)z? Returns the current event and increments the iteration index. r^)rrdr2 StopIteration)r>rs r-__next__HumdrumSpine.__next__GsE >>S0 0 NN4>>2  !r,cB[R"UR5$r)r unwrapWeakrefrr&s r-_getSpineCollection HumdrumSpine._getSpineCollectionQs##D$9$9::r,c:[R"U5Ulgr)r wrapWeakrefr)r>rws r-_setSpineCollection HumdrumSpine._setSpineCollectionTs & 2 22 6r,cURb UR$URHOn[R"SUR5nU(dM-UR S5UlURs $ g)Nz\*\*(.*)r^)rr2rar|rgroup)r>rm1s r-_getLocalSpineTypeHumdrumSpine._getLocalSpineTypeYs] ?? &?? "!^^ XXk9+=+=>2&(hhqkDO??* , r,cFURnUbURnUbU$ggr)rUrV)r>rU psSpineTypes r-_getParentSpineType HumdrumSpine._getParentSpineTypeds0&&  "%//K&""r,cURb UR$UR5nUbXlU$UR5nUbXlU$[S[ UR 5-5e)z8 searches the current and parent spineType for a search z0Could not determine spineType for spine with id )rr8r<r#r;rT)r>sts r- _getSpineTypeHumdrumSpine._getSpineTypensx ?? &?? "((*B~"$ --/>&(OI*,BDGL,QRRr,cXlgr)r)r> newSpineTypes r- _setSpineTypeHumdrumSpine._setSpineTypes&r,cUR5n[R"5nSUlSnSnSnUHn[ U[R 5(aTUS:wdU(a!UR 5 URU5 UnURnURnUS:XaSnMtMvUS:wdURRS:wa!URURU- U5 MURU5 M UR 5 UR 5 U(aURU5 UR[R5nU(aUSn U(dSU lURS5n U HYn[ U[R 5(aM$SUR;aM6U R!SU5 UR#U5 M[ U R$n U b`U RRU R&R:a2U R&RU RR- U lU$)a Takes a parsed stream and moves the elements inside the measures. Works with pickup measures, etc. Does not automatically create ties, etc. Why not just use Stream.makeMeasures()? because humdrum measures contain extra information about barlines etc. and pickups are explicitly defined. >>> s1 = stream.Stream() >>> s1.append(meter.TimeSignature('2/4')) >>> m1 = stream.Measure() >>> m1.number = 1 >>> s1.append(m1) >>> s1.append(note.Note('C4', type='quarter')) >>> m2 = stream.Measure() >>> m2.number = 2 >>> s1.append(m2) >>> s1.append(note.Note('D4', type='half')) >>> s1.show('text') {0.0} {0.0} {0.0} {1.0} {1.0} >>> hds = humdrum.spineParser.HumdrumSpine() >>> s2 = hds.moveElementsIntoMeasures(s1) >>> s2.show('text') {0.0} {0.0} {0.0} {1.0} {0.0} The first measure is correctly identified as a pickup! >>> s2.measure(1).paddingLeft 1.0 rFr^T MiscTandem)rrMeasurerpr:Streamrrrr quarterLengthrrcgetElementsByClassgetElementsByOffsetclassesrWr timeSignature barDuration paddingLeft) r>streamIn streamOutcurrentMeasurecurrentMeasureNumbercurrentMeasureOffset hasMeasureOnermeasureElementsr7beginningStuffm1TimeSignatures r-moveElementsIntoMeasures%HumdrumSpine.moveElementsIntoMeasuressX&&( ) !   B"fmm,,'1,"668((8!#')yy$')yy$'1,$(M-(1, 0I0IQ0N"--bii:N.NPRS((,#& **,%%'    ^ ,$66v~~F  #B  &::1=N$b&--00!RZZ/IIa$$$R(%!..O*;;,,/J/J/X/XX&5&A&A&O&O(* (A(A'BBNr,c"[S5nURHn[UR5nSnUS:XaOUR S5(aU[ ;a [ U5nOmUR S5(a[X15nUnOIUR S5(a [U5nO'[R"U5nURUl UcMURRU5 M URR5 g)z Dummy method that pushes all these objects to HumdrumSpine.stream as ElementWrappers. Should be overridden in specific Spine subclasses. =0Nrr!=!)hdStringToMeasurer2r;r startswithrrG SpineCommentrElementWrapperrhumdrumPositionrrr)r> lastContainerreventC thisObjects r-rHHumdrumSpine.parses *$/ ^^E(FJ}""3''!44!+F!3J""3'' 1& H * ""3'')&1 !007 -2^^ *% &&z2'$( '')r,)rrrrrr2rTrrrrrrrrUrrrrr)r&r'r(r)r*rrIr?r!rcr'r+r/r3propertyr8r8r<r@rDrVrZrHr+r%r,r-rrsw.`'(4V]]6 % ;724GHO R(' 6I_B*r,rcl^\rSrSrSrSS\R 4S U4SjjjrSrSr Sr S r S r S r U=r$) KernSpineiz A KernSpine is a type of humdrum spine with the \*\*kern attribute set and thus events are processed as if they are kern notes rNcz>[TU]XU5 SUlSUlSUlSUlSUlSUlg)Nr)rr?reinTupletlastNotecurrentBeamNumberscurrentTupletDurationdesiredTupletDuration)r>rr2rrs r-r?KernSpine.__init__s@ [9!  "#%("%("r,c [S5UlSUlSUlSUlSUlSUlURGHnURnSnUS:XaOURS5(a[U5nUbUnOURS5(a'[X R5UlURnO]URS5(a[U5nURS :XaSnO)S U;aURU5nOURU5nUb@URUlURUlUR$R'U5 GMGM! UR$R75 g![(aynSSKn[,R/S UR<S UR<S UR0SU35 UR35n[,R5SU35 SnAGMSnAff=f)Nr]Frrnrr!r^r_rzrzError in parsing event (z) at position z for spine rzTraceback for the exception: )r`rerorprqrrrsr2rrakernTandemToObjectrbcommentprocessChordEventprocessNoteEventrrdrrr Exception traceback environLocalwarnr format_exc printDebugr)r>rrfrg tempObjecter{tbs r-rHKernSpine.parses.t4  "#%("%("^^E" P! S=&&s++!3F!;J!-%/ &&s++):6CUCU)VD&!%!3!3J&&s++!-f!5J!))R/%) F]!%!7!7!?J!%!6!6v!>J)16J.*/..J'KK**:6*1$N '') P !!.u~~.@A##(>>"45!!&r!6 ))+''*I"(NOO PsDE>> HA-G<<Hcl[U5nURU5 URU5 X lU$)z similar to hdStringToNote, this method processes a string representing a single note, but stores information about current beam and tuplet state. )hdStringToNotesetBeamsForNotesetTupletTypeForNoterp)r>rf eventNotes r-ryKernSpine.processNoteEventIs5 #6*  Y' !!),! r,c.UR5n/nUHn[U5nURU5 M! [R"X3SR S9nUSR UlURU5 URU5 X`l U$)zn Process a single chord event Like processNoteEvent, stores information about current beam and tuplet state. r])beamsr) rrrcrChordrr rrrp)r>rfnotesToProcess chordNotes noteToProcessthisNote eventChords r-rxKernSpine.processChordEventVs  +M%m4H   h ',[[b>3G3GH (m44  Z( !!*-" r,c [US5(dgURS:waSURR(d8[ UR5HnURR S5 M gURR(atURRSR S:XaSUlgURRH*nUR S:wdMU=RS- slM, gg)z sets the beams for a Note (or Chord) given self.currentBeamNumbers and updates self.currentBeamNumbers based on stop beams. Safe enough to use on elements such as rests that don't have beam info. rNrcontinuestopr^)hasattrrqr beamsListrerctype)r>nunused_counterthisBeams r-rKernSpine.setBeamsForNoteksq'""  " "a '0A0A"'(?(?"@z*#A WW  ww  #((F2*+' ! 1 1H}}.//14/!2 r,cURnURRnURSLaVU(aOSUlUSR5UlUR UlSURRSlgURSLaEU(d>SUlSUlSUlSURRRSlgURSLaU=R UR - slUR UR:Xd=UR UR- [UR UR- 5:Xa SUSlSUlSUlSUlggg)NFTrstartrnr) r tupletsrototalTupletLengthrsrJrrrrpr)r>rnDurnTupletss r-rKernSpine.setTupletTypeForNotesJzz::%% ==E !h DM)1!)F)F)HD &)-););D &)0AJJ  q ! & ]]d "8!DM),D &),D &5;DMM " " * *1 - 2 ]]d "  & &$*<*< < &**d.H.HH22T5O5OOTW22T5O5OOUQQ#)  % -0*-0* Q #r,)rqrrrsrorerpri)r&r'r(r)r*rrIr?rHryrxrrr+rrs@r-rlrls> '(4V]]))/*d *5*11r,rlc\rSrSrSrSrSrg) DynamSpineiz A DynamSpine is a type of humdrum spine with the \*\*dynam attribute set and thus events are processed as if they are dynamics. crSnURGHn[UR5nSnUS:XaGOURS5(aU[;a [ U5nOURS5(a:Ub+UR 5 URRU5 [U5nOURS5(a[U5nURS:XaSnOnURS5(a[R"5nOBURS5(a[R"5nO[R"U5nUcGMGUR UlUcURRU5 GMyURU5 GM URR 5 g)Nrr!r^r_rz<>)r2r;rrarrGrrrr`rbrwr Diminuendo CrescendoDynamicrrd)r> thisContainerrrfrgs r-rHDynamSpine.parses^ ^^E(FJ}""3''!44!+F!3J""3'' ,!557KK**=9 1& 9 ""3'')&1 %%+!%J""3''%002 ""3''%//1 %--f5 %-2^^ * (KK**:6!,,Z8?$B '')r,r%Nr&r'r(r)r*rHr+r%r,r-rrs  #*r,rc\rSrSrSrSrSrg) HarmSpineia A HarmSpine is a type of humdrum spine with the \*\*harm attribute set and thus events are processed as if they are harmonic analysis annotations in the "harm" syntax. The harm roman numeral annotations are parsed using a superset of the original \*\*harm Humdrum representation, written for python and extending the syntax based on other projects like the RomanText and the MuseScore roman numeral notations. cx[S5n[R"S5nURGHnnURnSnUS:XaGOUR S5(aLU[ ;aM<URS5(aUSSn[R"U5nUnO[U5nOUR S5(a[XA5nUnOUR S 5(a [U5nOiURn[R"U5n[R"UU[RR[RR S 9nUcGM1UR"UlUR"UlUR(R+U5 GMq UR(R-5 g) Nr]Crr!rr^r]r^r_) sixthMinor seventhMinor)r`rKeyr2rrarendswithrGrbrconvertHarmToRomanr RomanNumeralMinor67DefaultFLATSHARPrrdrrrr) r>re currentKeyrrfrg keyStringharmStrromanStrs r-rHHarmSpine.parsesc)$/ WWS\ ^^E^^FJ}""3''00??3'' &q I!$!3J!+J",F!3J""3'' 1& H * ""3'')&1 ..%88A"//$3388!&!5!5!;!;  %-2^^ *&+nn # &&z2G$H '')r,r%Nrr%r,r-rrs  '*r,rc<\rSrSrSrS S SjjrSrSrS SjrSr g) ria A SpineEvent is an event in a HumdrumSpine or ProtoSpine. It's .contents property contains the contents of the spine, or it could be '.', in which case it means that a particular event appears after the last event in a different spine. It could also be "None" indicating that there is no event at all at this moment in the humdrum file. Happens if no ProtoSpine exists at this point in the file in this tab position. Should be initialized with its contents and position in file. These attributes are optional but likely to be very helpful:: position -- event position in the file protoSpineId -- ProtoSpine id (0 to N) spineId -- id of HumdrumSpine actually attached to (after SpinePaths are parsed) The `toNote()` method converts the contents into a music21 note as if it's kern -- useful to have in all spine types. >>> se1 = humdrum.spineParser.SpineEvent('EEE-8') >>> se1.position = 40 >>> se1.contents 'EEE-8' >>> se1 >>> n = se1.toNote() >>> n c8XlX lSUlSUlg)Nrrrrr)r>rrs r-r?SpineEvent.__init__ s% % !"!% r,cUR$rrr&s r-r!SpineEvent._reprInternal& }}r,cUR$rrr&s r-__str__SpineEvent.__str__)rr,NcHUc[UR5$[U5$)z parse the object as a \*\*kern note and return a :class:`~music21.note.Note` object (or Rest, or Chord) >>> se = humdrum.spineParser.SpineEvent('DD#4') >>> n = se.toNote() >>> n >>> n.octave 2 >>> n.duration.type 'quarter' )rr)r> convertStrings r-toNoteSpineEvent.toNote,s$  !$--0 0!-0 0r,r)rzr)rr;rrr) r&r'r(r)r*r?r!rrr+r%r,r-rrs@& 1r,rc\rSrSrSrSrSrSr\R4SSjjr Sr Sr S r S rS rS rS rSrSrSrSrSSjrSrSrg)riBa A SpineCollection is a set of HumdrumSpines with relationships to each other and where their position attributes indicate simultaneous onsets. When you iterate over a SpineCollection, it goes from right to left, since that's the order that humdrum expects. cJ/UlSUlSUlSUlSUlgr)spines nextFreeIdspineReclassDonerrr&s r-r?SpineCollection.__init__Ls&  % r,c@[UR5S- UlU$)zE Resets the counter to len(self.spines) so that iteration is correct r^)rdrrr&s r-r'SpineCollection.__iter__SsT[[)A- r,cURS:a[eURURnU=RS-slU$)z? Returns the current spine and decrements the iteration index. rr^)rr*rr>rYs r-r+SpineCollection.__next__Zs< >>A  KK/  !r,c[URUS9UlXRlURR UR5 U=RS- slSURlUR$)a@ creates a new spine in the collection and returns it. By default, the underlying music21 class of the spine is :class:`~music21.stream.Part`. This can be overridden by passing in a different streamClass. Automatically sets the id of the Spine. >>> hsc = humdrum.spineParser.SpineCollection() >>> newSpine = hsc.addSpine() >>> newSpine.id 0 >>> newSpine.stream >>> newSpine2 = hsc.addSpine(streamClass=stream.Stream) >>> newSpine2.id 1 >>> newSpine2 >>> newSpine2.stream rr^F)rrrr8rrcr)r>rs r-rSpineCollection.addSpinedsZ2%T__+N (, % 4==) 1%* "}}r,c:URRU5 g)zf appendSpine(spine) -- appends an already existing HumdrumSpine to the SpineCollection. Returns void N)rrc)r>spines r- appendSpineSpineCollection.appendSpines 5!r,cfURHnURU:XdMUs $ [S5e)zr returns the HumdrumSpine with the given id. raises a HumdrumException if the spine with a given id is not found z#Could not find a Spine with that ID)rrTr#)r>rrYs r- getSpineByIdSpineCollection.getSpineByIds2 I||w&  %DEEr,cURH0nURU:XdMURRU5 g [S[35e)a deletes a spine from the SpineCollection (after inserting, integrating, etc.) >>> hsc = humdrum.spineParser.SpineCollection() >>> newSpine = hsc.addSpine() >>> newSpine.id 0 >>> newSpine2 = hsc.addSpine() >>> newSpine2.id 1 >>> hsc.spines [, ] >>> hsc.removeSpineById(newSpine.id) >>> hsc.spines [] raises a HumdrumException if the spine with a given id is not found Nz$Could not find a Spine with that ID )rrTrr#)r>rrs r-removeSpineByIdSpineCollection.removeSpineByIdsG*Attw ""1%!EbTJKKr,cUR5 UR5 UR5 UR5 UR 5 UR 5 UR 5 g)a Create Music21 Stream objects from spineCollections by running: self.reclassSpines() self.parseMusic21() self.performInsertions() self.moveObjectsToMeasures() self.moveDynamicsAndLyricsToStreams() self.makeVoices() self.assignIds() N) reclassSpines parseMusic21performInsertionsmoveObjectsToMeasuresmoveDynamicsAndLyricsToStreams makeVoices assignIdsr&s r-rR$SpineCollection.createMusic21StreamssT     ""$ ++-  r,cSS0n0nURHnURnUR[R5nU(dSnOUSR nXa;aXBU'SX'XdlM\Uc"US==S- ss'[US5UlMXS:XaX&nUR S-UlX==S- ss'US-[X5-UlM g)a5 assign an ID based on the instrument or just a string of a number if none >>> hsc = humdrum.spineParser.SpineCollection() >>> newSpineDefault = hsc.addSpine() >>> newSpineDefault2 = hsc.addSpine() >>> newSpineOboe1 = hsc.addSpine() >>> newSpineOboe2 = hsc.addSpine() >>> newSpineTrumpet = hsc.addSpine() >>> newSpineOboe1.stream.append(instrument.Oboe()) >>> newSpineOboe2.stream.append(instrument.Oboe()) >>> newSpineTrumpet.stream.append(instrument.Trumpet()) >>> hsc.assignIds() >>> for sp in hsc.spines: ... print(sp.stream.id) 1 2 Oboe-1 Oboe-2 Trumpet Nrr^z-1-)rrrKr InstrumentinstrumentNamerTr;)r>usedIdsfirstStreamForEachInstrumentrY spineStreaminstrumentsStreamspineInstrument myFirstStreams r-rSpineCollection.assignIdss.)')$I#**K + > >z?T?T U $"&"3A"6"E"E-@K_=+,(!0 ( " !$WT]!3 +q0$@$QM'4'7'7$'>M$(A-(!03!6W=U9V!V )%r,cBURHnURbMUR(dM%URR 5n[ UR 5nSnURRH]nURnUH2nXG:dXg:aMURXU5 URU5 M4 UnU?URU5 M_ UR5 X!lUHnURXU5 M GM g![a NXf=f)zl take a parsed spineCollection as music21 objects and take sub-spines and put them in their proper location Nr])rrUrrrsortedr _elementsrdperformSpineInsertionrAttributeErrorrr)r>rY newStream insertPointslastHumdrumPositionrrdrhs r-r!SpineCollection.performInsertionss I$$0(("((224I!)"B"BCL"$ &&00 &(&8&8O).2o6I$229K$++A. * +:'*$$R(1  ) ) +(  "**9C"C%.&s=AD DDcUR5 URnURUnSnUHnUS- nS[U5-nURR Hln UR SLa![U [R5(aM3U RRU5 URXIR-U 5 Mn M UR5 g)z` Insert all the spines into newStream that should be inserted into thisSpine at insertionPoint. rr^voiceFN) r highestTimerr;rrrr:rHgroupsrcrr) r>rYrinsertionPoint startPointchildrenToInsert voiceNumber insertSpinevoiceStrinsertEls r-r%SpineCollection.performSpineInsertion!s %%'** $;;NK +K 1 K[!11H'..88++u4Hfnn9]9]OO**84((oo)ExP 9 , %%'r,cURHZnURS:Xa [UlM URS:Xa [UlM=URS:XdMO[ UlM\ SUlg)z changes the classes of HumdrumSpines to more specific types (KernSpine, DynamicSpine) according to their spineType (e.g., \*\*kern, \*\*dynam) rLdynamharmTN)rrVrlrrrrrs r-rSpineCollection.reclassSpines7s^ I""f,&/ #$$/&0 #$$.&/ # %!%r,c`0nURHnURbMURR5nUHin[ US5(dMUR U;a!U/nUR U4nXaUR 'MGXR SnURU5 Mk M U$)a' iterates through the spines by location and records the offset and priority for each Returns a dictionary where each index is humdrumPosition and the value is a two-element tuple where the first element is the music21 offset and the second element is a list of Music21Objects at that position rdr^)rrUrflattenrrdrrc)r>rrYsfr elementList valueTuples r-r1SpineCollection.getOffsetsAndPrioritiesByPositionFs I$$,%%--/Br#455--\A+-$K*,))[)AJ?I););<*67I7I*J1*MK'..r2%r,c[R"5nURHnURbMUR UR 5UlUR R [ R5H=nURU5 URSS9nUHnURU5 M M? SUl M g)z run moveElementsIntoMeasures for each HumdrumSpine that is not a sub-spine. Also fixes up the tuplets using duration.TupletFixer NT)incorporateGroupings) r TupletFixerrrUrZrrKrH setStreamfindTupletGroupsfixBrokenTupletDurationr)r>tfrYm tupletGroupstgs r-r%SpineCollection.moveObjectsToMeasures_s ! ! #I$$,#,#E#EiFVFV#W  #))< kernStreamsrYr* staffInfostavesAppliedToprioritiesToSearchxdynamic applyStaff applyStreamrrr)r.s r-r.SpineCollection.moveDynamicsAndLyricsToStreamsusL  I$$0""f,#**==jI}}//99 ab 12 )2)9)9 & J %I$$0""f, O!# #**:6==++H55 & ab 1I7@s7K&L7K!s1v7KO&L 7 ""g-(//779G!'8+;+;< =N> O O cURGHnURS:wd URbM#URnUR [R 5GHpnSnSnUH#nSUR ;dMSnURn O U(dM:[S5Vs/sHnSPM nnURn U HnUR n U (aU SRS5(dM1U Sn [U S 5n Xn U c4[R"5n XU 'U R RU 5 [R(aU ceURnUR!U5 U R#X- U5 M UH)n U cMU R%5 UR#X]5 M+ UR%5 GMs GM gs snf) z make voices for each kernSpine -- why not just run stream.makeVoices() ? because we have more information here that lets us make voices more intelligently Should be done after measures have been made. rLNFrvoice1T r)rrVrUrrKrHrrreelementsrarrrct TYPE_CHECKINGrrr)r>rY thisStreamr hasVoiceslowestVoiceOffsetmElrhvoicesrW mElGroups voiceNamer  voicePart mElOffsets r-rSpineCollection.makeVoicessI""f, 0E0E0Q"))J 33FNNC! $%!C3::-$( ,/JJ)  !AFr2KA42K"$++*C # I$IaL,C,CG,L,L )! I"%il"3K & 3I ($*LLN .7{+!((// :(444 # IIIcN(()FL%+("(I ,!557 &7C "( &&(MD %3Ls" GcJURHnUR5 M g)zT runs spine.parse() for each Spine. thus populating the spine.stream for each Spine N)rrHrs r-rSpineCollection.parseMusic21s I OO %r,)rrrrrN)rztype[stream.Stream])returnNone)r&r'r(r)r*r?r'r+rrrrrrrRrrrrrrrrrr+r%r,r-rrBsp;A++B" FL6(-W^'DX(, %2/,K-Z2)jr,rcF\rSrSrSrS SjrSrSrSrSr Sr S r S r g ) ria  An EventCollection is a time slice of all events that have an onset of a certain time. If an event does not occur at a certain time, then you should check EventCollection[n].lastEvents to get the previous event. (If it is a note, it is the note still sounding, etc.). The happeningEvent method gets either currentEvent or lastEvent. These objects normally get created by :meth:`~music21.humdrum.spineParser.HumdrumDataCollection.parseProtoSpinesAndEventCollections` so you won't need to do all the setup. Assume that ec1 is C4 pp and ec2 is: D4 . >>> SE = humdrum.spineParser.SpineEvent >>> eventList1 = [SE('C4'),SE('pp')] >>> eventList2 = [SE('D4'),SE('.')] >>> ec1 = humdrum.spineParser.EventCollection(maxSpines=2) >>> ec1.events = eventList1 >>> ec2 = humdrum.spineParser.EventCollection(maxSpines=2) >>> ec2.events = eventList2 >>> ec2.lastEvents[1] = eventList1[1] >>> ec2.maxSpines 2 >>> ec2.getAllOccurring() [, ] c[R"S5Ul[R"S5UlXlSUlg)Ncgrr%r%r,r-r*EventCollection.__init__..%sr,cgrr%r%r,r-rrP&sTr,F)r rr lastEventsr3r)r>r3s r-r?EventCollection.__init__$s3((6  ,,\:""r,c X RU'grrr>spineNum spineEvents r-rEventCollection.addSpineEvent+s * Hr,c X RU'gr)rRrVs r-r!EventCollection.addLastSpineEvent.s$.!r,cX[UR5HnXRU'M gr)rer3r)r> globalEventrhs r-rEventCollection.addGlobalEvent2s t~~&A(KKN'r,c URU$rrUr>rWs r- getSpineEventEventCollection.getSpineEvent6s{{8$$r,c^URUbURU$URU$r)rRrr`s r-r!EventCollection.getSpineOccurring9s1 ??8 $ 0??8, ,;;x( (r,c/n[UR5H#nURURU55 M% U$r)rer3rcr)r> retEventsrhs r-getAllOccurringEventCollection.getAllOccurringBs9 t~~&A   T33A6 7'r,)rrRr3rN)r) r&r'r(r)r*r?rrrrarrgr+r%r,r-rrs+B#+/)%)r,rc[R"SU5nSnSU;a[R"5nOzU(adUR S5nUSR 5nXCS:XaS[ U5-nOS[ U5- n[R"US9nXBlO[S US 35e[R"S U5n[R"S U5nU(a!UR S5URl O?U(a!UR S5URl OS U;aS URl [URS55HnM [URS55HnM [URS55HnM [URS55HnM SU;a[R"S5UlOCSU;a[R"S5UlO!SU;a[R"S5UlSU;a/UR R#[ R$"55 O4SU;a.UR R#[ R&"55 SU;a/UR R#[ R("55 OSU;a/UR R#[ R*"55 OiSU;a/UR R#[ R,"55 O4SU;a.UR R#[ R."55 SU;a/UR R#[ R0"55 OrSU;a/UR R#[ R2"55 O=S U;a7[ R0"5n S!U lUR R#U 5 S"U;aS#U;a.UR R#[ R6"55 S$U;a.UR8R#[8R:"55 S%U;a.UR8R#[8R<"55 S&U;a.UR8R#[8R>"55 S'U;a.UR8R#[8R@"55 S(U;a.UR8R#[8RB"55 S)U;a.UR R#[ RD"55 S*U;a/UR8R#[8RF"55 O4S+U;a.UR8R#[8RH"55 S,U;aS-Ul%O S.U;aS/Ul%[R"S0U5n [R"S1U5n U (as[MU R S55n [OU R S255n SU -U - URPl)S3U;a URS35URPl*GOU (Ga[MU R S55nUS:XazU R S5nUS4:XaS5URPl+O)US6:XaS7URPl+OS8URPl+S3U;a URS35URPl*GO/U[PRX;aJ[PRXUURPl+S3U;a URS35URPl*GO[MU5S9-n[ZR\"[ZR^"U55unnS2U-n[PRX[MU5URPl+[PR`"5n[PRb"URPRVS5Ul2[PRb"URPRVS5Ul3[ZRh"[MU5[MU55n[MUU- 5Ul5[M[OU5U- 5Ul6[nS:nUS;LaES3U;a?[PRb"URfRVURS355Ul3URPRqU5 US!La&S3U;a URS35URPl*SU;a3URs5nS;URPl:S=URPl+OS?U;aURsS!S@9nOSAU;a[URSB55HnURvR#S5 M [URSC55HnURvR#S5 M [URSD55HnURvR#SESF5 M! [URSG55HnURvR#SESF5 M! U$)Ha returns a :class:`~music21.note.Note` (or Rest or Unpitched, etc.) matching the current SpineEvent. Does not check to see that it is sane or part of a :samp:`**kern` spine, etc. New rhythmic extensions formerly defined in `wiki.humdrum.org/index.php/Rational_rhythms` and now at https://extras.humdrum.org/man/rscale/ are fully implemented: >>> n = humdrum.spineParser.hdStringToNote('CC3%2') >>> n.duration.quarterLength Fraction(8, 3) >>> n.duration.fullName 'Whole Triplet (2 2/3 QL)' >>> n = humdrum.spineParser.hdStringToNote('e-00.') >>> n.pitch >>> n.duration.quarterLength 24.0 >>> n.duration.fullName 'Perfect Longa' >>> n = humdrum.spineParser.hdStringToNote('F#000') >>> n.duration.quarterLength 32.0 >>> n.duration.fullName 'Imperfect Maxima' Note that the following example is interpreted as one note in the time of a double-dotted quarter not a double-dotted quarter-note triplet. I believe that the latter definition, though used in https://kern.humdrum.org/cgi-bin/ksdata?l=musedata/mozart/quartet&file=k421-01.krn&f=kern and the Josquin Research Project [JRP] is incorrect, seeing as it contradicts the specification in https://web.archive.org/web/20100203144730/http://www.music-cog.ohio-state.edu/Humdrum/representations/kern.html#N-Tuplets >>> storedFlavors = humdrum.spineParser.flavors['JRP'] #_DOCS_HIDE This is the default: >>> humdrum.spineParser.flavors['JRP'] = False >>> n = humdrum.spineParser.hdStringToNote('6..fff') >>> n.duration.quarterLength Fraction(7, 6) >>> n.duration.dots 0 >>> n.duration.tuplets[0].durationNormal.dots 2 If you want the JRP definition, set humdrum.spineParser.flavors['JRP'] = True before calling converter.parse() or anything like that: >>> humdrum.spineParser.flavors['JRP'] = True >>> n = humdrum.spineParser.hdStringToNote('6..fff') >>> n.duration.quarterLength Fraction(7, 6) >>> n.duration.dots 2 >>> n.duration.tuplets[0].durationNormal.dots 0 >>> n = humdrum.spineParser.hdStringToNote('gg#q/LL') >>> n.duration >>> n.duration.isGrace True >>> humdrum.spineParser.flavors['JRP'] = storedFlavors #_DOCS_HIDE z ([a-gA-G]+)Nrr^r)octavezCould not parse z for note informationz(#+)z(-+)r{}()[rrr_rr=TwWr!MS$RTrO'"`~^;vur'up\downz (\d+)%(\d+)z(\d+)r\r000maxima00longabrevernrFqeighthQP) appoggiaturapLJkpartialrightK)>#& ' ( 8>>#& ' ( 8>>#& ' ( 8>>#& ' ( h)    ,  h%%k&?&?&AB %%k&@&@&BC h%%k&I&I&KL %%k&J&J&LM %%k&A&A&CD %%k&B&B&DE h%%k&6&6&89 %%k&>&>&@A     !%%%b) h  h%%k&:&:&<= h  '' (>(>(@A h  '' (?(?(AB h   '' (C(C(EF h  '' (<(<(>? h  '' (<(<(>? h%%k&9&9&;< h  '' (;(;(=>   '' (=(=(?@ h#'   #)  IInh7M))Hh/KM//23 }22156,-,>,N ) (?'/~~c':J   $ ;,,Q/0 1 (..q1N&+3 ##(4'+2 ##(+2 ##(h+3>>#+> ##( X55 5'/'?'? 'MJ   $h+3>>#+> ##(\"S(B,0IIdiim,D ) yYI'/'?'?I'OJ   $__&F$,$F$FzGZGZG_G_ab$cF !$,$F$FzGZGZG_G_ab$cF !((3r7C N3C'*28}F $'*5+;c+A'BF $ %.Ce|x(0(J(J))..s0C)E%    , ,V 4d{sh+3>>#+> ##( h((* #+  ((* $) !#+  ((d(;  8>>#& '(( 8>>#& ''( 8>>#& ' 73( 8>>#& ' 73( r,c$[R"5n[R"SU5nU(aK[ UR S55UlUR S5(aUR S5Ul[R"5nSU;a SUl GOSU;a SUl GOSU;a S Ul GOS U;aCS Ul URS 5S:a S Ul GOsSU;a SUl GOdSU;aSUl GOUSU;aCSUl URS 5S:a S Ul GO*SU;a SUl GOSU;aSUl GO SU;a@SUl URS 5S:aS Ul OSU;aSUl OSU;aSUl OSU;a@SUl URS 5S:aS Ul OSU;aSUl OSU;aSUl OSU;a@SUl URS 5S:aS Ul OVSU;aSUl OHSU;aSUl O:SU;a4S Ul URS 5S:aS Ul US:Xa [S5eSU;a[R"5UlUbXAlU$XBlU$) aG kern uses an equals sign followed by processing instructions to create new measures. N.B. -- much of the code for describing how repeat signs are encoded is among the oldest code for music21 and was not updated when musicxml parsing was added. It does not yet use the bar.RepeatMark() class or any other post 2009 additions. z (\d+)([a-z]?)r^r\rnoner|shortr~tickz||doublerbothz:|leftz|:rr{z heavy-heavyz:!z!:z|!finalz!|z heavy-light|regularz==z==|zmCannot import a double bar visually rendered as a single bar -- not sure exactly what that would mean anyhow.r)rrHrarbrr6rp numberSuffixrBarlinerr repeatDotsr#rrpause rightBarline leftBarline)rpreviousMeasurer7 rematchMNbarlines r-r`r`` sv  B *H5I *+ ??1  'ooa0BOkkmG h     >>#  "!'G  X !'G  X !(G   $ >>#  "!'G  X !'G  X !(G    >>#  "!'G  X !'G  X !(G   $ >>#  "!'G  X !'G  X !(G    >>#  "!'G  X !'G  X !(G    >>#  "!'G  u "BC C h#++- "'.$ I! Ir,cXU[;agURS5(aUSSnUS:Xa[R"5$US:Xa[R"5$US:Xa[R "5$US:Xa[R "5$US:Xa[R "5$US :Xa[R "5$US :Xa[R"5$US :Xa[R"5$[R"U5nU$URS5(a'USSn[U5n[R"US9nU$URS5(aUSSn[R""SU5nU(a[%UR'S55nUR'S5n U S;a[(R*"U5$U S:XaUS-nSn OU S:XaUS-nSn O U S:XaUS-nSn [(R*"USU 35$[S US 35eURS!5(aUSSn [,R."U 5n U $URS"5(a [3U5$URS#5(a [3U5$URS$5(aUSSn [,R4"U 5n U $URS%5(aAUR7S&5n U S':XaS(UR7S5-n [8R:"U 5$UR=S)5(aUSS(n[8R>"U5$[3U5$![Ra [S US 35ef=f![aI [R "SSU5n[R "SSU5n[R"US9nUs$f=f![,R0a [3U 5s$f=f![,R0a [3U 5s$f=f)*a Kern uses symbols such as :samp:`*M5/4` and :samp:`*clefG2`, etc., to control processing This method converts them to music21 objects. >>> m = humdrum.spineParser.kernTandemToObject('*M3/1') >>> m Unknown objects are converted to MiscTandem objects: >>> m2 = humdrum.spineParser.kernTandemToObject('*TandyUnk') >>> m2 Nz*clefr;rXGv2GvzG^2zG^Fv4FvzUnknown clef type z foundz*MMrk)rpz^\[rzz]\s*$r)z*Mr\z (\d+)/(\d+)r^)0rrrrrlrr'zIncorrect meter: z*ICz*IGz*ITrz*Iz*k#rr]r) rrarNoClefPercussionClef Treble8vbClef Treble8vaClef Bass8vbClefclefFromString ClefExceptionr#rr MetronomeMark ValueErrorrarr|rr6r TimeSignaturerfromHumdrumClassHumdrumInstrumentExceptionrGfromHumdrumInstrumentrr KeySignaturerr)r*clefTyper metronomeMarkMMMS meterTypetsTemp numerator denominatorinstrumentClassiObj instrumentStr numSharpsthisKeys r-rvrv s$$$   7 # #!": s?;;= _&&( (  %%' '  %%' '  %%' '  %%' '  ##% %  ##% % L!%!4!4X!>%%   5 ! !qr  !-0M$$M:BI   4 12J .)4 FLLO,I ,,q/K"44**955#%NI"#K D(NI"#K E)NI"#K**i[++GHH"%6vhf#EF F   5 ! ! * ///@DK   5 ! !&!!   6 " "&!!   4 qr  -44]CDK   4 LL% >fll3/0I **   2,www&!!G%% L&);F86'JKK L FF62}=MFF8R?M$$-8BI  B55 /o. . /55 -m, , -sCM%4 N O":P%$N  AOO"PPP)(P)c2^\rSrSrSU4SjjrSrSrU=r$)rGi6 c 2>[TU]"S0UD6 Xlg)Nr%)rr?r*)r>r*keywordsrs r-r?MiscTandem.__init__7 s $8$ r,cUR$rr*r&s r-r!MiscTandem._reprInternal; s++r,rrz)r&r'r(r)r?r!r+rrs@r-rGrG6 s  r,rGc6^\rSrSrSrSU4SjjrSrSrU=r$)rbi? z A Music21Object that represents a comment in a single spine. >>> sc = humdrum.spineParser.SpineComment('! this is a spine comment') >>> sc >>> sc.comment 'this is a spine comment' c b>[TU]"S0UD6 [R"SSU5nX0lg)Nz^!+\s?rzr%)rr?rarrwr>rwr commentPartrs r-r?SpineComment.__init__J s* $8$ffYG4 " r,c,[UR5$rr9rwr&s r-r!SpineComment._reprInternalO DLL!!r,rwr r&r'r(r)r*r?r!r+rrs@r-rbrb? s # ""r,rbc6^\rSrSrSrSU4SjjrSrSrU=r$)riS a A Music21Object that represents a comment for the whole score >>> sc = humdrum.spineParser.GlobalComment('!! this is a global comment') >>> sc >>> sc.comment 'this is a global comment' c >[TU]"S0UD6 [R"SSU5nUR 5nX0lg)Nr rzr%)rr?rarrrwrs r-r?GlobalComment.__init__] s8 $8$ffZW5 !'') " r,c,[UR5$rrr&s r-r!GlobalComment._reprInternalc rr,rrrrs@r-rrS s# ""r,rc z^\rSrSr%SrSU4Sjjr0SS_SS_S S _S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS _S!S_0S"S#_S$S_S%S&_S'S_S(S)_S*S_S+S_S,S_S-S_S.S_S/S_S0S_S1S2_S3S_S4S_S5S6_S7S8_E0S9S:_S;S<_S=S>_S?S@_SASB_SCSD_SESF_SGSH_SISJ_SKSL_SMSN_SOSP_SQS_SRSS_STSU_SVSW_SXSY_E0SZS[_S\S]_S^S_S_S_S`Sa_SbSc_SdSe_SfSg_ShSi_SjSk_SlSm_SnSo_SpSq_SrSs_StSu_SvSw_SxSy_E0SzS_S{S_S|S_S}S~_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_ESSSSSSSSSSSS. ErS\S'SSjrSr Sr U=r $)rig a A Music21Object that represents a reference in the score, called a "reference record" in Humdrum. See Humdrum User's Guide Chapter 2. >>> sc = humdrum.spineParser.GlobalReference('!!!REF:this is a global reference') >>> sc >>> sc.code 'REF' >>> sc.value 'this is a global reference' Alternate form >>> sc = humdrum.spineParser.GlobalReference('REF', 'this is a global reference') >>> sc >>> sc.code 'REF' >>> sc.value 'this is a global reference' Language codes are parsed: >>> sc = humdrum.spineParser.GlobalReference('!!!OPT@@RUS: Vesna svyashchennaya') >>> sc.code 'OPT' >>> sc.language 'RUS' >>> sc.isPrimary True >>> sc = humdrum.spineParser.GlobalReference('!!!OPT@FRE: Le sacre du printemps') >>> sc.code 'OPT' >>> sc.language 'FRE' >>> sc.isPrimary False rzc >[TU]"S 0UD6 [R"SSU5nUR 5nUc6SU;a0[R"SSU5n[R"SSU5nXlX lSUlSUlSUR ;a(SUlUR RSS 5UlS UR ;a)UR RS 5uUlUlgg) Nrrzrz^.*?:z:.*$Fz@@T@r%) rr?rarrrrlanguage isPrimaryreplacer)r> codeOrAll valueOrNonerrs r-r?GlobalReference.__init__ s $8$FF8R3 OO%  3)#3&&2y9KwI6I    499 !DN ))$4DI $)) '+yys'; $DIt} r,COMcomposerCOAattributedComposerCOSsuspectedComposerCOL composerAliasCOCcomposerCorporateCDTCBLCDLCNTLYRlyricistLIB librettistLARarrangerLOR orchestratorTXOtextOriginalLanguageTXL textLanguageTRN translatorRTLRMM manufacturerzRC#RRD dateIssuedRLCRNPproducerRDTzRT#MGNMPNMPSMRDMLCMCN conductorMPDMDTOTLtitleOTP popularTitleOTAalternativeTitleOPR parentTitleOAC actNumberOSC sceneNumberOMVmovementNumberOMD movementNameOPS opusNumberONMrpOVM volumeNumberODE dedicatedToOCO commissionOCL transcriberONBODT dateCreatedOCYcountryOfCompositionOPClocaleOfCompositionGTL groupTitleGAWassociatedWorkGCOcollectionDesignationPUBPEDPPRfirstPublisherPDTdateFirstPublishedPTLpublicationTitlePPPplaceFirstPublishedzPC#publishersCatalogNumberSCTscholarlyCatalogAbbreviationSCAscholarlyCatalogNameSMSmanuscriptSourceNameSMLmanuscriptLocationSMAmanuscriptAccessAcknowledgementYEPelectronicPublisherYEC copyrightYERelectronicReleaseDateYEMYENYORYOOoriginalDocumentOwnerYOYYOEoriginalEditorEEDelectronicEditorENCelectronicEncoderENDEMDEEVEFLESTVTSACOAFRAGN) ASTAMDAMTAINAREARLHAOHTXRLNRNBRWBdicthumdrumKeyToUniqueNamec URnURnURRUS5nU(aUR XC5 gX R;aUR SU-U5 gUR X#5 g)zy update a metadata object according to information in this GlobalReference See humdrum guide Appendix I for information rzzhumdrum:N)rrrgetadd addCustom)r>rcr uniqueNames r-rGlobalReference.updateMetadata si II JJ5599!R@  FF: ! -- - LLa + LL r,c:URSUR<3$)Nr)rrr&s r-r!GlobalReference._reprInternal# s))Adjj^,,r,)rr(r'r)rzN)rzmetadata.Metadata) r&r'r(r)r*r?r__annotations__rr!r+rrs@r-rrg s;'P<"l$ zl$ # l$ " l$  l$ "l$ rl$ rl$ rl$ rl$ zl$ |l$ zl$ ~l$ %!l$" ~#l$( |)l$* r+l$, ~-l$. r/l$0 |1l$2 r3l$4 z5l$6 r7l$8 r9l$< r=l$> r?l$@ rAl$B rCl$D rEl$F {Gl$H rIl$J rKl$N wOl$P ~Ql$R !Sl$T }Ul$V {Wl$X }Yl$Z [l$\ ~]l$^ |_l$` xal$b ~cl$d }el$f |gl$h }il$j rkl$l }ml$n %ol$p $ql$t |ul$v wl$x &yl$| r}l$~ rl$@ Al$B #Cl$D !El$F $Gl$H (Il$J -Kl$L %Ml$N %Ol$P #Ql$R 0Sl$T $Ul$V {Wl$X &Yl$Z r[l$\ r]l$^ r_l$` &al$b rcl$d el$f !gl$h "il$j rkl$l rml$n rol$p rql$r rsl$t rul$x ryl$z r{l$| r}l$~Wl$Dl\&--r,rc\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrg)Testi' c2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestrglobals)r>rs r-testCopyAndDeepcopyTest.testCopyAndDeepcopy( s7D')$r,c&[[R5nUR5 URR S5nUR URS5 UR URRS5 URR S5nURVs/sHoDRPM nnUR U/SQ5 UR URS5 URU[5 gs snf)Nr;r^)r;r& r:  #$'rrL) r/rmazurka6rHr8r assertEqualrTrUrrVassertIsInstancerl)r>hf1spine5spine1csspine1Childrens r-testLoadMazurkaTest.testLoadMazurka, s$I$6$67 $$$11!4 A& ++..2$$11!4*0*<*<=*s0Dc`[S5nUR5nURURRR S5 URUR RS5 URUR RSRRS5 g)Nz40..ccccc##_wtLLK~v/z double-sharprr\) rrrrrnamer rrr)r>abs r-testSingleNoteTest.testSingleNoteN s{ - . HHJ ++00.A !, ++A.==BBAFr,c[R"5n[SU5nURURS5 URUR S5 URUR RS5 URUR RS5 URUR R5 URUR R[R5 g)Nz=29a;:|:rrr)rrHr`rrprrrrassertIsNotNonerrrr)r>m0r7s r-testMeasureBoundariesTest.testMeasureBoundariesV s ^^  z2 . B' #. --y9 33V< R__223 boo33[5H5HIr,c4[S5nUR[U5S5 [S5nUR[U5S5 [S5nUR[U5S5 [S5nUR[U5S5 g) Nz*M3/1z!z*M3/0z!z*M3/00z"z*M3/000z")rvrr;)r>r!s r-testMeterBreveTest.testMeterBreve` s~ w ' Q!DE w ' Q!DE x ( Q!EF y ) Q!EFr,c[[R5nUR5 URnUR 5 g)zD test loading a fake piece with spine paths, lyrics, dynamics, etc. N)r/rfakeTestrHrshow)r>rvmss r-x_testFakePieceTest.x_testFakePiecej s/$I$6$67 ZZ  r,c[[R5nUR5 URnSnUR 5Hn[ US5(a3URRS:XaURS:XaUS- nMEMG[ US5(dMZURH,nURS:XdMURS:XdM'US- nM. M URUS5 g)NrrzG#r\r^pitchesV) r/rrrHrrrrrbeatrr)r>r masterStream gSharpCountrrs r-testSpineMazurkaTest.testSpineMazurkas s#I$6$67 zz  %%'Aq'""qww||t';66Q;1$KI&&Avv~!&&A+#q( # ( b)r,clSSKJn [R"5S- nUS- nUR U5ng)Nr) converterhumdrumzMissa_Sine_nomine-Kyrie.krn)music21rr getSourceFilePathrH)r>r parserPathsineNominePathunused_myScores r-testParseSineNomineTest.testParseSineNomine s1%--/); #&CC"8r,cZ[[R5nUR5 URnUR UR SRS5R55 URUR SRS5R55 g)Nrrlr;) r/r splitSpines2rHr assertTruepartsmeasurer@ assertFalse)r>rrs r-testSplitSpinesTest.testSplitSpines s|#I$:$:; zz   **1-55a8BBDE ++A.66q9CCEFr,cn[[R5nUR5 URngr)r/rrrHr)r>runused_ss r-x_testMoveDynamicsTest.x_testMoveDynamics s$#I$6$67 ::r,cSSKJn [[R5nUR 5 UR nURU5nURUS5 g)NrrzMagijago ickewyan) r r)r/rrrHrassembleLyricsr)r>r)rrr(s r-testLyricsInSpineTest.testLyricsInSpine sH #I$6$67 JJ$$Q' !45r,cn[[R5nUR5 URng)z Currently this does not work since a second split on a stream that already resulted from a split does not parse properly. Shows up also in strangeWTCOpening, below. N)r/r splitLotsrHrr>runused_masterStreams r-testSplitSpines2Test.testSplitSpines2 s' $I$7$78 !jjr,cN[[R5nURngr)r/rstrangeWTCOpeningrr"s r-testParseStrangeSplitTest.testParseStrangeSplit s#I$?$?@!jjr,c[[R5nUR5 URnUR Sn/nU[ HnURUR5 M URSU;5 g)Nr\z spine comment) r/rrrHrrrbrcrwr)r>rrrcommentsrs r-testSpineCommentsTest.testSpineComments se#I$6$67 JJ GGAJ<A OOAII &! 834r,c[[R5nUR5 URn0SS/SQSSSS4_SS/S QS S SS4_S S /S QSSSS4_SS/SQSSSS4_SS/SQSSSS4_SS/SQSSSS4_SS/SQSSSS4_SS /S!QSS"S#S4_S$S%/S&QS"S S'S(4_S)S/SQSSSS4_S*S/SQSSSS4_S+S,/S-QSSSS4_S.S//S0QS S SS4_S1S2/S3QS4S4SS4_S5S6/S7QS8SS#S4_S9S:/S;QSSSS4_S/S?QS@SAS#S4S=/SQSSSS4SB/SCQS SASDS(4S=/SQSSSS4SE/SFQS@SAS'S(4SG/SHQSSSS4S=/SQSSSS4S=/SQSSSS4SI/SQSSSS4SJ. EnUR 5R [R5HnURnURnUR5RnUR5RnUR5n UR5n UUUUU U 4n UR!XUR"5 M g)KNrn I in C majorrrlr5F?z ii in C major)r\r;rD@ziii in C major)rlr1 E@z IV in C major)r;rrF@zI64 in C major)r1rrlG@@z V in C major)r1r6r\@z vi in C majorrrrlA@z V6 in C major)r6r\r1Br& @zviio65/i in C majorr\r;rr6AT"@&@(@z i in c minor)rrkr1*@ziio in c minor)r\r;r,@zIII in c minor)rkr1r:zE-.@z N6 in c minor)r;rr^zD-0@zi64 in c minor)r1rrk1@z V in c minorzIt6 in c minor)rrr&zF#zA-zFr43 in c minor)rrr\r&+zGer65 in c minor)rrrkr&z iv in c minor)r;rrz I in c minor 2@g4@g5@g7@8@;@>@g@@g@@)r/rharmScaleDegreesrHrrrKrr figureAndKey pitchClassesrootrbass inversionName isSeventhrr r>rr groundTruthrrUrVrWrXrYrZ assertTuples r-testHarmSpineDegreesTest.testHarmSpineDegrees s#I$>$>? JJ .)S#r5A /9c3EB  "JS"eD  /9c3EB  "IsCUC  .*c3EB   /9c3EB  /:sCEB  'S"dK  .)S#r5A  >9c3EB  >9c3EB  #YS"eD  #ZtRG  ?ItS!UC #YS"eD! " >:sCUC# $$YdAuE!:sCUC$lCr4H!:sCUC%|T4TJ"IsCUC!:sCUC!:sCUC!9c3EB5 8IIK2253E3EFD,,L,,L99;##D99;##D ..0M(I K   [dkk*B CGr,c[[R5nUR5 URn0SS/SQSSSS4_SS/S QS S SS4_S S /S QSSSS4_SS/SQSSSS4_SS/SQSSSS4_SS/SQSSSS4_SS/SQSSSS4_SS /S!QSSS"S#4_S$S%/SQSSSS4_S&S'/SQSSSS4_S(S)/SQSSSS4_S*S+/SQSSSS4_S,S-/S QS S SS4_S.S//S QSSSS4_S0S1/S2QSSSS4_S3S4/S5QSSS"S#4_S6S7/S8QSSS9S4_S:/S;QS SSQSSS9S4S?/S@QSSSz V7 in C major)r1r6r\r;r;rAr/r0r2FrHz i7 in a minorrIziv7 in a minorrJz-VII7 in a minorrKzIII7 in a minorrLzVI7 in a minorrMziio7 in a minorrPz V7 in a minor)rlrr6r\g3@z i in a minorr?rQzI65 in C major)rlr1r6rrEzIV2 in C major)rlr;rr*zviio65 in C majorrDziii2 in C major)r\rlr1r6zvi43 in C major)rlr1rrrNzV43 in C major)r\r;r1r6zi65 in a minor)rrlr1rziv2 in a minor)rr\r;rz-VII65 in a minor)r6r\r;r1zIII2 in a minor)r6rrlr1zVI43 in a minor)rrlr;rzV43 in a minor)r6r\rlr)g9@g:@rRg<@g=@rSg?@gB@gB@gC@gC@gD@gD@gE@gE@)r/r harmSeventhsrHrrrKrrrUrVrWrrXrYrZrrr[s r-testHarmSpineSeventhsTest.testHarmSpineSevenths s|#I$:$:; JJ! /=#sAtD! "L#sAtD!  $mS#q$G!  #]CaF ! "L#sAtD ! "L#sAtD !  /=#sAtD!  .)S#r5A!  ?L#sAtD!  #\3QE!  %}c34H!  $mS#q$G!  #\3QE!  $mS#q$G!  ?M3QE! >9c3EB!! " #]Cb$G#! $$\3RF& sCTJ$mS#r4H$lCb$G#\3QE#]Cb$G!9c3EB#\3RF#\3RF& sCTJ$mS#r4H$lCb$G$mS#q$G#]Cb$G!9c3EBA! DIIK2253E3EFD,,L,,L99;##D99;##D ..0M(I K   [dkk*B CGr,c  [[R5nUR5 URn0SS_SS_SS_SS_SS_SS_SS_S S_S S_S S_S S_S S_SS_SS_SS_SS_SS_SSSSSSSSSS. EnUR 5R [R5HgnUR5nUR5nUR5nUR5nUUUU4n URXUR5 Mi g)Nrn)FFFFr3r5r8r:r=r>rArCrFrGrHrIrJrKrLrM)TTFF)TFTF)TFFTrO)r/rrTrHrrrKrrisAugmentedSixthisItalianAugmentedSixthisFrenchAugmentedSixthisGermanAugmentedSixthrr) r>rrr\rrfrgrhrir]s r-testHarmSpineAugmentedSixths!Test.testHarmSpineAugmentedSixths5 s#I$>$>? JJ -  -  -  -  -   -  -  -  -  -  .  .  .  . .! " .# $ .% &-.,.,....7 :IIK2253E3EFD#446 &*&B&B&D #%)%@%@%B "%)%@%@%B " '&& K   [dkk*B CGr,cSSKJn URS5nURnUR UR 5 UR SUR 5 g)Nr)corpuszpalestrina/agnus_0 Palestrina)r rmrHrrr.assertIn)r>rmrrs r-testMetadataRetrievedTest.testMetadataRetrievedc sA" LL- . ZZ R[[) lBKK0r,c[SnS[S'[[R5nUR 5 UR nS[S'[[R5nUR 5 UR nU[S'UR SRS5RSnUR SRS5RSnURURRS5 URURRS5 UR[URRSR5S5 URURRSRRS5 URURRS5 URURRS5 UR[URRSR5S 5 URURRSRRS5 g) NrFTrr^zEighth Triplet (1/2 QL)z8DurationTuple(type='eighth', dots=1, quarterLength=0.75)zDotted Eighth Triplet (1/2 QL)z7DurationTuple(type='eighth', dots=0, quarterLength=0.5))rr/r dottedTupletrHrrrnotesrr fullNamerr9rr)r> prevFlavorrvrhdc2dcndns r- testFlavorsTest.testFlavorsj sU^ #I$:$:; JJ$Y%;%;< KK# WWQZ   " ( ( + WWQZ   " ( ( + --/HI ))1- bkk11!4CCDS U ,,Q/>>CCQG --/OP ))1- bkk11!4CCDR T ,,Q/>>CCQGr,r%N)r&r'r(r)rrrrrrrrrrrr$r(r,r^rcrjrpr{r+r%r,r-rr' sn% 1DGJG*D9G6))5/Db5Dn,D\1Hr,rc\rSrSrSrSrSrg) TestExternali Tc[[R5nUR5 UR(aUR R 5 ggr)r/r sousaStarsrHrr)r>rs r- testShowSousaTestExternal.testShowSousa s5#I$8$89 99 JJOO  r,r%N)r&r'r(r)rrr+r%r,r-r~r~ s Dr,r~__main__r)Gr* __future__rrqrratypingr=unittestr rrrrrr r r r r rrrrrrrrrrrmusic21.humdrumrrrr>pathlib Environmentr|rrMusic21Exceptionr#ProtoM21Objectr/rrrr}r~rrrlrrrrrrr`rv Music21ObjectrGrbrrTestCaserr~r&mainTestr%r,r-rs$"F# ! %&'??&&'<= %.9 |44 n /G22n /b'>($ $B=+=@% %P#''#*a*7))a*H R1 R1j)*)*X2* 2*n>1''>1F{g,,{@DDNTnWtm"x ## "4%%"("D&&"(}-d((}-@YH8  YHx 8$$ z Tr,