U md@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) StrCategoryConvertercCsP|dkrtdt|ttj|td}||tj|j j t 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 `~numpy.ndarray` of float NzMissing category information for StrCategoryConverter; this might be caused by unintendedly mixing categorical and numeric dataZdtype)Zotypes) ValueErrorr_validate_unitnp atleast_1darrayobjectupdateZ vectorize_mapping __getitem__float)valueunitaxisvaluesrL/home/sam/Atlas/atlas_env/lib/python3.8/site-packages/matplotlib/category.pyconverts  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)rr StrCategoryLocatorrStrCategoryFormatterrZAxisInfo)rrrrrrraxisinfo<s   zStrCategoryConverter.axisinfocCs,|jdkr|t|n |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)datarrrr default_unitsWs  z"StrCategoryConverter.default_unitscCst|dstd|ddS)NrzProvided unit "zU" is not valid for a categorical converter, as it does not have a _mapping attribute.)hasattrr)rrrrr ns  z#StrCategoryConverter._validate_unitN)__name__ __module__ __qualname__ staticmethodrrr r rrrrrs   rc@s(eZdZdZddZddZddZdS) rz1Tick at every integer mapping of the string data.cCs ||_dSz Parameters ---------- units_mapping : dict Mapping of category names (str) to indices (int). N_unitsselfZ units_mappingrrr__init__xszStrCategoryLocator.__init__cCst|jSN)listr(rr*rrr__call__szStrCategoryLocator.__call__cCs|Sr,r)r*ZvminZvmaxrrr tick_valuesszStrCategoryLocator.tick_valuesN)r"r#r$__doc__r+r/r0rrrrrvs rc@s6eZdZdZddZd ddZddZed d ZdS) rz0String representation of the data at every tick.cCs ||_dSr&r'r)rrrr+szStrCategoryFormatter.__init__NcCs||gdS)Nr) format_ticks)r*xposrrrr/szStrCategoryFormatter.__call__cs*fddjDfdd|DS)Ncsi|]\}}||qSr)_text).0kvr.rr sz5StrCategoryFormatter.format_ticks..csg|]}t|dqS))getround)r6val) r_mappingrr sz5StrCategoryFormatter.format_ticks..)r(items)r*rr)r>r*rr2sz!StrCategoryFormatter.format_tickscCs.t|tr|jdd}nt|ts*t|}|S)z0Convert text values into utf-8 or ascii strings.zutf-8)encoding) isinstancebytesdecodestrrrrrr5s   zStrCategoryFormatter._text)N) r"r#r$r1r+r/r2r%r5rrrrrs  rc@s*eZdZdddZeddZddZdS) rNcCs(t|_t|_|dk r$||dS)z Create mapping between unique categorical values and integer ids. Parameters ---------- data : iterable sequence of string values N)rr itertoolscount_counterr)r*rrrrr+s  zUnitData.__init__c CsTz t|WnBtk rNztj|Wnttfk rHYYdSXYnXdS)zY Helper method to check whether a string can be parsed as float or date. FT)rrdateutilparserparse TypeError)r=rrr_str_is_convertibles zUnitData._str_is_convertiblecCszttj|td}d}t|D]>}tjtt f|d|rF| |}||j kr"t |j |j |<q"|jrv|rvtddS)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. rTrFzUsing 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 rfromkeysrZcheck_isinstancerErCrNrnextrIsize_loginfo)r*rZ convertibler=rrrrs    zUnitData.update)N)r"r#r$r+r%rNrrrrrrs  r)r1 collectionsrZdateutil.parserrJrGloggingnumpyr Z matplotlibrrr getLoggerr"rRZConversionInterfacerZLocatorr FormatterrrregistryrEZstr_rCbytes_rrrrs  \>