rh,SrSSKJr SSKrSSKrSSKrSSKJr SSKJ r SSKJ r SSK J r J r JrJr SSKJr \ R""S 5r"S S \R&5r"S S \5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"S S!\R>5r "S"S#\R>5r!\"S$:XaSSKr\RF"\ 5 gg)%a Object definitions for graphing and plotting :class:`~music21.stream.Stream` objects. The :class:`~music21.graph.primitives.Graph` object subclasses primitive, abstract fundamental graphing archetypes using the matplotlib library. From the highest level to the lowest level of usage, ways of graphing are as follows: 1. streamObj.plot('graphName') 2. graph.plot.Class(streamObj).run() 3. plotter = graph.primitives.Class(); plotter.data = ...; plotter.process() 4. Use matplotlib directly to create your graph. ) annotationsN)common) SubConverter) environment)getExtendedModulesGraphExceptiongetColoraccidentalLabelToUnicode)prebasezgraph.primitivesc \rSrSr%SrSrSrS\S'SrS\S 'S r S\S 'S r S r Sr Sr \S5r\R S5rSrSrS"SjrS#SjrS$Sjr\S$Sj5rSrSrSrSrSrS%SjrSrS%S jrS!r g)&Graph-a A music21.graph.primitives.Graph is an object that represents a visual graph or plot, automating the creation and configuration of this graph in matplotlib. It is a low-level object that most music21 users do not need to call directly; yet, as most graphs will take keyword arguments that specify the look of graphs, they are important to know about. The keyword arguments can be provided for configuration are: * doneAction (see below) * alpha (which describes how transparent elements of the graph are) * dpi * colorBackgroundData * colorBackgroundFigure * colorGrid, * title (a string) * figureSize (a tuple of two ints) * colors (a list of colors to cycle through) * tickFontSize * tickColors (a dict of 'x': '#color', 'y': '#color') * titleFontSize * labelFontSize * fontFamily * hideXGrid * hideYGrid * xTickLabelRotation * marker * markersize Graph objects do not manipulate Streams or other music21 data; they only manipulate raw data formatted for each Graph subclass, hence it is unlikely that users will call this class directly. The `doneAction` argument determines what happens after the graph has been processed. Currently, there are three options, 'write' creates a file on disk (this is the default), while 'show' opens an interactive GUI browser. The third option, None, does the processing but does not write any output. figureSize: A two-element iterable. Scales all graph components but because of matplotlib limitations (esp. on 3d graphs) no all labels scale properly. defaults to .figureSizeDefault >>> a = graph.primitives.Graph(title='a graph of some data to be given soon', tickFontSize=9) >>> a.data = [[0, 2], [1, 3]] >>> a.graphType 'genericGraph' genericGraphxyztuple[str, ...]axisKeys)rztuple[int | float, ...]figureSizeDefault)alphacolorBackgroundDatacolorBackgroundFigure colorGridcolors doneActiondpi figureSize fontFamily hideXGrid hideYGrid labelFontSizemarker markersize tickColors tickFontSizetitle titleFontSizexTickLabelHorizontalAlignmentxTickLabelRotationxTickLabelVerticalAlignmentkeywordConfigurablesc [5nURUlSUlSUlSUl0UlUR H$n0UR U'SUR US'M& SUl0UlUR HnSURU'M SUl SUl SUl SUl SUl SUlURUlSUlS Ul/S QUlS UlS S S .UlSUlSUlSUlSUlSUlSUlSUlSUlSUlSUlSUl URBHnXQ;dM [EXX5 M g)NrangeTF皙?z#ffffffz#ddddddz Music21 Graphor)z#605c7fz#5c7f60z#988969z#628297z#ad776dz#80a364#000000r serifrcenterwrite)#rpltdatafiguresubplotaxisrgridaxisRangeHasBeenSetrrrrrr&rrr"r#rr%r$r'r!rrr r)r(r*hideLeftBottomSpines _doneAction_dataColorIndexr+setattr)selfkeywordsextmaxaxisKeykws R/home/james-whalen/.local/lib/python3.13/site-packages/music21/graph/primitives.py__init__Graph.__init__sm!#88    --BDIIbM%)DIIbM' "  #% }}G05D $ $W -% #, %.""$ 00   ) :!"#-5*+3($)!" ++B~(,/,c[US5(a4URb&URRUR5 ggg)zM Matplotlib Figure objects need to be explicitly closed when no longer used. r9N)hasattrr9r7closerBs rH__del__ Graph.__del__s6 4 " "t{{'> HHNN4;; '(? "rKc@URR5nUS U$)zS The wrapper to matplotlib.pyplot stored as self.plt cannot be pickled/deepcopied. r7)__dict__copy)rBstates rH __getstate__Graph.__getstate__s" ""$ %L rKcpURRU5 [5nURUlgN)rSupdaterr7)rBrUrDs rH __setstate__Graph.__setstate__s' U#!#88rKcUR$)zc returns or sets what should happen when the graph is created (see docs above) default is 'write'. )r?rOs rHrGraph.doneActions rKc8US;aXlg[SU35e)N)showr6Nzno such done action: )r?r)rBactions rHrr^s$ , ,%  #8!AB BrKc[URUR[UR5-5nU=RS- slU$)a Utility function that cycles through the colors of self.colors. >>> g = graph.primitives.Graph() >>> g.colors = ['#605c7f', '#5c7f60', '#715c7f'] >>> g.nextColor() '#605c7f' >>> g.nextColor() '#5c7f60' >>> g.nextColor() '#715c7f' >>> g.nextColor() '#605c7f' )r rr@len)rBcs rH nextColorGraph.nextColorsA& T[[!5!5DKK8H!HI J !rKcUcgXR;a[SUS35e/n/nUH'upVURU5 URU5 M) X44URUS'g)a Set the tick-labels for a given graph or plot's axisKey (generally 'x', and 'y') with a set of pairs Pairs are iterables of positions and labels. N.B. -- both 'x' and 'y' ticks have to be set in order to get matplotlib to display either (and presumably 'z' for 3D graphs). >>> g = graph.primitives.GraphHorizontalBar() >>> g.axis['x']['ticks'] Traceback (most recent call last): KeyError: 'ticks' >>> g.axis['x'] {'range': None} >>> g.setTicks('x', [(0, 'a'), (1, 'b')]) >>> g.axis['x']['ticks'] ([0, 1], ['a', 'b']) >>> g.setTicks('m', [('a', 'b')]) Traceback (most recent call last): music21.graph.utilities.GraphException: Cannot find key 'm' in self.axis >>> g.setTicks('x', []) >>> g.axis['x']['ticks'] ([], []) NzCannot find key 'z' in self.axisticks)r;rappend)rBrFpairs positionslabelsvaluelabels rHsetTicksGraph.setTicksss: =  )) # #4WI^!LM M !LE   U # MM% "'0&7 '7#rKc[U5n[XC- 5n/nUS::aSn[SUS-U5HnURXw/5 M UR 5 UR X&5$)a~ Set the ticks for an axis (usually 'y') given unsorted data. Data steps shows how many ticks to make from the data. >>> g = graph.primitives.GraphHorizontalBar() >>> g.setIntegerTicksFromData([10, 5, 3, 8, 20, 11], dataSteps=4) >>> g.axis['y']['ticks'] ([0, 5, 10, 15, 20], ['0', '5', '10', '15', '20']) TODO: should this not also use min? instead of always starting from zero? rcr)maxroundr-rjsortrp)rB unsortedDatarF dataStepsmaxDatatickSteptickListrs rHsetIntegerTicksFromDataGraph.setIntegerTicksFromData!skl#,- q=Hq'A+x0A OOQ#K (1 }}W//rKcXR;a[SU35eUS:waUSUS- nXC-nOSnUSU- USU-4URUS'SURU'g)a  Set the range for the axis for a given axis key (generally, 'x', or 'y') ValueRange is a two-element tuple of the lowest number and the highest. By default, there is a padding of 10% of the range in either direction. Set paddingFraction = 0 to eliminate this shift No such axis exists: rrcr-TN)rrr;r=)rBrF valueRangepaddingFraction totalRangeshifts rH setAxisRangeGraph.setAxisRange9s -- ' #8 !BC C a #AA6J0EE'1!}u'<'1!}u'<'> '7#-1  )rKcXR;a[SU35eU(a+SURU;aURUS(agX RUS'g)Nrro)rrr;)rBrFro conditionals rH setAxisLabelGraph.setAxisLabelSsW -- ' #8 !BC C 7dii&88TYYw=OPW=X &+ '7#rKcURR5HLup#US;aU(aURS5 M%M'US;aURS5 M@[SU35e [ UR 5UR 5-5H;upEU(aURS5 MUS-S:XdM*URS5 M= g) z Remove the right and top spines from the diagram. If leftBottom is True, remove the left and bottom spines as well. Spines are removed by setting their colors to 'none' and every other tick line set_visible to False. leftbottomnone)righttopzunknown spine location: FrsrcN)spinesitems set_color ValueError enumerateget_xticklinesget_yticklines set_visible)r: leftBottomlocspineilines rHhideAxisSpinesGraph.hideAxisSpines[s"....0JC((OOF+((' #;C5!ABB1!!7!7!9GMMD  ) )' 8" ::   djj43E3Edoo  ^ !MML??2   \//,:W  X* t||$   !34 !!$//!"45rKc\UR(aBURb5URS5 URSS[UR5S9 UR(aUR RS5 UR (aURRS5 gg)zA Apply the Grid to the subplot such that it goes below the data. NTmajor)whichcolorF)r<r set_axisbelowr r yaxisrxaxisrBr:s rHrGraph.applyGridst 993  ! !$ ' LLWHT^^4LL M >> MM  u % >> MM  u % rKc URUnUS;agSU;a?USb9SU-S-n[UR5S:XaUS- n[X5nU"US6 SU;a7USb1[USU-S-5nU"USURUR S 9 S U;a#US b[USU-S -5nU"US 5 [US U-S -5n[USU-S -5n[USU-S -5n S U;a0U b-U"5n U"U 5 U "U URUR S 9 U$US upUbU"U 5 US:XaIURU URUR URURURSS9 U$US:Xa)URU URUR SSS9 U$[U 5(aU "U URUR S 9 U$![ a SnSnSn GNf=f)a< Given a matplotlib.Axes object (a subplot) and a string of 'x', 'y', or 'z', set the Axes object's xlim (or ylim or zlim or xlim3d, etc.) from self.axis[axis]['range'], Set the label from self.axis[axis]['label'], the scale, the ticks, and the ticklabels. Returns the matplotlib Axis object that has been modified rrzNr-set_lim3drorscaleget_ri ticklabelsrg{Gz)rrhorizontalalignmentverticalalignmentrotationrrrr5rrrr)r;rdrgetattrr!rAttributeErrorr%set_xticklabelsr(r*r)set_yticklabelscallable) rBr:r;thisAxis rangeFuncName thisRangeFuncsetLabelFunctiongetTickFunctionsetTickFunctionsetTickLabelFunctionrivaluesrms rHrGraph.applyFormattingToOneAxissl99T?  &  h 8G#4#@"TME1M4==!Q&% #G;M 8G, - h 8G#4#@&w 0GH  Xg.&*&8&8 R h 8G#4#@&w 0GH  Xg. / (%gv}w/FGO%gv}w/FGO#*7FTML4P#Q  ( "';'G#%E E " *.*;*;(, 981&g.NF*'s{''151B1B/3<@<^<^:>:Z:Z151H1H*/ (1(''151B1B/3rcallDoneActionrBrDr7s rHprocess Graph.processs"#hh jj4+E+EjF {{..q!Q7   4<<( DLLT5N5NO T\\* rKcg)z9 Calls the subclass specific information to get the data Nrs rHrGraph.renderSubplots rKNcURS:XaUR5 gURS:XaURU5 gURcgg)z9 Implement the desired doneAction, after data processing r`r6N)rr`r6)rBfps rHrGraph.callDoneActionsB ??f $ IIK __ ' JJrN __ $ %rKc8URR5 g)z Calls the show() method of the matplotlib plot. For most matplotlib back ends, this will open a GUI window with the desired graph. N)r9r`rOs rHr` Graph.show(s rKcUc[RS5nURnUcSnURR UUS9 [ R "5SLa[5RUSS9 gUR$)zQ Writes the graph to a file. If no file path is given, a temporary file is used. N.png,)rTpng)fmt) r getTempFilerr9savefigrrunningInNotebookrlaunch)rBrrs rHr6 Graph.write0s| :))&1Bhh ;C B!$  %  # # %T 1 N ! !"% ! 0;; rK)r@r?rr;r=rrrrr8rr9rrr<r>rr r!r"r#r7r:r$r%r&r'r(r)r*)r)皙?)FrY)!__name__ __module__ __qualname____firstlineno____doc__ graphTyper__annotations__rr+rIrPrVr[propertyrsetterrfrpr|rr staticmethodrrrrrrrr`r6__static_attributes__rrKrHr r -s4jI *Ho*/5,5-/0:0x(   CC .*8X0014,((6#6R & IV6  rKr cj^\rSrSr%SrSSS.rS\S'Sr\RS-r U4S jr S r S r U=r $) GraphNetworkxGraphiFzf Grid a networkx graph -- which is a graph of nodes and edges. Requires the optional networkx module. z'An instance of a networkx graph object.:bool to hide the left and bottom axis spines; default True) networkxGraphr>dict[str, str] _DOC_ATTRnetworkxc >SUlSUl[TU] "S0UD6 [ 5nSU;aSUlgUR b"UR R5nX0lgg![a gf=f)NTr&z Network Plotr) rr>superrIrr&rr NameError)rBrCrDg __class__s rHrIGraphNetworkxGraph.__init__Zs|!$(! $8$!# ( "'DJ ]] & MM'') &'"'  s A(( A54A5c [5nURn0n0nURRSS9H!upgUSXF'USSS-USS4XV'M# UR URUSUSS S 9 URR SS9HHupn [ RS XU 4/5 X4/n URURXKS U S SU SUS9 MJ URURUURURSUS9 URSS5 URSS5 URS/5 URS/5 SUlg)NT)r8posrg?rcrz#605C7F?) node_sizerE node_colorrrrsstylez#666666weight)edgelistwidthr edge_colorrrEr1) font_size font_family font_colorrErrF)rrrnodesdraw_networkx_nodesedgesrrdraw_networkx_edgesdraw_networkx_labelsr!rrrpr<) rBr:rDrposNodes posNodeLabelsnIdnDatauvdrs rHr GraphNetworkxGraph.renderSubplotqs!#== ,,222=JC!%LHM"',q/E"95<?!KM > $$T%7%7/2w9\_ % a++11t1rr&rrrrrrrrr r+rIrr __classcell__r s@rHrrFsKG \!I~ I 559.**rKrcl^\rSrSr%SrSS0rS\S'SrSr\ RS -r U4S jr S r S r U=r$) GraphColorGridia} Grid of discrete colored "blocks" to visualize results of a windowed analysis routine. Data is provided as a list of lists of colors, where colors are specified as a hex triplet, or the common HTML color codes, and based on analysis-specific mapping of colors to results. >>> #_DOCS_SHOW g = graph.primitives.GraphColorGrid() >>> g = graph.primitives.GraphColorGrid(doneAction=None) #_DOCS_HIDE >>> data = [['#55FF00', '#9b0000', '#009b00'], ... ['#FFD600', '#FF5600'], ... ['#201a2b', '#8f73bf', '#a080d5', '#403355', '#999999']] >>> g.data = data >>> g.process() .. image:: images/GraphColorGrid.* :width: 600 r>rrrr) rr>c 4>SUl[TU]"S0UD6 g)NTr)r>rrIrBrCr s rHrIGraphColorGrid.__init__s$(! $8$rKc NURRSS9 [UR5n[ U5GHnURUn/n/n/n[ U5H;upUR US-5 UR U 5 UR S5 M= URRUSX#- 5n U RUUSUSSSS9 U RR5H8upU RS5 U RS5 U RS5 M: [ U R5U R5-5HupU R!S5 M U R#/5 U R%/5 U R'S /[U R)55-5 U R+S /[U R-55-5 U R/S [URU5/5 U R15R!S5 U R35R!S5 GM US :aURRS S 9 OURRS S 9 SnUR5SUS 5 SUlg)N333333?rrrc333333?r1F)r linewidth edgecolor antialiasedrrr2)hspacerrrcr)r9subplots_adjustrdr8r-rrjrbarrr set_linewidthr set_alpharrr set_xticks set_yticksrget_yticklabelsrget_xticklabelsset_xlim get_xaxis get_yaxisrr<)rBr:rowCountr thisRowDatarlheights subColorsj thisColorrE unused_locrraxisRangeNumberss rHrGraphColorGrid.renderSubplotsF ###.tyy>xA))A,KIGI )+ 6   U+  +q! !7((1hlCB FF9" &$  &&(YY__%6! ##C( *" &7%R%6%6%82;L;L;N%NO  'P MM"  MM"    tc"*<*<*>&?? @   tc"*<*<*>&?? @ KKC ! -. / LLN & &u - LLN & &u -]!d b= KK ' 'q ' 1 KK ' 's ' 3! #/3 rK)r<r>)rrrrrrrrrr r+rIrrr(r)s@rHr+r+sN&  \!I~I 558QQ%HHrKr+cr^\rSrSr%SrSS0rS\S'SrSr\ RS -r U4S jr S r S r S rU=r$)GraphColorGridLegendia Grid of discrete colored "blocks" where each block can be labeled Data is provided as a list of lists of colors, where colors are specified as a hex triplet, or the common HTML color codes, and based on analysis-specific mapping of colors to results. >>> #_DOCS_SHOW g = graph.primitives.GraphColorGridLegend() >>> g = graph.primitives.GraphColorGridLegend(doneAction=None) #_DOCS_HIDE >>> data = [] >>> data.append(('Major', [('C#', '#00AA55'), ('D-', '#5600FF'), ('G#', '#2B00FF')])) >>> data.append(('Minor', [('C#', '#004600'), ('D-', '#00009b'), ('G#', '#00009B')])) >>> g.data = data >>> g.process() .. image:: images/GraphColorGridLegend.* :width: 600 r>rrrcolorGridLegend)?r-c P>SUl[TU]"S0UD6 SU;aSUlgg)NTr&Legendr)r>rrIr&r/s rHrIGraphColorGridLegend.__init__$s/$(! $8$ ( "!DJ #rKc[UR5H,up#USnUSnURURX$U5 M. UR SSS5 UR 5UR 5-n[U5HupxURS5 M URRSSSS 9 URS S 5 URSS 5 URS /5 URS/5 g) Nrrcrr9FrRg?r.)r8rrrr) rr8makeOneRowOfGraphr9rrrrr:rrp) rBr:rrowLabelAndDatarowLabelrowData allTickLinesrIrs rHr"GraphColorGridLegend.renderSubplot,s"+DII"6 A&q)H%a(G  " "4;;W E#7 #vq)--/'2H2H2JJ  .GA   U #/ ##3D#E #r" #r" c2 c2rKc /n/n/n[U5H>upURSU-5 URU S5 URS5 M@ [UR5SUS-4n UR"U 6n Sn U R XVXSSS9 U R R5H%n U RS5 U RS5 M' U R5U R5-n[U5HupURS5 M U RS/5 U RU/URUR SS S 9 U R#[%[U55Vs/sHnUS-PM sn5 UVVs/sHunn['U5PM nnnU R)UURUR S S S S 9 U R+S[U5S-/5 U $s snfs snnf) a Makes a subplot for one row of data (such as for the Major label) and returns a matplotlib.axes.AxesSubplot instance representing the subplot. Here we create an axis with a part of Scriabin's mapping of colors to keys in Prometheus: The Poem of Fire. >>> import matplotlib.pyplot >>> colorLegend = graph.primitives.GraphColorGridLegend() >>> rowData = [('C', '#ff0000'), ('G', '#ff8800'), ('D', '#ffff00'), ... ('A', '#00ff00'), ('E', '#4444ff')] >>> colorLegend.data = [['Scriabin Mapping', rowData]] >>> fig = matplotlib.pyplot.figure() >>> subplot = colorLegend.makeOneRowOfGraph(fig, 0, 'Scriabin Mapping', rowData) >>> subplot g?rcr4r1)rr5r6Frrr5rgٿ)rrrrr)rrjrdr8rr;rrr<rrrrr?rr%rr>r-r rrB)rBr9rowIndexrYrZrlrGrHrIoneColorMapping posTriplerEr spineArtistr[rrunused_ysubstitutedAccidentalLabelss rHrW&GraphColorGridLegend.makeOneRowOfGraphCs.  "+G"4 A   S1W %   _Q/ 0 NN1 #5 ^Q1 5    + y5ST]^99++-K  % %c *  ! !) ,. ((*R->->-@@  .GA   U #/ se H:$($5$5"&///6-5  7 eCL&9:&9q1u&9:;@G'H?F 8(@'B?F $'H  '&&?? (&   S#g,,-. ;'Hs 6G5G:)r>r&)rrrrrrrrrr r+rIrrWrr(r)s@rHrOrOsS(  \!I~"I  558QQ".MMrKrOc^\rSrSr%SrSSS.rS\S'SrS r\ RS-r U4S jr \ S 5r SS jrS rU=r$)GraphHorizontalBariaj Numerous horizontal bars in discrete channels, where bars can be incomplete and/or overlap. Data provided is a list of pairs, where the first value becomes the key, the second value is a list of x-start, x-length values. Note how the second element in each data point is the length, so subtracting death year from birth year gives the appropriate length. Example: Plot the life-span of four composers whose lives were entertwined: Chopin, Robert and Clara Schumann, and Brahms. >>> a = graph.primitives.GraphHorizontalBar() >>> a.doneAction = None #_DOCS_HIDE >>> data = [('Chopin', [(1810, 1849-1810)]), ... ('Schumanns', [(1810, 1856-1810), (1819, 1896-1819)]), ... ('Brahms', [(1833, 1897-1833)])] >>> a.data = data >>> a.process() .. image:: images/GraphHorizontalBar.* :width: 600 Data is a list of tuples in the form, where each entry represents a space on the Y axis: * Label * List of tuples of numeric data where each tuple has two or three elements: * Start x-position * Length of bar * Optional: dictionary of format information about this point. * Optional: dictionary of format informmation for all points at this level. (this will be overridden by any information for the particular point) To make an equally spaced plot, like in a Pitch Space plot, leave empty data in the form: `('', [], {})` 2Amount of vertical space each bar takes; default 8zj Vertical space above and below the bars, default 2 (= total4 space between bars) barSpacemarginrr horizontalBarr3c ^>SUlSUl[TU] "S0UD6 SU;aSUlgg)Nrrsr333333?rrirjrrIrr/s rHrIGraphHorizontalBar.__init__s5   $8$ ( "DJ #rKc:URURS-- $NrsrhrOs rH barHeightGraphHorizontalBar.barHeight}} a00rKcURRSS9 Sn[5n/n/n/nSnURGH}n[ U5S:XaUup0n OUupn UR U 5 U R SUR55n U (a[ U S5S:Hn U (aU nU nO:U Vs/sHnUSR SU 5PM nnU Vs/sHnUSSPM nnX R-UR4nURUUUURS9 U H^n[ U5S:a USSunnO[S[ U5SU35eUU-nUU4HnUU;dM URU5 M M` UR X RS --U /5 X R- nUS - nGM S nS nU(a[U5n[!U5nUU- nUR#S S[ U5UR-45 UR#S UU45 UR%S U5 SUR&S ;aUR&S S(d[)U[+US- 5-5nUS:XaS n[-[)[.R0"U55[+[.R2"U55U5HnUR UU/5 M UR%S U5 gggs snfs snf)Nr2r3rrsr) facecolorsrz"Points must be length 2 or 3, not z: rrcrrrir3)r9r:setr8rdrjgetrfrjrt broken_barhrraddriminrtrrpr;intrur-mathfloorceil)rBr:yPosxPointsyTicksxTickskeysrinfokeypointsfullRowFormatDict faceColoruniformFormatPerRow rowFaceColorspositionPointspyRangexStartxLenxEndrxMinxMaxxRange rangeSteps rHr GraphHorizontalBar.renderSubplots ###."%% IID4yA~" $&!15.. KK *--gt~~7GHI'*6!9~':#&$-M%+NKQ$R6aQqTXXgy%A6M$R5;% #d|, c6" diin $TYYs^G-DD5"#556IA~ 3tzz$/0 41$& qQCk*& MM#v &.E $O%S%SUlSUl[TU] "S0UD6 SU;aSUlgg)Nr?rrcrrpr/s rHrI#GraphHorizontalBarWeighted.__init__:s7   $8$ ( "DJ #rKc:URURS-- $rsrhrOs rHrt$GraphHorizontalBarWeighted.barHeightLrvrKc vURRSS9 Sn/n/n/nSn[UR5UlURR 5 URGHupxUR U5 /n /n /n /n [ U5GHSupmSnSnSnUR5nURnSn[U 5S:XaU upnOD[U 5S:XaU upnnO.[U 5S:XaU upnnnO[U 5S:XaU upnnnn[U5nU R X45 U R U5 U R U5 X;aUR U5 X-U;aUR X-5 URU-nURU- S -nURSU- -S -nX R-U-UU--nU R UU45 GMV [ U 5H"unnURU/XXXXS 9 M$ UR X RS --U/5 X R- nUS- nGM [U5n[!U5nUU- nUR#S S[U5UR-4S S 9 UR#SUU4SS 9 UR%S U5 g)Nr2r3rrcrrmrQrr)rxrr6r皙?)rrg{Gz?)r9r:listr8reverserjrrfrrdr rtrjr|rir~rtrrp)rBr:rrrrrrrxRangesyRangesalphasrr8rspan heightScalarrryShifthyAdjust yShiftUnit adjustedYrrrs rHr(GraphHorizontalBarWeighted.renderSubplotPs ###. O  99KC KK GGFF$V, ( t9>,0)A\Y!^370A\5Y!^:>7A\5%Y!^BF?A\5% y) e$ e$#NN1%HW,NN18, NN\1>>A-4!^^q>> g = graph.primitives.GraphScatterWeighted() >>> g.doneAction = None #_DOCS_HIDE >>> data = [(23, 15, 234), (10, 23, 12), (4, 23, 5), (15, 18, 120)] >>> g.data = data >>> g.process() .. image:: images/GraphScatterWeighted.* :width: 600 z1the maximum diameter of any ellipse, default 1.25z1the minimum diameter of any ellipse, default 0.25 maxDiameter minDiameterrrscatterWeighted)rQrQc ^>SUlSUl[TU] "S0UD6 SU;aSUlgg)Ng?rrror)rrrrIrr/s rHrIGraphScatterWeighted.__init__s7 $8$ ( "DJ #rKc4URUR- $rYrrOs rH rangeDiameter"GraphScatterWeighted.rangeDiameters$"2"222rKc [5nURnURRSSS9 URVs/sHoDSPM nnURVs/sHoDSPM nnURVs/sHoDSPM nn/nURH+n[ U5S:aUSn O0n UR U 5 M- [U5n [U5n [X- 5n [U5n [U5n[X- 5n[U5n[U5n[UU- 5nSnSnX:aX- nO X:aX- n/nUH^nUS:XaUR SS/5 MUS:wa UU- U- nOSnURURU--nUR UU/5 M` [[ UR55HnUUnUUnUUunnUUn UU-nUU-nUR"SUU4UUS.U D6nURU5 URUR 5 UR#UR$5 UR'UR)55 UUS:dMUUS-S U---n US -n!UR+U U![-UU5S S S S S9 M UR/SX45 UR/SX45 gs snfs snfs snf)Nr2rrrcrsrr)xyrheightrrrbaseliner)sizevahamultialignmentrrr)rpatchesr9r:r8rdrjrtr~floatrrr-Ellipse add_artist set_clip_boxbboxr=rrrftextstrr)"rBr:rDrr%xListyListzListformatDictList formatDictrrryMaxyMinrzMaxzMinzRangexDistortyDistortzNormrscalarscaledrrrunused_zScalarrre adjustedXrs" rHr"GraphScatterWeighted.renderSubplots!#,, ##d#; $yy)y!1y)#yy)y!1y)#yy)y!1y)A1vzqT   ! !* - 5z5zt{#5z5zt{#5z5ztd{#  ?H _HAAv aV$Q;$h&0F F))T-?-?&-HI ff-.s499~&AaAaA %a A~'*JLE\FTAq6vTTA   q ! NN7<< ( KK # OODNN, - Qx!| %#+$/!BC H  Y& q]"# * &,2 49'H #|, #|,k*))sKK;K#)rrr)rrrrrrrrrr r+rIrrrrr(r)s@rHrrsc KJ!I~ "I 558VV33]-]-rKrc"\rSrSrSrSrSrSrg) GraphScatteri6a( Graph two parameters in a scatter plot. Data representation is a list of points of values. >>> g = graph.primitives.GraphScatter() >>> g.doneAction = None #_DOCS_HIDE >>> data = [(x, x * x) for x in range(50)] >>> g.data = data >>> g.process() .. image:: images/GraphScatter.* :width: 600 scatterc <URRSS9 /n/nSnURHIn[U5S:a [ S5eUSnUSnUR U5 UR U5 MK UR 5 UR 5 URHnUSnUSnURnUR5n URn URn [U5S:a1USn SU ;aU Sn S U ;aU S nS U ;aU S n S U ;aU S n URXgXXS 9 US- nM URS (dURS USUS45 URS(dURSUSUS45 gg)Nr2r3rrsz1Need at least two points for a graph data object!rcrrr"rr#)r"rrr#rr)r9r:r8rdrrjrvr"rfrr#plotr=r) rBr:xValuesyValuesrrowrrr"rrr# displayDatas rHrGraphScatter.renderSubplotFs ###. 99C3x!|$%XYYAAAA NN1  NN1     99CAAAA[[FNN$EJJEJ3x1}!!f k)'0E{*(2Fk)'0E;.!,\!:J LLfL ^ FA'*'',   cGAJ #< ='',   cGAJ #< =-rKrN)rrrrrrrrrrKrHrr6s I)>rKrcv^\rSrSr%SrSS0rS\S'Sr\RS-r S S S .S U4S jjjr S r Sr U=r $)GraphHistogramira Graph the count of a single element. Data set is simply a list of x and y pairs, where there is only one of each x value, and y value is the count or magnitude of that value >>> import random >>> g = graph.primitives.GraphHistogram() >>> g.doneAction = None #_DOCS_HIDE >>> g.graphType 'histogram' >>> data = [(x, random.choice(range(30))) for x in range(50)] >>> g.data = data >>> g.process() .. image:: images/GraphHistogram.* :width: 600 binWidthz Size of each bin; if the bins are equally spaced at intervals of 1, then 0.8 is a good default to allow a little space. 1.0 will give no space. rr histogram)r皙?)rrc 6>Xl[TU]"SSU0UD6 g)Nrr)rrrI)rBrrrCr s rHrIGraphHistogram.__init__s  1u11rKc\URRSS9 /n/nURn[URS5nUR nUR H>n[U5S:aUupn OUupURU5 URU 5 M@ URX#XFUS9 g)Nr2r3rrsrrr) r9r:rr rrr8rdrjr;) rBr:rrrrrpointabunused_formatDicts rHrGraphHistogram.renderSubplots ###.  ==Q( YYE5zA~*/'' HHQK HHQK   AU CrK)rrrrr'r)s@rHrrrsS, !I~I 55 E,/22DDrKrcZ^\rSrSrSrSr\RS-rU4SjrSr Sr Sr U=r $) GraphGroupedVerticalBariaw Graph the count of on or more elements in vertical bars Data set is simply a list of x and y pairs, where there is only one of each x value, and y value is a list of values >>> from collections import OrderedDict >>> g = graph.primitives.GraphGroupedVerticalBar() >>> g.doneAction = None #_DOCS_HIDE >>> lengths = OrderedDict( [('a', 3), ('b', 2), ('c', 1)] ) >>> data = [('bar' + str(x), lengths) for x in range(3)] >>> data [('bar0', OrderedDict([('a', 3), ('b', 2), ('c', 1)])), ('bar1', OrderedDict([('a', 3), ('b', 2), ('c', 1)])), ('bar2', OrderedDict([('a', 3), ('b', 2), ('c', 1)]))] >>> g.data = data >>> g.process() groupedVerticalBar)r roundDigitsgroupLabelHeightc P>SUlSUlSUl[TU]"S0UD6 g)Nrcryr)rrrrrIr/s rHrI GraphGroupedVerticalBar.__init__s*  # $8$rKc UH|nUR5UR5S- -nUR5nURUU[ [ XPR 55SSURURS9 M~ g)Nrsr5r)rrrr) get_x get_width get_heightrrrurr%r)rBr:rectsrrrs rH labelBars!GraphGroupedVerticalBar.labelBarsssD (81(<=I__&F LLU6+;+;<=$$"&"3"3 $  1rKc [5nURnSn/nURH)upg[U5n[ UR 55n O UR nX- n /n /n [UR5HTun upgU RU 5 U R[ UR 55V s/sHoU PM sn 5 MV /n[U5Hn /n[U 5HunnURU UU 5 M /nU HnURUX--5 M URUUU SUR5S9nURU5 M /nUH)nURUU5 URUS5 M+ URRURUR S9nUR#UUUS9 gs sn f)Nrcrrr)rr)prop)r matplotlibr8rdsortedrrrrjr-r;rfr font_managerFontPropertiesr%rlegend)rBr:rDr  barsPerGroup subLabelsunused_arr widthShiftxValsyBundlesrrryValsrIr xValsShiftedrr fontPropss rHr%GraphGroupedVerticalBar.renderSubplots!#__    99KHq6Lqvvx(I  % ==,  )$)) 4 A} LLO OOvaffh/?@/?sV/?@ A!5 |$AE!%(1 Xa[^,)L##A$89;;|$%/%(%)^^%5 7D LL %"D NN7D ) MM$q' "++::@Q@QBF//;S vyy97As<G )rrr) rrrrrrr r+rIrrrr(r)s@rHrrs9$%I 55988% 11:1:rKrcL^\rSrSrSrSrSrSS.S U4SjjjrSrS r S r U=r $) Graph3DBarsi a Graph multiple parallel bar graphs in 3D. Data definition: A list of lists where the inner list of (x, y, z) coordinates. For instance, a graph where the x values increase (left to right), the y values increase in a step pattern (front to back), and the z values decrease (top to bottom): >>> g = graph.primitives.Graph3DBars() >>> g.doneAction = None #_DOCS_HIDE >>> data = [] >>> for i in range(1, 10 + 1): ... q = [i, i//2, 10 - i] ... data.append(q) >>> g.data = data >>> g.process() 3DBarsrr)rc J>[TU]"SSU0UD6 SU;a /SQUlgg)Nrr)z#ff0000z#00ff00z#6666ffr)rrIr)rBrrCr s rHrIGraph3DBars.__init__$s, 1u11 8 #;DK $rKc([5nURnUR5UlURRSSSSS9UlUR UR5 UR UR5 UR5 g)Nrcr) projection)rr7r9rr:rrrrs rHrGraph3DBars.process)so!#hhjjl {{..q!Q4.H  4<<( T\\* rKc 0nURH:n[U5S:aUupEpgOUupEnXR;a/X%'X%RXF45 M< [UR 55nUR 5 /n /n UHKn [ [X+55H.n X+U upFU RU5 U RU5 M0 MM URSSc&[U 5[U 54URSS'URSSc&[U 5[U 54URSS'URSSc&[U5[U54URSS'[U 5[U 5- S- n [U5[U5- S- nURHn[U5S:XaUupEn0nO![U5S:aUupEnnO [S5eSU;aUSnOUR5nURXMS - - X^S - - S XUUURS 9 M URSSS S 9 URSSS S 9 URSSS S 9 g)Nrrr-rrz,Cannot plot a point with fewer than 3 valuesrrsr)rrT)r)r8rdrjrrrvr-r;r~rtrrfbar3drr)rBr:yDictrrrrrrzValsrrrbarWidthbarDepth dataPointrrs rHrGraph3DBars.renderSubplot5s^YYE5zA~-2*a*a~ HOOQF #UZZ\" C3uz?+z!} Q Q, 99S>' " *&)%j#e*&' " *&)%j#e*&' " *&)%j#e*&?CYAW KKN )/ BXsD)*D.5D3cJ/nSH|n/n[S5HVn[R"[S55nU[R"[S55-nURXV45 MX URX#/5 M~ [ SS9nXlUR 5 g)N) rrrer%rfr rrrIr3r6r)r-r8r9rjrfr8r)rBr8rorrstartendrs rHtestBrokenHorizontal!TestExternal.testBrokenHorizontalsGEF2Y eCj1fmmE"I66 ul+ KK ( H $ / rKcx/n[S5Htn[R"[S55n[R"[S55n[R"[SS55nURX4U/5 Mv UR(aSnOSn[ US9nXlUR5 g)Nr6r#rcr6rA)r-r8r9rjr`rr8r)rBr8rrrrrrs rHtestScatterWeighted TestExternal.testScatterWeightedsrA eBi(A eBi(A eArl+A KKq "  99 JJ J 7 rKc R/n[SS5HTn[S5Vs/sH*o3[R"[SUS--55U4PM, nnURU5 MV [SS/4SSS /4S S /4/4[ /S Q4[ [S 5Vs/sHo3X3-4PM sn4[[S 5Vs/sH#o3[R"[S554PM% sn4[U4[S/SQ4S/SQ4/4[/SQSS//SQ/4/nUHupgU"SS9nXxl UR5 URRS-n [[ R#5U - 5n [ R%SU /5 UR'U 5 M gs snfs snfs snf)z Write a graphic file for all graphs, naming them after the appropriate class. This is used to generate documentation samples. rcrmr#r3Chopin)' Schumanns)rK.)iMBrahms)i)@)))r3rRr2)rmrRrQ)rSxr6r7Major))Cz#00AA55)Dz#5600FF)Gz#2B00FFMinor))rXz#004600)rYz#00009b)rZz#00009B)z#8968CDz#96CDCDz#CD4F39z#FFD600z#FF5600)z#201a2bz#8f73bfz#a080d5z#6495EDz#FF83FANrAr writing fp:)r-r8r9r:rfrrrrrOr+r8rr rrrgetRootTempDirrr6) rBdata3DPolygonBarsrrr; graphClassesgraphClassNamer8objfnrs rHx_test_writeAllGraphs"TestExternal.x_test_writeAllGraphssq!AEJ2YOYV]]5q1u#67;YAO  $ $Q ' -./02EFG-./1  " E G "') ,)Q!%j) , . 5:2Y ?Y&--b *+Y ? A + , !NONOS ?()4U  # 2%1 N D1CH KKM''&0B\002R78B  # #]B$7 8 IIbM%1=P- ?s1FF :*F$ c[SS9n/SQ/SQ/SQ/SQ/SQ/SQ/nX!lUR5 URRS-n[ [ R5U- 5nURU5 g) NrA)#525252#5f5f5f#797979#858585#727272#6c6c6c#8c8c8crlrk#999999rmrhrkrgrfz#464646#3f3f3frn#4c4c4crorhrhrororfrgrhrirjrk)rmrmrmrmrmrmrmrmrmrmrmrhrkrgrgrirhrhrhrhrhrhri#929292rm)rmrmrmrmrmrmrmrmrmrmrmrmrlrlrlrirhrirprm)rmrmrmrmrmrmrmrmrmrmrmrmrlrprm) rmrmrmrmrmrmrmrmrmrm)rmrmrmrmrmr) r+r8rr rrrr]r6)rBrr8rbrs rHx_test_writeGraphColorGrid'TestExternal.x_test_writeGraphColorGridsy d +S ^'2=G%I& [[ ! !F * ,,.3 4  rKc /n[SS9n[S5Vs/sHo3X3-4PM nnXBlURUS/5 [SSSS9n[S5Vs/sHo3X3-4PM nnXBlURUS/5 [ SS9n[S5Vs/sH#o3[ R "[S 554PM% nnXBlURUS /5 [SS9n/n[SS 5HTn[S 5Vs/sH*o3[ R "[S US--55U4PM, nnURU5 MV XBlURUS/5 [SSSS/SQS9nXGlURUS/5 UHbupUR5 U S-n [[R5U - 5n [RSU /5 URU 5 Md gs snfs snfs snfs snf)z& Write graphing examples for the docs NrAr6z graphing-01zExponential Graphrc)r&rrz graphing-02r7z graphing-03rmr#r3z graphing-04z Random Datarr.)rrr )r&rr'rrz graphing-05rr\)rr-r8rjrr8r9rr:rrrr]rr6) rBpostrrr8rr;rranamerbrs rHx_test_writeGraphingDocs%TestExternal.x_test_writeGraphingDocss D )$)"I.IqAE I. Q &' 2! M$)"I.IqAE I. Q &' d +7*H1HNcSSKJn UR5nUR5n[ USS9nXElUR 5 g)Nr)discreter)rr)music21.analysisrzKrumhanslSchmucklersolutionLegendrOr8r)rBrrzksr8rs rHtestColorGridLegend TestExternal.testColorGridLegend+s;-  ) ) +  " JC @ rKc[SS9n[S5Vs/sHnSU3SSSS.4PM nnX1lUR5 gs snf)NrAr3r;rrsrc)rrre)rr-r8r)rBr rr8s rHtestGraphVerticalBar!TestExternal.testGraphVerticalBar5sJ #t 4?DRyIy!3qc!!!45yI JsAcf[5nURb[SS9nUR5 gg)NrA)rrrr)rBrDrs rHtestGraphNetworkxGraph#TestExternal.testGraphNetworkxGraph;s,!# == $"d3A IIK %rKrrY)rrrrr`r<rDrGrcrqrwrrrrrrKrHr4r4xs6 D0  /b:*X rKr4__main__)$r __future__rrr8unittestmusic21rmusic21.converter.subConvertersrrmusic21.graph.utilitiesrrr r r EnvironmentrProtoM21Objectr rr+rOrfrrrrrrTestCaser,r4rmainTestrrKrHrs1 # 8'' &&'9: VG " "VrUUpgUgTH5HVP'P'f{#{#TC-5C-L9>59>x6DU6Dr\:e\:~d6%d6N%8  %I8$$IX z TrK