matplotlib.axis

刻度以及 x 轴和 y 轴的类。

继承

Axis 对象

class matplotlib.axis.Axis(axes, *, pickradius=15, clear=True)

XAxis 和 YAxis 的基类。

属性：

isDefault_label布尔值

axesAxes

艺人（artist）所在的 Axes 实例，或 None。

majorTicker

确定主刻度位置及其标签格式。

minorTicker

确定次刻度位置及其标签格式。

callbacksCallbackRegistry

labelText

轴标签。

labelpad浮点数

轴标签和刻度标签之间的距离。默认为 rcParams["axes.labelpad"]（默认值：4.0）。

offsetTextText

一个包含刻度数据偏移量（如果有）的 Text 对象。

pickradius浮点数

用于包含性测试的接受半径。

majorTicksTick 列表

主刻度。

警告

刻度不保证是持久的。各种操作可以创建、删除和修改 Tick 实例。如果您在图中进一步操作（包括在显示的图中平移/缩放），单个刻度的更改可能无法保留。

操作单个刻度是最后的手段。如果可能，请改用 set_tick_params。

minorTicksTick 列表

次刻度。

参数:

axesAxes

所创建 Axis 所属的 Axes。

pickradius浮点数

用于包含性测试的接受半径。另请参阅 Axis.contains。

clear布尔值，默认值：True

是否在创建时清除 Axis。这不是必需的，例如，当创建作为 Axes 一部分的 Axis 时，因为 Axes.clear 将调用 Axis.clear。 .. 版本新增于:: 3.8

class matplotlib.axis.XAxis(*args, **kwargs)

参数:

axesAxes

所创建 Axis 所属的 Axes。

pickradius浮点数

用于包含性测试的接受半径。另请参阅 Axis.contains。

clear布尔值，默认值：True

是否在创建时清除 Axis。这不是必需的，例如，当创建作为 Axes 一部分的 Axis 时，因为 Axes.clear 将调用 Axis.clear。 .. 版本新增于:: 3.8

class matplotlib.axis.YAxis(*args, **kwargs)

参数:

axesAxes

所创建 Axis 所属的 Axes。

pickradius浮点数

用于包含性测试的接受半径。另请参阅 Axis.contains。

clear布尔值，默认值：True

是否在创建时清除 Axis。这不是必需的，例如，当创建作为 Axes 一部分的 Axis 时，因为 Axes.clear 将调用 Axis.clear。 .. 版本新增于:: 3.8

class matplotlib.axis.Ticker

一个包含定义刻度位置和格式的对象的容器。

属性：

locatorLocator 子类

确定刻度的位置。

formatterFormatter 子类

确定刻度标签的格式。

Axis.clear	清除轴。
Axis.get_scale	返回此轴的比例尺（字符串形式）。

格式化器和定位器

Axis.get_major_formatter	获取主刻度格式化器。
Axis.get_major_locator	获取主刻度定位器。
Axis.get_minor_formatter	获取次刻度格式化器。
Axis.get_minor_locator	获取次刻度定位器。
Axis.set_major_formatter	设置主刻度格式化器。
Axis.set_major_locator	设置主刻度定位器。
Axis.set_minor_formatter	设置次刻度格式化器。
Axis.set_minor_locator	设置次刻度定位器。
Axis.remove_overlapping_locs	如果次刻度位置与主刻度位置重叠，是否应修剪。
Axis.get_remove_overlapping_locs
Axis.set_remove_overlapping_locs

轴标签

Axis.label	轴标签的 Text 对象。
Axis.set_label_coords	设置标签的坐标。
Axis.set_label_position	设置标签位置（顶部或底部）
Axis.set_label_text	设置轴标签的文本值。
Axis.get_label_position	返回标签位置（顶部或底部）
Axis.get_label_text	获取标签文本。

刻度、刻度标签和偏移文本

Axis.get_major_ticks	返回主 Tick 列表。
Axis.get_majorticklabels	返回此轴的主刻度标签，作为 Text 列表。
Axis.get_majorticklines	返回此轴的主刻度线，作为 Line2D 列表。
Axis.get_majorticklocs	返回此轴在数据坐标系中的主刻度位置。
Axis.get_minor_ticks	返回次 Tick 列表。
Axis.get_minorticklabels	返回此轴的次刻度标签，作为 Text 列表。
Axis.get_minorticklines	返回此轴的次刻度线，作为 Line2D 列表。
Axis.get_minorticklocs	返回此轴在数据坐标系中的次刻度位置。
Axis.get_offset_text	以 Text 实例形式返回轴偏移文本。
Axis.get_tick_padding
Axis.get_tick_params	获取刻度、刻度标签和网格线的显示参数。
Axis.get_ticklabels	获取此轴的刻度标签。
Axis.get_ticklines	返回此轴的刻度线，作为 Line2D 列表。
Axis.get_ticklocs	返回此轴在数据坐标系中的刻度位置。
Axis.get_gridlines	返回此轴的网格线，作为 Line2D 列表。
Axis.grid	配置网格线。
Axis.set_tick_params	设置刻度、刻度标签和网格线的显示参数。
Axis.axis_date	设置轴刻度和标签，将此轴上的数据视为日期。
Axis.minorticks_off	从此轴移除次刻度。
Axis.minorticks_on	根据比例尺（get_scale）在此轴上显示默认次刻度。

数据和视图区间

Axis.get_data_interval	返回此轴的数据限制 (min, max)。
Axis.get_view_interval	返回此轴的视图限制 (min, max)。
Axis.get_inverted	返回此轴是否按“反向”方向定位。
Axis.set_data_interval	设置轴数据限制。
Axis.set_view_interval	设置轴视图限制。
Axis.set_inverted	设置此轴是否按“反向”方向定位。

渲染辅助工具

Axis.get_minpos
Axis.get_tick_space	返回轴上可容纳的估计刻度数量。
Axis.get_tightbbox	返回包含该轴的边界框。

交互式

Axis.contains	测试艺术家是否包含鼠标事件。
Axis.pickradius	用于包含性测试的接受半径。
Axis.get_pickradius	返回选择器使用的轴深度。
Axis.set_pickradius	设置选择器使用的轴深度。

单位

Axis.convert_units
Axis.set_units	设置轴的单位。
Axis.get_units	返回轴的单位。
Axis.set_converter	设置轴的单位转换器。
Axis.get_converter	获取轴的单位转换器。
Axis.update_units	检查 data 以获取单位转换器，并在必要时更新 axis.get_converter 实例。

X轴特有

XAxis.axis_name	标识坐标轴的只读名称。
XAxis.get_ticks_position	返回刻度位置（“top”、“bottom”、“default”或“unknown”）。
XAxis.set_ticks_position	设置刻度位置。
XAxis.set_label_position	设置标签位置（顶部或底部）
XAxis.tick_bottom	将刻度及刻度标签（如果存在）移动到 Axes 的底部。
XAxis.tick_top	将刻度及刻度标签（如果存在）移动到 Axes 的顶部。

Y轴特有

YAxis.axis_name	标识坐标轴的只读名称。
YAxis.get_ticks_position	返回刻度位置（“left”、“right”、“default”或“unknown”）。
YAxis.set_offset_position
YAxis.set_ticks_position	设置刻度位置。
YAxis.set_label_position	设置标签位置（左或右）
YAxis.tick_left	将刻度及刻度标签（如果存在）移动到 Axes 的左侧。
YAxis.tick_right	将刻度及刻度标签（如果存在）移动到 Axes 的右侧。

其他

Axis.OFFSETTEXTPAD
Axis.axes	艺人（artist）所在的 Axes 实例，或 None。
Axis.limit_range_for_scale	返回范围 vmin, vmax，限制在当前比例尺支持的域内。
Axis.reset_ticks	重新初始化主次刻度（Tick）列表。
Axis.set_clip_path	设置艺术家的裁剪路径。
Axis.set_default_intervals	如果轴数据和视图区间尚未被修改，则设置它们的默认限制。

不推荐使用

这些方法应谨慎使用，在调用 set_ticklabels 指定匹配的标签系列之前，应先调用 set_ticks 指定所需的刻度位置。调用 set_ticks 会创建一个 FixedLocator；其位置列表随后被 set_ticklabels 用于生成适当的 FuncFormatter。

Axis.get_label	以 Text 实例形式返回轴标签。
Axis.set_label	不支持分配图例标签。
Axis.set_ticks	设置此轴的刻度位置和可选的刻度标签。
Axis.set_ticklabels	[不推荐使用] 使用字符串标签列表设置此轴的刻度标签。

Tick 对象

class matplotlib.axis.Tick(axes, loc, *, size=None, width=None, color=None, tickdir=None, pad=None, labelsize=None, labelcolor=None, labelfontfamily=None, zorder=None, gridOn=None, tick1On=True, tick2On=True, label1On=True, label2On=False, major=True, labelrotation=0, grid_color=None, grid_linestyle=None, grid_linewidth=None, grid_alpha=None, **kwargs)

轴刻度、网格线和标签的抽象基类。

刻度标记轴上的位置。它们包含两条线作为标记和两个标签；对于 XAxis，各有一个用于底部和顶部位置，对于 YAxis，各有一个用于左侧和右侧位置。

属性：

tick1lineLine2D

左/下刻度标记。

tick2lineLine2D

右/上刻度标记。

gridlineLine2D

与标签位置关联的网格线。

label1Text

左/下刻度标签。

label2Text

右/上刻度标签。

bbox 是 Axes 在显示坐标中的 Bound2D 边界框。loc 是数据坐标中的刻度位置。size 是点表示的刻度大小。

class matplotlib.axis.XTick(*args, **kwargs)

包含制作 X 轴刻度所需的所有 Artist 对象——刻度线、标签文本和网格线

bbox 是 Axes 在显示坐标中的 Bound2D 边界框。loc 是数据坐标中的刻度位置。size 是点表示的刻度大小。

class matplotlib.axis.YTick(*args, **kwargs)

包含制作 Y 轴刻度所需的所有 Artist 对象——刻度线、标签文本和网格线

bbox 是 Axes 在显示坐标中的 Bound2D 边界框。loc 是数据坐标中的刻度位置。size 是点表示的刻度大小。

Tick.get_loc	将刻度位置（数据坐标）以标量形式返回。
Tick.get_pad	获取刻度标签在点中的填充值。
Tick.get_tick_padding	获取 Axes 外部刻度的长度。
Tick.get_tickdir
Tick.get_view_interval	返回刻度所属轴的视图限制 (min, max)。
Tick.set_clip_path	设置艺术家的裁剪路径。
Tick.set_pad	设置刻度标签在点中的填充。
Tick.set_url	设置 label1 和 label2 的 URL。
Tick.update_position	使用标量 loc 设置刻度在数据坐标中的位置。