rhY SrSSKJr SSKJr SSKrSSKrSSKJ r SSKJ r SSKJ r SSKJ r SS KJ r SS KJr \R (aSS KJr \ R$"S 5r"S S\ R(5r\ R,S\ R,S\ R,S\ R,S\ R,S\ R,S\ R,S\ R,S\ R,S4 r"SS\ R0\\ R25r"SS\ R0\5r"SS\R85r\\/r\S:XaSSKr\R@"\5 gg)a The module defines Beam and Beams (note plural) objects. The Beams object holds multiple Beam objects (e.g., a 32nd note might have three Beam objects in its Beam object). The Beams object is stored in :class:`~music21.note.Note` and :class:`~music21.chord.Chord` objects as their :attr:`~music21.note.Note.beams` attributes. Beams objects can largely be treated as a list. See `meter.TimeSignature`. :meth:`~music21.meter.TimeSignature.getBeams` for a way of getting beam information for a measure given the meter. The `meter.TimeSignature`. :attr:`~music21.meter.TimeSignature.beamSequence` attribute holds information about how to beam given the TimeSignature Run `Stream`. :meth:`~music21.stream.Stream.makeBeams` to set beaming information automatically given the current meter. Suppose you had a measure of two eighths and a quarter and wanted to explicitly beam the two eighth notes. You could do this: >>> m = stream.Measure() >>> n1 = note.Note('C4', quarterLength=0.5) >>> n2 = note.Note('D4', quarterLength=0.5) >>> n3 = note.Note('E4', quarterLength=1.0) >>> m.append(n1) >>> m.append(n2) >>> m.append(n3) >>> n1.beams.fill('eighth', type='start') >>> n2.beams.fill('eighth', type='stop') >>> n1.beams > >>> n2.beams > But suppose you wanted something harder: two 16ths, an 8th, a quarter, with the first 3 notes beamed? The first note and 3rd are easy to do, using the method above: >>> m = stream.Measure() >>> n1 = note.Note('C4', quarterLength=0.25) >>> n2 = note.Note('D4', quarterLength=0.25) >>> n3 = note.Note('E4', quarterLength=0.5) >>> n4 = note.Note('F4', quarterLength=1.0) >>> for n in [n1, n2, n3, n4]: ... m.append(n) >>> n1.beams.fill('16th', type='start') >>> n3.beams.fill('eighth', type='stop') but the second note has an 8th beam that continues and a 16th beam that stops. So you will need to set them separately: >>> n2.beams.append('continue') >>> n2.beams.append('stop') >>> n2.beams /> To get rid of beams on a note do: >>> n2.beams.beamsList = [] ) annotations)IterableN) exceptions21)duration) environment)prebase)style)EqualSlottedObjectMixin)basebeamc\rSrSrSrg) BeamException_N)__name__ __module__ __qualname____firstlineno____static_attributes__rF/home/james-whalen/.local/lib/python3.13/site-packages/music21/beam.pyrr_srr @c:^\rSrSrSrSrSU4SjjrSrSrU=r $)Beamla A Beam is an object representation of one single beam, that is, one horizontal line connecting two notes together (or less commonly a note to a rest). Thus, it takes two separate Beam objects to represent the beaming of a 16th note. The Beams object (note the plural) is the object that handles groups of Beam objects; it is defined later on. Here are two ways to define the start of a beam >>> b1 = beam.Beam(type='start') >>> b2 = beam.Beam('start') Here is a partial beam (that is, one that does not connect to any other note, such as the second beam of a dotted eighth, sixteenth group) Two ways of doing the same thing >>> b3 = beam.Beam(number=1, type='partial', direction='left') >>> b3 >>> b4 = beam.Beam('partial', 'left') >>> b4.number = 1 >>> b4 All attributes must be the same for equality: >>> b3 == b4 True >>> b2 >>> b2 == b3 False ) directionidindependentAnglenumbertypect>[TU]5 XlX lSUlX0l[ U5UlgN)super__init__r(r$r&r'r%)selfr(r$r' __class__s rr, Beam.__init__s4  " $ T(rczURSUR3nURbUSUR3- nU$N/)r'r(r$)r-outs r _reprInternalBeam._reprInternals? Qtyyk* >> % Qt~~&' 'C r)NNN) rrrr__doc__ __slots__r,r4r __classcell__)r.s@rr"r"ls%RI rr"c\rSrSr%SrSrSS0rS\S'SrS r S r S r S r S r \SSj5r\SSj5r\S5r\SSj5rSSjrSSjrSrSrSrSrSSjrSSjrSrg) Beamsa The Beams object stores in it attribute beamsList (a list) all the Beam objects defined above. Thus, len(beam.Beams) tells you how many beams the note currently has on it, and iterating over a Beams object gives you each Beam. >>> n = note.Note(type='16th') >>> isinstance(n.beams, beam.Beams) True >>> n.beams.fill(2, 'start') >>> len(n.beams) 2 >>> for thisBeam in n.beams: ... thisBeam.type 'start' 'start' >>> print(n.beams) />  beamsList featheredr%r>zg Boolean determining if this is a feathered beam or not (does nothing for now).zdict[str, str] _DOC_ATTRc@/UlSUl[U5Ulg)NFr<r-s rr,Beams.__init__sT(rc,[UR5$r*)iterr=rAs r__iter__Beams.__iter__sDNN##rc,[UR5$r*)lenr=rAs r__len__ Beams.__len__s4>>""rch[XR5=(a [U5[U5:H$r*) isinstancer.repr)r-others r__eq__ Beams.__eq__s#%0NT$Z4;5NNrc[U5S- $)N)r%rAs r__hash__Beams.__hash__s$x1}rc/nURHnUR[U55 M SRU5$r1)r=appendstrjoin)r-msgr s rr4Beams._reprInternals3NND JJs4y !#xx}rcD/nUHnURR[;aURS5 M4SUR;aURS5 MW[ 5nUR URR5 URU5 M U$)a Given a list or iterator of elements, return a list of None or Beams for each element: None if the element is a quarter or larger or if the element is a Rest, and the fullest possible set of beams for the duration if it is a beamable. Each beam object has type of None staticmethod, does not need instance: >>> durList = [0, -1, -2, -3] >>> srcList = [note.Note(quarterLength=2 ** x) for x in durList] >>> srcList.append(note.Rest(type='32nd')) >>> beam.Beams.naiveBeams(srcList) [None, >, />, //>, None] NNotRest)rr(beamableDurationTypesrVclassSetr:fill)srcListr=elbs r naiveBeamsBeams.naiveBeamss,') B{{'<<  &"++-  &Gr{{''(  #rcSn[[U55H-nU[U5S- :waXS-nOSnUcUcSX'XnM/ U$)a Go through the naiveBeamsList and remove beams from objects surrounded by None objects -- you can't beam to nothing! Modifies beamsList in place >>> N = note.Note >>> R = note.Rest >>> e = 'eighth' >>> nList = [N(type=e), R(type=e), N(type=e), N(type=e), ... R(type=e), N(type=e), R(type=e), N(type=e)] >>> beamsList = beam.Beams.naiveBeams(nList) >>> beamsList [>, None, >, >, None, >, None, >] >>> beamsList2 = beam.Beams.removeSandwichedUnbeamables(beamsList) >>> beamsList2 is beamsList True >>> beamsList2 [None, None, >, >, None, None, None, None] N)rangerH)r=beamLastibeamNexts rremoveSandwichedUnbeamables!Beams.removeSandwichedUnbeamables$s`Ls9~&AC NQ&&$U+H$4#  |H'rc B[[USSUSS55GH1unup#U(aU(dMUR5nU(dM2UHnURU5nURS:wdUR S:waM6XSR5;aMKURU5nURS:XaUR S:XaM~URS;a'[ RSRX#X55 MSUlSUlURS:XaS UlOURS:XaS UlSUlM GM4 [USSUSS5Hup(U(aU(dMUR5nU(dM.UHnURU5nURS:wdUR S :waM6XXR5;aMKURU5n U RS :waMnS UlSUlS U lM M U$) z Partial-right followed by partial-left must also be connected, even if otherwise over a archetypeSpan, such as 16th notes 2 and 3 in a quarter note span where 16ths are not beamed by default. Nrfpartialright)continuestopz6Found a messed up beam pair {}, {}, at index {} of {}startrrrqleft) enumeratezip getNumbers getByNumberr(r$ environLocalwarnformat) r=ribThisbNextbThisNumthisNumthisBeamnextBeambPrevprevBeams rmergeConnectingPartialBeams!Beams.mergeConnectingPartialBeamsVs"+3y"~y}+M!N A~'')H# ,,W5==I-1C1Cw1N"2"2"44 ,,W5==I-(2D2D2O==$88 %%QXX!!89 ' %)"==I-$*HM]]g-$.HM%)"1$"OF !" y"~>LE'')H# ,,W5==I-1C1Cv1M"2"2"44 ,,W5==F* & %)" * $?0rc[U5HupUcM UR5nSU;aSU;a SU;aSX'M2SnSnURHnURS:XaSnMURS:XaSnM+U(a)URS:XaURS:Xa S UlM[U(dMdURS:XdMvURS :XdMSUlM M U$) a It is possible at a late stage to have beams that only consist of partials or beams with a 'start' followed by 'partial/left' or possibly 'stop' followed by 'partial/right'; beams entirely consisting of partials are removed and the direction of irrational partials is fixed. NrsrrrqFTrortrp)rugetTypesr=r(r$)r=ribeamsObjallTypeshasStarthasStoprbs rsanitizePartialBeamsBeams.sanitizePartialBeamss%Y/KA((*Hh&6+AjX`F`# HG''66W$#H66V#"G) 3 v8M")AKW9!49O"(AK(04rNc[U[5(a)[X5n[UR5S-UlOUnURR U5 g)a Append a new Beam object to this Beams object, automatically creating the Beam object and incrementing the number count. >>> beams = beam.Beams() >>> beams.append('start') >>> beams.beamsList [] >>> beams.append('partial', 'right') >>> beams.beamsList [, ] A beam object can also be specified: >>> beams = beam.Beams() >>> beam1 = beam.Beam(type='start', number=1) >>> beams.append(beam1) >>> beams.beamsList [] rfN)rLrWr"rHr=r'rV)r-r(r$objs rrV Beams.appendsG. dC t'CT^^,q0CJC c"rc/UlUSS[RS4;aSnOUS[RS4;aSnOUS[RS4;aSnOUS[RS 4;aSnOUS [RS 4;aS nO~US [RS 4;aS nObUS[RS4;aSnOFUS[RS4;aSnO*US[RS4;aSnO[SU35e[ SUS-5H.n[ 5nXElURRU5 M0 UbURU5 gg)a A quick way of setting the beams list for a particular duration, for instance, `fill('16th')` will clear the current list of beams in the Beams object and add two beams. `fill(2)` will do the same (though note that that is an int, not a string). It does not do anything to the direction that the beams are going in, or by default. Either set type here or call `setAll()` on the Beams object afterwards. Both "eighth" and "8th" work. Adding more than nine beams (i.e. things like 4096th notes) raises an error. >>> a = beam.Beams() >>> a.fill('16th') >>> len(a) 2 >>> a.fill('32nd', type='start') >>> len(a) 3 >>> a.beamsList[2] >>> a.beamsList[2].type 'start' Filling a smaller number wipes larger numbers of beams: >>> a.fill('eighth', type='start') >>> len(a) 1 OMIT_FROM_DOCS >>> a.fill(4) >>> len(a) 4 >>> a.fill('128th') >>> len(a) 5 >>> a.fill('256th') >>> len(a) 6 >>> a.fill(12) Traceback (most recent call last): music21.beam.BeamException: cannot fill beams for level 12 rf8thrrrrRrrrrr r zcannot fill beams for level N) r=rtypeFromNumDictrrgr"r'rVsetAll)r-levelr(countrirs rr_ Beams.fillsrj Qx77:; ;E q(22267 7E q(22267 7E q(22267 7E q(22378 8E q(22378 8E q(22378 8E q(22489 9E q(22489 9E">ug FG Gq%!)$A&CJ NN ! !# &%   KK  rcXR5;a[SUS35eURHnURU:XdMUs $ g)z Gets an internal beam object by number. >>> a = beam.Beams() >>> a.fill('16th') >>> a.setAll('start') >>> a.getByNumber(2).type 'start' >>> a.getByNumber(30) Traceback (most recent call last): IndexError: beam number 30 cannot be accessed beam number  cannot be accessedN)rw IndexErrorr=r')r-r'r s rrxBeams.getByNumber4sE * *|F83FGH HNND{{f$ #rcXURVs/sHoRPM sn$s snf)z Returns a list of all defined beam numbers; it should normally be a set of consecutive integers, but it might not be. >>> a = beam.Beams() >>> a.fill('32nd') >>> a.getNumbers() [1, 2, 3] )r=r'r-xs rrwBeams.getNumbersHs"#'..1.Q.111'cURU5nURc UR$URSUR3$)z Get beam type, with direction, by number >>> a = beam.Beams() >>> a.fill('16th') >>> a.setAll('start') >>> a.setByNumber(2, 'partial-right') >>> a.getTypeByNumber(2) 'partial-right' >>> a.getTypeByNumber(1) 'start' -)rxr$r()r-r'beamObjs rgetTypeByNumberBeams.getTypeByNumberTsF""6*    $<< ll^1W%6%6$78 8rcXURVs/sHoRPM sn$s snf)z Returns a list of all beam types defined for the current beams >>> a = beam.Beams() >>> a.fill('16th') >>> a.setAll('start') >>> a.getTypes() ['start', 'start'] )r=r(rs rrBeams.getTypeshs"!%/1///rcjUS;a[SU35eURHnXlX#lM g)a1 `setAll` is a method of convenience that sets the type of each of the beam objects within the beamsList to the specified type. It also takes an optional "direction" attribute that sets the direction for each beam (otherwise the direction of each beam is set to None) Acceptable directions (start, stop, continue, etc.) are listed under Beam() above. >>> a = beam.Beams() >>> a.fill('16th') >>> a.setAll('start') >>> a.getTypes() ['start', 'start'] >>> a.setAll('sexy') Traceback (most recent call last): music21.beam.BeamException: beam type cannot be sexy rsrrrqrobeam type cannot be N)rr=r(r$)r-r(r$r s rr Beams.setAllts8( ? ?"6tf => >NNDI&N#rcSU;aURS5up#US;a[SU35eXR5;a[SUS35eURH!nUR U:XdMX$lX4lM# g)aZ Set an internal beam object by number, or rhythmic symbol level. >>> a = beam.Beams() >>> a.fill('16th') >>> a.setAll('start') >>> a.setByNumber(1, 'continue') >>> a.beamsList[0].type 'continue' >>> a.setByNumber(2, 'stop') >>> a.beamsList[1].type 'stop' >>> a.setByNumber(2, 'partial-right') >>> a.beamsList[1].type 'partial' >>> a.beamsList[1].direction 'right' >>> a.setByNumber(30, 'stop') Traceback (most recent call last): IndexError: beam number 30 cannot be accessed >>> a.setByNumber(2, 'crazy') Traceback (most recent call last): music21.beam.BeamException: beam type cannot be crazy rrrrrN)splitrrwrr=r'r(r$)r-r'r(r$r s r setByNumberBeams.setByNumbers}@ $;"jjoOD ? ?"6tf => > * *|F83FGH HNND{{f$ !*#r)r`zIterable[base.Music21Object])r=list[Beams | None])r=rreturnr)NNr*)rrrrr6r7r?__annotations__r,rErIrOrSr4 staticmethodrcrkrrrVr_rxrwrrrrrrrrr:r:s2I '!I~$#O%%N//bBBH!!L#>Qf( 29( 0'4)+rr:c\rSrSrSrSrg)Testic2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestrglobals)r-rs rtestCopyAndDeepcopyTest.testCopyAndDeepcopys7D')$rrN)rrrrrrrrrrrs%rr__main__)!r6 __future__rcollections.abcrtypingtunittestmusic21rrrrr music21.common.objectsr TYPE_CHECKINGr EnvironmentryMusic21Exceptionrrr]ProtoM21Object StyleMixinr"r:TestCaser _DOC_ORDERrmainTestrrrrsT=|#$ :??&&v.  L11  Q R (":":2"> R (":":3"? S!8#;#;C#@ T"H$<$