rh52SrSSKJr SSKJr SSKrSSKrSSKJ r SSK J r SSK J r SSKJr SS KJrJr SS KJr SS KJr SS KJr \R."S 5r"SS\ R2\ 5r"SS\5r\S:XaSSKr\R:"5 gg)z This module defines two component objects for defining nested metrical structures: :class:`~music21.meter.core.MeterTerminal` and :class:`~music21.meter.core.MeterSequence`. ) annotations)SequenceN)prebase)opFrac)SlottedObjectMixin)common)DurationDurationException) environment)MeterException)toolsz meter.corecp\rSrSrSrSrSSSjjrSSjrSrSr S r SS jr S r SS jr SS jr\SSj5r\R"SSj5r\SSj5r\R"S Sj5r\SSj5r\R"S Sj5rSr\S5r\R"S!Sj5r\S5rSrg)" MeterTerminal#a  A MeterTerminal is a nestable primitive of rhythmic division. >>> a = meter.MeterTerminal('2/4') >>> a.duration.quarterLength 2.0 >>> a = meter.MeterTerminal('3/8') >>> a.duration.quarterLength 1.5 >>> a = meter.MeterTerminal('5/2') >>> a.duration.quarterLength 10.0 ) _denominator _duration _numerator_overriddenDuration_weightNcSUlSUlSUlSUlSUlUb8[ R "U5nURUlURUlUR5 X lg)Nr) rrrrrr slashToTuple numerator denominator _ratioChanged)self slashNotationweightvaluess L/home/james-whalen/.local/lib/python3.13/site-packages/music21/meter/core.py__init__MeterTerminal.__init__<so)- !""# 26  $'' 6F$..DO & 2 2D    cUR5nURUlURUlUR5 URUlU$)z Helper method to for the deepcopy function in copy.py. Do not call this directly. Defining a custom __deepcopy__ here is a performance boost, particularly in not copying _duration, directly assigning _weight, and other benefits. ) __class__rrrrrmemonews r __deepcopy__MeterTerminal.__deepcopy__UsEnn,, ll  r#c[U5$N)strrs r _reprInternalMeterTerminal._reprInternalis 4yr#c[[UR55S-[[UR55-$)N/)r-intrrr.s r __str__MeterTerminal.__str__ls03t~~&'#-C8H8H4I0JJJr#cvUcgURUR:XaURUR:Xagg)aY Compare the numerator and denominator of another object. Note that these have to be exact matches; 3/4 is not the same as 6/8 >>> a = meter.MeterTerminal('3/4') >>> b = meter.MeterTerminal('6/4') >>> c = meter.MeterTerminal('2/4') >>> d = meter.MeterTerminal('3/4') >>> a.ratioEqual(b) False >>> a.ratioEqual(c) False >>> a.ratioEqual(d) True FTrr)rothers r ratioEqualMeterTerminal.ratioEqualos6 = OOt~~ -%%)9)99r#cP[5nURXSURS9 U$)a returns a MeterSequence made up of taking this MeterTerminal and subdividing it into the given number of parts. Each of those parts is a MeterTerminal >>> a = meter.MeterTerminal('3/4') >>> b = a.subdivideByCount(3) >>> b >>> len(b) 3 >>> b[0] What happens if we do this? >>> a = meter.MeterTerminal('5/8') >>> b = a.subdivideByCount(2) >>> b >>> len(b) 2 >>> b[0] >>> b[1] But what if you want to divide into 3/8+2/8 or something else? for that, see the :meth:`~music21.meter.MeterSequence.load` method of :class:`~music21.meter.MeterSequence`. T) autoWeight targetWeight) MeterSequenceloadr)r countRequestmss r subdivideByCountMeterTerminal.subdivideByCounts)B_ t$++N r#c^[5nURU5 URU5 U$)a' Return a MeterSequence dividing this MeterTerminal according to the numeratorList >>> a = meter.MeterTerminal('3/4') >>> b = a.subdivideByList([1, 1, 1]) >>> b >>> len(b) 3 >>> b[0] Unequal subdivisions work: >>> c = a.subdivideByList([1, 2]) >>> c >>> len(c) 2 >>> (c[0], c[1]) (, ) So does subdividing by strings >>> c = a.subdivideByList(['2/4', '1/4']) >>> len(c) 2 >>> (c[0], c[1]) (, ) See :meth:`~music21.meter.MeterSequence.partitionByList` method of :class:`~music21.meter.MeterSequence` for more details. )r>r?partitionByList)r numeratorListrAs r subdivideByListMeterTerminal.subdivideByLists*H_   =) r#c[5nURRURR:wa[SU35eUR U5 U$)a Return a MeterSequence based on another MeterSequence >>> a = meter.MeterSequence('1/4+1/4+1/4') >>> a >>> b = meter.MeterSequence('3/8+3/8') >>> a.subdivideByOther(b) >>> terminal = meter.MeterTerminal('1/4') >>> divider = meter.MeterSequence('1/8+1/8') >>> terminal.subdivideByOther(divider) zcannot subdivide by other: )r>duration quarterLengthr r?)rr8rAs r subdivideByOtherMeterTerminal.subdivideByOthersJ"_ >> ' '4==+F+F F #>ug!FG G  r#c[R"U5(aURU5$[U[5(aUR U5$[R "U5(aURU5$[SU35e)a) Subdivision takes a MeterTerminal and, making it into a collection of MeterTerminals, Returns a MeterSequence. This is different from partitioning a MeterSequence. `subdivide` does not happen in place and instead returns a new object. If an integer is provided, assume it is a partition count. "cannot process partition argument ) r isListLikerG isinstancer>rLisNumrBr rvalues r subdivideMeterTerminal.subdividesw   U # #''. . } - -((/ / \\% ((/ / #EeW!MN Nr#cUR$)zu Return or set the weight of a MeterTerminal >>> a = meter.MeterTerminal('2/4') >>> a.weight = 0.5 >>> a.weight 0.5 rr.s r rMeterTerminal.weight s||r#cXlgr,rXrSs r rrYs r#cUR$)z Return or set the numerator of the MeterTerminal >>> a = meter.MeterTerminal('2/4') >>> a.numerator 2 >>> a.duration.quarterLength 2.0 >>> a.numerator = 11 >>> a.duration.quarterLength 11.0 )rr.s r rMeterTerminal.numeratorsr#c0XlUR5 gr,)rrrSs r rr\+s r#cUR$)a: Get or set the denominator of the meter terminal >>> a = meter.MeterTerminal('2/4') >>> a.denominator 4 >>> a.duration.quarterLength 2.0 >>> a.denominator = 8 >>> a.duration.quarterLength 1.0 >>> a.denominator = 7 Traceback (most recent call last): music21.exceptions21.MeterException: bad denominator value: 7 )rr.s r rMeterTerminal.denominator0s$   r#ctU[R;a[SU35eXlUR 5 g)Nzbad denominator value: )r validDenominatorsSetr rrrSs r rr_Ds7 22 2 #:5'!BC C! r#c[5UlSUR-UR- URlg![ a0 [ RSSURUR/5 gf=f)z9 If ratio has been changed, call this to update duration g@zDurationException encounteredznumerator/denominatorN)r rrrrKr environLocal printDebugr.s r rMeterTerminal._ratioChangedLso " t~~%)9)99 NN (!   # #0(!!  s+=7A76A7cTUR(a UR$UR$)z duration gets or sets a duration value that is equal in length of the terminal. >>> a = meter.MeterTerminal() >>> a.numerator = 3 >>> a.denominator = 8 >>> d = a.duration >>> d.type 'quarter' >>> d.dots 1 >>> d.quarterLength 1.5 )rrr.s r rJMeterTerminal.durationas#"  # #++ +>> !r#cXlgr,)rrSs r rJrgws#( r#cg)zQ Return how many levels deep this part is -- the depth of a terminal is always 1 rr.s r depthMeterTerminal.depth{s r#)Nr)rz str | Noner int | floatr,)r8z'music21.meter.MeterSequence')rTz)Sequence[int | str] | MeterSequence | int)return float | int)rTrornr3)rTr3)rTr )__name__ __module__ __qualname____firstlineno____doc__ __slots__r!r)r/r4r9rBrGrLrUpropertyrsetterrrrrJrk__static_attributes__rjr#r rr#s I2(K4&P'R0O8O2   ]]  !!&*""*__))r#rc(^\rSrSrSrSrS.S/U4SjjjrS0SjrS1SjrSr Sr S2S jr S r \ S 5rS3S jrS4S jrS5SjrS6S7SjjrS8SjrS9SjrS:S;SjjrS0SS?SjjrSr\ S@Sj5r\R:SASj5rSr\ S5rSBSjr \ S5r!\ S5r"S S!.S"jr#S6SCS#jjr$SDS$jr%SES%jr&SES&jr'SES'jr(S:SFS(jjr)S:S)jr*S:S*jr+S+r,SGSHS,jjr-S-r.U=r/$)Ir>izG A meter sequence is a list of MeterTerminals, or other MeterSequences )_levelListCache _partition parenthesissummedNumeratorc>[TU]5 SUlSUl/Ul0UlSUlSUlUbURX5 gg)NrrF) superr!rrr|r{r~r}r?)rrTpartitionRequestr%s r r!MeterSequence.__init__sY  !"=?LN&+"'   IIe . r#c<UR5nURUlURUl[R"UR U5UlUR 5 URUlURUlURUl U$)a Helper method to copy.py's deepcopy function. Call it from there. Defining a custom __deepcopy__ here is a performance boost, particularly in not copying _duration and other benefits. Notably, self._levelListCache is not copied, which may not be needed in the copy and may be large. >>> from copy import deepcopy >>> ms1 = meter.MeterSequence('4/4+3/8') >>> ms2 = deepcopy(ms1) >>> ms2 ) r%rrcopydeepcopyr|rrr~r}r&s r r)MeterSequence.__deepcopy__s{"nn,,t= #'":":"22** r#c\[U5[U5:a[eURU$)zu Get an MeterTerminal (or MeterSequence) from _partition >>> a = meter.MeterSequence('4/4', 4) >>> a[3].numerator 1 )abslen IndexErrorr|)rkeys r __getitem__MeterSequence.__getitem__s) s8s4y  s##r#c,[UR5$)z Support iteration of top level partitions >>> a = meter.MeterSequence('4/4', 2) >>> for x in a: ... print(repr(x)) )iterr|r.s r __iter__MeterSequence.__iter__sDOO$$r#c,[UR5$)z Return the length of the partition list >>> a = meter.MeterSequence('4/4', 4) >>> a >>> len(a) 4 )rr|r.s r __len__MeterSequence.__len__s4??##r#c[U[5(d[SSU3-5eURX5(aX RU'O[SUSX35e0Ulg)a9 Insert items at index positions. >>> a = meter.MeterSequence('4/4', 4) >>> a >>> a[0] >>> a[0] = a[0].subdivide(2) >>> a >>> a[0][0] = a[0][0].subdivide(2) >>> a >>> a[3] >>> a[3] = a[0][0] Traceback (most recent call last): ... music21.exceptions21.MeterException: cannot insert {1/16+1/16} into space of 1/4 z3values in MeterSequences must be MeterTerminals or zMeterSequences, not zcannot insert z into space of N)rQrr r9r|r{)rrrTs r __setitem__MeterSequence.__setitem__sv.%// !V%9%#A"BC C   DI & &#(OOC  >% {!ST T "r#c&SUR-S-$)N{})partitionDisplayr.s r r4MeterSequence.__str__sT***S00r#c/nURHnUR[U55 M SRU5$)a Property -- Display the partition as a str without the surrounding curly brackets. >>> a = meter.MeterSequence('4/4') >>> a.partitionDisplay '4/4' >>> a = meter.MeterSequence('2/4+6/8') >>> a.partitionDisplay '2/4+6/8' partitionDisplay is most useful for non-divided meter sequences. This is less helpful: >>> a = meter.MeterSequence('4/4', 4) >>> a.partitionDisplay '1/4+1/4+1/4+1/4' +)r|appendr-join)rmsgmts r rMeterSequence.partitionDisplays5$//B JJs2w "xx}r#c /Ul0Ulg)zE This will not sync with .numerator and .denominator if called alone N)r|r{r.s r _clearPartitionMeterSequence._clearPartition5s!r#c[U[5(aUnO [U5nURRU5 0Ulg)z Add an object to the partition list. This does not update numerator and denominator. ???: (targetWeight is the expected total Weight for this MeterSequence. This would be self.weight, but often partitions are cleared before _addTerminal is called.) N)rQrr|rr{)rrTrs r _addTerminalMeterSequence._addTerminal=s< e] + +Bu%B r"!r#c([UR5n[UR5n/nUR[ [ R "X555 UR[ [ R"X555 [U5$)a Return either a cached or a new set of division/partition options. Calls `tools.divisionOptionsAlgo` and `tools.divisionOptionsPreset` (which will be empty except if the numerator is 5). Works on anything that has a .numerator and .denominator. >>> meter.MeterSequence('3/4').getPartitionOptions() (('1/4', '1/4', '1/4'), ('1/8', '1/8', '1/8', '1/8', '1/8', '1/8'), ('1/16', '1/16', '1/16', '1/16', '1/16', '1/16', '1/16', '1/16', '1/16', '1/16', '1/16', '1/16'), ('3/4',), ('6/8',), ('12/16',), ('24/32',), ('48/64',), ('96/128',)) The additional 2 + 2 + 1 and 2 + 1 + 2 options for numerator 5 are at the end. >>> meter.MeterSequence('5/32').getPartitionOptions() (('2/32', '3/32'), ('3/32', '2/32'), ('1/32', '1/32', '1/32', '1/32', '1/32'), ('1/64', '1/64', '1/64', '1/64', '1/64', '1/64', '1/64', '1/64', '1/64', '1/64'), ('5/32',), ('10/64',), ('20/128',), ('2/32', '2/32', '1/32'), ('2/32', '1/32', '2/32')) ) r3rrextendlistr divisionOptionsAlgodivisionOptionsPresettuple)rndoptss r getPartitionOptions!MeterSequence.getPartitionOptionsUsi8     ! D22189: D44Q:;<T{r#c fUR5nSnUHn[U5U:XdMUn O Uc=U(a U(aUSnO)[SUSURSURS35eUR nUR 5 UHnURU5 M X`l0Ulg)a Divide the current MeterSequence into the requested number of parts. If it is not possible to divide it into the requested number, and loadDefault is `True`, then give the default partition: This will destroy any established structure in the stored partition. >>> a = meter.MeterSequence('4/4') >>> a >>> a.partitionByCount(2) >>> a >>> str(a) '{1/2+1/2}' >>> a.partitionByCount(4) >>> a >>> str(a) '{1/4+1/4+1/4+1/4}' The partitions are not guaranteed to be the same length if the meter is irregular: >>> b = meter.MeterSequence('5/8') >>> b.partitionByCount(2) >>> b This relies on a pre-defined exemption for partitioning 5 by 3: >>> b.partitionByCount(3) >>> str(b) '{2/8+2/8+1/8}' Here we use loadDefault=True to get the default partition in case there is no known way to do this: >>> a = meter.MeterSequence('5/8') >>> a.partitionByCount(11) >>> str(a) '{2/8+3/8}' If loadDefault is False then an error is raised: >>> a.partitionByCount(11, loadDefault=False) Traceback (most recent call last): music21.exceptions21.MeterException: Cannot set partition by 11 (5/8) NrCannot set partition by  (r2)) rrr rrrrrr{)rr@ loadDefaultroptMatchoptr=mStrs r partitionByCountMeterSequence.partitionByCount{sj'')C3x<'  t7$.|nBt~~>NaPTP`P`Oaabc{{  D   d #"  "r#c Sn[US[5(a[5nUH-nUR[R "[U55 M/ UR 5 URRURR:XaUnGO>[SU35e[[R "[[U55[SS5Vs/sHoPRU-PM sn;a[SS5Hzn[[R "[[U55URU-:XdMA/nUH&nURUSUR U-35 M( [#U5n OR OOUR%5n U H9n U Vs/sH n[UR'S5S5PM" n nX:XdM7U n O Uc)[SUSURSUR S35eUR(n UR+5 UHn URU 5 M Xl0Ulgs snfs snf) a Given a numerator list, partition MeterSequence into a new list of MeterTerminals >>> a = meter.MeterSequence('4/4') >>> a.partitionByList([1, 1, 1, 1]) >>> str(a) '{1/4+1/4+1/4+1/4}' This divides it into two equal parts: >>> a.partitionByList([1, 1]) >>> str(a) '{1/2+1/2}' And now into one big part: >>> a.partitionByList([1]) >>> str(a) '{1/1}' Here we divide 4/4 very unconventionally: >>> a.partitionByList(['3/4', '1/8', '1/8']) >>> a But the basics of the MeterSequence must be observed: >>> a.partitionByList(['3/4', '1/8', '5/8']) Traceback (most recent call last): music21.exceptions21.MeterException: Cannot set partition by ['3/4', '1/8', '5/8'] Nrrr r2rr)rQr-r>rtcast _updateRatiorJrKr sumrr3rangerrrrrsplitrrr{)rrFrtestmtStrxi optMatchInnerrrrnFoundr=rs r rEMeterSequence.partitionByListsF<@ mA& , , ?D&!!!&&e"45'    }}**dmm.I.II$'? %OPP S =1 2SXYZ\]S^6_S^a~~7IS^6_ _1a[qvvd3i78DNNQ>> a = meter.MeterSequence('4/4', 4) >>> str(a) '{1/4+1/4+1/4+1/4}' >>> b = meter.MeterSequence('4/4', 2) >>> a.partitionByOtherMeterSequence(b) >>> len(a) 2 >>> str(a) '{1/2+1/2}' z/Cannot set partition for unequal MeterSequencesN) rrrrrrrr r{)rr8r=rs r partitionByOtherMeterSequence+MeterSequence.partitionByOtherMeterSequence sy NNeoo -$$(9(99;;L  "!!$--"34&K !RS S "r#c[R"U5(aURU5 g[U[5(aUR U5 g[U[ 5(aURXS9 g[SU35e)a= Partitioning creates and sets a number of MeterTerminals that make up this MeterSequence. A simple way to partition based on argument time. Single integers are treated as beat counts; lists are treated as numerator lists; MeterSequence objects are partitioned by calling partitionByOtherMeterSequence(). >>> a = meter.MeterSequence('5/4+3/8') >>> len(a) 2 >>> str(a) '{5/4+3/8}' >>> b = meter.MeterSequence('13/8') >>> len(b) 1 >>> str(b) '{13/8}' >>> b.partition(13) >>> len(b) 13 >>> str(b) '{1/8+1/8+1/8+...+1/8}' >>> a.partition(b) >>> len(a) 13 >>> str(a) '{1/8+1/8+1/8+...+1/8}' Demo of loadDefault: if impossible, then do it another way: >>> c = meter.MeterSequence('3/128') >>> c.partition(2) Traceback (most recent call last): music21.exceptions21.MeterException: Cannot set partition by 2 (3/128) >>> c = meter.MeterSequence('3/128') >>> c.partition(2, loadDefault=True) >>> len(c) 3 >>> str(c) '{1/128+1/128+1/128}' * Changed in v9.3: if given a list it must either be all numbers, all strings, or all MeterTerminals, not a mix (which was undocumented and buggy) )rrON) rrPrErQr>rr3rr )rrTrs r partitionMeterSequence.partition=spj   U # #   ' } - -  . .u 5 s # #  ! !% ! A #EeW!MN Nr#cSn[[U55HLnUc/XRnUS;aSnOUS:XaSnOUS;aUS-nOUnOUnXRU5X'MN 0Ulg)ak Subdivide all partitions by equally-spaced divisions, given a divisions value. Manipulates this MeterSequence in place. Divisions value may optionally be a MeterSequence, from which a top-level partitioning structure is derived. Example: First we will do a normal partition (not subdivided partition) >>> ms = meter.MeterSequence('2/4') >>> ms >>> len(ms) 1 >>> ms[0] >>> len(ms[0]) Traceback (most recent call last): TypeError: object of type 'MeterTerminal' has no len() Divide the Sequence into two parts, so now there are two MeterTerminals of 1/4 each: >>> ms.partition(2) >>> ms >>> len(ms) 2 >>> ms[0] >>> ms[1] But what happens if we want to divide each of those into 1/8+1/8 are replace them by MeterSequences? subdividePartitionsEqual is what is needed. >>> ms.subdividePartitionsEqual(2) >>> ms Length is still 2, but each of the components are now MeterSequences of their own: >>> len(ms) 2 >>> ms[0] >>> ms[1] There is not a way (the authors know of) to get to the next level. You would just need to do them individually. >>> ms[0].subdividePartitionsEqual(2) >>> ms >>> ms[1].subdividePartitionsEqual(2) >>> ms If None is given as a parameter, then it will try to find something logical. >>> ms = meter.MeterSequence('2/4+3/4') >>> ms.subdividePartitionsEqual(None) >>> ms If any partition cannot be divided by the given count, a MeterException is raised: >>> ms = meter.MeterSequence('5/8+3/8') >>> len(ms) 2 >>> ms.subdividePartitionsEqual(5) Traceback (most recent call last): music21.exceptions21.MeterException: Cannot set partition by 5 (3/8) rN)r @r)r )rrrrUr{)r divisionsdivisionsLocalrpartitionNumerators r subdividePartitionsEqual&MeterSequence.subdividePartitionsEqual{s\ s4y!A *.'*;*;"%)AA%&N'1,%&N'+II%71%>> ms = meter.MeterSequence('2/4') >>> ms.partition(2) >>> ms >>> ms[0] >>> post = ms._subdivideNested([ms], 2) >>> ms >>> ms[0] >>> post [, ] >>> ms[0] is post[0] True >>> post2 = ms._subdivideNested(post, 2) # pass post here >>> ms >>> post2 [, , , ] Notice that since we gave a list of lists, post2 is now one level down >>> post2[0] is ms[0] False >>> post2[0] is ms[0][0] True )rrr{)rprocessObjListrobjpostsubs r _subdivideNestedMeterSequence._subdivideNestedsSP"C  ( ( 3"!C C " " r#cURS5 Sn[U[5(a&URUR S55 US- nO9Uc UR nUS;aSnO US;aSnOUnUR U5 US- nUS/nXA:aURUSS9nUS- nU(dM#/nUH0nURU;dMURUR5 M2 [U5S:ae/n [[U55HHn XjR[U5:XaXRXj/SS9- n M5U RXj5 MJ U nOOMXA:aM0Ul g) a Create nested structure down to a specified depth; the first division is set to one; the second division may be by 2 or 3; remaining divisions are always by 2. This a destructive procedure that will remove any existing partition structures. `normalizeDenominators`, if True, will reduce all denominators to the same minimum level. >>> ms = meter.MeterSequence('4/4') >>> ms.subdivideNestedHierarchy(1) >>> ms >>> ms.subdivideNestedHierarchy(2) >>> ms >>> ms.subdivideNestedHierarchy(3) >>> ms I think you get the picture! The effects above are not cumulative. Users can skip directly to whatever level of hierarchy they want. >>> ms2 = meter.MeterSequence('4/4') >>> ms2.subdivideNestedHierarchy(3) >>> ms2 rrN)rrrrrrr)rr)r)rrQr>r?getLevelrrrrrrrminr{) rrkfirstPartitionFormnormalizeDenominators depthCountdivFirstrrrefpostNewrs r subdivideNestedHierarchy&MeterSequence.subdivideNestedHierarchysD q (- 8 8 II(11!4 5 !OJ!)%)^^"!%99#s* .  ) )( 3 !OJ Qy (((>D !OJ(Ca/1 q6A: G"3t9- 7..#a&8#'<' "r#c^[U5nSnU[U5:aX!$[U5S-$)a Return the number of top-level partitions in this MeterSequence as a string. >>> ms = meter.MeterSequence('2/4+2/4') >>> ms >>> ms.partitionStr 'Duple' >>> ms = meter.MeterSequence('6/4', 6) >>> ms >>> ms.partitionStr 'Sextuple' >>> ms = meter.MeterSequence('6/4', 2) >>> ms.partitionStr 'Duple' >>> ms = meter.MeterSequence('6/4', 3) >>> ms.partitionStr 'Triple' Anything larger than 8 is simply the number followed by '-uple' >>> ms = meter.MeterSequence('13/4', 13) >>> ms.partitionStr '13-uple' Single partition: >>> ms = meter.MeterSequence('3/4', 1) >>> ms.partitionStr 'Single' ) EmptySingleDupleTriple Quadruple QuintupleSextupleSeptupleOctuplez-uple)rr-)rcount countNames r partitionStrMeterSequence.partitionStr|s;LD 8 3y> !# #u:' 'r#cU(aUc URnOSnUR5 [U[5(ac[R "U5uoPlUH&upgUSU3nUR[U55 M( UR5 UbX@lO[U[5(a+UbXAlURU5 UR5 O^[R"U5(a4UHn URU 5 M UR5 UbX@lO[SU<35eUbURU5 0Ulg)a This method is called when a MeterSequence is created, or if a MeterSequence is re-set. User can enter a list of values or an abbreviated slash notation. autoWeight, if True, will attempt to set weights. targetWeight, if given, will be used instead of self.weight loading is a destructive operation. >>> a = meter.MeterSequence() >>> a.load('4/4', 4) >>> a >>> str(a) '{1/4+1/4+1/4+1/4}' >>> a.load('4/4', 2) # request 2 beats >>> a >>> str(a) '{1/2+1/2}' >>> a.load('5/8', 2) # request 2 beats >>> str(a) '{2/8+3/8}' >>> a.load('5/8+4/4') >>> str(a) '{5/8+4/4}' Nr2z%cannot create a MeterSequence with a )rrrQr-r slashMixedToFractionr~rrrr isIterabler rr{) rrTrr<r= ratioListrrrrs r r?MeterSequence.loads?T ##{{ L  eS ! !.3.H.H.O +I+!#$#Qqc !!- ">?"    '* } - -'+   e $       u % %!!#&    '*  #H !RS S  ' NN+ , "r#c[SUR55n[R"U5uUlUlUR 5 g)z Look at _partition to determine the total numerator and denominator values for this sequence This should only be called internally, as MeterSequences are supposed to be immutable (mostly) c3P# UHoRUR4v M g7fr,r7).0rs r -MeterSequence._updateRatio..sP" bnn5s$&N)rr|r fractionSumrrr)rfTuples r rMeterSequence._updateRatio s@PPP.3->->v-F** r#cLSnURHnXR- nM U$)a Get the weight for the MeterSequence, or set the weight and thereby change the weights for each object in this MeterSequence. By default, all the partitions of a MeterSequence's weights sum to 1.0 >>> a = meter.MeterSequence('3/4') >>> a.weight 1.0 >>> a.partition(3) >>> a >>> a.weight 1.0 >>> a[0].weight 0.3333... But this MeterSequence might be embedded in another one, so perhaps its weight should be 0.5? >>> a.weight = 0.5 >>> a[0].weight 0.16666... When creating a new MeterSequence from MeterTerminals, the sequence has the weight of the sum of those creating it. >>> downbeat = meter.MeterTerminal('1/4', 0.5) >>> upbeat = meter.MeterTerminal('1/4', 0.25) >>> accentSequence = meter.MeterSequence([downbeat, upbeat]) >>> accentSequence.weight 0.75 Changing the weight of the child sequence will affect the parent, since this is not cached, but recomputed on each call. >>> downbeat.weight = 0.375 >>> accentSequence.weight 0.625 Changing the weight on the parent sequence will reset weights on the children >>> accentSequence.weight = 1.0 >>> (downbeat.weight, upbeat.weight) (0.5, 0.5) Assume this MeterSequence is a whole, not a part of some larger MeterSequence. Thus, we cannot use numerator/denominator relationship as a scalar. )r|r)r summationrs r rMeterSequence.weights*j ??C  #I#r#c[R"U5(d [S5eURUR- nURH(nURUR- nXU- -UlM* g![ aY [SSUR<S[ UR5<SUR<S[ UR5<3-5ef=f)Nzweight values must be numbersz!Something wrong with the type of zthis numerator  z or this denominator ) rrRr rr TypeErrortyper|r)rrT totalRatior partRatios r rrWs||E"" !@A A O4+<+<>> a = meter.MeterSequence('3/4') >>> a.partition(3) >>> b = a._getFlatList() >>> b [, , ] >>> len(b) 3 >>> a[1] = a[1].subdivide(4) >>> len(a) 3 >>> a >>> b = a._getFlatList() >>> len(b) 6 >>> b [, , , , , ] >>> a[1][2] = a[1][2].subdivide(4) >>> a >>> b = a._getFlatList() >>> len(b) 9 )r|rQr>r _getFlatList)rmtListrs r r MeterSequence._getFlatListnsIX??Cc=11 c"**,, #  r#c"UR5$)z> deprecated. Call .flatten() instead. To be removed in v11. )flattenr.s r flatMeterSequence.flats ||~r#cX[5nURUR55 U$)aU Return a new MeterSequence composed of the flattened representation. Here a sequence is already flattened: >>> ms = meter.MeterSequence('3/4', 3) >>> ms >>> b = ms.flatten() >>> b >>> len(b) 3 >>> b is ms False Now take the original MeterSequence and subdivide the second beat into 4 parts: >>> ms[1] = ms[1].subdivide(4) >>> ms >>> b = ms.flatten() >>> len(b) 6 >>> b >>> ms[1][2] = ms[1][2].subdivide(4) >>> ms >>> b = ms.flatten() >>> len(b) 9 >>> b )r>r?r )rrs r r$MeterSequence.flattens&J $##%& r#cn/nUR5HnURUR5 M U$)z% Return a list of flat weight values )r rr)rrrs r flatWeightMeterSequence.flatWeights1 ##%B KK "& r#cRSnSnURU5nX2:waUS- nUnOU$M#)z| Return how many unique levels deep this part is This should be optimized to store values unless the structure has changed. rNr) getLevelList)rrk lastMatchrs r rkMeterSequence.depthsB  $$U+D    r#r)rkc(/n/nURU5HynURU;aURUR5 URU;aURUR5 [ U5S:d[ U5S:dMy g g)a Return True if the top-level partitions (if depth=0) or a lower-level section has equal durations >>> ms = meter.MeterSequence('3/8+2/8+3/4') >>> ms.isUniformPartition() False >>> ms = meter.MeterSequence('4/4') >>> ms.isUniformPartition() True >>> ms.partition(4) >>> ms.isUniformPartition() True >>> ms[0] = ms[0].subdivideByCount(2) >>> ms[1] = ms[1].subdivideByCount(4) >>> ms.isUniformPartition() True >>> ms.isUniformPartition(depth=1) False >>> ms = meter.MeterSequence('2/4+2/4') >>> ms.isUniformPartition() True >>> ms = meter.MeterSequence('5/8', 5) >>> ms.isUniformPartition() True >>> ms.partition(2) >>> ms.isUniformPartition() False * Changed in v7: depth is keyword only rFT)r-rrrr)rrkrrrAs r isUniformPartition MeterSequence.isUniformPartitionsyF  ##E*B||1$&~~Q&(1vzSVaZ+r#cxX4n[[URU55$![a Of=f/n[ [ UR 55HnUR Un[U[5(dXnURU5 M>US:aXFRUS- U5- nM]U(aJ[UR<SUR<35nURUlURU5 MURU5 M [[U55URU'U$)a" Recursive utility function that gets everything at a certain level. If flat is True, it guarantees to return a list of MeterTerminals and not MeterSequences. Otherwise, there may be Sequences in there. Example: a Sequence representing something in 4/4 divided as 1 quarter, 2 eighth, 1 quarter, ((2-sixteenths) + 1 eighth). >>> b = meter.MeterSequence('4/4', 4) >>> b[1] = b[1].subdivide(2) >>> b[3] = b[3].subdivide(2) >>> b[3][0] = b[3][0].subdivide(2) >>> b Get the top level of this structure, flattening everything underneath: >>> b.getLevelList(0) [, , , ] One level down: >>> b.getLevelList(1) [, , , , , ] Without flattening, first two levels: >>> b.getLevelList(0, flat=False) [, , , ] (Note that levelList 0, flat=False is essentially the same as iterating over a MeterSequence) >>> list(b) [, , , ] >>> b.getLevelList(1, flat=False) [, , , , , ] Generally, these level lists will be converted back to MeterSequences: >>> meter.MeterSequence(b.getLevelList(0)) >>> meter.MeterSequence(b.getLevelList(1)) >>> meter.MeterSequence(b.getLevelList(2)) >>> meter.MeterSequence(b.getLevelList(3)) OMIT_FROM_DOCS Test that cache is used and does not get manipulated >>> b = meter.MeterSequence('3/4', 3) >>> (0, True) in b._levelListCache False >>> o = b.getLevelList(0) Mess with the list: >>> o.append(meter.core.MeterTerminal('1/8')) >>> o [, , , ] Cache is populated: >>> (0, True) in b._levelListCache True But a new list is created. >>> b.getLevelList(0) [, , ] >>> b.getLevelList(0)[0] is o[0] True rrr2)rrr{KeyErrorrrr|rQr>rr-rrrr)r levelCountr%cacheKeyr!r partition_irs r r-MeterSequence.getLevelList s!R% d228<=> >   ')s4??+,A7;q7IKk=99W b!>66"Q..F*'11;3J3J,LM%0$6$6  b) k2)-.*.eFm)<X& s & 33c6[URX55$)ay Return a complete MeterSequence with the same numerator/denominator relationship but that represents any partitions found at the requested level. A sort of flatness with variable depth. >>> b = meter.MeterSequence('4/4', 4) >>> b[1] = b[1].subdivide(2) >>> b[3] = b[3].subdivide(2) >>> b[3][0] = b[3][0].subdivide(2) >>> b >>> b.getLevel(0) >>> b.getLevel(1) >>> b.getLevel(2) )r>r-)rlevelr%s r rMeterSequence.getLevels&T..u;<>> b = meter.MeterSequence('4/4', 4) >>> b[1] = b[1].subdivide(2) >>> b[3] = b[3].subdivide(2) >>> b[3][0] = b[3][0].subdivide(2) >>> b >>> b.getLevelSpan(0) [(0.0, 1.0), (1.0, 2.0), (2.0, 3.0), (3.0, 4.0)] >>> b.getLevelSpan(1) [(0.0, 1.0), (1.0, 1.5), (1.5, 2.0), (2.0, 3.0), (3.0, 3.5), (3.5, 4.0)] >>> b.getLevelSpan(2) [(0.0, 1.0), (1.0, 1.5), (1.5, 2.0), (2.0, 3.0), (3.0, 3.25), (3.25, 3.5), (3.5, 4.0)] T)r%r)r-rrrrJrKr)rr:rAmappingposrstartends r getLevelSpanMeterSequence.getLevelSpanso"  u4  0s2wAE!u~~;;;>> a = meter.MeterSequence('4/4', 4) >>> a.getLevelWeight() [0.25, 0.25, 0.25, 0.25] >>> b = meter.MeterSequence('4/4', 4) >>> b.getLevelWeight(0) [0.25, 0.25, 0.25, 0.25] >>> b[1] = b[1].subdivide(2) >>> b[3] = b[3].subdivide(2) >>> b.getLevelWeight(0) [0.25, 0.25, 0.25, 0.25] >>> b[3][0] = b[3][0].subdivide(2) >>> b >>> b.getLevelWeight(0) [0.25, 0.25, 0.25, 0.25] >>> b.getLevelWeight(1) [0.25, 0.125, 0.125, 0.25, 0.125, 0.125] >>> b.getLevelWeight(2) [0.25, 0.125, 0.125, 0.25, 0.0625, 0.0625, 0.125] )r-rr)rr:rrs r getLevelWeightMeterSequence.getLevelWeights38##E*B KK "+ r#cURU5n[[U55HnX4nX[U5-UlM g)a The `weightList` is an array of weights to be applied to a single level of the MeterSequence. >>> a = meter.MeterSequence('4/4', 4) >>> a.setLevelWeight([1, 2, 3, 4]) >>> a.getLevelWeight() [1, 2, 3, 4] >>> b = meter.MeterSequence('4/4', 4) >>> b.setLevelWeight([2, 3]) >>> b.getLevelWeight(0) [2, 3, 2, 3] >>> b[1] = b[1].subdivide(2) >>> b[3] = b[3].subdivide(2) >>> b.getLevelWeight(0) [2, 3.0, 2, 3.0] >>> b[3][0] = b[3][0].subdivide(2) >>> b >>> b.getLevelWeight(0) [2, 3.0, 2, 3.0] >>> b.getLevelWeight(1) [2, 1.5, 1.5, 2, 1.5, 1.5] >>> b.getLevelWeight(2) [2, 1.5, 1.5, 2, 0.75, 0.75, 1.5] N)r-rrr)r weightListr: levelObjsrrs r setLevelWeightMeterSequence.setLevelWeightsA<%%e, s9~&AB"s:#67BI'r#cXRR:dUS:a)[SUS3SURR3-5eSnSn[[ U55H}nUn[ X0URR-5nU(aXas=::aU::aO OUn U$OXas=::aU:aO OUn U$[ X0URR-5nM U$)aH Given an offset in quarterLengths (0.0 through self.duration.quarterLength), return the index of the active MeterTerminal or MeterSequence >>> a = meter.MeterSequence('4/4') >>> a.offsetToIndex(0.5) 0 >>> a.offsetToIndex(3.5) 0 >>> a.partition(4) >>> a.offsetToIndex(0.5) 0 >>> a.offsetToIndex(3.5) 3 >>> a.partition([1, 2, 1]) >>> len(a) 3 >>> a.offsetToIndex(2.9) 1 >>> a[a.offsetToIndex(2.9)] >>> a = meter.MeterSequence('4/4') >>> a.offsetToIndex(5.0) Traceback (most recent call last): music21.exceptions21.MeterException: cannot access from qLenPos 5.0 where total duration is 4.0 Negative numbers also raise an exception: >>> a.offsetToIndex(-0.5) Traceback (most recent call last): music21.exceptions21.MeterException: cannot access from qLenPos -0.5 where total duration is 4.0 rcannot access from qLenPos rzwhere total duration is )rJrKr rrr)rqLenPosincludeCoincidentBoundariesqPosmatchrr?r@s r offsetToIndexMeterSequence.offsetToIndex"sJ mm11 1Wq[ -gYa8,T]]-H-H,IJK  s4y!AEQ 0 0 > >>?C**s*E + )c)E $a!1!1!?!??@D" r#cXRR:dUS:a[SU35eSnSn/nSn[[ U55HnUnX@URR-nU(a#X1s=::aU::aO O6UR U5 OBO"X1s=::aU:aO OUR U5 OX@URR- nM Ub2[ X[5(aX- nXPURUU5- nU$)aX Give a list of values that show all indices necessary to access the exact terminal at a given qLenPos. The len of the returned list also provides the depth at the specified qLen. >>> a = meter.MeterSequence('3/4', 3) >>> a[1] = a[1].subdivide(4) >>> a >>> len(a) 3 >>> a.offsetToAddress(0.5) [0] >>> a[0] >>> a.offsetToAddress(1.0) [1, 0] >>> a.offsetToAddress(1.5) [1, 2] >>> a[1][2] >>> a.offsetToAddress(1.99) [1, 3] >>> a.offsetToAddress(2.5) [2] rrLN) rJrKr rrrrQr>offsetToAddress) rrNrOr?rPrQrr@ qLenPosShifts r rUMeterSequence.offsetToAddress`s 8 mm11 1Wq[ #>wi!HI I s4y!AEa))777C**s*LLO+)c)LLO G$$22 2D" =Z??#?L !W,,\-HJ JE r#c[U5nXRR:dUS:aJU(d+[SU<SURR<SU<35eXRR-nUR U5nSnSnSn[ [ U55HTnXs:Xa(Un[X@URR-5nM0[X@URR-5nMV XV4$)aJ Given a qLenPos, return the span of the active region. Only applies to the top most level of partitions If `permitMeterModulus` is True, quarter length positions greater than the duration of the Meter will be accepted as the modulus of the total meter duration. >>> a = meter.MeterSequence('3/4', 3) >>> a.offsetToSpan(0.5) (0, 1.0) >>> a.offsetToSpan(1.5) (1.0, 2.0) This is the same as 1.5: >>> a.offsetToSpan(4.5, permitMeterModulus=True) (1.0, 2.0) Make sure it works for tuplets even with so-so rounding: >>> a.offsetToSpan(4.33333336, permitMeterModulus=True) (1.0, 2.0) rcannot access qLenPos  when total duration is and ts is N)rrJrKr rRrr)rrNpermitMeterModulusiMatchr>r?r@rs r offsetToSpanMeterSequence.offsetToSpans6/ mm11 1Wq[%%!>> a = meter.MeterSequence('3/4', 3) >>> a.offsetToWeight(0.0) Fraction(1, 3) >>> a.offsetToWeight(1.5) Fraction(1, 3) rrYrZr[)rrJrKr rRr)rrNr]s r offsetToWeightMeterSequence.offsetToWeightsn/ mm11 1Wq[ T]]88$@A A##G,dl))**r#c[U5nXRR:dUS:a[SU35eSnUR UR S- 5nUR UR S- 5nUcURU5nXSupxUS:Xa [U5n OUn Sn [UR 5H<n UR U 5n U H"upUS;aU nOUS:XaUnXI:XdMU S- n M$ M> U $)a Given a qLenPos, return the maximum available depth at this position. >>> b = meter.MeterSequence('4/4', 4) >>> b[1] = b[1].subdivide(2) >>> b[3] = b[3].subdivide(2) >>> b[3][0] = b[3][0].subdivide(2) >>> b >>> b.offsetToDepth(0) 3 >>> b.offsetToDepth(0.25) # quantizing active by default 3 >>> b.offsetToDepth(1) 3 >>> b.offsetToDepth(1.5) 2 >>> b.offsetToDepth(-1) Traceback (most recent call last): music21.exceptions21.MeterException: cannot access from qLenPos -1.0 * Changed in v7: `index` can be provided, if known, for a long `MeterSequence` to improve performance. rrLrquantize)r?rer@) rrJrKr rArkrrRr)rrNalignindexsrcMatchmapMinmsMinqStart unused_qEndposMatchscorer:r=r?r@s r offsetToDepthMeterSequence.offsetToDepths4/ mm11 1Wq[ #>wi!HI I""4::>2 djj1n- =''0E$m J f~HH4::&E''.G% 11$He^"H'QJE &' r#)rr{rr|r}r~r)NN)rTzDstr | MeterTerminal | Sequence[MeterTerminal] | Sequence[str] | Nonerz t.Any | Noner,)rr3rnr)rr3rTr)rnNone)rTzMeterTerminal | strrnrq)rnztools.MeterOptions)T)r@r3rboolrnrq)rFzSequence[int] | Sequence[str]rnrq)r8r>rnrq)F)rTzMint | Sequence[str] | Sequence[MeterTerminal] | Sequence[int] | MeterSequencernrq)r int | Nonernrq)NT)NFN)rTz=str | MeterTerminal | Sequence[MeterTerminal] | Sequence[str]rzTint | Sequence[str] | Sequence[MeterTerminal] | Sequence[int] | MeterSequence | Noner<rrr=zint | float | None)rnrm)rTrmrnrq)rnr>)r5r3r%rrrnzlist[MeterTerminal])rT)rrp)reN)rgrs)0rqrrrsrtrurvr!r)rrrrr4rwrrrrrrErrrrrrr?rrrxr r%r$r*rkr1r-rrArDrIrRrUr^rarory __classcell__)r%s@r r>r>s IW['+/S/%//:@ $ % $ "D10""0"LO"bR"h"@<O\<O  <O|b"H1fBF7;e"T.(.(t+/ %,0W"QW"!'W"W"*W"r(77r ]]99,2h 'R"+,-dHT=*8B!8L<|9v4l+*66r#r>__main__)ru __future__rcollections.abcrrtypingrmusic21rmusic21.common.numberToolsrmusic21.common.objectsrrmusic21.durationr r r music21.exceptions21r music21.meterr EnvironmentrcProtoM21Objectrr>rqmainTestrjr#r rs#$ -58/&&|4 ]G**,>]F VMVr4 z r#