rh<%SrSSKJr SSKrSSKrSSKrSSKrSSKJ r SSKJ r SSKJ r \ R\ R\ R\ R\ RS.rS\S '/S QrS \S '\Vs/sHoSPM snrSS jrSSjrSSjrSrSSjrSSjrSSjrSSSjjr"SS\R85r\S:XaSSKr\R@"\5 ggs snf) z7 Functions that find appropriate plots for graph.plot. ) annotationsN)axis)plot) primitives)ambitusdolan instrumentskey pianorollz%dict[str, type[plot.PlotStreamMixin]]PLOTCLASS_SHORTCUTS)) horizontalbarbar horizontalr piano) histogramhistocount)scatterpoint)scatterweightedweightedscatterweighted)3dbars3d) colorgridgridwindowwindowed)horizontalbarweighted barweighted weightedbarzlist[tuple[str, ...]]FORMAT_SYNONYMSc/n[[R5Hn[[U5n[ U5(dM%[ U[ R5(aMF[US5(dMY[RUR;dMy[RUR;dMUR[R"[ [RU55 M U$)aW return a list of all PlotStreamMixin subclasses. Returns a list sorted by name >>> graph.findPlot.getPlotClasses() [, , , , , ...] __mro__)sortedr__dict__getattrcallable isinstancetypes FunctionTypehasattrPlotStreamMixinr$rGraphappendtcasttype)allPlotinames P/home/james-whalen/.local/lib/python3.13/site-packages/music21/graph/findPlot.pygetPlotClassesr73s13G DMM "tQ TNN"4););<<D),,((DLL8$$ 4 NN166$t';';">> graph.findPlot.getAxisClasses() [, , , , ...] ) r%rr&r'r(r)r*r+ issubclassAxisr/)allAxisr4r5s r6getAxisClassesr=Lsh&(G DMM "tQ TNN"4););<<tTYY// NN4 # Nr8cUc [5n/nUHEnU(aURUR5 M'URURS5 MG U$)aq >>> graph.findPlot.getAxisQuantities() ['generic', 'count', 'dynamic', 'offset', 'offsetEnd', 'pitchGeneric', 'pitchClass', 'pitchSpace', 'octave', 'position', 'quarterLength'] >>> graph.findPlot.getAxisQuantities(synonyms=True) ['generic', 'one', 'nothing', 'blank', 'count', 'quantity', 'frequency', ...] >>> theseAxes = [graph.axis.CountingAxis, graph.axis.OffsetAxis] >>> graph.findPlot.getAxisQuantities(axesToCheck=theseAxes) ['count', 'offset'] >>> graph.findPlot.getAxisQuantities(True, axesToCheck=theseAxes) ['count', 'quantity', 'frequency', 'counting', 'offset', 'measure', 'offsets', 'measures', 'time'] r)r=extend quantitiesr/)synonyms axesToCheck allQuantitiesaxClasss r6getAxisQuantitiesrEasY&$& M   !3!3 4  !3!3A!6 7  r8c|UR5nURSS5n[HnX;dM USs $ U$)a Replace possible user format strings with defined format names as used herein. Returns string unaltered if no match. >>> graph.findPlot.userFormatsToFormat('horizontal') 'horizontalbar' >>> graph.findPlot.userFormatsToFormat('Weighted Scatter') 'scatterweighted' >>> graph.findPlot.userFormatsToFormat('3D') '3dbars' Unknown formats pass through unaltered. >>> graph.findPlot.userFormatsToFormat('4D super chart') '4dsuperchart'  r)lowerreplacer") userFormatopts r6userFormatsToFormatrMsE$!!#J##C,J  q6M r8c[U5R5nUc [5n/nUH4nURR5U:XdM#UR U5 M6 U$)aP Given a graphFormat, find a list of plots that match: >>> graph.findPlot.getPlotClassesFromFormat('scatterweighted') [, , , ] Or give a list of plot classes to check: >>> pcs = [graph.plot.ScatterWeighted, graph.plot.Dolan] >>> graph.findPlot.getPlotClassesFromFormat('scatterweighted', pcs) [] )rMrIr7 graphTyper/) graphFormatcheckPlotClasses filteredPlotsps r6getPlotClassesFromFormatrTs`"&k288:K)+M  ;;   + -   # r8cN[5Hn[X5(dMUs $ g)a7 given an axis value return the single best axis for the value, or None uses Axis.quantities >>> getAxis = graph.findPlot.getAxisClassFromValue >>> getAxis('counting') >>> getAxis('pc') >>> print(getAxis('boogie')) None N)r=axisMatchesValue) axisValuethisAxiss r6getAxisClassFromValuerYs&"#$ H 0 0O% r8cvUR5nURHnUR5U:XdM g g)aA Returns Bool about whether axisValue.lower() is anywhere in axisClass.quantities >>> ax = graph.axis.CountingAxis >>> graph.findPlot.axisMatchesValue(ax, 'counting') True >>> graph.findPlot.axisMatchesValue(ax, 'count') True >>> graph.findPlot.axisMatchesValue(ax, 'offset') False Works on an instantiated object as well: >>> ax = graph.axis.CountingAxis() >>> graph.findPlot.axisMatchesValue(ax, 'counting') True >>> graph.findPlot.axisMatchesValue(ax, 'flute') False * Changed in v8: Must send a subclass of axis.Axis or an instance. `None` is no longer supported. TF)rIr@) axisClassrWvs r6rVrVs62!I  ! ! 779 !" r8c^^^UUU4SjnUTTT/S/S-:XaSnU[;a [U/nO [U5nU(dU(aUTTsmmmSn[5n/nST4ST4ST44HgupxUH\n UcMXyR;aUR U 5 M*U RUn [ X5(aMKUR U 5 M^ Mi UV s/sH oU;dM U PM n n U (a U(d[ U 5S:XaU $U"U 5$/nST4ST4ST44HfupxUH[n UcMS n U RR5Hup[ X5(dMS n O U (aMJUR U 5 M] Mh UV s/sH oU;dM U PM n n U (a U(d[ U 5S:XaU $U"U 5$[R"5nST4ST4ST44HupxUcM [U5nUcMUX'M [ U5S:XaUS U4/$U"U5nU(aUS U4/$US U4/$s sn fs sn f) a Returns either a list of plot classes to make if there is a predetermined class or a list of tuples where the first element of each tuple is the plot class and the second is a dict of {'x': axisXClass, 'y': axisYClass} etc. Default is pianoroll >>> graph.findPlot.getPlotsToMake() [] >>> graph.findPlot.getPlotsToMake('scatter') [, , , , ] >>> graph.findPlot.getPlotsToMake('scatter', 'offset', 'pitchClass') [] Try in wrong order: >>> graph.findPlot.getPlotsToMake('scatter', 'pitchClass', 'offset') [] Try giving just one value: >>> graph.findPlot.getPlotsToMake('scatter', 'offset') [] >>> graph.findPlot.getPlotsToMake('scatter', 'ql') # abbreviation [, ] Just one value, but it is in the wrong axis: >>> graph.findPlot.getPlotsToMake('scatter', 'pitchClass') [, ] Create a graph that does not exist: >>> graph.findPlot.getPlotsToMake('scatter', 'offset', 'dynamics') [(, OrderedDict([('x', ), ('y', )]))] Just a couple of values: >>> graph.findPlot.getPlotsToMake('offset', 'dynamics') [(, OrderedDict([('x', ), ('y', )]))] Just one value: >>> graph.findPlot.getPlotsToMake('octave') [(, OrderedDict([('x', )]))] Three values: >>> graph.findPlot.getPlotsToMake('offset', 'dynamics', 'count') [(, OrderedDict([('x', ), ('y', ), ('z', )]))] c>[TTT4Vs/sH ocMSPM sn5nSnUS:XaSnOUS:XaSnOUS:XaSn[X05nU(aU$U$s snf)NrHrrr)lenrT)graphClassesToChooseFromvalnumAxes bestGraphTypeinnerFilteredClassesxValueyValuezValues r6 _bestPlotType%getPlotsToMake.._bestPlotType=snVVV$<P$>*5L#L<<""2&"O(4L|! 7KA|L #23q8' ' !56 6K#&-#vf !N B E35>>3G3G3I/!#L<< E4J 5""2&"O(4L|! 7KA|L #23q8' ' !56 6&&(H#&-#vf !N   ))4   ( "O <Aa(+,,' 5 $Q'23 3!!_h/0 0aM,Ms I&I I I c \rSrSrSrSrSrg)Testic[S5nURU[R/5 [S5nURU[R/5 [5nURU[R /5 [S5nURU[R /5 [S5nURU[R /5 [S5nURU[R/5 [S5nURU[R/5 [S5nURU[R/5 [S5nURU[R/5 [S SS 5nURU[R/5 [S S S 5nURU[R/5 g) Nrr duration quarterLengthpspitch pitchspace pitchClassrqlpcoffset) r assertEqualrWindowedAmbitus WindowedKeyHorizontalBarPitchSpaceOffsetHistogramQuarterLengthHistogramPitchSpaceHistogramPitchClassScatterPitchSpaceQuarterLengthScatterPitchClassOffsetselfposts r6testGetPlotsToMakeATest.testGetPlotsToMakeAsi(  4 456e$  0 012  B BCDj)  ; ;<=o.  ; ;<=d#  8 89:g&  8 89:l+  8 89:l+  8 89:i$7  C CDEix8  < <=>r8c[S5nURU[R/5 [S5nURU[R/5 g)Nrr )rrrDolanrs r6testGetPlotsToMakeBTest.testGetPlotsToMakeBsBg&  |,m,  |,r8N)__name__ __module__ __qualname____firstlineno__rr__static_attributes__rr8r6rrs ?<-r8r__main__)returnz list[type[plot.PlotStreamMixin]])rzlist[type[axis.Axis]])FN)N)rWstrrztype[axis.Axis] | None)r[ztype[axis.Axis] | axis.AxisrWrrbool)NNNN)rPz str | None)!__doc__ __future__rrsr*unittesttypingr0 music21.graphrrrrrrrr __annotations__r"FORMATSr7r=rErMrTrYrVrTestCaserrmusic21mainTest)syns0r6rs# $## ZZ::   33 >:*&- -_cq6_ -2*<<8. #(,@,0j1Z#-8  #-L z Tg .s8C,