Module that allows plotting of string "category" data. i.e. plot(['d', 'f', 'a'],[1, 2, 3])
will plot three points with x-axis values of 'd', 'f', 'a'.
See Plotting categorical variables for an example.
The module uses Matplotlib's matplotlib.units
mechanism to convert from strings to integers, provides a tick locator and formatter, and the class:UnitData
that creates and stores the string-to-integer mapping.
class matplotlib.category.StrCategoryConverter
[source]
Bases: matplotlib.units.ConversionInterface
static axisinfo(unit, axis)
[source]
Sets the default axis ticks and labels
Parameters: |
|
---|---|
Returns: |
|
static convert(value, unit, axis)
[source]
Convert strings in value to floats using mapping information store in the unit object.
Parameters: |
|
---|---|
Returns: |
|
static default_units(data, axis)
[source]
Sets and updates the axis
units.
Parameters: |
|
---|---|
Returns: |
|
class matplotlib.category.StrCategoryFormatter(units_mapping)
[source]
Bases: matplotlib.ticker.Formatter
String representation of the data at every tick
Parameters: |
|
---|
class matplotlib.category.StrCategoryLocator(units_mapping)
[source]
Bases: matplotlib.ticker.Locator
tick at every integer mapping of the string data
Parameters: |
|
---|
tick_values(self, vmin, vmax)
[source]
Return the values of the located ticks given vmin and vmax.
Note
To get tick locations with the vmin and vmax values defined automatically for the associated axis
simply call the Locator instance:
>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
class matplotlib.category.UnitData(data=None)
[source]
Bases: object
Create mapping between unique categorical values and integer ids.
Parameters: |
|
---|
update(self, data)
[source]
Maps new values to integer identifiers.
Parameters: |
|
---|---|
Raises: |
|
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.1.1/api/category_api.html