matplotlib.category#

字符串“类别”数据的绘图:plot(['d', 'f', 'a'], [1, 2, 3]) 将绘制三个点,其 x 轴值为 'd', 'f', 'a'。

有关示例,请参阅 绘制分类变量。

该模块使用 Matplotlib 的 matplotlib.units 机制将字符串转换为整数,并提供了一个刻度定位器 (tick locator)、一个刻度格式化程序 (tick formatter) 以及用于创建和存储字符串到整数映射的 UnitData 类。

class matplotlib.category.StrCategoryConverter[源代码]#

基类:ConversionInterface

static axisinfo(unit, axis)[源代码]#

设置默认的轴刻度和标签。

参数:
unitUnitData

值的对象字符串单位信息

axisAxis

正在设置信息的轴

注意

axis 未被使用

返回:
AxisInfo

支持默认刻度标注的信息

static convert(value, unit, axis)[源代码]#

使用存储在 unit 对象中的映射信息,将 value 中的字符串转换为浮点数。

参数:
valuestr 或可迭代对象

要转换的值或值列表。

unitUnitData

将字符串映射到整数的对象。

axisAxis

绘制转换后值的轴。

注意

axis 未使用。

返回:
float 或 ndarray 的 float
static default_units(data, axis)[源代码]#

设置并更新 Axis 单位。

参数:
datastr 或字符串的可迭代对象
axisAxis

绘制数据的轴

返回:
UnitData

存储字符串到整数映射的对象

class matplotlib.category.StrCategoryFormatter(units_mapping)[源代码]#

基类:Formatter

每个刻度处数据的字符串表示形式。

参数:
units_mappingdict

类别名称(str)到索引(int)的映射。

format_ticks(values)[源代码]#

返回所有 values 的刻度标签字符串。

这是生成刻度标签的公共 API。它在委托给每个单个值的 __call__ 之前,调用 set_locs 来配置依赖上下文的格式化状态。

输出可能包含 mathtext 或 LaTeX 标记。

每当格式化一整套刻度值时,请使用此方法(而非 __call__),以便需要查看所有刻度位置的格式化器(例如为了确定精度、偏移量或要显示的日期组件)能够正确工作。

class matplotlib.category.StrCategoryLocator(units_mapping)[源代码]#

基类:Locator

在字符串数据的每个整数映射处设置刻度。

参数:
units_mappingdict

类别名称(str)到索引(int)的映射。

tick_values(vmin, vmax)[源代码]#

返回给定 vmin 和 vmax 的定位刻度值。

注意

要获取关联 axis 自动定义 vmin 和 vmax 值的刻度位置,只需调用 Locator 实例

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]
class matplotlib.category.UnitData(data=None)[源代码]#

基类: object

创建唯一分类值与整数 ID 之间的映射。

参数:
data可迭代对象

字符串值序列

update(data)[源代码]#

将新值映射到整数标识符。

参数:
datastr 或 bytes 的可迭代对象
引发:
TypeError

如果 data 中的元素既不是 str 也不是 bytes。