j|tdZddlmZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z ddl mZddl mZddl mZdd l mZdd l mZdd l mZdd lmZdd lmZejrddl mZdZGddejZGddeZGddeZGddeZGddeZ GddeZ!Gdde!Z"Gdde!Z#Gd d!e"Z$Gd"d#eZ%Gd$d%eZ&Gd&d'ej'Z(e)d(krddl Z e j*e(dSdS))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)noteceZdZUdZddddddZded <d Zd d d dZdZded<d%dZ dZ e dZ e j dZ e dZej dZe dZd&d!Zd"Zd#Zd'd$ZdS)(Axisz 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, ...]rNrct|trtdd|_d|_||_||_d|_d|_dS)Nz,Client must be a PlotStream, Stream, or None) isinstancestrr_client_labelclientrrr)selfr)rs /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/graph/axis.py__init__z Axis.__init__[sR fc " " Q !OPP P       cL|j}| |jj}nd}d|jd|S)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 Nz (no client)z: z axis for )r) __class____name__r)r*c clientNames r+ _reprInternalzAxis._reprInternalgs9. K =-JJ&J9DM99Z999r-c,|j|jS|jS)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+labelz Axis.labels ; "; $ $r-c||_dSNr(r*values r+r7z Axis.label  r-c4tj|jS)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'r6s r+r)z Axis.clients#DL111r-c8tj||_dSr9)r wrapWeakrefr')r*referents r+r)z Axis.clients)(33 r-c^|j}|dSt|tjr|S|jS)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*r1s r+r z Axis.streams6 K 94 6= ) ) H; r-nnote.GeneralNote formatDictdict[str, t.Any]returnt.AnycdS)z( Override in subclasses rr*rFrHs r+extractOneElementzAxis.extractOneElements qr-c|j|rt||_|j|rt||_dSdSdS)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+setBoundariesFromDatazAxis.setBoundariesFromDatasJ: = V KKDM = V KKDMMM ! r-c|j}|j}|d}|d}||z }|dkrd}n$ttj||z }d|z}|dkr||z dkrt|dz }t||z dz |z}|dkr|dkrd}t||z dz|z}t |||}g} |D]&} | | t| f'| S)az 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')] Nr rr)rrintmathlog10rangeappendr&) r*minVmaxV difference log10distance closest10 startValue stopValuestepstickstickNums r+rez Axis.tickss%6}} <D <DD[ ??MM 4$; 7 788M-' q==j94::IN++I$*++a/9< >>daiiJ )**Q.); j)Y77 2 2G LL'3w<<0 1 1 1 1 r-cdS)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+postProcessDatazAxis.postProcessDatas r-Nr)rFrGrHrIrJrKr9)r0 __module__ __qualname____doc__r__annotations__r5rrr,r3propertyr7setterr)r rOrUrerirMr-r+rr-sxT"3!!!!I!!!!FL**K"HJHHHH    :::>%%X%  \\22X2 ]44]4X  ( ( (D777r      r-rcneZdZUdZdddddZded<d Zd Zd ed <dfd Ze ddZ dZ xZ S) PitchAxisz0 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#rNrct||d|_d|_d|_d|_dS)NfewT)superr,rvrsrtrur*r)rr/s r+r,zPitchAxis.__init__>s@ *** " $r-relist[tuple[t.Any, str]]rJcfg}|D]+\}}t|}|||f,|S)u 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\)repostr<r7s r+makePitchLabelsUnicodez PitchAxis.makePitchLabelsUnicodeEsG0! ( (LE5,U33E KK ' ' ' ' r-c|j}|i}ntj||}g}i}t}d}d} t t |jt |jdzD]} tj } t| || g} |D]T} | |vr%ttj | ||| <|| | kr| || | fU|j r| | n| |d}| s#|jr|jst| |}nZd}nW|j s| dd}nAg}| D]'\}}| t#|(d|}|jd urt)jd d|}ng|jd kr\t)jd |}|rE|d}||vrt)jd d|}n||| | |f||}|S) z Helper method that can apply all the showEnharmonic, etc. values consistently see the `ticks` methods below. Returns a list of two-element tuples Nc^|\}}|dr d|ddz}d|z|fS)a 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+weightedSortHelperz6PitchAxis._pitchTickHelper..weightedSortHelperwsE!" FI##C(( 0)ABB-/ K+ +r-cX|\}}|dr d|ddz}||fS)Nrrrrrs r+unweightedSortHelperz8PitchAxis._pitchTickHelper..unweightedSortHelpers? ! FI##C(( 0)ABB-/ I& &r-r)keyr/Fz\drz)r rpitchAttributeCountsetr[rXrrr rwsetattrgetattrr\rssortrurtrjoinrvresubsearchgroupaddr)r*attributeCounterattributeCompares nameCountre helperDict octavesSeenrripweightsrr7r unused_weightname matchOctave octaveMatchs r+_pitchTickHelperzPitchAxis._pitchTickHelpercs K 9II%9!=MNNI ee  , , , ' ' ' s4=))3t}+=+=+ABB. %. %A A A' + + +G  : :j(('.ek#.>.>@P&Q&QJsOc?a''NNIcNC#8999" 5 !5 6666 !3 444E &?,#A'788EEEE( & 1 +2??'M4JJ7==>>>> 5((ub%00!U** iu55 5"-"3"3A"6"6K"k11 "ub% 8 8# 444 LL!U $ $ $ $++E22 r-rj)rer}rJr}) r0rkrlrmrrnr5rr, staticmethodrr __classcell__r/s@r+rrrr's!!I L"4J4444\:VVVVVVVr-rrcFeZdZUdZdZdZded<d fd Zdd Zd Z xZ S)PitchClassAxiszr Axis subclass for dealing with PitchClasses By default, axis is not set from data, but set to 0, 11 z Pitch Class) pitchClass pitchclasspcr#rNrcvd|_t||d|_d|_dS)NFr )rvr{r,rrr|s r+r,zPitchClassAxis.__init__s7  ***  r-rJ int | Nonec>t|dr |jjSdSNr )hasattrr rrNs r+rOz PitchClassAxis.extractOneElements$ 1g   &7% %tr-c.|ddS)u' 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. rrrr6s r+rezPitchClassAxis.tickssb$$V\:::r-rj)rJr) r0rkrlrmr5rrnr,rOrerrs@r+rrs !L"DJDDDD  q;q;q;q;q;q;q;r-rc4eZdZUdZdZdZded<dZd d Zd S) PitchSpaceAxiszB Axis subclass for dealing with PitchSpace (MIDI numbers) rw) pitchSpacer pitchspacepsr#rc>t|dr |jjSdSr)rr rrNs r+rOz PitchSpaceAxis.extractOneElementKs( 1g   7:   r-$dc.|ddS)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+rezPitchSpaceAxis.ticksOsd$$%5t<<eZdZUdZdZdZded<d fd Zd ZxZ S) PitchSpaceOctaveAxiszF An axis similar to pitch classes, but just shows the octaves Octave)octaveoctavesr#rNrcZt||d|_dS)NC2)r{r,startNameWithOctaver|s r+r,zPitchSpaceOctaveAxis.__init__s+ ***#'   r-cBg}tj|j}|j|jkr^|j|jkr.|t|j|jf|xj dz c_ |j|jk^| |}|S)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 rwrrrrr\rXrrr)r*re currentPitchs r+rezPitchSpaceOctaveAxis.tickss{4#;<< o..$-// c,/22L4OPQQQ   1 $  o..++E22 r-rj) r0rkrlrmr5rrnr,rerrs@r+rrspL"7J7777((((((r-rcJeZdZUdZddiZded<dZdZded <d fd ZxZ S) PositionAxisz2 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#rNrcZt||d|_dS)Ng?)r{r,rr|s r+r,zPositionAxis.__init__s+ *** r-rj) r0rkrlrmrrnr5rr,rrs@r+rrs  !IL";J;;;;!!!!!!!!!!r-rceZdZUdZdddddddZd ed <d Zd Zd ed<dfd ZdZ e dZ e j dZ ddZ dZdZdZddZxZS) OffsetAxisz0 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#rNrct||d|_d|_d|_d|_dS)NrWF)r{r,rrrrr|s r+r,zOffsetAxis.__init__sC *** &(#!&r-c6||jSr9)getOffsetInHierarchyr rNs r+rOzOffsetAxis.extractOneElements%%dk222r-cd|j|jS|j}||}|rdSdS)a 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' NzMeasure Numberr)r(rsetUseMeasuresFromOffsetMap)r*rs r+r7zOffsetAxis.label!sF ; "; &  ::<>> 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 _measureTicksrrrXrYfloorceilr[rr\r&)r* offsetMapreoMinoMaxrs r+rezOffsetAxis.ticksHs^%%''  ((333   %%dmT]INN NEtz$-0011Dty//00D44+>?? * * aQ[))))Lr-cggt}|D]'}||cxkr|krn|(|jrLdD]G}|}|dj}|t |f} | vr| HnFt fd} | d| tdz tdtdz D]B}|} | d} | j #| j j tj vr | |Ct|jtz dzt} tt| zd}|}|tdz kr&| |||z }|tdz k&S)zB helper method for ticks() just to pull out code. )rrrc|vrdS|}|d}|j}|t|f}||dSNr)numberr&r\r) index_in_mNoToUser foundMeasuremNumber tickTuplemNoToUsertickIndexesUsedres r+add_tick_tuplez0OffsetAxis._measureTicks..add_tick_tuplesr$77F!"34(03 &-#S\\2  Y'''##$566666r-r)listkeysr\rrr&rlenr[ rightBarlinetyperstrongBarlineTypesrQrrRr)r*rrr sortedKeysrrrrrr mapOffset mapMeasuremaxMoreTicksToAdd mNoStepSizerrres ` @@@r+rzOffsetAxis._measureTickssV)..**++  % %C#((((((((($$$  !,  , ,!!#F+A.5#S\\2 E))LL+++  ,"eeO 7 7 7 7 7 7 7 7 N1    N3x==1, - - -1c(mma/00 & &$QK &y1!4 +7&38C>> 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 hasPartLikeStreamsgetElementsByClassrDfirstmeasureOffsetMapMeasure hasMeasures)r*rrs r+rzOffsetAxis.getOffsetMapsF K 9I   ! ! --fm<<BBDD**FN+;<< I ]]__ **FN+;<>> 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*rs r+rz&OffsetAxis.setUseMeasuresFromOffsetMap sET   '# #  ))++I ??r-rjr9)r0rkrlrmrrnr5rr,rOror7rprUrerrrrrs@r+rrsC  _]##!!I0L"VJVVVV''''''333X. \\ # # # #]]]~CCCJ222h/ / / / / / / / r-rceZdZUdZdddZded<dZdZd ed <dfd ZdZ dZ dZ dZ e fdZejfdZdZxZS)QuarterLengthAxisz7 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#rNrcht||d|_d|_dS)NTF)r{r,rrr|s r+r,zQuarterLengthAxis.__init__js3 *** %r-c@||jjSr9) dataFromQLrrrNs r+rOz#QuarterLengthAxis.extractOneElementosqz7888r-cz|jr||}n|dkrt|}n|j}|Sr)rremapQuarterLengthfloatr)r*rrs r+rzQuarterLengthAxis.dataFromQLrsE   !''++AA !VVb AA Ar-c|j}|sgS|jjr|}n|}||jj}t j|d}g}t|D]l}| |}|j rtj |j }ntt|d}|||fm|S)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') rr)r r)recurseiterr classFilterListelementAnalysisattributeCountsortedrrrDurationfullNamer&roundr\)r*rsSrcmappingrerrr7s r+rezQuarterLengthAxis.ticks{sT K I [  99;;DD6688D&&t{'BCC!0GG// % %B##A$ * )"--6E"aLL)) LL!U $ $ $ $ r-cF|jdurdS|jdurdSd|jddS)a 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$))rr6s r+ labelLogTagzQuarterLengthAxis.labelLogTagsA&  u $ $2   % %<3T-3333 3r-cTtj|zSr9)r{r7r0)r*r/s r+r7zQuarterLengthAxis.labels ww}t//1111r-c.|t_dSr9)r{r7)r*r<r/s r+r7zQuarterLengthAxis.labels r-c|dkr|j} tjt|S#t$rt d|wxYw)z 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: )rrYlog2r! ValueErrorr)r*rs r+r z$QuarterLengthAxis.remapQuarterLengthsg 66 A E9U1XX&& & E E E !C!C!CDD D Es 0A rj)r0rkrlrmrrnr5rr,rOrrer0ror7rpr rrs@r+rrRs4  ! !I    $L#%J%%%%&&&&&& 999>>>@44442222X2 \\ E E E E E E Er-rcReZdZUdZddiZded<dZded<d d effd Zd Z xZ S) OffsetEndAxiszI 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#rNrct||||_|tkr|j|_dSdSr9)r{r,r8USE_GRACE_NOTE_SPACINGr)r*r)rr8r/s r+r,zOffsetEndAxis.__init__sJ ***& 0 0 0#/D    1 0r-c,t||j}t|jj}||jkr|j}n>||jdzkr0t |dr|j|jjdvrn ||jz}||fS)Nrtie)startcontinue) r!rr rrr8rr?r)r*rFrHoffuseQLs r+rOzOffsetEndAxis.extractOneElementsA**4;7788aj.// 4# # #$EE T%) ) )q%   *QU%615:I^;^;^))U|r-) r0rkrlrmrrnrr=r,rOrrs@r+r7r7s !I #IJHHHH"S>T000000       r-r7c>eZdZUdZdZdZded<d fd ZdZxZ S) DynamicsAxisz1 Axis subclass for dealing with Dynamics Dynamic)dynamicr volumer#rNc|*d|_ttjdz |_dSt |t|j|_t|j|_dS)Nrr)rrr shortNamesrr{rUrX)r*rTr/s r+rUz"DynamicsAxis.setBoundariesFromDatash >DM 344q8DMMM GG ) )& 1 1 1 ..DM ..DMMMr-cg}|j|t|j|jdzD]-}||dt j|df.|S)ak 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$')] Nr$)rrUr[rr\r rJ)r*rers r+rezDynamicsAxis.tickssx$ =  & & ( ( (t}dma&788 = =A LL!:!4Q!7:::; < < < < r-r9) r0rkrlrmr5rrnrUrerrs@r+rErE spL"CJCCCC//////r-rEcPeZdZUdZddiZded<dZdZded <dfd Zd Z xZ S) CountingAxisa 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#rNrcZt||d|_dSrj)r{r,rOr|s r+r,zCountingAxis.__init__Rs( ***r-c&j}|gSddlm}j}t j|s|f}t fd|D}jj}||fd|j D}i}|j D]P}|} |d} t| ts+| |vr||  | K| || <Qtj|} g} | D]} dgt|dzz}t|dkr|D] }| |||<n | ||d<| | ||<|| i} | t || fzt%| |_ |j S)zS Replace client.data with a list that only includes each key once. Nr) itemgetterc32K|]}j|VdSr9)r).0rr*s r+ z/CountingAxis.postProcessData..cs+QQ8D,X6QQQQQQr-c&g|] }|SrMrM)rY innerTupleselectors r+ z0CountingAxis.postProcessData..fs#KKK,,KKKr-rr)r)operatorrWrOr isIterabletuplerrdatar%dictupdate collectionsCounterrgetr\r()r*r)rWrO axesIndices thisIndex relevantDatatupleFormatDict dataPoint dataIndexrHcounter newClientData counterKey innerListdependentIndexr]s` @r+rizCountingAxis.postProcessDataVs >I''''''N  ++ %" IQQQQyQQQQQ $T]3 :{+KKKKv{KKK  8 8I ++I"2Jj$// O++ *11*====-7 **%l33 ! C CJ#k"2"2Q"67I;!##&1KKN0:>0JIn--K-7 +a.)#*:#6Ii (,,Z<.countingAxisFormatters"w!-&+ 7#7* *r-r) Histogram) converterz$tinynotation: 4/4 C4 D E F C D# E F#rrrrxrw) music21.graph.plotr|music21r}parse doneActionraxisXrOrun assertEqualrb)r*r{r|r}rhists r+testCountingAxisFormatzTest.testCountingAxisFormats + + + 100000%%%%%% OOB C Cy||$__ '< $   a*q!gu-=&>a*q!gu-=&>@ A A A A Ar-N)r0rkrlrrMr-r+rtrts(AAAAAr-rt__main__)+rm __future__rrerYrtypingtunittestmusic21.graph.utilitiesrrrrrrr r r r music21.analysisr r&r TYPE_CHECKINGrr=ProtoM21Objectrrrrrrrrrr7rErNTestCasertr0mainTestrMr-r+rs#""""" LLLLLLLL888888******?u u u u u 7 !u u u tRRRRRRRRjE;E;E;E;E;YE;E;E;P==========Y======@!!!!!>!!!@!!!!!4!!!&X X X X X X X X v VEVEVEVEVE VEVEVErJD(((((4(((ZIIIII4IIIZAAAAA8 AAA, zNNNGTr-