+ ,iRt^RIHt^RIt^RIt^RIt^RIt^RI H t H t H t H t ]P!]4t!RR] P"4t!RR] P&4t!RR ] P*4t!R R 4t]!4;] P0]&;] P0]P4&;] P0]&] P0]P8&R#) a Plotting of string "category" data: ``plot(['d', 'f', 'a'], [1, 2, 3])`` will plot three points with x-axis values of 'd', 'f', 'a'. See :doc:`/gallery/lines_bars_and_markers/categorical_variables` for an example. The module uses Matplotlib's `matplotlib.units` mechanism to convert from strings to integers and provides a tick locator, a tick formatter, and the `.UnitData` class that creates and stores the string-to-integer mapping. ) OrderedDictN)_apicbooktickerunitsc`a]tRt^to]R4t]R4t]R4t]R4tRt Vt R#)StrCategoryConverterc Vf \R4h\PV4\P!\P !V\ R74pVPV4\P!VPP\.R7!V4p\P!V4'gV#V^,#)a Convert strings in *value* to floats using mapping information stored in the *unit* object. Parameters ---------- value : str or iterable Value or list of values to be converted. unit : `.UnitData` An object mapping strings to integers. axis : `~matplotlib.axis.Axis` The axis on which the converted value is plotted. .. note:: *axis* is unused. Returns ------- float or `~numpy.ndarray` of float zMissing category information for StrCategoryConverter; this might be caused by unintendedly mixing categorical and numeric datadtype)otypes) ValueErrorr_validate_unitnp atleast_1darrayobjectupdate vectorize_mapping __getitem__floatris_scalar_or_string)valueunitaxisvaluesss&&& 5/usr/lib/python3/dist-packages/matplotlib/category.pyconvertStrCategoryConverter.converts* <   ++D1rxxV<= F LL22E7 CF K11%88qBadBc \PV4\VP4p\ VP4p\ P !W#R7#)aL Set the default axis ticks and labels. Parameters ---------- unit : `.UnitData` object string unit information for value axis : `~matplotlib.axis.Axis` axis for which information is being set .. note:: *axis* is not used Returns ------- `~matplotlib.units.AxisInfo` Information to support default tick labeling )majlocmajfmt)rrStrCategoryLocatorrStrCategoryFormatterrAxisInfo)rrr#r$s&& raxisinfoStrCategoryConverter.axisinfo=s?( ++D1$DMM2%dmm4~~V;;r!c VPf'VP\V44VP#VPPV4VP#)z Set and update the `~matplotlib.axis.Axis` units. Parameters ---------- data : str or iterable of str axis : `~matplotlib.axis.Axis` axis on which the data is plotted Returns ------- `.UnitData` object storing string to integer mapping )r set_unitsUnitDatar)datars&&r default_units"StrCategoryConverter.default_unitsXsH" ::  NN8D> *zz JJ  d #zzr!cH\VR4'g\RV R24hR#)rzProvided unit "zU" is not valid for a categorical converter, as it does not have a _mapping attribute.N)hasattrr )rs&rr#StrCategoryConverter._validate_unitos6tZ((!$(GGH H)r!N) __name__ __module__ __qualname____firstlineno__ staticmethodrr(r.r__static_attributes____classdictcell__ __classdict__s@rrrsXCCB<<4,HHr!rc6a]tRt^wtoRtRtRtRtRtVt R#)r%z1Tick at every integer mapping of the string data.c WnR#zb Parameters ---------- units_mapping : dict Mapping of category names (str) to indices (int). N_unitsself units_mappings&&r__init__StrCategoryLocator.__init__y $ r!cH\VPP44#N)listrAr)rCs&r__call__StrCategoryLocator.__call__sDKK&&())r!cV!4#rIr3)rCvminvmaxs&&&r tick_valuesStrCategoryLocator.tick_valuess v r!r@N) r4r5r6r7__doc__rErKrPr9r:r;s@rr%r%ws;$*r!r%cJa]tRt^toRtRtRRltRt]R4t Rt Vt R#) r&z0String representation of the data at every tick.c WnR#r?r@rBs&&rrEStrCategoryFormatter.__init__rGr!Nc4VPV.4^,#)) format_ticks)rCxposs&&&rrKStrCategoryFormatter.__call__s  !%a((r!cVPP4UUu/uFwr#W0PV4bK pppVUu.uFqTP\ V4R4NK up#uuppiuupi))rAitems_textgetround)rCrkv r_mappingvals&& rrX!StrCategoryFormatter.format_tickss]26++2C2C2EF2E$!Q 1 %2E F9?@# eCj"-@@G@s A'#A-c \V\4'dVPRR7pV#\V\4'g \V4pV#)z0Convert text values into utf-8 or ascii strings.zutf-8)encoding) isinstancebytesdecodestrrs&rr_StrCategoryFormatter._textsE eU # #LL'L2E E3''JE r!r@rI) r4r5r6r7rRrErKrXr8r_r9r:r;s@rr&r&s,:$)A r!r&c@a]tRt^toRRlt]R4tRtRtVt R#)r,Nc \4Vn\P!4VnVeVP V4R#R#)z Create mapping between unique categorical values and integer ids. Parameters ---------- data : iterable sequence of string values N)rr itertoolscount_counterr)rCr-s&&rrEUnitData.__init__s2$  !)   KK  r!c \V4R# \d>\PP T4R# \\ 3dR#i;ii;i)zI Helper method to check whether a string can be parsed as float or date. FT)rr dateutilparserparse TypeError)res&r_str_is_convertibleUnitData._str_is_convertiblesY   #J   %%c* *   s$  A=AAAAc \P!\P!V\R74pRp\P !V4Frp\ P!\\3VR7V'dVPV4pW0P9gKP\VP4VPV&Kt VP'd"V'd\P!R4R#R#R#)z Map new values to integer identifiers. Parameters ---------- data : iterable of str or bytes Raises ------ TypeError If elements in *data* are neither str nor bytes. r TrmzUsing categorical units to plot a list of strings that are all parsable as floats or dates. If these strings should be plotted as numbers, cast to the appropriate data type before plotting.N)rrrrrfromkeysrcheck_isinstancerlrjrzrnextrssize_loginfo)rCr- convertibleres&& rrUnitData.updates}}RXXd&9: ''-C  ! !3,c :"66s; --'%)$--%8 c". 999 II? @%9r!)rsrrI) r4r5r6r7rEr8rzrr9r:r;s@rr,r,s*   @@r!r,)rR collectionsrdateutil.parserrvrqloggingnumpyr matplotlibrrrr getLoggerr4rConversionInterfacerLocatorr% Formatterr&r,registryrlstr_rjbytes_r3r!rrs $11"ZH544ZHz(6++<:@:@D!5 67s7 NN2777 NN5 NN299r!