matplotlib.axis

用于刻度和 x 轴与 y 轴的类。

继承

Axis 对象

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

XAxis 和 YAxis 的基类。

属性:

isDefault_label布尔

轴 : AxesAxes

艺术家所在的 Axes 实例，或 None。

主要 : TickerTicker

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

次要 : TickerTicker

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

回调 : CallbackRegistry回调注册表

标签 : Text文本

轴标签。

labelpad浮动

轴标签与刻度标签之间的距离。默认为 rcParams["axes.labelpad"] (default: 4.0) = 4。

offsetText文本

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

pickradius浮动

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

majorTicks : Tick 的列表列表

主要刻度。

警告

刻度不保证是持久的。各种操作可以创建、删除和修改刻度实例。如果你进一步处理图形（包括在显示的图形上平移/缩放），个别刻度的变化有即将丢失的风险。

逐个处理刻度是一种最后的手段。如果可能，请使用 set_tick_params。

minorTicks : Tick 的列表列表

次要刻度。

参数:

axesAxes

创建的轴所属的 Axes。

pickradius浮动

用于包含测试的接受半径。另见 Axis.contains。

清除bool, 默认: True

是否在创建时清除轴。这不是必需的，例如，当作为 Axes 的一部分创建 Axis 时，因为 Axes.clear 会调用 Axis.clear。 .. versionadded:: 3.8

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

参数:

axesAxes

创建的轴所属的 Axes。

pickradius浮动

用于包含测试的接受半径。另见 Axis.contains。

清除bool, 默认: True

是否在创建时清除轴。这不是必需的，例如，当作为 Axes 的一部分创建 Axis 时，因为 Axes.clear 会调用 Axis.clear。 .. versionadded:: 3.8

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

参数:

axesAxes

创建的轴所属的 Axes。

pickradius浮动

用于包含测试的接受半径。另见 Axis.contains。

清除bool, 默认: True

是否在创建时清除轴。这不是必需的，例如，当作为 Axes 的一部分创建 Axis 时，因为 Axes.clear 会调用 Axis.clear。 .. versionadded:: 3.8

class matplotlib.axis.Ticker

定义刻度位置和格式的对象的容器。

属性:

定位器 : Locator 子类定位器子类

确定刻度的位置。

formatter : Formatter 子类格式化器子类

确定刻度标签的格式。

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.set_label_coords	设置标签的坐标。
Axis.set_label_position	设置标签位置（顶部或底部）
Axis.set_label_text	设置轴标签的文本值。
Axis.get_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	返回此轴的 (最小值, 最大值) 数据限制。
Axis.get_view_interval	返回此轴的 (最小值, 最大值) 视图限制。
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.update_units	内省 数据 以进行单位转换，并在必要时更新 axis.converter 实例。

X轴特定

XAxis.axis_name	只读名称，用于标识轴。
XAxis.get_ticks_position	返回刻度位置（“顶部”、“底部”、“默认”或“未知”）。
XAxis.set_ticks_position	设置刻度位置。
XAxis.set_label_position	设置标签位置（顶部或底部）
XAxis.tick_bottom	将刻度和刻度标签（如果存在）移动到 Axes 的底部。
XAxis.tick_top	将刻度和刻度标签（如果存在）移动到 Axes 的顶部。

Y轴特定

YAxis.axis_name	只读名称，用于标识轴。
YAxis.get_ticks_position	返回刻度位置（“左”，“右”，“默认”，或“未知”）。
YAxis.set_offset_position
YAxis.set_ticks_position	设置刻度位置。
YAxis.set_label_position	设置标签位置（左侧或右侧）
YAxis.tick_left	将刻度和刻度标签（如果存在）移动到 Axes 的左侧。
YAxis.tick_right	将刻度和刻度标签（如果存在）移动到 Axes 的右侧。

其他

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

不鼓励

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

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

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

label1文本

左侧/底部刻度标签。

label2文本

右侧/顶部刻度标签。

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

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

包含制作 x 轴刻度所需的所有艺术家 - 刻度线、标签文本和网格线

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

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

包含制作 Y 轴刻度所需的所有艺术家 - 刻度线、标签文本和网格线

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

Tick.get_loc	返回刻度位置（数据坐标）作为标量。
Tick.get_pad	获取刻度标签在点中的间距值。
Tick.get_tick_padding	获取刻度在Axes外部的长度。
Tick.get_tickdir
Tick.get_view_interval	返回刻度所属轴的视图限制 (最小值, 最大值)。
Tick.set_pad	设置刻度标签的间距，单位为点
Tick.set_url	设置标签1和标签2的URL。
Tick.update_position	使用标量 loc 设置刻度在数据坐标中的位置。