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)[源代码]
设置默认的轴刻度和标签。
- 参数:
- unit
UnitData 值的对象字符串单位信息
- axis
Axis 正在设置信息的轴
- 返回:
AxisInfo支持默认刻度标注的信息
-
static convert(value, unit, axis)[源代码]
使用存储在 unit 对象中的映射信息,将 value 中的字符串转换为浮点数。
- 参数:
- valuestr 或可迭代对象
要转换的值或值列表。
- unit
UnitData 将字符串映射到整数的对象。
- axis
Axis 绘制转换后值的轴。
- 返回:
- float 或
ndarray 的 float
-
static default_units(data, axis)[源代码]
设置并更新 Axis 单位。
- 参数:
- datastr 或字符串的可迭代对象
- axis
Axis 绘制数据的轴
- 返回:
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。