rh*SrSSKJr SSKrSSKrSSKrSSKJr SSKJ r SSKJ r SSKJ r SSKJ r SS KJ r SS KJr SS KJr SS KJr \R"(aSS KJr \ R("S5r0SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_S S!_S"S#_S$S%_S&S'_S(S)_S*S+_S,S+_S-S.S/S0S0S0S1S2S2S3S4S5S6S7. ErSQSRS8jjr"S9S:\ R05r"S;S<\R45r"S=S>\5r"S?S@\5r"SASB\5r"SCSD\5r"SESF\5r SSSGjr!"SHSI\RD5r#"SJSK\#5r$"SLSM\#5r%"SNSO\RL5r'\\\ \\%\$\#\!/r(\)SP:XaSSKr\RT"\'5 gg)TzH This module defines objects for describing tempo and changes in tempo. ) annotationsN)base)common)duration) environment) exceptions21) expressions)note)spanner)style) OffsetQLIntempo larghissimo largamente grave(z molto adagiolargo.lento4adagio8slowlangsam larghetto< adagiettoBandanteH andantinoPzandante moderatoSmaestosoXmoderato\moderatelx) allegrettoanimatozallegro moderatoallegrofastschnell allegrissimoz molto allegro très vitevivace vivacissimopresto prestissimocLSU- nX1- nU[U5-n[SU- 5$)a Convert between equivalent tempi, where the speed stays the same but the beat referent and number change. 60 bpm at quarter, going to half >>> tempo.convertTempoByReferent(60, 1, 2) 30.0 60 bpm at quarter, going to 16th >>> tempo.convertTempoByReferent(60, 1, 0.25) 240.0 60 at dotted quarter, get quarter >>> tempo.convertTempoByReferent(60, 1.5, 1) 90.0 60 at dotted quarter, get half >>> tempo.convertTempoByReferent(60, 1.5, 2) 45.0 60 at dotted quarter, get trip >>> tempo.convertTempoByReferent(60, 1.5, 1/3) 270.0 A Fraction instance can also be used: >>> tempo.convertTempoByReferent(60, 1.5, common.opFrac(1/3)) 270.0 r)float) numberSrcquarterLengthBeatSrcquarterLengthBeatDst srcDurPerBeatdur dstDurPerBeats G/home/james-whalen/.local/lib/python3.13/site-packages/music21/tempo.pyconvertTempoByReferentrIIs8RNM  .C% 455M m# $$c\rSrSrSrg)TempoException}N__name__ __module__ __qualname____firstlineno____static_attributes__rNrJrHrLrL}rJrLcD\rSrSrSrSr\RrSSjr Sr Sr g) TempoIndicationzv A generic base class for all tempo indications to inherit. Can be used to filter out all types of tempo indications. NcUcUn[U[5(a UR$[U[5(aU$SUR;aUR 5$[ SU35e)zZ Get the appropriate MetronomeMark from any sort of TempoIndication, regardless of class. TempoTextz9cannot derive a MetronomeMark from this TempoIndication: ) isinstanceMetricModulation newMetronome MetronomeMarkclassesgetMetronomeMarkrL)selffounds rHgetSoundingMetronomeMark(TempoIndication.getSoundingMetronomeMarksn =E e- . .%% % } - -L EMM )))+ + KE7SU UrJcURS[RRRS9nUcgUR U5$)a Do activeSite and context searches to try to find the last relevant MetronomeMark or MetricModulation object. If a MetricModulation mark is found, return the new MetronomeMark, or the last relevant. >>> s = stream.Stream() >>> s.insert(0, tempo.MetronomeMark(number=120)) >>> mm1 = tempo.MetronomeMark(number=90) >>> s.insert(20, mm1) >>> mm1.getPreviousMetronomeMark() rW)getElementMethodN)getContextByClassrenums ElementSearch BEFORE_OFFSETrd)rbobjs rHgetPreviousMetronomeMark(TempoIndication.getPreviousMetronomeMarksI $$%66>> import music21 >>> tm = music21.tempo.TempoText('adagio') >>> tm >>> print(tm.text) adagio c \>[TU]"S0UD6 SUlUb[U5Ulgg)NrN)super__init___textExpressionstrtext)rbr{keywords __class__s rHrxTempoText.__init__s3 $8$ $  D DI rJc,[UR5$ro)reprr{rbs rH _reprInternalTempoText._reprInternalsDIIrJc.URR$)z( Get the text used for this expression. )rycontentrs rH_getTextTempoText._getTexts##+++rJc&URct[R"U5UlUR(aURURlgURRUlUR 5 gXRlg)zx Set the text of this repeat expression. This is also the primary way that the stored TextExpression object is created. N)ryr TextExpressionhasStyleInformationr applyTextFormattingrrbvalues rH_setTextTempoText._setTextsk    '#.#=#=e#DD ''-1ZZ$$*"1177 ((*+0 (rJz Get or set the text as a string. >>> import music21 >>> tm = music21.tempo.TempoText('adagio') >>> tm.text 'adagio' >>> tm.getTextExpression() docc[URS9nUR(aURUlU$URUlU$)z Return a MetronomeMark object that is configured from this objects Text. >>> tt = tempo.TempoText('slow') >>> mm = tt.getMetronomeMark() >>> mm.number 56 )r{)r_r{rr rbmms rHraTempoText.getMetronomeMarks? *  # #zzBH DJ rJc^URcg[R"UR5$)z` Return a TextExpression object for this text. What is this a deepcopy and not the actual one? N)rycopydeepcopy)rbnumberImplicits rHgetTextExpressionTempoText.getTextExpressions(    '==!5!56 6rJc.XlURR(aURRUlgUR(aURURlgURRUlUR5 g)z0 Given a TextExpression, set it in this object. N)ryrr rrs rHsetTextExpressionTempoText.setTextExpression sh %    3 3--33DJ  % %)-D &--33DJ  $ $ &rJcUc URnSURlU(aSURlU$SURlU$)zU Apply the default text formatting to the text expression version of this tempo mark bold-)ryr fontStyle absoluteY)rbters rHrTempoText.applyTextFormattingsI :%%B# !#BHH  "$BHH  rJcSnUcURRn[HnU"U5nU"U5nX;dX1;dM g g)aH Return True or False if the supplied text seems like a plausible Tempo indications be used for this TempoText. >>> tt = tempo.TempoText('adagio') >>> tt.isCommonTempoText() True >>> tt = tempo.TempoText('Largo e piano') >>> tt.isCommonTempoText() True >>> tt = tempo.TempoText('undulating') >>> tt.isCommonTempoText() False cUR5nURSS5nURSS5nUR5nU$)N .)stripreplacelower)ss rH stripText.TempoText.isCommonTempoText..stripText7s= A #r"A #r"A AHrJTF)ryrdefaultTempoValues)rbrr candidates rHisCommonTempoTextTempoText.isCommonTempoText&sP"  =((00E+I!),Ie$E!Y%7 , rJ)ryr r{roFNF)rPrQrRrSrprxrrrpropertyr{rarrrrrT __classcell__r}s@rHr[r[sO", 1 Hh - D" 7' ""rJr[c\rSrSrSrg)MetronomeMarkExceptioniLrNNrOrNrJrHrrLrUrJrc^^\rSrSr%SrSS0rS\S'S&SSSSS .S'U4S jjjjrS rS r S r Sr Sr \ "\ \ SS9rSrS(Sjr\ "\\SS9rS)SjrS(S*Sjjr\ "\\SS9rSrSr\ "\\SS9rS(S+SjjrS(SjrSrS,SjrS-SjrS rS!rS"rS#r S$r!S%r"U=r#$).r_iRu A way of specifying a particular tempo with a text string, a referent (a duration) and a number. The `referent` attribute is a Duration object, or a string duration type or a floating-point quarter-length value used to create a Duration. MetronomeMarks, as Music21Object subclasses, also have .duration object property independent of the `referent`. >>> a = tempo.MetronomeMark('slow', 40, note.Note(type='half')) >>> a.number 40 >>> a.referent >>> a.referent.type 'half' >>> print(a.text) slow Some text marks will automatically suggest a number. >>> mm = tempo.MetronomeMark('adagio') >>> mm.number 56 >>> mm.numberImplicit True For certain numbers, a text value can be set implicitly >>> tm2 = tempo.MetronomeMark(number=208) >>> print(tm2.text) prestissimo >>> tm2.referent Unicode values work fine thanks to Python 3: >>> marking = 'très vite' >>> marking 'très vite' >>> print(tempo.defaultTempoValues[marking]) 144 >>> tm2 = tempo.MetronomeMark(marking) >>> tm2.text.endswith('vite') True >>> tm2.number 144 For playback only (no score output) set numberSounding but no number: >>> fast = tempo.MetronomeMark(numberSounding=168) >>> fast placementa Staff placement: 'above', 'below', or None. A setting of None implies that the placement will be determined by notation software and no particular placement is demanded. This is not placed in the `.style` property, since for some expressions, the placement above or below an object has semantic meaning and is not purely presentational. zdict[str, str] _DOC_ATTRNF) parentheses playbackOnlynumberSoundingrc >[T U]"S0UD6 Uc[U[5(aUnSnUb[R "U5OSUlSUlUbXplOUR bSUlSUlSUl UbXl X@l SUl SUl Uc[R"SS9nX0lUR#5 UR%5 X`lg)NFquartertyperN)rwrxr\intrnumToIntOrFloat_numberr _tempoText textImplicitr{rr _referentrDurationreferent_updateNumberFromText_updateTextFromNumber_numberSounding) rbr{numberrrrrrr|r}s rHrxMetronomeMark.__init__s $8$ >js33FD/5.@F " "6 *d #  %"0  \\ %"'D    I"-  ((i8H  ""$ ""$ .rJcSnURnURbURcSnURnURcURRSUU3$URSURRSUU3$)Nrz (playback only)=r)rrr{rfullName)rbsoundingrs rHrMetronomeMark._reprInternals    + 0C)H))F 99 mm,,-QvhxjA Aii[$--"8"8!96(8*M MrJcURcMURb?URURUR5SS9 URbSUlgggg)z8 Update text if number is given and text is not defined NF)updateNumberFromTextT)rrr_getDefaultTextr{rrs rHr#MetronomeMark._updateTextFromNumbers^ ?? "t||'? MM$..t||DN \\% Juc$:$:%..u5DN t11 2 2"^^DN x00 1 1"N!#STYSZ![\ \rJz{ Get or set the referent, or the Duration object that is the reference for the tempo value in BPM. rcJURcgURR$ro)rr{rs rHrMetronomeMark._getTexts ?? "###rJcNUcSUlO[U[5(aXlSUlO_[U5UlUR(aUR URlOURR UlSUlU(aUR 5 ggr)rr\r[rrr r)rbrrs rHrMetronomeMark._setText sz ="DO y ) )#O %D '.DO''(, %!__22 %D    & & ( rJa Get or set a text string for this MetronomeMark. Internally implemented as a :class:`~music21.tempo.TempoText` object, which stores the text in a :class:`~music21.expression.TextExpression` object. >>> mm = tempo.MetronomeMark(number=123) >>> mm.text == None True >>> mm.text = 'medium fast' >>> print(mm.text) medium fast cUR$ro)rrs rH _getNumberMetronomeMark._getNumber(s ||rJc[R"U5(d [S5e[R"U5UlSUlU(aUR 5 gg)Nzcannot set number to a stringF)rrrLrrrr)rbrupdateTextFromNumbers rH _setNumberMetronomeMark._setNumber+sM||E"" !@A A--e4 #   & & ( rJa8 Get and set the number, or the numerical value of the Metronome. >>> mm = tempo.MetronomeMark('slow') >>> mm.number 56 >>> mm.numberImplicit True >>> mm.number = 52.5 >>> mm.number 52.5 >>> mm.numberImplicit False cUR$ro)rrs rH_getNumberSounding MetronomeMark._getNumberSoundingEs###rJcb[R"U5(dUb [S5eXlg)Nz%cannot set numberSounding to a string)rrrLrrs rH_setNumberSounding MetronomeMark._setNumberSoundingHs(||E""u'8 !HI I$rJa Get and set the numberSounding, or the numerical value of the Metronome that is used for playback independent of display. If numberSounding is None, number is assumed to be numberSounding. >>> mm = tempo.MetronomeMark('slow') >>> mm.number 56 >>> mm.numberImplicit True >>> mm.numberSounding is None True >>> mm.numberSounding = 120 >>> mm.numberSounding 120 cU(a8URb+[URURRS5$URb+[URURRS5$g)ai Get a BPM value where the beat is a quarter; must convert from the defined beat to a quarter beat. Will return None if no beat number is defined. This mostly used for generating MusicXML tags when necessary. >>> mm = tempo.MetronomeMark(number=60, referent='half') >>> mm.getQuarterBPM() 120.0 >>> mm.referent = 'quarter' >>> mm.getQuarterBPM() 60.0 N?)rrIr quarterLengthr)rbuseNumberSoundings rH getQuarterBPMMetronomeMark.getQuarterBPM_sk !4!4!@)$*=*=*.--*E*E*-/ / ;; ")$++*.--*E*E*-/ /rJcn[USURR5nU(dXlgXlg)aQ Given a value in BPM, use it to set the value of this MetronomeMark. BPM values are assumed to refer only to quarter notes; different beat values, if defined here, will be scaled >>> mm = tempo.MetronomeMark(number=60, referent='half') >>> mm.setQuarterBPM(240) # set to 240 for a quarter >>> mm.number # a half is half as fast 120 rN)rIrrrr)rbr setNumbers rH setQuarterBPMMetronomeMark.setQuarterBPMxs*'uc4==3N3NO#( KrJcd[U[5(a URnOUnSnUR5[;a[UR5nOU[;a [UnUcCUR S5H.n[H!nXTR5:XdM[UnM# M0 U$)z Given a tempo text expression or an TempoText, get the default number. >>> mm = tempo.MetronomeMark() >>> mm._getDefaultNumber('schnell') 132 >>> mm._getDefaultNumber('adagio') 56 >>> mm._getDefaultNumber('Largo e piano') 46 Nr)r\r[r{rrsplit)rb tempoTexttempoStrpostwordkeys rHrMetronomeMark._getDefaultNumbers i + + ~~H H >> 1 1%hnn&67D + +%h/D < s+-Cjjl*1#6., rJc([R"U5(aUnO [U5n/n[R 5HupVUR Xe/5 M UR 5 SnUHupeXb- Us=::a Xb-::dMO MUn U$ U$)a8 Given a tempo number try to get a text expression; presently only looks for approximate matches The `spread` value is a +/- shift around the default tempo indications defined in defaultTempoValues >>> mm = tempo.MetronomeMark() >>> mm._getDefaultText(92) 'moderate' >>> mm._getDefaultText(208) 'prestissimo' N)rrrAritemsappendsort)rbrspread tempoNumbermatchesr tempoValuers rHrMetronomeMark._getDefaultTexts <<   K-K$6$<$<$> H NNJ1 2%? $+ J# L 8KLL %,  rJcURcgUR(aUR(a+U(a#URRURS9$gg)a If there is a TextExpression available that is not implicit, return it; otherwise, return None. >>> mm = tempo.MetronomeMark('presto') >>> mm.number 184 >>> mm.numberImplicit True >>> mm.getTextExpression() >>> mm.textImplicit False >>> mm = tempo.MetronomeMark(number=90) >>> mm.numberImplicit False >>> mm.textImplicit True >>> mm.getTextExpression() is None True >>> mm.getTextExpression(returnImplicit=True) N)r)rrrr)rbreturnImplicits rHrMetronomeMark.getTextExpressionsR2 ?? "  T%6%6>??44#2254 4>> mm1 = tempo.MetronomeMark(number=60, referent=1.0) >>> mm1.getEquivalentByReferent(0.5) >>> mm1.getEquivalentByReferent(duration.Duration('half')) >>> mm1.getEquivalentByReferent('longa') Nr{rr) rrr\rzrrrrrIrr_r{)rbrrd newNumbers rHgetEquivalentByReferent%MetronomeMark.getEquivalentByReferents" << ! !$M # & &!!(+AOOM$22M ;; ".t{{/3}}/J/J/<>II$))I&.&7&7 &FH HrJc@[URURUS9$)zU Return a new MetronomeMark object that has an equivalent number but a new referent. r)r_r{r)rbrs rHgetMaintainedNumberWithReferent-MetronomeMark.getMaintainedNumberWithReferents $))DKK&.0 0rJcdUR5nUbSUR5- $[S5e)az Return the duration in seconds for each quarter length (not necessarily the referent) of this MetronomeMark. >>> mm1 = tempo.MetronomeMark(referent=1.0, number=60.0) >>> mm1.secondsPerQuarter() 1.0 >>> mm1 = tempo.MetronomeMark(referent=2.0, number=60.0) >>> mm1.secondsPerQuarter() 0.5 >>> mm1 = tempo.MetronomeMark(referent=2.0, number=30.0) >>> mm1.secondsPerQuarter() 1.0 N@z5cannot derive seconds as getQuarterBPM() returns None)rr)rbqbpms rHsecondsPerQuarterMetronomeMark.secondsPerQuarter s8!!#  $,,.. .()`a arJc|[R"U5(aUnO URnUR5U-$)aK Given a duration specified as a :class:`~music21.duration.Duration` object or a quarter length, return the resultant time in seconds at the tempo specified by this MetronomeMark. >>> mm1 = tempo.MetronomeMark(referent=1.0, number=60.0) >>> mm1.durationToSeconds(60) 60.0 >>> mm1.durationToSeconds(duration.Duration('16th')) 0.25 )rrrr#)rbdurationOrQuarterLengthqls rHdurationToSecondsMetronomeMark.durationToSeconds5s8 <</ 0 0(B(66B%%'",,rJc[R"U5(aUS::a [S5eXR5- n[R "US9$)aK Given a duration in seconds, return a :class:`~music21.duration.Duration` object equal to that time. >>> mm1 = tempo.MetronomeMark(referent=1.0, number=60.0) >>> mm1.secondsToDuration(0.25) >>> mm1.secondsToDuration(0.5).type 'eighth' >>> mm1.secondsToDuration(1) gz*seconds must be a number greater than zeror)rrrr#rr)rbsecondsr's rHsecondsToDurationMetronomeMark.secondsToDurationHsG||G$$3()UV V --/ /  r22rJ) rrrrrrrrrr r{r)NNN)r{zstr | int | NonerOffsetQLIn | Nonerz@OffsetQLIn | str | duration.Duration | base.Music21Object | Nonerboolrr0rr/rz bool | NonereturnNoneT)r1int | float | None)rr4)r1z float | None)r)$rPrQrRrSrpr__annotations__rxrrrrrrrrrr{rrrrrrrrrrrrrr#r(r-rTrrs@rHr_r_Rsj7r   !I~ ""&MQ 0. ""*.$(0.0. 0.K 0.  0.0.(0."0. 0.0.d N )+]" l9  H $ )" Hh - D)- )j* 3  F$% 02DK  N$2 (<B4D!HT0b*-&33rJr_c\rSrSrSrg)MetricModulationExceptioni\rNNrOrNrJrHr8r8\rUrJr8c^\rSrSrSrU4SjrSrSrSr\ "\\SS9r S r S r \ "\ \ S S9r S rS r\ "\\SS9rSrSr\ "\\SS9r\ S5rSrSSjrSSSjjrSrU=r$)r]iaa A class for representing the relationship between two MetronomeMarks. Generally this relationship is one of equality, where the number is maintained but the referent that number is applied to each change. The basic definition of a MetricModulation is given by supplying two MetronomeMarks, one for the oldMetronome, the other for the newMetronome. High level properties, oldReferent and newReferent, and convenience methods permit only setting the referent. The `classicalStyle` attribute determines of the first MetronomeMark describes the new tempo, not the old (the reverse of expected usage). The `maintainBeat` attribute determines if, after an equality statement, the beat is maintained. This is relevant for moving from 3/4 to 6/8, for example. >>> s = stream.Stream() >>> mm1 = tempo.MetronomeMark(number=60) >>> s.append(mm1) >>> s.repeatAppend(note.Note(quarterLength=1), 2) >>> s.repeatAppend(note.Note(quarterLength=0.5), 4) >>> mmod1 = tempo.MetricModulation() >>> mmod1.oldReferent = 0.5 # can use Duration objects >>> mmod1.newReferent = 'quarter' # can use Duration objects >>> s.append(mmod1) >>> mmod1.updateByContext() # get number from last MetronomeMark on Stream >>> mmod1.newMetronome >>> s.append(note.Note()) >>> s.repeatAppend(note.Note(quarterLength=1.5), 2) >>> mmod2 = tempo.MetricModulation() >>> s.append(mmod2) # if the obj is added to Stream, can set referents >>> mmod2.oldReferent = 1.5 # will get number from previous MetronomeMark >>> mmod2.newReferent = 'quarter' >>> mmod2.newMetronome Note that an initial metric modulation can set old and new referents and get None as tempo numbers: >>> mmod3 = tempo.MetricModulation() >>> mmod3.oldReferent = 'half' >>> mmod3.newReferent = '16th' >>> mmod3 => test w/ more sane referents that either the old or the new can change without a tempo number >>> mmod3.oldReferent = 'quarter' >>> mmod3.newReferent = 'eighth' >>> mmod3 => >>> mmod3.oldMetronome >>> mmod3.oldMetronome.number = 60 New number automatically updates: >>> mmod3 => c >[TU]"S0UD6 SUlSUlSUlSUlSUlSUlSUlg)NFrrN) rwrxclassicalStyle maintainBeattransitionSymbolarrowDirectionr _oldMetronome _newMetronome)rbr|r}s rHrxMetricModulation.__init__sO $8$#! #"!"!rJc8URSUR3$)Nr) oldMetronomer^rs rHrMetricModulation._reprInternals!##$Ad&7&7%899rJcpUcO,[US5(aSUR;a [S5eXlg)Nr`r_z?oldMetronome property must be set with a MetronomeMark instance)hasattrr`r8r?rs rH_setOldMetronome!MetricModulation._setOldMetronome: =  **oU]].R+QS S"rJcURb'URRcUR5 UR$ro)r?rupdateByContextrs rH_getOldMetronome!MetricModulation._getOldMetronomes8    )!!((0$$&!!!rJa Get or set the left :class:`~music21.tempo.MetronomeMark` object for the old, or previous value. >>> mm1 = tempo.MetronomeMark(number=60, referent=1) >>> mm1 >>> mmod1 = tempo.MetricModulation() >>> mmod1.oldMetronome = mm1 Note that we do need to have a proper MetronomeMark instance to figure this out: >>> mmod1.oldMetronome = 'junk' Traceback (most recent call last): music21.tempo.MetricModulationException: oldMetronome property must be set with a MetronomeMark instance rcUc [S5eURbURRU5nO$UR5nUbURU5nUbX lg[ US9Ulg)Nzcannot set old referent to Noner)r8r?rrmr_rbrrs rH_setOldReferent MetricModulation._setOldReferentst =+,MN N    )##;;EBB..0B~//6 >!# "/!>D rJcJURbURR$gro)r?rrs rH_getOldReferent MetricModulation._getOldReferent%    )%%.. . *rJa Get or set the referent of the old MetronomeMark. >>> mm1 = tempo.MetronomeMark(number=60, referent=1) >>> mmod1 = tempo.MetricModulation() >>> mmod1.oldMetronome = mm1 >>> mmod1.oldMetronome >>> mmod1.oldReferent = 0.25 >>> mmod1.oldMetronome cpUcO,[US5(aSUR;a [S5eXlg)Nr`r_z?newMetronome property must be set with a MetronomeMark instance)rFr`r8r@rs rH_setNewMetronome!MetricModulation._setNewMetronomerIrJcURb'URRcUR5 UR$ro)r@rrKrs rH_getNewMetronome!MetricModulation._getNewMetronome s8    )!!((0$$&!!!rJa' Get or set the right :class:`~music21.tempo.MetronomeMark` object for the new, or following value. >>> mm1 = tempo.MetronomeMark(number=60, referent=1) >>> mm1 >>> mmod1 = tempo.MetricModulation() >>> mmod1.newMetronome = mm1 >>> mmod1.newMetronome = 'junk' Traceback (most recent call last): music21.tempo.MetricModulationException: newMetronome property must be set with a MetronomeMark instance cUc [S5eSnURbURRU5nO2URbURR U5nO [ US9nX lg)Nzcannot set new referent to NonerO)r8r@rr?rr_rPs rH_setNewReferent MetricModulation._setNewReferent sn =+,MN N     )##;;EBB    +##CCEJB.BrJcJURbURR$gro)r@rrs rH_getNewReferent MetricModulation._getNewReferent1rVrJa Get or set the referent of the new MetronomeMark. >>> mm1 = tempo.MetronomeMark(number=60, referent=1) >>> mmod1 = tempo.MetricModulation() >>> mmod1.newMetronome = mm1 >>> mmod1.newMetronome >>> mmod1.newReferent = 0.25 >>> mmod1.newMetronome cJURbURR$g)a& Get and the number of the MetricModulation, or the number assigned to the new MetronomeMark. >>> s = stream.Stream() >>> mm1 = tempo.MetronomeMark(number=60) >>> s.append(mm1) >>> s.repeatAppend(note.Note(quarterLength=1), 2) >>> s.repeatAppend(note.Note(quarterLength=0.5), 4) >>> mmod1 = tempo.MetricModulation() >>> mmod1.oldReferent = 0.5 # can use Duration objects >>> mmod1.newReferent = 'quarter' >>> s.append(mmod1) >>> mmod1.updateByContext() >>> mmod1.newMetronome >>> mmod1.number 120 N)r@rrs rHrMetricModulation.numberBs',    )%%,, , *rJcUR5nSnUbhURb=URRb&URURR5nO[ URUR S9nUbX lUR bVUR Rb>URR b&URR UR lgggg)z Update this metric modulation based on the context, or the surrounding MetronomeMarks or MetricModulations. The object needs to reside in a Stream for this to be effective. Nrr)rmr?rrr_rr@)rbmmLastmmOlds rHrK MetricModulation.updateByContextcs..0  "".**33?66&&//1&v-3]]<  !&     *&&//;&&--9(,(:(:(A(AD   %:< +rJc UcURcSnOURcSnUS;a[SU35eUS:Xa!URRU5UlgUS:Xa!URRU5Ulgg)a Set the other side of the metric modulation to an equality; side can be specified, or if one side is None, that side will be set. >>> mm1 = tempo.MetronomeMark(number=60, referent=1) >>> mmod1 = tempo.MetricModulation() >>> mmod1.newMetronome = mm1 >>> mmod1.setEqualityByReferent(None, 2) >>> mmod1 => Nleftrightrkrl"cannot set equality for a side of )r?r@rLrrbsiders rHsetEqualityByReferent&MetricModulation.setEqualityByReferent~s <!!)##+ ( ( #EdV!LM M 7?!%!3!3!K!K"D  V^!%!3!3!K!K"D rJc UcURcSnOURcSnUS;a[SU35eUS:Xa!URRU5UlgUS:Xa!URRU5Ulgg)z Set the other side of the metric modulation not based on equality, but on a direct translation of the tempo value. referent can be a string type or an int/float quarter length Nrkrlrmrn)r?r@rLrros rHsetOtherByReferent#MetricModulation.setOtherByReferents <!!)##+ ( ( #EdV!LM M 7?!%!3!3!S!ST\!]D  V^!%!3!3!S!ST\!]D rJ)r@r?r>r;r<rr=)Nr)rpz str | Nonerzstr | int | float)rPrQrRrSrprxrrGrLrrCrQrT oldReferentrXr[r^r^ra newReferentrrKrqrtrTrrs@rHr]r]asDL" : #" ,.>E  L$?&/?O B  K#",.> E  L "/?O B  K--@B6B"%^^ ^^rJr]c bURU5nURU5nURU5nURU5n X- X- - n UR UUS9n U HAn U RU5n U RU5 XU- -U-nU R X>5 MC g![Ran[S5UeSnAff=f![Ran[S5UeSnAff=f![Ran[S5UeSnAff=f![Ran[S5UeSnAff=f![ RaPnUSLa"XU- -U-nURX5 SnAGM![SU <S U R<S 3-S -5UeSnAff=f) a Assume that element1 and element2 are two elements in sourceStream and destinationStream with other elements (say eA, eB, eC) between them. For instance, element1 could be the downbeat at offset 10 in sourceStream (a Stream representing a score) and offset 20.5 in destinationStream (which might be a Stream representing the timing of notes in particular recording at approximately but not exactly qtr = 30). Element2 could be the following downbeat in 4/4, at offset 14 in source but offset 25.0 in the recording: >>> sourceStream = stream.Stream() >>> destinationStream = stream.Stream() >>> element1 = note.Note('C4', type='quarter') >>> element2 = note.Note('G4', type='quarter') >>> sourceStream.insert(10, element1) >>> destinationStream.insert(20.5, element1) >>> sourceStream.insert(14, element2) >>> destinationStream.insert(25.0, element2) Suppose eA, eB, and eC are three quarter notes that lie between element1 and element2 in sourceStream and destinationStream, as in: >>> eA = note.Note('D4', type='quarter') >>> eB = note.Note('E4', type='quarter') >>> eC = note.Note('F4', type='quarter') >>> sourceStream.insert(11, eA) >>> sourceStream.insert(12, eB) >>> sourceStream.insert(13, eC) >>> destinationStream.append([eA, eB, eC]) # not needed if autoAdd were true then running this function will cause eA, eB, and eC to have offsets 21.625, 22.75, and 23.875 respectively in destinationStream: >>> tempo.interpolateElements(element1, element2, ... sourceStream, destinationStream, autoAdd=False) >>> for el in [eA, eB, eC]: ... print(el.getOffsetBySite(destinationStream)) 21.625 22.75 23.875 if the elements between element1 and element2 do not yet appear in destinationStream, they are automatically added unless autoAdd is False. (with the default autoAdd, elements are automatically added to new streams): >>> destStream2 = stream.Stream() >>> destStream2.insert(10.1, element1) >>> destStream2.insert(50.5, element2) >>> tempo.interpolateElements(element1, element2, sourceStream, destStream2) >>> for el in [eA, eB, eC]: ... print('%.1f' % (el.getOffsetBySite(destStream2),)) 20.2 30.3 40.4 (unless autoAdd is set to False, in which case a Tempo Exception arises:) >>> destStream3 = stream.Stream() >>> destStream3.insert(100, element1) >>> destStream3.insert(500, element2) >>> eA.id = 'blah' >>> tempo.interpolateElements(element1, element2, sourceStream, destStream3, autoAdd=False) Traceback (most recent call last): music21.tempo.TempoException: Could not find element with id ... z'could not find element1 in sourceStreamNz,could not find element1 in destinationStreamz'could not find element2 in sourceStreamz,could not find element2 in destinationStream) offsetStart offsetEndTzCould not find element z with id rz)in destinationStream and autoAdd is false) getOffsetBySiterMusic21ExceptionrLgetElementsByOffsetsetOffsetBySiterSitesExceptioninsertid)element1element2 sourceStreamdestinationStreamautoAddstartOffsetSrcestartOffsetDest endOffsetSrc endOffsetDest scaleAmountinterpolatedElementsel elOffsetSrcdestinationOffsets rHinterpolateElementsrsPO!11,?T"223DEO// = T 001BC "3 8UVK';;"<#((6  E   0 1"-n0L!MQ` `    0 D#-  ( (OFGQNO  ( (TKLRSST  ( (OFGQNO  ( (TKLRSST"" J$%0.4P%QUd$d!!(():??$-iy23ABCIJJ  JszB*CC:D"9E *C> C  CC7& C22C7:D DD"E6 EE F. F)$F))F.c\rSrSrSrSrg)TempoChangeSpanneri)z< Spanners showing tempo-change. They do nothing right now. rNNrPrQrRrSrprTrNrJrHrr)  rJrc\rSrSrSrSrg)RitardandoSpanneri0z& Spanner representing a slowing down. rNNrrNrJrHrr0rrJrc\rSrSrSrSrg)AccelerandoSpanneri7z% Spanner representing a speeding up. rNNrrNrJrHrr7rrJrcz\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrg)Testi?c2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestrglobals)rbrs rHtestCopyAndDeepcopyTest.testCopyAndDeepcopy@s7D')$rJc[S[R"SS9S9nURURS5 [ S5nURUR S5 g)NrrrrrLebhaft)r_r Note assertEqualrr[r{)rbmm1tm1s rH testSetupTest.testSetupDsI2 y0IJ R( " 9-rJc[5 [S5 [S5nURURS5 UR UR 5 URURS5 [S5nURUR S5 UR5nURURS5 g)Nrrr;r0)r[r_rr assertTruerr{ra)rbrtm2s rH testUnicodeTest.testUnicodeKs (8 $ B' ))* B' % <0  ! ! # C(rJc SSKJn URS5nURURR S5 URURR S5 SURlURURR S5 SURlSURlURnURUS5 UR5nURURS5 URURR S5 URURR S5 [R"S5nS URlS URlURURR S 5 URURR S 5 URU5 URURR S 5 URURR S 5 URURUR5 UR5 URnURUS5 URURR S 5 URURR S 5 [R"S 5nURUR 5 UR#UR 5 URU5 URURR S 5 URURR S 5 URURUR5 UR5 URnURUS 5 URURR S 5 URURR S 5 SUl[R"S 5nURUR 5 URUR 5 URU5 URURR S5 URURR S5 URURUR5 g) Nrrrrr!italicr!& bolditaliczandante with no style)music21rr[rr rr fontWeightr{rrr rrassertIs assertFalserr)rbrtmtxte1te2te3te4s rHtestTempoTextStyleTest.testTempoTextStyle]s! __X & ++R0 ++V4 ++R0%"WW X&""$ h/ ++R0 ++X6((3  *  ,,b1 ,,l; S! ++R0 ++\: bhh *  WW Y' ++R0 ++\:(()@A 001 ../ S! ++R0 ++\: bhh *  WW 45 ++R0 ++\:(()@A 001 //0 S! ++R0 ++V4 bhh *rJc|SSKJn UR5nSUlUR UR S5 UR UR5 SUlUR UR S5 URUR5 UR URRS5 UR5nSUl[R"S5Ul UR UR S5 UR URS 5 UR UR5 S UlUR URS 5 URUR5 UR URRS5 UR [U5S 5 g) Nrrrrslowishrr>g@r3z4)rrr_rrr{rrrrrrrrr)rbrrs rHtestMetronomeMarkATest.testMetronomeMarkAsF!  "  (+ ( ), ) 22C8 "'',  (+ C( ))*  C( **+ 22C8 b#YZrJch[5nURURS5 URURS5 [SS9nURURS5 UR UR5 URUR S5 URURS5 [SSS9nURURS5 UR UR5 URUR S5 UR UR5 g)Ndrerapido)rr{)r_rrrrrr{rs rHtestMetronomeMarkBTest.testMetronomeMarkBs _ **D1 $/ # & C( **+ $' $/ #H 5 C( **+ (+ )rJcSSKJn URSSS9nURSS9nUR5nX$lX4lUR [U5S5 URSSS9nUR5nX$lURSS9 UR [U5S5 UR URR5S 5 UR UR R5S 5 g) Nrr?r,rf16thrOz=>r!g>@) rrr_r]rCr^rrzrtr)rbrrmm2mmod1s rHtestMetronomeModulationATest.testMetronomeModulationAs!!!3s!;!!6!2&&(   UM N !!3s!;&&(    & 1 UM N ++99;TB ++99;TBrJcSSKJn SSKJn UR5nUR 5nUR [ R"SS9S5 [R"U5nURSSS 9nURSU5 URS S S 9nURSU5 URXE/5 UR[UR55S 5 g) NrrstreamrYr+r?rrz,)rrrPartMeasure repeatAppendr rrrr_rr rrzrmrbrrpm1m2rrs rHtestGetPreviousMetronomeMarkA"Test.testGetPreviousMetronomeMarkAs!" KKM ^^   2A6 ]]2 !!d!; !S!!s!; !S " S99;<G IrJcSSKJn SSKJn UR5nUR 5nUR [ R"SS9S5 [R"U5nURS5nURSU5 URSS S 9nURSU5 URXE/5 UR[UR!55S 5 g) NrrrrYr+rrrrrz-)rrrrrrr rrrr[rr_r rrzrmrs rHtestGetPreviousMetronomeMarkB"Test.testGetPreviousMetronomeMarkBs!" KKM ^^   2A6 ]]2 oof% !S!!s!; !S " S99;<H JrJcSSKJn SSKJn UR5nUR 5nUR [ R"SS9S5 [R"U5n[R"U5nURS5nURSU5 UR5nURSSS 9Ul URS S 9 URSU5 URS S S9n URSU 5 URXEU/5 UR![#U R%55S5 g)NrrrrYr+rrrrfrrOrrrz+)rrrrrrr rrrr_rr]rCrtr rrzrm) rbrrrrrm3rrmm3s rHtestGetPreviousMetronomeMarkC"Test.testGetPreviousMetronomeMarkCs!" KKM ^^   2A6 ]]2  ]]2 !!&) !S$$& ..".E / !S!!s!; !S "" S99;<F HrJchSSKJn SSKJn UR5nUR 5nUR [ R"SS9S5 [R"U5n[R"U5nURSS9nURSU5 UR5nURSU5 URXEU/5 S UlUR[!UR"5S 5 UR%S S 9 UR[!UR&5S 5 g)z7 Test setting referents directly via context searches. rrrrYr+rr)rrz/r5rOz/N)rrrrrrr rrrr_rr]r rvrrzrCrtr^) rbrrrrrrrrs rHtestSetReferentATest.testSetReferentA+s #! KKM ^^   2A6 ]]2  ]]2 !!!, !S$$& !S "" S--.J L * S--.J LrJc SSKJn SSKJn UR5nUR SS9nUR U5 UR [R"SS9S5 UR [R"S S9S 5 UR5nS Ul S Ul UR U5 UR5 UR[URR 5S 5 URURR"S 5 UR[UR$5S5 UR [R"55 UR [R"SS9S5 UR5nSUl S Ul UR U5 UR5 UR[UR5S5 UR[UR$5S5 g)NrrrrrrYr+r5rrrr,z1?z7z2)rrrStreamr_r rr rr]rvrwrKrrzrCrrr^rbrrrrrmmod2s rHtestSetReferentBTest.testSetReferentBGs!" MMO!!!,   tyyq115 tyys3Q7&&(%   U//889;\] ++22C8 U//0L N  tyys3Q7&&(%   U//0R T U//0M OrJcSSKJn SSKJn UR5nUR SS9nUR U5 UR [R"SS9S5 UR [R"S S9S 5 UR5nUR U5 S Ul S Ul UR[URR5S 5 URURR S 5 UR[UR"5S5 UR [R"55 UR [R"SS9S5 UR5nUR U5 SUl S Ul UR[UR5S5 UR[UR"5S5 g)NrrrrrrYr+r5rrrrr,z3rz9z2)rrrrr_r rr rr]rvrwrrzrCrrr^rs rHtestSetReferentCTest.testSetReferentCksw!" MMO!!!,   tyyq115 tyys3Q7&&( % U//889;\] ++22C8 U//0N P  tyys3Q7&&( % U//0T V U//0M OrJcSSKJn SSKJn UR5nUR SS9nUR U5 UR [R"SS9S5 UR [R"S S9S 5 UR5nUR U5 UR5 UR[URR5S 5 URURRS5 URUR S5 S UlUR[UR 5S 5 g)NrrrrrrYr+r5rrzrz/)rrrrr_r rr rr]rKrrzrCrrr^rw)rbrrrrrs rHtestSetReferentDTest.testSetReferentDs!" MMO!!!,   tyyq115 tyys3Q7&&(   U//889;\] ++22B7 ++T2  U//02cdrJcSSKJn UR5n[SS9nUR U5 UR [ R"SS9S5 UR [ R"SS9S 5 [5nS Ul S Ul UR U5 URURRS 5 URURRS 5 UR5n[SS9nUR U5 UR [ R"SS9S5 UR [ R"SS9S 5 [5nS Ul S Ul UR U5 URURRS 5 URURRS 5 URURS 5 g) NrrFrrYr+r5rreighthhalfr/)rrrr_r rr rr]rvrwrrCrr^)rbrrrrs rHtestSetReferentETest.testSetReferentEsm" MMO2&   tyyq115 tyys3Q7 "$"  ++22C8 ++22C8 MMO2&   tyyq115 tyys3Q7!"$"  ++22C8 ++22C8 s+rJc[SSS9nURUR5S5 URURS5S5 URUR S5R S5 [SSS9nURUR5S5 URURS5S5 URUR S5R S5 [SSS9nURUR5S 5 URURS 5S5 URUR S5R S 5 [S SS9nUR UR5S 5 URURS5S5 URUR S5R S5 g)Nrg^@rfrr,r!rg@rgn@rgUUUUUU?gf@)r_rr#r(r-rassertAlmostEqualrs rHtestSecondsPerQuarterATest.testSecondsPerQuarterAs C 6 --/5 --c2D9 --d3AA5I C 6 --/5 --b148 --d3AA4H C 6 --/6 --c2D9 --d3AA5I C 6 r335u= --c2D9 --d3AA5IrJc<[R"SS9n[SSU5nSURlUR UR RUR5 UR UR RRUR5 g)Nrrrrrk)r rr_r justifyrrry)rbhalfNoters rHtestStylesAreSharedTest.testStylesAreSharedsh99&) 62x 0! bmm))2884 bmm3399288DrJrNN)rPrQrRrSrrrrrrrrrrrrrrrrr rTrNrJrHrr?sf%.)$?+B[4*&C@I$J$H8L8OHODe0,>J*ErJr__main__)r)rB int | floatrCrr1rAr3)+rp __future__rrtypingtunittestrrrrrrr r r r TYPE_CHECKINGmusic21.common.typesr Environment environLocalrrIr|rLrrWr[rr_r8r]rSpannerrrrTestCaser _DOC_ORDERrPmainTestrNrJrHrsl#  ??/&&w/ 2" RB   R   R  b Brr !"#$ =J0%0%#0% 0%h \22 12d((12jQQj ^ F3OF3T  Q^Q^l 48oEf   *  + _E8  _EH Y(8/ "35G!#  z TrJ