rhTSrSSKJr SSKrSSKrSSKrSSKrSSKrSSK J r J r SSK J r SSK Jr SSK Jr SSK Jr SS K Jr SS K Jr SS K Jr SS KJr SS KJr \R0(aSSK Jr Sr"SS\R65r"SS\5r"SS\5r"SS\5r"SS\5r "SS\5r!"SS\!5r""SS\!5r#"S S!\"5r$"S"S#\5r%"S$S%\5r&"S&S'\RN5r(\)S(:XaSSK r \ RT"\(5 gg))z Definitions for extracting data from a Stream to place on one axis of a :class:`~music21.graph.plot.PlotStream` or similar object. ) annotationsN)accidentalLabelToUnicodeGraphException)bar)common)duration)dynamics)pitch)prebase)stream)elements) pitchAnalysis)notec\rSrSr%SrSSSSSS.rS \S 'S rS S SS.rSr S\S'S Sjr Sr \ S5r \ RS5r \ S5r\RS5r\ S5rS!SjrSrSrS"SjrSrg)#Axis.z An Axis is an easier way of specifying what to plot on any given axis. Client should be a .plot.PlotStream or None. Eventually a Stream may be allowed, but not yet. z=the name of the axis. One of "x" or "y" or for 3D Plots, "z"zV None or number representing the axis minimum. Default None. zV None or number representing the axis maximum. Default None. a{ a dict of {'x': 0, 'y': 1, 'z': 2} mapping where an axis's data can be found in self.client.data after extract data is run: >>> b = corpus.parse('bwv66.6') >>> plot = graph.plot.ScatterPitchClassOffset(b) >>> pcAxis = plot.axisY >>> pcAxis.axisName 'y' >>> pcAxisDataIndex = pcAxis.axisDataMap[pcAxis.axisName] >>> pcAxisDataIndex 1 >>> plot.extractData() >>> pcValues = [dataTuple[pcAxisDataIndex] for dataTuple in plot.data] >>> pcValues[0:2] [1, 11] a a tuple of strings representing the quantities the axis can plot. The first element of the tuple is the authoritative name. >>> ax = graph.axis.DynamicsAxis() >>> ax.quantities ('dynamic', 'dynamics', 'volume') )axisNameminValuemaxValue axisDataMap quantitiesdict[str, str] _DOC_ATTRzan axisr)xyz)genericonenothingblanktuple[str, ...]rNc[U[5(a [S5eSUlSUlXlX lSUlSUlg)Nz,Client must be a PlotStream, Stream, or None) isinstancestrr_client_labelclientrrr)selfr*rs L/home/james-whalen/.local/lib/python3.13/site-packages/music21/graph/axis.py__init__ Axis.__init__\sA fc " " !OP P      cvURnUbURRnOSnSURSU3$)a The representation of the Axis shows the client and the axisName in addition to the class name. >>> s = stream.Stream() >>> plot = graph.plot.ScatterPitchClassQuarterLength(s) >>> plot.axisX >>> plot.axisY >>> axIsolated = graph.axis.DynamicsAxis(axisName='z') >>> axIsolated >>> s = stream.Part() >>> axStream = graph.axis.DynamicsAxis(s, axisName='y') >>> axStream z (no client)z: z axis for )r* __class____name__r)r+c clientNames r, _reprInternalAxis._reprInternalhs=. KK =--J&JDMM?*ZL99r/cLURb UR$UR$)z Returns self.label or class.labelDefault if not set: >>> ax = graph.axis.Axis(axisName='y') >>> ax.label 'an axis' >>> ax.label = 'velocity' >>> ax.label 'velocity' )r) labelDefaultr+s r,label Axis.labels$ ;; ";; $$ $r/cXlgNr)r+values r,r:r; r/cB[R"UR5$)z The client stores a reference to the Plot that makes reference to this axis. (Like all music21 clients, It is normally stored internally as a weakref, so no need for garbage collecting) )r unwrapWeakrefr(r9s r,r* Axis.clients##DLL11r/c:[R"U5Ulgr=)r wrapWeakrefr()r+referents r,r*rDs))(3 r/c|URnUcg[U[R5(aU$UR$)z Returns a reference to the client's .streamObj (or None if client is None) If the client is itself a stream, return it. Read-only N)r*r&r Stream streamObj)r+r3s r,r Axis.streams5 KK 9 6== ) )H;; r/cg)z Override in subclasses rr+n formatDicts r,extractOneElementAxis.extractOneElementsr/cURcU(a[U5UlURcU(a[U5Ulggg)a If self.minValue is not set, then set self.minValue to be the minimum of these values. Same with maxValue >>> ax = graph.axis.Axis() >>> print(ax.minValue) None >>> values = [10, 0, 3, 5] >>> ax.setBoundariesFromData(values) >>> ax.minValue 0 >>> ax.maxValue 10 If a boundary is given or .setXXXFromData is False then no changes are made >>> ax = graph.axis.Axis() >>> ax.minValue = -1 >>> ax.setBoundariesFromData(values) >>> ax.minValue -1 >>> ax.maxValue 10 N)rminrmaxr+valuess r,setBoundariesFromDataAxis.setBoundariesFromDatas:: == VKDM == VKDM&, r/cURnURnUcSnUcSnX!- nUS:XaSnO![[R"X!- 55nSU-nUS:aX5- S::a[US- 5n[X- 5S- U-nUS:aUS:aSn[X%- 5S-U-n[ XgU5n/n UHn U R U [U 545 M! U $)a Get a set of ticks for this data. Used by several numeric axes to make a reasonable number of ticks. >>> cax = graph.axis.Axis() >>> cax.minValue = 1 >>> cax.maxValue = 9 >>> cax.ticks() [(0, '0'), (1, '1'), (2, '2'), (3, '3'), (4, '4'), (5, '5'), (6, '6'), (7, '7'), (8, '8'), (9, '9'), (10, '10')] For larger data, the ticks are farther apart. >>> cax.minValue = 7 >>> cax.maxValue = 80 >>> cax.ticks() [(0, '0'), (10, '10'), (20, '20'), (30, '30'), (40, '40'), (50, '50'), (60, '60'), (70, '70'), (80, '80'), (90, '90')] >>> cax.minValue = 712 >>> cax.maxValue = 2213 >>> cax.ticks() [(600, '600'), (700, '700'), (800, '800'), (900, '900'), (1000, '1000'), ... (2100, '2100'), (2200, '2200'), (2300, '2300')] r rr)rrintmathlog10rangeappendr') r+minVmaxV difference log10distance closest10 startValue stopValuestepstickstickNums r,ri Axis.tickss6}}}} <D <D[ ?M 4; 78M-' q=j4:IN+I$*+a/9< >daiJ)*Q.); jY7G LL'3w<0 1 r/cg)z Routine to be called after data has been extracted to do any cleanup, etc. Defaults to doing nothing, but see CountingAxis for an example of how this works. NrM)r+dataLists r,postProcessDataAxis.postProcessDatas r/)r(r)rr*rrNr)rOznote.GeneralNoterPzdict[str, t.Any]returnzt.Anyr=)r2 __module__ __qualname____firstlineno____doc__r__annotations__r8rrr-r5propertyr:setterr*r rQrXrirn__static_attributes__rMr/r,rr.sT"3!!I~!FL*K"HJH :>%%  \\22 ]]44  (D7r r/rcv^\rSrSr%SrSSSSS.rS\S 'S rS rS \S 'SU4Sjjr \ SSj5r Sr Sr U=r$) PitchAxisi(z( Axis subclass for dealing with Pitches za bool on whether to show both common enharmonics in labels, default True zZ bool on whether to hide labels for unused pitches, default True. zw bool on whether not to even show a tick when a pitch doesn't exist. default True. z bool or 'few' about whether to show octave numbers. If 'few' then only the first pitch in each octave is shown. Default 'few' )showEnharmonicblankLabelUnused hideUnused showOctavesrrPitch) pitchGenericr$rc\>[TU]X5 SUlSUlSUlSUlg)NfewT)superr-rr|r}r~r+r*rr1s r,r-PitchAxis.__init__?s/ * " $r/cZ/nUH"up#[U5nURX#45 M$ U$)un Given a list of ticks, replace all labels with alternative/unicode symbols where necessary. >>> ticks = [(60, 'C4'), (61, 'C#4'), (62, 'D4'), (63, 'E-4')] >>> t2 = graph.axis.PitchAxis.makePitchLabelsUnicode(ticks) >>> len(t2) 4 >>> [num for num, label in t2] [60, 61, 62, 63] >>> t2[0] (60, 'C4') >>> for num, label in t2: ... label 'C4' 'C♯4' 'D4' 'E♭4' )rr`)ripostr@r:s r,makePitchLabelsUnicode PitchAxis.makePitchLabelsUnicodeFs40!LE,U3E KK '" r/cURnUc0nO[R"X15n/n0n[5nSnSn [ [ UR 5[ UR5S-5GHn [R"5n [XU 5 /n UHIn X;a"[[R"U 5U5Xm'XmU :XdM4U RXMU 45 MK UR(aU RU S9 OU RUS9 SnU (d3UR(aMUR (d [X5nOVSnOSUR(d U SSnO9/nU H unnUR[#U55 M" SR%U5nUR&S La[(R*"S SU5nOoUR&S :Xa_[(R,"S U5nU(aAUR/S5nUU;a[(R*"S SU5nOUR1U5 URX45 GM UR3U5nU$) z Helper method that can apply all the showEnharmonic, etc. values consistently see the `ticks` methods below. Returns a list of two-element tuples NcTUupURS5(aSUSS-nSU-U4$)z ensure that higher weighed weights come first, but then alphabetical by name, except that G comes before A. That's the only "out of order" item we need to be concerned with since we are only comparing enharmonics. AHrNr startswithrweight sort_names r,weightedSortHelper6PitchAxis._pitchTickHelper..weightedSortHelperxs<!" F##C(()AB-/ K+ +r/cLUupURS5(aSUSS-nX4$)Nrrrrrs r,unweightedSortHelper8PitchAxis._pitchTickHelper..unweightedSortHelpers4 ! F##C(()AB-/ & &r/r)keyr/Fz\dr)r rpitchAttributeCountsetr_r\rrr rsetattrgetattrr`r|sortr~r}rjoinrresubsearchgroupaddr)r+attributeCounterattributeCompares nameCountri helperDict octavesSeenrripweightsrr:r unused_weightname matchOctave octaveMatchs r,_pitchTickHelperPitchAxis._pitchTickHelperds KK 9I%99!NI e  , ' s4==)3t}}+=+ABA A A +G ('.ekk#.>@P&QJO?a'NNINC#89!"" !5 6 !3 4E??,,#A8EE(( 1 +2'M4JJ7=>,3 5(ub%0!!U* iiu5 "-"3"3A"6K"k1 "ub% 8# 4 LL! $]C^++E2 r/)r}r~r|rrp)rilist[tuple[t.Any, str]]rqr)r2rrrsrtrurrvr8rr- staticmethodrrry __classcell__r1s@r,r{r{(s`!I~ L"4J4:VVr/r{cT^\rSrSr%SrSrSrS\S'S U4SjjrS Sjr S r S r U=r $) PitchClassAxisizf Axis subclass for dealing with PitchClasses By default, axis is not set from data, but set to 0, 11 z Pitch Class) pitchClass pitchclasspcr$rcN>SUl[TU] X5 SUlSUlg)NFr )rrr-rrrs r,r-PitchClassAxis.__init__s&  *  r/cR[US5(aURR$gNr )hasattrr rrNs r,rQ PitchClassAxis.extractOneElements" 1g  77%% %r/c&URSS5$)u9 Get ticks and labels for pitch classes. If `showEnharmonic` is `True` (default) then when choosing whether to display as sharp or flat use the most commonly used enharmonic. >>> s = corpus.parse('bach/bwv324.xml') >>> s.analyze('key') >>> plotS = graph.plot.PlotStream(s) >>> ax = graph.axis.PitchClassAxis(plotS) >>> ax.hideUnused = True Ticks returns a list of two-element tuples: >>> ax.ticks() [(0, 'C'), (2, 'D'), ..., (11, 'B')] >>> for position, noteName in ax.ticks(): ... print(str(position) + ' ' + noteName) 0 C 2 D 3 D♯ 4 E 6 F♯ 7 G 9 A 11 B >>> s = corpus.parse('bach/bwv281.xml') >>> plotS = graph.plot.PlotStream(s) >>> ax = graph.axis.PitchClassAxis(plotS) >>> ax.hideUnused = True >>> ax.showEnharmonic = True >>> for position, noteName in ax.ticks(): ... print(str(position) + ' ' + noteName) 0 C 2 D 3 E♭ 4 E 5 F 7 G 9 A 10 B♭ 11 B >>> ax.blankLabelUnused = True >>> ax.hideUnused = False >>> for position, noteName in ax.ticks(): ... print(str(position) + ' ' + noteName) 0 C 1 2 D 3 E♭ 4 E 5 F 6 7 G 8 9 A 10 B♭ 11 B `.showEnharmonic` will change here: >>> s.append(note.Note('A#4')) >>> s.append(note.Note('G#4')) >>> s.append(note.Note('A-4')) >>> s.append(note.Note('A-4')) >>> for position, noteName in ax.ticks(): ... print(str(position) + ' ' + noteName) 0 C 1 2 D 3 E♭ 4 E 5 F 6 7 G 8 G♯/A♭ 9 A 10 A♯/B♭ 11 B Make sure that Ab shows since there are two of them and only one G# >>> ax.showEnharmonic = False >>> for position, noteName in ax.ticks(): ... print(str(position) + ' ' + noteName) 0 C 1 2 D 3 E♭ 4 E 5 F 6 7 G 8 A♭ 9 A 10 B♭ 11 B OMIT_FROM_DOCS TODO: this ultimately needs to look at key signature/key to determine defaults for undefined notes where blankLabelUnused is False. rrrr9s r,riPitchClassAxis.tickssf$$V\::r/)rrrrp)rqz int | None) r2rrrsrtrur8rrvr-rQriryrrs@r,rrs/ !L"DJD  s;s;r/rc<\rSrSr%SrSrSrS\S'SrS Sjr S r g ) PitchSpaceAxisiGz: Axis subclass for dealing with PitchSpace (MIDI numbers) r) pitchSpacer pitchspacepsr$rcR[US5(aURR$gr)rr rrNs r,rQ PitchSpaceAxis.extractOneElementNs" 1g  77::  r/c&URSS5$)u >>> ax = graph.axis.PitchSpaceAxis() >>> ax.hideUnused = False >>> ax.blankLabelUnused = False >>> ax.minValue = 20 >>> ax.maxValue = 24 >>> for ps, label in ax.ticks(): ... print(str(ps) + ' ' + label) 20 G♯0 21 A 22 B♭ 23 B 24 C1 >>> ax.showOctaves = False >>> for ps, label in ax.ticks(): ... print(str(ps) + ' ' + label) 20 G♯ 21 A 22 B♭ 23 B 24 C >>> ax.showOctaves = True >>> for ps, label in ax.ticks(): ... print(str(ps) + ' ' + label) 20 G♯0 21 A0 22 B♭0 23 B0 24 C1 >>> ax.minValue = 60 >>> ax.maxValue = 72 >>> [x for x, y in ax.ticks()] [60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72] >>> bach = corpus.parse('bwv66.6') >>> plotS = graph.plot.PlotStream(bach.parts[-1]) >>> ax = graph.axis.PitchSpaceAxis(plotS) >>> ax.hideUnused = False >>> ax.minValue = 36 >>> ax.maxValue = 100 >>> ticks = ax.ticks() >>> ticks[0] # blank because no note 36 in data (36, '') >>> ticks[21] (57, 'A') nameWithOctaverr)r+dataMindataMaxs r,riPitchSpaceAxis.ticksRsd$$%5t< An axis similar to pitch classes, but just shows the octaves Octave)octaveoctavesr$rc2>[TU]X5 SUlg)NC2)rr-startNameWithOctavers r,r-PitchSpaceOctaveAxis.__init__s *#' r/c/n[R"UR5nURUR::a{URUR :a0UR [UR5UR45 U=RS- sl URUR::aM{URU5nU$)a This class does not currently take into account whether the octaves themselves are found in the Stream. >>> ax = graph.axis.PitchSpaceOctaveAxis() >>> ax.minValue = 36 >>> ax.maxValue = 100 >>> ax.ticks() [(36, 'C2'), (48, 'C3'), (60, 'C4'), (72, 'C5'), (84, 'C6'), (96, 'C7')] >>> ax.startNameWithOctave = 'A2' >>> ax.ticks() [(45, 'A2'), (57, 'A3'), (69, 'A4'), (81, 'A5'), (93, 'A6')] r) r rrrrrr`r\rrr)r+ri currentPitchs r,riPitchSpaceOctaveAxis.tickss{{4#;#;< oo.$--/ c,//2L4O4OPQ   1 $ oo.++E2 r/)rrp) r2rrrsrtrur8rrvr-riryrrs@r,rrs(L"7J7(r/rcV^\rSrSr%SrSS0rS\S'SrSrS \S 'S U4S jjr S r U=r $) PositionAxisiz* Axis subclass for dealing with Positions graceNoteQLz length to substitute a grace note or other Zero-length element for. Default is the length of a 64th note (1/16 of a QL) rrPosition)position positionsr$rc2>[TU]X5 SUlg)Ng?)rr-rrs r,r-PositionAxis.__init__s * r/)rrp) r2rrrsrtrurrvr8rr-ryrrs@r,rrs;  !I~L";J;!!r/rc^\rSrSr%SrSSSSSSS .rS \S 'S rS rS\S'SU4Sjjr Sr \ S5r \ RS5r SSjrSrSrSrSSjrSrU=r$) OffsetAxisiz( Axis subclass for dealing with Offsets z bool or None for whether offsets (False) or measure numbers (True) should be used in the case of an offset access. Default, None, meaning to check whether the stream has measures first. z If measures are not used then this number is used to create the number of steps between an axis tick. Currently the default is 10, but it might become a function of the length of the stream eventually. z If True then only the first and last values will be used to create ticks for measures. Default False. zHThe lowest starting position (as an offset). Will be set automatically.zGThe highest ending position (as an offset). Will be set automatically.a When plotting measures, will limit the number of ticks given to at most this number. Note that since all double/final/heavy bars are show, this number may be exceeded if there are more that this number of double bars. Default: 20. ) useMeasuresoffsetStepSizeminMaxMeasureOnlyrrmostMeasureTicksToShowrrOffset)offsetmeasureoffsetsmeasurestimer$rc\>[TU]X5 SUlSUlSUlSUlg)Nr[F)rr-rrrrrs r,r-OffsetAxis.__init__s0 * &(#!&r/c8URUR5$r=)getOffsetInHierarchyr rNs r,rQOffsetAxis.extractOneElement!s%%dkk22r/cURb UR$URnUcUR5nU(agg)z Return an axis label for measure or offset, depending on if measures are available. >>> a = graph.axis.OffsetAxis() >>> a.label 'Offset' >>> a.useMeasures = True >>> a.label 'Measure Number' zMeasure Numberr)r)rsetUseMeasuresFromOffsetMap)r+rs r,r:OffsetAxis.label$s@ ;; ";; &&  ::r?s r,r:r<rAr/cURRUlURRUlg![ a* SUlU(a[ U5UlgSUlgf=f)Nrr[)r lowestOffsetr highestTimerAttributeErrorrUrVs r,rX OffsetAxis.setBoundariesFromData@sT # KK44DM KK33DM #DM #F  "  #s69(A-#A-,A-cUR5nURU5 UR(a'URURUR U5$/n[ [R"UR55n[ [R"UR 55n[X4S-UR5HnURU[U545 M! U$)a Get offset or measure ticks >>> bach = corpus.parse('bach/bwv281.xml') >>> plotS = graph.plot.PlotStream(bach) >>> ax = graph.axis.OffsetAxis(plotS) >>> ax.setBoundariesFromData() >>> ax.ticks() # on whole score, showing anacrusis spacing [(0.0, '0'), (1.0, '1'), (5.0, '2'), (9.0, '3'), (13.0, '4'), (17.0, '5'), (21.0, '6'), (25.0, '7'), (29.0, '8')] We can reduce the number of ticks shown: >>> ax.mostMeasureTicksToShow = 4 >>> ax.ticks() [(0.0, '0'), (9.0, '3'), (21.0, '6'), (29.0, '8')] We can also plot on a part: >>> soprano = bach.parts.first() >>> plotSoprano = graph.plot.PlotStream(soprano) >>> ax = graph.axis.OffsetAxis(plotSoprano) >>> ax.setBoundariesFromData() >>> ax.ticks() # on whole score, showing anacrusis spacing [(0.0, '0'), (1.0, '1'), (5.0, '2'), (9.0, '3'), (13.0, '4'), (17.0, '5'), (21.0, '6'), (25.0, '7'), (29.0, '8')] Now we will show just the first and last measure: >>> ax.minMaxMeasureOnly = True >>> ax.ticks() [(0.0, '0'), (29.0, '8')] Only show ticks between minValue and maxValue (in offsets): >>> ax.minMaxMeasureOnly = False >>> ax.minValue = 8 >>> ax.maxValue = 12 >>> ax.ticks() [(9.0, '3')] Double bars and other heavy bars always show up. (Let's get a new axis object to see.) >>> ax = graph.axis.OffsetAxis(plotSoprano) >>> ax.setBoundariesFromData() >>> ax.mostMeasureTicksToShow = 4 >>> ax.ticks() [(0.0, '0'), (9.0, '3'), (21.0, '6'), (29.0, '8')] >>> m5 = soprano.getElementsByClass(stream.Measure)[5] >>> m5.number 5 >>> m5.rightBarline = bar.Barline('double') >>> ax.ticks() [(0.0, '0'), (13.0, '4'), (17.0, '5'), (29.0, '8')] Future improvements might make the spacing around the double bars a bit better. It'd be nice to see measure 2 or 3 ticked rather than measure 4. On a raw collection of notes with no measures, offsets are used: >>> n = note.Note('a') >>> s = stream.Stream() >>> s.repeatAppend(n, 20) >>> plotS = graph.plot.PlotStream(s) >>> ax = graph.axis.OffsetAxis(plotS) >>> ax.setBoundariesFromData() >>> ax.ticks() [(0, '0'), (10, '10'), (20, '20')] The space between offsets is configured by `.offsetStepSize`. At present mostMeasureTicksToShow to does affect streams without measures. >>> ax.offsetStepSize = 5 >>> ax.ticks() [(0, '0'), (5, '5'), (10, '10'), (15, '15'), (20, '20')] r) getOffsetMaprr _measureTicksrrr\r]floorceilr_rr`r')r+ offsetMaprioMinoMaxrs r,riOffsetAxis.ticksKsd%%'  ((3   %%dmmT]]IN NEtzz$--01Dtyy/0D44+>+>? aQ[)@Lr/c^^^^/m/m[TR55nUH&nXs=::aU::dMO MTRU5 M( UR(aHSH@nTUnTUSRnU[ U54n U T;dM/TRU 5 MB T$[ 5mUUUU4Sjn U "S5 U "[T5S- 5 [S[T5S- 5HQnTUn TU Sn U RcMU RR[R;dMIU "U5 MS [UR[T5- S-[T55n [[T5U -S5nUnU[T5S- :a U "U5 Xn- nU[T5S- :aM TR!5 T$)z2 helper method for ticks() just to pull out code. )rrrc>UT;agTUnTUSnURnU[U54nTRU5 TRU5 gNr)numberr'r`r) index_in_mNoToUser foundMeasuremNumber tickTuplemNoToUser tickIndexesUsedris r,add_tick_tuple0OffsetAxis._measureTicks..add_tick_tuples\$7!"34(03 &--#S\2  Y'##$56r/r)listkeysr`rrr'rlenr_ rightBarlinetyperstrongBarlineTypesrTrrUr)r+rrr  sortedKeysrrrrrr mapOffset mapMeasuremaxMoreTicksToAdd mNoStepSizerrris ` @@@r,rOffsetAxis._measureTickss)..*+ C((($  ! !!!#F+A.55#S\2 E)LL+ Z M"eO 7 7 1  3x=1, -1c(ma/0$QK &y1!4 ++7&3388C>> b = corpus.parse('bwv66.6') >>> p = graph.plot.PlotStream(b) >>> ax = graph.axis.OffsetAxis(p, 'x') >>> om = ax.getOffsetMap() >>> om OrderedDict([(0.0, []), (1.0, []), (5.0, []), ...]) Same if called on a single part: >>> p = graph.plot.PlotStream(b.parts[0]) >>> ax = graph.axis.OffsetAxis(p, 'x') >>> om2 = ax.getOffsetMap() >>> om2 OrderedDict([(0.0, []), (1.0, []), (5.0, []), ...]) But empty if called on a single Measure ... >>> p = graph.plot.PlotStream(b.parts[0].getElementsByClass(stream.Measure)[2]) >>> ax = graph.axis.OffsetAxis(p, 'x') >>> om3 = ax.getOffsetMap() >>> om3 {} )r hasPartLikeStreamsgetElementsByClassrIfirstmeasureOffsetMapMeasure hasMeasures)r+rr s r,rOffsetAxis.getOffsetMapsF KK 9I   ! !--fmm<BBD**FNN+;<  ]]__**FNN+;>> b = corpus.parse('bwv66.6') >>> p = graph.plot.PlotStream(b) >>> ax = graph.axis.OffsetAxis(p, 'x') >>> print(ax.useMeasures) None >>> ax.setUseMeasuresFromOffsetMap() True Sets `.useMeasures` as a side effect: >>> ax.useMeasures True same as: >>> ax = graph.axis.OffsetAxis(p, 'x') >>> om = ax.getOffsetMap() >>> ax.setUseMeasuresFromOffsetMap(om) True If `.useMeasures` is set explicitly, then we return that >>> ax.useMeasures = False >>> ax.setUseMeasuresFromOffsetMap() False Returns False if the offsetMap is empty >>> p = graph.plot.PlotStream(b.parts[0].getElementsByClass(stream.Measure)[2]) >>> axMeasure = graph.axis.OffsetAxis(p, 'x') >>> axMeasure.setUseMeasuresFromOffsetMap() False >>> axMeasure.useMeasures False )rrbool)r+r s r,r&OffsetAxis.setUseMeasuresFromOffsetMap&sIT    '## #  ))+I ?r/)r)rrrrrrrpr=)r2rrrsrtrurrvr8rr-rQrwr:rxrXrirrrryrrs@r,rrs  _]##!I~0L"VJV'3. \\ #`DCJ2h/ / r/rc^\rSrSr%SrSSS.rS\S'SrS rS \S 'SU4S jjr S r Sr Sr Sr \U4Sj5r\R U4Sj5rSrSrU=r$)QuarterLengthAxisiXz/ Axis subclass for dealing with QuarterLengths z bool or int for whether to scale numbers logarithmically. Adds (log2) to the axis label if used. If True (default) then log2 is assumed. If an int, then log the int (say, 10) is used. instead. z If used then duration names replace numbers for ticks. If set, probably will want to change tickFontSize in the graph object ) useLogScaleuseDurationNamesrrzQuarter Length) quarterLengthqlquarterlengths durationsrr$rc@>[TU]X5 SUlSUlg)NTF)rr-r4r5rs r,r-QuarterLengthAxis.__init__ps  * %r/cLURURR5$r=) dataFromQLrr6rNs r,rQ#QuarterLengthAxis.extractOneElementusqzz7788r/cUR(aURU5nU$US:a [U5nU$URnU$r)r4remapQuarterLengthfloatr)r+r7rs r,r=QuarterLengthAxis.dataFromQLxsM   ''+A  !Vb A  Ar/cURnU(d/$URR(aUR5nOUR5nUR URR 5n[ R"US5n/n[U5HmnURU5nUR(a![R"U5RnO[[US55nUR!Xg45 Mo U$)aA Get ticks for quarterLength. If `remap` is `True` (the default), the `remapQuarterLength()` method will be used to scale displayed quarter lengths by log base 2. Note that mix and max do nothing, but must be included in order to set the tick style. >>> s = stream.Stream() >>> for t in ['32nd', '16th', 'eighth', 'quarter', 'half']: ... n = note.Note() ... n.duration.type = t ... s.append(n) >>> plotS = graph.plot.PlotStream(s) >>> ax = graph.axis.QuarterLengthAxis(plotS) >>> ax.ticks() [(-3.0, '0.12'), (-2.0, '0.25'), (-1.0, '0.5'), (0.0, '1.0'), (1.0, '2.0')] >>> ax.useLogScale = False >>> ax.ticks() [(0.125, '0.12'), (0.25, '0.25'), (0.5, '0.5'), (1.0, '1.0'), (2.0, '2.0')] >>> ax.useDurationNames = True >>> ax.ticks() [(0.125, '32nd'), (0.25, '16th'), (0.5, 'Eighth'), (1.0, 'Quarter'), (2.0, 'Half')] >>> nGrace = note.Note() >>> nGrace.getGrace(inPlace=True) >>> s.append(nGrace) >>> plotS = graph.plot.PlotStream(s) >>> ax = graph.axis.QuarterLengthAxis(plotS) >>> ax.ticks()[0] (-4.0, '0.0') >>> ax.useLogScale = False >>> ax.ticks()[0] (0.0625, '0.0') r6r)r r*recurseiterr)classFilterListelementAnalysisattributeCountsortedr=r5rDurationfullNamer'roundr`)r+rsSrcmappingrir7rr:s r,riQuarterLengthAxis.tickssT KKI [[ 99;D668D&&t{{'B'BC!00G/B#A$$ ))"-66E"aL) LL! $ " r/cdURSLagURSLagSURSS3$)aH Returns a TeX formatted tag to the axis label depending on whether the scale is logarithmic or not. Checks `.useLogScale` >>> a = graph.axis.QuarterLengthAxis() >>> a.useLogScale True >>> a.labelLogTag() ' ($log_2$)' >>> a.useLogScale = False >>> a.labelLogTag() '' >>> a.useLogScale = 10 >>> a.labelLogTag() ' ($log_10$)' FrTz ($log_2$)z ($log_dz$))r4r9s r, labelLogTagQuarterLengthAxis.labelLogTags>&   u $    %T--a03 3r/c:>[TU]UR5-$r=)rr:rR)r+r1s r,r:QuarterLengthAxis.labelsw}t//111r/c$>U[5lgr=)rr:)r+r@r1s r,r:rUs  r/cUS:Xa URn[R"[U55$![a [ SU35ef=f)zu Remap a quarter length as its log2. Essentially it's just math.log2(x), but x=0 is replaced with self.graceNoteQL. rzcannot take log of x value: )rr]log2rA ValueErrorr)r+rs r,r@$QuarterLengthAxis.remapQuarterLengthsS 6  A E99U1X& & E #?s!CD D Es 3A )r5r4rp)r2rrrsrtrurrvr8rr-rQr=rirRrwr:rxr@ryrrs@r,r3r3Xs  !I~ $L#%J%& 9>@4422 \\ E Er/r3c^^\rSrSr%SrSS0rS\S'SrS\S 'S S \4U4S jjr S r Sr U=r $) OffsetEndAxisizA An Axis that gives beginning and ending values for each element noteSpacingzt amount in QL to leave blank between untied notes. (default = self.graceNoteQL) rr) offsetEnd timespanstimespanr$rNrch>[TU]X5 X0lU[:XaURUlggr=)rr-r]USE_GRACE_NOTE_SPACINGr)r+r*rr]r1s r,r-OffsetEndAxis.__init__s2 *& 0 0#//D  1r/c[URUR55n[URR5nX@R :aUR nX44$X@R S-:aJ[ US5(a+URbURRS;aX44$X@R -nX44$)Nrtie)startcontinue) rArr rr6r]rrer)r+rOrPoffuseQLs r,rQOffsetEndAxis.extractOneElementsA**4;;78ajj../ ## #$$E| %%) )q%  QUU%6155::I^;^|)))|r/)r]) r2rrrsrtrurrvrrbr-rQryrrs@r,r\r\sD !I~ #IJH"S>T0  r/r\cJ^\rSrSr%SrSrSrS\S'S U4SjjrSr S r U=r $) DynamicsAxisiz) Axis subclass for dealing with Dynamics Dynamic)dynamicr volumer$rc>Uc)SUl[[R5S- Ulg[ TU]U5 [UR5Ul[UR5Ulg)Nrr)rrr shortNamesrrrXr\)r+rWr1s r,rX"DynamicsAxis.setBoundariesFromDatasS >DM 3 34q8DM G )& 1 .DM .DMr/c/nURcUR5 [URURS-5H*nUR US[ R U-45 M, U$)a  Utility method to get ticks in dynamic values: >>> ax = graph.axis.DynamicsAxis() >>> ax.ticks() [(0, '$pppppp$'), (1, '$ppppp$'), (2, '$pppp$'), (3, '$ppp$'), (4, '$pp$'), (5, '$p$'), (6, '$mp$'), (7, '$mf$'), (8, '$f$'), (9, '$fp$'), (10, '$sf$'), (11, '$ff$'), (12, '$fff$'), (13, '$ffff$'), (14, '$fffff$'), (15, '$ffffff$')] A minimum and maximum dynamic index can be specified as minValue and maxValue >>> ax.minValue = 3 >>> ax.maxValue = 6 >>> ax.ticks() [(3, '$ppp$'), (4, '$pp$'), (5, '$p$'), (6, '$mp$')] rz$%s$)rrXr_rr`r rq)r+rirs r,riDynamicsAxis.ticks#se$ ==  & & (t}}dmma&78A LL!Wx':':1'==> ?9 r/)rrr=) r2rrrsrtrur8rrvrXriryrrs@r,rlrls(L"CJC/r/rlc\^\rSrSr%SrSS0rS\S'SrSrS \S 'SU4S jjr S r S r U=r $) CountingAxisi@a Axis subclass for counting data in another Axis. Used for histograms, weighted scatter, etc. >>> bach = corpus.parse('bwv66.6') >>> plotS = graph.plot.PlotStream(bach) >>> plotS.axisX = graph.axis.PitchSpaceAxis(plotS, 'x') >>> plotS.axisY = graph.axis.CountingAxis(plotS) >>> plotS.doneAction = None >>> plotS.run() >>> plotS.data [(42.0, 1, {}), (45.0, 1, {}), (46.0, 1, {}), (47.0, 5, {}), (49.0, 6, {}), ...] countAxeszf a string or tuple of strings representing an axis or axes to use in counting rrCount)countquantity frequencycountingr$rc2>[TU]X5 SUlgrp)rr-rwrs r,r-CountingAxis.__init__Xs *r/cD^TRnUc/$SSKJn TRn[R "U5(dU4n[ U4SjU55nTRTRnU"U6nURVs/sH ov"U5PM nn0n URHEn U"U 5n U Sn [U [5(dM'X;aXRU 5 MAXU 'MG [R"U5n /nU HunS/[U5S--n[U5S:aUH nUUUU'M OUUUS'XUU'U R!U05n UR#[ U5U 4-5 Mw [%U5Ul UR$s snf)zC Replace client.data with a list that only includes each key once. Nr) itemgetterc3B># UHnTRUv M g7fr=)r).0rr+s r, /CountingAxis.postProcessData..isQy8D,,X6ysrr)r*operatorrrwr isIterabletuplerrdatar&dictupdate collectionsCounterrgetr`rI)r+r*rrw axesIndices thisIndexselector innerTuple relevantDatatupleFormatDict dataPoint dataIndexrPcounter newClientData counterKey innerListdependentIndexs` r,rnCountingAxis.postProcessData\s >I'NN   ++" IQyQQ $$T]]3 {+?E{{K{,{ KI +I"2Jj$//+*11*=-7 *%%%l3 !J#k"2Q"67I;!#&1N0:>0JIn-'2-7 +a.)#*#6Ii (,,Z.countingAxisFormatters,ww!!-&+ 7#77** *r/r) Histogram) converterz$tinynotation: 4/4 C4 D E F C D# E F#rrrrr) music21.graph.plotrmusic21rparse doneActionraxisXrQrun assertEqualr)r+rrrrhists r,testCountingAxisFormatTest.testCountingAxisFormats + 1% OOB C|$_ '< $   a*q!gu-=&>a*q!gu-=&>@ Ar/rMN)r2rrrsrtrryrMr/r,rrsAr/r__main__)+ru __future__rrr]rtypingtunittestmusic21.graph.utilitiesrrrrrrr r r r music21.analysisr rGr TYPE_CHECKINGrrbProtoM21Objectrr{rrrrrr3r\rlrvTestCaserr2mainTestrMr/r,rs&# L8*??u 7 ! !u tRRjG;YG;T==Y==@!>!@!4!&[ [ | VE VErJD(4(ZI4IZA8  A, z Tr/