o :a@sdZddlmZddlZddlZddlZddlZddl m Z m Z m Z e eZGddde jZGddde jZGd d d e jZGd d d Zee je<ee jej<ee je<ee jej<dS) 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)_apitickerunitsc@s<eZdZeddZeddZeddZeddZd S) StrCategoryConvertercCs|durtdt|ttj|td}tt dd|D}Wdn1s/wY|rDtj dddtj |t dS| |tj|jjt gd |S) 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 ndarray[float] NzMissing category information for StrCategoryConverter; this might be caused by unintendedly mixing categorical and numeric dataZdtypecss,|]}tj|ot|ttf VqdSN)rConversionInterface is_numlike isinstancestrbytes).0vr5/usr/lib/python3/dist-packages/matplotlib/category.py :s   z/StrCategoryConverter.convert..z3.5zSupport for passing numbers through unit converters is deprecated since %(since)s and support will be removed %(removal)s; use Axis.convert_units instead.)message)Zotypes) ValueErrorr_validate_unitnp atleast_1darrayobjectrZ'suppress_matplotlib_deprecation_warningallZwarn_deprecatedZasarrayfloatupdateZ vectorize_mapping __getitem__)valueunitaxisvaluesr rrrconverts$    zStrCategoryConverter.convertcCs,t|t|j}t|j}tj||dS)a 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)r r!r$r%rrraxisinfoGs   zStrCategoryConverter.axisinfocCs0|jdur|t||jS|j||jS)aO 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 N)rZ set_unitsUnitDatar)datar!rrr default_unitsbs  z"StrCategoryConverter.default_unitscCst|ds td|ddS)NrzProvided unit "zU" is not valid for a categorical converter, as it does not have a _mapping attribute.)hasattrr)r rrrrys  z#StrCategoryConverter._validate_unitN)__name__ __module__ __qualname__ staticmethodr#r(r+rrrrrrs +  rc@s(eZdZdZddZddZddZdS) r&z1Tick at every integer mapping of the string data.cC ||_dSz Parameters ---------- units_mapping : dict Mapping of category names (str) to indices (int). N_unitsselfZ units_mappingrrr__init__ zStrCategoryLocator.__init__cCst|jSr)listr4r"r6rrr__call__szStrCategoryLocator.__call__cCs|Srr)r6ZvminZvmaxrrr tick_valuesszStrCategoryLocator.tick_valuesN)r-r.r/__doc__r7r;r<rrrrr&s  r&c@s6eZdZdZddZd ddZddZed d ZdS) r'z0String representation of the data at every tick.cCr1r2r3r5rrrr7r8zStrCategoryFormatter.__init__NcCs||gdS)Nr) format_ticks)r6xposrrrr;szStrCategoryFormatter.__call__cs*fddjDfdd|DS)Ncsi|] \}}||qSr)_text)rkrr:rr z5StrCategoryFormatter.format_ticks..csg|] }t|dqS))getround)rval) r_mappingrr rDz5StrCategoryFormatter.format_ticks..)r4items)r6r"r)rIr6rr>sz!StrCategoryFormatter.format_tickscCs0t|tr |jdd}|St|tst|}|S)z0Convert text values into utf-8 or ascii strings.zutf-8)encoding)r r decoder rrrrrAs   zStrCategoryFormatter._textr) r-r.r/r=r7r;r>r0rArrrrr's r'c@s*eZdZdddZeddZddZdS) r)NcCs,t|_t|_|dur||dSdS)z Create mapping between unique categorical values and integer ids. Parameters ---------- data : iterable sequence of string values N)rr itertoolscount_counterr)r6r*rrrr7s  zUnitData.__init__c CsNzt|WdSty&z tj|WYdSttfy%YYdSww)zY Helper method to check whether a string can be parsed as float or date. FT)rrdateutilparserparse TypeError)rHrrr_str_is_convertibles  zUnitData._str_is_convertiblecCsxttj|td}d}t|D]}tjtt f|d|r#| |}||j vr0t |j |j |<q|r:tddSdS)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. rTrNzUsing 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)rrrrrfromkeysrZcheck_isinstancer r rVrnextrQ_loginfo)r6r*Z convertiblerHrrrrs   zUnitData.updater)r-r.r/r7r0rVrrrrrr)s    r))r= collectionsrZdateutil.parserrRrOZloggingZnumpyrZ matplotlibrrrZ getLoggerr-rYr rZLocatorr&Z Formatterr'r)registryr Zstr_r Zbytes_rrrrs   g >