+ ]icsRt^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)_apicbooktickerunitscs`a]tRt^to]R4t]R4t]R4t]R4tRt Vt R#)StrCategoryConverterc sVf \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 dataZdtype)Zotypes) ValueErrorr_validate_unitnp atleast_1darrayobjectupdateZ vectorize_mappingZ __getitem__floatrZis_scalar_or_string)valueunitaxisvaluesZss&&& :/usr/lib64/python3.14/site-packages/matplotlib/category.pyconvertZStrCategoryConverter.converts* <   ++D1rxxV<= F LL22E7 CF K11%88qBadBc s\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)rrStrCategoryLocatorrStrCategoryFormatterrZAxisInfo)rrrr&& raxisinfoZStrCategoryConverter.axisinfo=s?( ++D1$DMM2%dmm4~~V;;rc sVPf'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 )rZ set_unitsUnitDatar )datar&&r default_unitsZ"StrCategoryConverter.default_unitsXsH" ::  NN8D> *zz JJ  d #zzrcsH\VR4'g\RV R24hR#)rzProvided unit "zU" is not valid for a categorical converter, as it does not have a _mapping attribute.N)Zhasattrr)r&rrZ#StrCategoryConverter._validate_unitos6tZ((!$(GGH H)rN) __name__ __module__ __qualname____firstlineno__ staticmethodrrr r__static_attributes____classdictcell__Z __classdict__@rrrsXCCB<<4,HHrrcs6a]tRt^wtoRtRtRtRtRtVt R#)rz1Tick at every integer mapping of the string data.c WnR#zb Parameters ---------- units_mapping : dict Mapping of category names (str) to indices (int). N_unitsselfZ units_mappingrr__init__ZStrCategoryLocator.__init__y $ rcsH\VPP44#N)Zlistr/r)r1r!r__call__ZStrCategoryLocator.__call__sDKK&&())rcsV!4#r4r")r1ZvminZvmax&&&r tick_valuesZStrCategoryLocator.tick_valuess v rr.N) r#r$r%r&__doc__r2r5r7r(r)r*r+rrrws;$*rrcsJa]tRt^toRtRtRRltRt]R4t Rt Vt R#) rz0String representation of the data at every tick.c r,r-r.r0rrr2ZStrCategoryFormatter.__init__r3rNcs4VPV.4^,#)i) format_ticks)r1ZxZposr6rr5ZStrCategoryFormatter.__call__s  !%a((rcsVPP4UUu/uFwr#W0PV4bK pppVUu.uFqTP\ V4R4NK up#uuppiuupi)Z)r/Zitems_textZgetZround)r1rZkZvZ r_mappingvals&& rr9Z!StrCategoryFormatter.format_tickss]26++2C2C2EF2E$!Q 1 %2E F9?@# eCj"-@@G@s A'#A-c s\V\4'dVPRR7pV#\V\4'g \V4pV#)z0Convert text values into utf-8 or ascii strings.zutf-8)Zencoding)Z isinstancebytesZdecodestrrr!rr:ZStrCategoryFormatter._textsE eU # #LL'L2E E3''JE rr.r4) r#r$r%r&r8r2r5r9r'r:r(r)r*r+rrrs,:$)A rrcs@a]tRt^toRRlt]R4tRtRtVt R#)rNc s\4Vn\P!4VnVeVP V4R#R#)z Create mapping between unique categorical values and integer ids. Parameters ---------- data : iterable sequence of string values N)rr itertoolsZcount_counterr )r1rrrr2ZUnitData.__init__s2$  !)   KK  rc s\V4R# \d>\PP T4R# \\ 3dR#i;ii;i)zI Helper method to check whether a string can be parsed as float or date. FT)rrdateutilZparserZparseZ TypeError)r;r!r_str_is_convertibleZUnitData._str_is_convertiblesY   #J   %%c* *   s$  A=AAAAc s\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. rTr>zUsing 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)r r r r rZfromkeysrZcheck_isinstancer=r<rBrZnextr@Zsize_logZinfo)r1rZ convertibler;rrr ZUnitData.updates}}RXXd&9: ''-C  ! !3,c :"66s; --'%)$--%8 c". 999 II? @%9r)r@rr4) r#r$r%r&r2r'rBr r(r)r*r+rrrs*   @@rr)r8Z collectionsrZdateutil.parserrAr?ZloggingZnumpyr Z matplotlibrrrrZ getLoggerr#rCZConversionInterfacerZLocatorrZ FormatterrrZregistryr=Zstr_r<Zbytes_r"rrrDs $11"ZH544ZHz(6++<:@:@D!5 67s7 NN2777 NN5 NN299r