3jP|dZddlmZddlZddlmZddlZddlZddl m Z ddl m Z ddl m Z ejr ddl mZdd l mZe j"d ZGd d e j&ZGd dZGddeZGddeZGddej0Zedk(rddl Z e j6eyy)za Tools for grouping notes and chords into a searchable tree organized by start and stop offsets. ) annotationsN)inf) OffsetQLIn) environment) exceptions21)basestreamz tree.spansc eZdZy)TimespanExceptionN__name__ __module__ __qualname__?/DATA/.local/lib/python3.12/site-packages/music21/tree/spans.pyr r #rr cdeZdZdZe efdZdZdZedZ edZ d dZ d Z d Z d Zy) Timespana+ A span of time, with a start offset and stop offset. Useful for demonstrating various properties of the timespan-collection class family. >>> timespan = tree.spans.Timespan(-1.5, 3.25) >>> print(timespan) A timespan has two attributes, its offset and its endTime. They are immutable. >>> timespan.offset -1.5 >>> timespan.endTime 3.25 To create a changed timespan, call the .new() method on the timespan. >>> ts2 = timespan.new(offset=0.0) >>> ts2 >>> ts3 = timespan.new(endTime=5.0) >>> ts3 Two timespans are equal if they have the same offset and endTime >>> ts4 = tree.spans.Timespan(-1.5, 5.0) >>> ts3 == ts4 True >>> ts4 == ts2 False c| t|}||_| t|}||_||||kDrtd|d|yyy)Noffset z must be after endTime )float_offset_endTimer selfoffsetendTimes r__init__zTimespan.__init__Nsi  6]F  GnG  '"5''&;RSZR](^__ #6 rct|t|ur3|j|jk(r|j|jk(ryy)NTF)typerr)rexprs r__eq__zTimespan.__eq__Ys8 :d #{{dkk)<<4<</rclt|j}d|d|jd|jdS)N< >)r"rrrrtypeNames r__repr__zTimespan.__repr__`s4:&&8*Adkk]!DLL>;;rc|jS)aM The start offset of the Timespan, relative to its containing score. >>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans() >>> verticality = scoreTree.getVerticalityAt(1.0) >>> timespan = verticality.startTimespans[0] >>> timespan.offset 1.0 )rrs rrzTimespan.offsetds||rc|jS)aM The stop offset of the Timespan, relative to its containing score. >>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans() >>> verticality = scoreTree.getVerticalityAt(1.0) >>> timespan = verticality.startTimespans[0] >>> timespan.endTime 2.0 )rr-s rrzTimespan.endTimets}}rNc`| |j}| |j}t|||S)zG return a new object with the given offset and endTime rr)rrr"rs rnewz Timespan.news3 >[[F ?llGtDz99rct|t|s d|d|d}d|fS|j|jk(s&|j|jk(s d|d|d}d|fSy)a returns a tuple of (True or False) if these timespans can be merged with the second element being a message or None. >>> ts1 = tree.spans.Timespan(0, 5) >>> ts2 = tree.spans.Timespan(5, 7) >>> ts1.canMerge(ts2) (True, '') >>> ts3 = tree.spans.Timespan(6, 10) >>> ts1.canMerge(ts3) (False, 'Cannot merge with : not contiguous') Overlapping Timespans cannot be merged, just contiguous ones. >>> ts4 = tree.spans.Timespan(3, 4) >>> ts1.canMerge(ts4) (False, 'Cannot merge with : not contiguous') Cannot merge  with z : wrong typesFz: not contiguous)T) isinstancer"rr)rothermessages rcanMergezTimespan.canMergest&%d,%dV6% FG7# #-MMT[[0%dV6%8HIG7# #rc|j|\}}|dur t||j|jkr|j|j}|S|j|j}|S)ad Merges two consecutive/contiguous timespans, keeping the information from the former of the two. >>> ts1 = tree.spans.Timespan(0, 5) >>> ts2 = tree.spans.Timespan(5, 7) >>> ts3 = ts1.mergeWith(ts2) >>> ts3 Note that (for now), overlapping timespans cannot be merged: >>> ts4 = tree.spans.Timespan(6, 10) >>> ts3.mergeWith(ts4) Traceback (most recent call last): music21.tree.spans.TimespanException: Cannot merge with : not contiguous Fr)r9r rr1r)rr7canr8mergedTimespans r mergeWithzTimespan.mergeWithsp&}}U+ W %<#G, , ;; %!XXemmX>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans(classList=(note.Note,)) >>> verticality = scoreTree.getVerticalityAt(0) >>> verticality >>> timespan = verticality.startTimespans[0] >>> timespan > >>> for shard in timespan.splitAt(0.25): ... shard ... > > >>> timespan.splitAt(1000) (>,) r;)r)rrr1)rrleftrights rsplitAtzTimespan.splitAtsL0 DKK 4<<7Nxxx''U{r)NN)rrr__doc__rr r$r+propertyrrr1r9r>rBrrrrr)s]"H #dC `<     :8:rrceZdZUdZddiZded< d dfd ZdZdZe d Z dd Z e d Z d Z e d ZdddZxZS)ElementTimespana A span of time anchored to an element in a score. The span of time may be the same length as the element in the score. It may be shorter (a "slice" of an element) or it may be longer (in the case of a timespan that is anchored to a single element but extends over rests or other notes following a note) PitchedTimespans give information about an element (such as a Note). It knows its absolute position with respect to the element passed into TimespanTree. It contains information about what measure it's in, what part it's in, etc. Example, getting a passing tone from a known location from a Bach chorale. First we create an Offset tree: >>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans() >>> scoreTree > Then get the verticality from offset 6.5, which is beat two-and-a-half of measure 2 (the piece is in 4/4 with a quarter-note pickup) >>> verticality = scoreTree.getVerticalityAt(6.5) >>> verticality There are four PitchedTimespans in the verticality -- each representing a note. The notes are arranged from lowest to highest. We can find all the PitchedTimespans that start exactly at 6.5. There's one. >>> verticality.startTimespans (>,) >>> pitchedTimespan = verticality.startTimespans[0] >>> pitchedTimespan > What can we do with a PitchedTimespan? We can get its Part object and from there the Part object name >>> pitchedTimespan.part >>> pitchedTimespan.part.partName 'Tenor' Find out what measure it's in: >>> pitchedTimespan.measureNumber 2 >>> pitchedTimespan.parentOffset 5.0 The position in the measure is given by subtracting that from the .offset: >>> pitchedTimespan.offset - pitchedTimespan.parentOffset 1.5 >>> pitchedTimespan.element These are not dynamic, so changing the Score object does not change the measureNumber, etc. parentageau The Stream hierarchy above the element in a ElementTimespan. >>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans() >>> verticality = scoreTree.getVerticalityAt(1.0) >>> pitchedTimespan = verticality.startTimespans[0] >>> pitchedTimespan > >>> for streamSite in pitchedTimespan.parentage: ... streamSite zdict[str, str] _DOC_ATTRct|||||_||_| t |}||_| t |}||_||||kDrtd|d|yyy)Nr0rz must be after parentEndTime )superr elementrGr parentOffset parentEndTimer rrKrLrMrGrr __class__s rr zElementTimespan.__init__Cs 807 "  # .L(  $!-0M*  # (Am+'l--J=J[\^^,)B #rc ||uS)Nr)rr7s rr$zElementTimespan.__eq__\s u}rc t|j}d|d|jd|jd|jd S)Nr&z (z to z) r()r"rrrrKr)s rr+zElementTimespan.__repr___s?:&&8*Bt{{m4 ~R ?OqQQrc4|j|jz S)a The quarterLength of the Timespan, which, due to manipulation, may be different from that of the element. >>> n = note.Note('D-') >>> n.offset = 1.0 >>> n.duration.quarterLength = 2.0 >>> pts = tree.spans.PitchedTimespan(n, offset=n.offset, endTime=3.0) >>> pts > >>> pts.quarterLength 2.0 >>> n.duration.quarterLength 2.0 >>> pts2 = pts.new(offset=0.0) >>> pts2 > >>> pts2.quarterLength 3.0 >>> pts2.element.duration.quarterLength 2.0 )rrr-s r quarterLengthzElementTimespan.quarterLengthes4||dkk))rc|xs |j}| |j}| |j}| |j}| |j}t |||||j ||S)a Create a new object that is identical to the calling object but with some parameters overridden. >>> n = note.Note('C#') >>> pts = tree.spans.PitchedTimespan(n, offset=11.0, endTime=12.0) >>> pts > >>> pts2 = pts.new(endTime=13.0) >>> pts2 > >>> pts.element is pts2.element True rKrLrMrGrr)rKrLrMrrr"rG)rrKrLrMrrs rr1zElementTimespan.newsy*)T\\  ,,L   ..M >[[F ?llGtDz%'nn   rc.|jjS)aN The measure number of the measure containing the element. >>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans() >>> verticality = scoreTree.getVerticalityAt(1.0) >>> pitchedTimespan = verticality.startTimespans[0] >>> pitchedTimespan.measureNumber 1 )rK measureNumberr-s rrWzElementTimespan.measureNumbers||)))rcF|jD]}t||s|cSy)a> returns that is the first parentage that has this classList. default stream.Part >>> score = corpus.parse('bwv66.6') >>> score.id = 'bach' >>> scoreTree = score.asTimespans() >>> verticality = scoreTree.getVerticalityAt(1.0) >>> pitchedTimespan = verticality.startTimespans[2] >>> pitchedTimespan > >>> pitchedTimespan.getParentageByClass(classList=(stream.Part,)) >>> pitchedTimespan.getParentageByClass(classList=(stream.Measure,)) >>> pitchedTimespan.getParentageByClass(classList=(stream.Score,)) The closest parent is returned in case of a multiple list: >>> searchTuple = (stream.Voice, stream.Measure, stream.Part) >>> pitchedTimespan.getParentageByClass(classList=searchTuple) TODO: this should take a normal class list. N)rGr6)r classListparents rgetParentageByClassz#ElementTimespan.getParentageByClasss&6nnF&), %rcHddlm}|j|jfS)a find the object in the parentage that is a Part object: >>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans() >>> verticality = scoreTree.getVerticalityAt(1.0) >>> pitchedTimespan = verticality.startTimespans[2] >>> pitchedTimespan > >>> pitchedTimespan.part rr )rY)music21r r[Part)rr s rpartzElementTimespan.parts! #''6;;.'AArc|j}|y|r9|}tj|}||j_d|j_|j |j_|S)z Return a copy of the element (or the same one if makeCopy is False) with the quarterLength set to the length of the timespan Nzspans.makeElement)rKcopydeepcopy derivationoriginmethodrSduration)rmakeCopyelel_olds r makeElementzElementTimespan.makeElementsZ \\ : Fv&B#)BMM #6BMM $($6$6 ! r)NNNrNN) rKbase.Music21Object | NonerLOffsetQLIn | NonerMrlrGztuple[stream.Stream, ...]rrlrrl)NNNNN)T)rgboolreturnrk)rrrrCrH__annotations__r r$r+rDrSr1rWr[r_rj __classcell__rOs@rrFrFsBL !I~,,0(,)-/1"&#'^(^&^' ^ - ^  ^!^2R **< & T * *&@BB rrFcFeZdZ dfd ZedZfdZxZS)PitchedTimespanc0t|||||||y)NrU)rJr rNs rr zPitchedTimespan.__init__s( &2'4#, &!(  *rc.|jjS)a Gets the pitches of the element wrapped by this PitchedTimespan. >>> c = chord.Chord('C4 E4 G4') >>> pts = tree.spans.PitchedTimespan(c, offset=0.0, endTime=1.0) >>> pts.pitches (, , ) >>> pts.pitches == c.pitches True >>> pts.pitches is c.pitches False )rKpitchesr-s rrvzPitchedTimespan.pitchess||###rct||\}}|dur$|j|jk7r d|d|d}d}||fS)a9 sub-method of base canMerge that checks to see if the pitches are the same. For quick score reductions, we can merge two consecutive like-pitched element timespans, keeping score-relevant information from the first of the two, such as its Music21 Element. This is useful when using timespans to perform score reduction. Let's demonstrate merging some contiguous E's in the alto part of a Bach chorale: >>> score = corpus.parse('bwv66.6') >>> scoreTree = score.asTimespans(classList=(note.Note,)) >>> timespan_one = scoreTree[12] >>> print(timespan_one) > >>> print(timespan_one.part) >>> timespan_two = scoreTree.findNextPitchedTimespanInSameStreamByClass(timespan_one) >>> print(timespan_two) > >>> timespan_one.canMerge(timespan_two) (True, '') >>> merged = timespan_one.mergeWith(timespan_two) >>> print(merged) > >>> merged.part is timespan_one.part True Attempting to merge timespans which are not contiguous, or which do not have identical pitches will result in error: >>> scoreTree[0].canMerge(scoreTree[50]) (False, 'Cannot merge > with >: not contiguous') >>> scoreTree[0].mergeWith(scoreTree[50]) Traceback (most recent call last): music21.tree.spans.TimespanException: Cannot merge > with >: not contiguous This is probably not what you want to do: get the next element timespan in the same score: >>> timespan_twoWrong = scoreTree.findNextPitchedTimespanInSameStreamByClass( ... timespan_one, classList=(stream.Score,)) >>> print(timespan_twoWrong) > >>> print(timespan_twoWrong.part) Tr3r4z: different pitchesF)rJr9rv)rr7r<r8rOs rr9zPitchedTimespan.canMerge(sTzw'. W $;||u}},)$veWrs# + ??&{&&|4  22 {{@YhY|cocP 8    zGTr