hSrSSKJr SSKrSSKrSSKrSSKrSSK J r J r J r J r \R"\5r"SS\ R"5r"SS\ R&5r"S S \ R*5r"S S 5r\"5=\ R0\'=\ R0\R4'=\ R0\'\ R0\R8'g) 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)_apicbooktickerunitscT\rSrSr\S5r\S5r\S5r\S5rSr g)StrCategoryConvertercpUc [S5e[RU5 [R"[R "U[ S95nURU5 [R"URR[/S9"U5n[R"U5(dU$US$)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)otypesr) ValueErrorr _validate_unitnp atleast_1darrayobjectupdate vectorize_mapping __getitem__floatris_scalar_or_string)valueunitaxisvaluesss E/var/www/html/env/lib/python3.13/site-packages/matplotlib/category.pyconvertStrCategoryConverter.converts* <   ++D1rxxV<= F LL22E7 CF K11%88qBadBc[RU5 [UR5n[ UR5n[ R "X#S9$)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)r rStrCategoryLocatorrStrCategoryFormatterrAxisInfo)rrr%r&s r axisinfoStrCategoryConverter.axisinfo=s?( ++D1$DMM2%dmm4~~V;;r#cURc&UR[U55 UR$URRU5 UR$)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#cD[US5(d[SUS35eg)NrzProvided unit "zU" is not valid for a categorical converter, as it does not have a _mapping attribute.)hasattrr)rs r r#StrCategoryConverter._validate_unitos6tZ((!$(GGH H)r#N) __name__ __module__ __qualname____firstlineno__ staticmethodr!r*r0r__static_attributes__r5r#r r r sUCCB<<4,HHr#r c*\rSrSrSrSrSrSrSrg)r'wz1Tick at every integer mapping of the string data.cXlgzb Parameters ---------- units_mapping : dict Mapping of category names (str) to indices (int). N_unitsself units_mappings r __init__StrCategoryLocator.__init__y $ r#cH[URR55$N)listrAr)rCs r __call__StrCategoryLocator.__call__sDKK&&())r#cU"5$rIr5)rCvminvmaxs r tick_valuesStrCategoryLocator.tick_valuess v r#r@N) r6r7r8r9__doc__rErKrPr;r5r#r r'r'ws;$*r#r'c>\rSrSrSrSrS SjrSr\S5r Sr g) r(z0String representation of the data at every tick.cXlgr?r@rBs r rEStrCategoryFormatter.__init__rGr#Nc,URU/5S$)Nr) format_ticks)rCxposs r rKStrCategoryFormatter.__call__s  !%a((r#cURR5VVs0sHup#X0RU5_M nnnUVs/sHoTR[ U5S5PM sn$s snnfs snf)N)rAitems_textgetround)rCrkv r_mappingvals r rX!StrCategoryFormatter.format_tickss]26++2C2C2EF2E$!Q 1 %2E F9?@# eCj"-@@G@s A)$A/c[U[5(aURSS9nU$[U[5(d [U5nU$)z0Convert text values into utf-8 or ascii strings.zutf-8)encoding) isinstancebytesdecodestrrs r r_StrCategoryFormatter._textsE eU # #LL'L2E E3''JE r#r@rI) r6r7r8r9rRrErKrXr:r_r;r5r#r r(r(s):$)A r#r(c4\rSrSrSSjr\S5rSrSrg)r.Nc[5Ul[R"5UlUbUR U5 gg)z Create mapping between unique categorical values and integer ids. Parameters ---------- data : iterable sequence of string values N)rr itertoolscount_counterr)rCr/s r rEUnitData.__init__s2$  !)   KK  r#c[U5 g![a: [RR U5 g![[ 4a gf=ff=f)zI Helper method to check whether a string can be parsed as float or date. FT)rrdateutilparserparse TypeError)res r _str_is_convertibleUnitData._str_is_convertiblesY   #J   %%c* *   s$  A:A A AAc[R"[R"U[S95nSn[R "U5Hmn[ R"[[4US9 U(aURU5nX0R;dMK[UR5URU'Mo UR(aU(a[R!S5 ggg)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_isinstancerlrjr{rnextrtsize_loginfo)rCr/ convertibleres r rUnitData.updates}}RXXd&9: ''-C  ! !3,c :"66s; --'%)$--%8 c". 99 II? @%9r#)rtrrI) r6r7r8r9rEr:r{rr;r5r#r r.r.s!   @r#r.)rR collectionsrdateutil.parserrwrrloggingnumpyr matplotlibrrrr getLoggerr6rConversionInterfacer Locatorr' Formatterr(r.registryrlstr_rjbytes_r5r#r rs $11"ZH544ZHz(6++<:@:@D!5 67s7 NN2777 NN5 NN299r#