ث ًٍ3jل<مَج—UdZddlmZddlZddlZddlZddlZddlm Z ddlm Z ddlmZe je je je je jdœZded <gd ¢Zded<eDڈcgc]}|d‘Œ c}Zdd „Zdd„Zdd„Zd„Zdd„Zdd„Z dd„Z ddd„ZGd„dej8«Zedk(rddlZej@e«yycc}w) z7 Functions that find appropriate plots for graph.plot. é)عannotationsN)عaxis)عplot)ع primitives)عambitusعdolanعinstrumentsعkeyع pianorollz%dict[str, type[plot.PlotStreamMixin]]عPLOTCLASS_SHORTCUTS))ع horizontalbarعbarع horizontalrعpiano)ع histogramعhistoعcount)عscatterعpoint)عscatterweightedعweightedscatterعweighted)ع3dbarsع3d)ع colorgridعgridعwindowعwindowed)عhorizontalbarweightedعbarweightedعweightedbarzlist[tuple[str, ...]]عFORMAT_SYNONYMScَ¶—g}ttj«D]؛}tt|«}t |«sŒt|tj«rŒ:t|d«sŒGtj|jvsŒdtj|jvsŒپ|jtjt tj|««Œ¼|S)a{ return a list of all PlotStreamMixin subclasses. Returns a list sorted by name >>> graph.findPlot.getPlotClasses() [, , , , , ...] ع__mro__)عsortedrع__dict__عgetattrعcallableع isinstanceعtypesعFunctionTypeعhasattrعPlotStreamMixinr$rعGraphعappendعtعcastعtype)عallPlotعiعnames ْC/DATA/.local/lib/python3.12/site-packages/music21/graph/findPlot.pyعgetPlotClassesr72s–€ً13€Gـ ”D—M‘Mض "ˆـ”tکQسˆنگTچNـ" 4¬×);ر);ص<ـکD )ص,ـ×(ر(¨D¯L©Lز8ـ×$ر$¨¯©ز4طڈN‰Nœ1ں6™6¤$¤t×';ر';ر"<¸dسCصDً#ً€Nَcَ—g}ttj«D]e}tt|«}t |«sŒt|tj«rŒ:t|tj«sŒU|j|«Œg|S)a7 return a list of all Axis subclasses. Returns a list sorted by name >>> graph.findPlot.getAxisClasses() [, , , , ...] )r%rr&r'r(r)r*r+ع issubclassعAxisr/)عallAxisr4r5s r6عgetAxisClassesr=Ks`€ً&(€Gـ ”D—M‘Mض "ˆـ”tکQسˆـگTچNـ" 4¬×);ر);ص<ـکt¤T§Y،Yص/طڈN‰Nک4ص ً#ً€Nr8cَ¨—|€ t«}g}|D]>}|r|j|j«Œ!|j|jd«Œ@|S)a >>> 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ع allQuantitiesعaxClasss r6عgetAxisQuantitiesrE`sY€ً$ذـ$س&ˆط€Mغˆظط× ر ×!3ر!3ص4à× ر ×!3ر!3°Aر!6ص7ً ً ذr8cَv—|j«}|jdd«}tD] }||vsŒ|dcS|S)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)عlowerعreplacer")ع userFormatعopts r6عuserFormatsToFormatrM}sG€ً$×!ر!س#€Jط×#ر# C¨س,€Jçˆطکزطگq‘6ٹMًًذr8cَہ—t|«j«}|€ t«}g}|D]1}|jj«|k(sŒ!|j |«Œ3|S)a| 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/)عgraphFormatعcheckPlotClassesع filteredPlotsعps r6عgetPlotClassesFromFormatrT›s`€ô"& kس2×8ر8س:€Kàذـ)س+ذط€Mغ ˆطڈ;‰;×رس +س-ط× ر ص#ًًذr8cَB—t«D]}t||«sŒ|cSy)a_ 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)ع axisValueعthisAxiss r6عgetAxisClassFromValuerY·s%€ô"#ض$ˆـکH iص0طٹOً%ًr8cَp—|j«}|jD]}|j«|k(sŒyy)a„ 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@)ع axisClassrWعvs r6rVrVخs6€ً0—‘س!€Iط × !ش !ˆطڈ7‰7‹9ک س!ظً"ًr8cٍَ‡‡‡—ˆˆˆfd„}|‰‰‰gdgdzk(rd}|tvrt|g}nt|«}|s|r|‰‰cٹٹٹd}t«}g}d‰fd‰fd‰ffD]\\}}|D]R} |€Œ|| jvr|j | «Œ&| j|} t| |«rŒB|j | «ŒTŒ^|Dڈcgc] }||vsŒ|‘Œ}}|r|st |«dk(r|S||«Sg}d‰fd‰fd‰ffD]W\} }|D]M} |€Œd }| jj«D]\}} t| |«sŒd }n|rŒ=|j | «ŒOŒY|Dڈcgc] }||vsŒ|‘Œ}}|r|st |«dk(r|S||«Stj«}d‰fd‰fd‰ffD]\}}|€Œ t|«}|€Œ|||<Œt |«dk(r|d|fgS||«}|r|d|fgS|d|fgScc}wcc}w)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َ¢•—t‰‰‰fDڈcgc]}|€Œd‘Œ c}«}d}|dk(rd}n|dk(rd}n|dk(rd}t||«}|r|S|Scc}w)NérHérérr)عlenrT)عgraphClassesToChooseFromعvalعnumAxesع bestGraphTypeعinnerFilteredClassesعxValueعyValueعzValues €€€r6ع _bestPlotTypez%getPlotsToMake.._bestPlotType7suّ€ن V¨V°Vر$<سPر$<کSہء’qذ$<رPسQˆطˆ àگaٹ<ط-‰Mط کٹ\ط%‰Mط کٹ\ط'ˆMـ7¸ ذG_س`ذظط'ذ'à+ذ+ùٍQs ژA–ANérعxعyعzr_FTr)rrTr7عaxesClassesr/rVrbعitemsعcollectionsعOrderedDictrY)rPrhrirjrkعgraphClassesعgraphRemoveع axisLetterrWعgcعaxisObjClassrmعgraphClassesFilteredع_axisLetterعfoundعunused_axisLetterعaxisDictr[عfilteredClassess ``` r6عgetPlotsToMakerيs±ْ€ِT,ً" گVکV Vذ,°°¸± ز:ط!ˆًش)ر)ـ+¨Kر8ذ9‰ن/°س<ˆٌ™Kط!,¨f°fذˆگکطˆـ%س'ˆً€Kط#&¨ -°#°v°ہہfہ س!Nرˆ گIغˆBطذ طط §،ر/ط×"ر" 2ش&ططں>™>¨*ر5ˆLـ# L°)ص<ط×"ر" 2ص&ًٌ"Oٌ(4سL،| !°qہز7KڑA |ذذLظظœ#ذ2س3°qز8ط'ذ'ل ذ!5س6ذ6ً€Kط$'¨ =°3¸°-ہ#ہvہس"OرˆگYغˆBطذ ططˆEط35·>±>×3Gر3Gض3Iر/ذ! <ـ# L°)ص<ط گEظً4Jٍ ط×"ر" 2ص&ًٌ#Pٌ(4سL،| !°qہز7KڑA |ذذLظظœ#ذ2س3°qز8ط'ذ'ل ذ!5س6ذ6ô×&ر&س(€Hط#&¨ -°#°v°ہہfہ س!Nرˆ گIطذطـ)¨)س4ˆ طذطط(ˆگزً "Oôˆ<سکAزطکa‘ (ذ+ذ,ذ,ل'¨س5ˆلط$ Qر'¨ذ2ذ3ذ3à! !‘_ hذ/ذ0ذ0ùٍaMùٍ,Msآ? G/أ G/إ G4إ G4cَ—eZdZd„Zd„Zy)عTestcَز—td«}|j|tjg«td«}|j|tjg«t«}|j|tj g«td«}|j|tjg«td«}|j|tjg«td«}|j|tjg«td«}|j|tjg«td«}|j|tjg«td«}|j|tjg«td dd «}|j|tjg«td dd«}|j|tjg«y) Nrr عdurationع quarterLengthعpsعpitchع pitchspaceع pitchClassrعqlعpcعoffset)rعassertEqualrعWindowedAmbitusعWindowedKeyعHorizontalBarPitchSpaceOffsetعHistogramQuarterLengthعHistogramPitchSpaceعHistogramPitchClassعScatterPitchSpaceQuarterLengthعScatterPitchClassOffset©عselfعposts r6عtestGetPlotsToMakeAzTest.testGetPlotsToMakeAکsچ€ـکiس(ˆط×رک¤× 4ر 4ذ5ش6ـکeس$ˆط×رک¤× 0ر 0ذ1ش2ôسˆط×رک¤× Bر BذCشDôکjس)ˆط×رک¤× ;ر ;ذ<ش=ـکoس.ˆط×رک¤× ;ر ;ذ<ش=ـکdس#ˆط×رک¤× 8ر 8ذ9ش:ـکgس&ˆط×رک¤× 8ر 8ذ9ش:ـکlس+ˆط×رک¤× 8ر 8ذ9ش:ـکlس+ˆط×رک¤× 8ر 8ذ9ش:نکi¨°$س7ˆط×رک¤× Cر CذDشEنکi¨¨xس8ˆط×رک¤× <ر <ذ=ص>r8cَ´—td«}|j|tjg«td«}|j|tjg«y)Nrr )rrŒrعDolanr•s r6عtestGetPlotsToMakeBzTest.testGetPlotsToMakeB¶sB€ـکgس&ˆط×رک¤§ ، ک|ش,ـکmس,ˆط×رک¤§ ، ک|ص,r8N)ع__name__ع __module__ع__qualname__rکr›©r8r6rپrپ—s„ٍ?َ<-r8rپع__main__)عreturnz list[type[plot.PlotStreamMixin]])r،zlist[type[axis.Axis]])FN)N)rWعstrr،ztype[axis.Axis] | None)r[ztype[axis.Axis] | axis.AxisrWr¢r،عbool)NNNN)rPz str | None)!ع__doc__ع __future__rrrr*عunittestعtypingr0ع music21.graphrrrrچrڑrژrڈrع__annotations__r"عFORMATSr7r=rErMrTrYrVrعTestCaserپrœعmusic21عmainTest)عsyns0r6عr¯sًٍُ#مغغغهفف$ً×#ر#ط ڈZ‰Zط—:‘:ط×رط×3ر3ٌ>ذذ:ٍَ*€ذ&ٌَ-س -™_گcˆ3ˆq‹6ک_ر -€ََ2َ*ٍ:َ<َ8ً.ط #ًط(,ًَ>,0طططôg1ôT#-ˆ8×رô#-ًLˆzزغط€G×رگTصًùٍ].sء8C!