matplotlib.axes
¶
Table of Contents
轴类¶
-
class
matplotlib.axes.
Axes
(fig, rect, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, box_aspect=None, **kwargs)[源代码]¶ 基类:
matplotlib.axes._base._AxesBase
这个
Axes
包含大多数图形元素:Axis
,Tick
,Line2D
,Text
,Polygon
等,并设置坐标系。这个
Axes
实例通过回调属性支持回调,该属性是CallbackRegistry
实例。您可以连接到的事件是'xlim_changed'和'ylim_changed',回调将用func调用。( ax 何处 ax 是Axes
实例。属性: 在图形中构建轴。
参数: - fig :
Figure
图形 轴内置于
Figure
fig .- rect[左、下、宽、高]
轴内置在矩形中 rect . rect 是在
Figure
协调。- 斯莱西 :
Axes
可选可选轴 - frameonbool,默认值:True
轴框架是否可见。
- box_aspect无,或数字,可选
设置轴框的纵横比。看到了吗
set_box_aspect
有关详细信息。- **kwargs
其他可选关键字参数:
财产 描述 adjustable
'box'、'datalim' agg_filter
一种过滤函数,它接受一个(m,n,3)浮点数组和一个dpi值,并返回一个(m,n,3)数组。 alpha
浮动或无 anchor
2-浮点数或'c'、'sw'、's'、'se'、… animated
布尔 aspect
{auto}或num autoscale_on
布尔 autoscalex_on
布尔 autoscaley_on
布尔 axes_locator
可赎回的 [[轴,渲染器]] Bbox axisbelow
布尔或“线” box_aspect
没有,或者是一个数字 clip_box
Bbox
clip_on
布尔 clip_path
面片或(路径、变换)或无 contains
未知的 facecolor
或fc颜色 figure
Figure
frame_on
布尔 gid
STR in_layout
布尔 label
对象 navigate
布尔 navigate_mode
未知的 path_effects
AbstractPathEffect
picker
无、布尔或可呼叫 position
[左、下、宽、高] 或 Bbox
prop_cycle
未知的 rasterization_zorder
浮动或无 rasterized
布尔或无 sketch_params
(比例:浮动,长度:浮动,随机性:浮动) snap
布尔或无 title
STR transform
Transform
url
STR visible
布尔 xbound
未知的 xlabel
STR xlim
(底部:浮动,顶部:浮动) xmargin
浮动大于-0.5 xscale
“Linear”,“Log”,“SymLog”,“Logit”,… xticklabels
未知的 xticks
未知的 ybound
未知的 ylabel
STR ylim
(底部:浮动,顶部:浮动) ymargin
浮动大于-0.5 yscale
“Linear”,“Log”,“SymLog”,“Logit”,… yticklabels
未知的 yticks
未知的 zorder
浮动
返回: - fig :
次要情节¶
SubplotBase |
子批次的基类,它是 Axes 具有其他方法的实例,以便于生成和操作一组 Axes 在一个数字内。 |
subplot_class_factory |
创建继承自的新类 SubplotBase 以及给定的轴类(假定为 axes.Axes ) |
作图¶
基本的¶
Axes.plot |
绘制Y和X作为直线和/或标记。 |
Axes.errorbar |
将Y和X绘制为带有附加误差线的直线和/或标记。 |
Axes.scatter |
散点图 y VS |
Axes.plot_date |
包含日期的绘图数据。 |
Axes.step |
绘制一个步进图。 |
Axes.loglog |
在X轴和Y轴上绘制对数比例图。 |
Axes.semilogx |
在X轴上绘制对数比例图。 |
Axes.semilogy |
在Y轴上绘制对数比例图。 |
Axes.fill_between |
填充两条水平曲线之间的区域。 |
Axes.fill_betweenx |
填充两条垂直曲线之间的区域。 |
Axes.bar |
绘制条形图。 |
Axes.barh |
绘制水平条形图。 |
Axes.stem |
创建一个茎图。 |
Axes.eventplot |
在给定位置绘制相同的平行线。 |
Axes.pie |
绘制饼图。 |
Axes.stackplot |
绘制堆积面积图。 |
Axes.broken_barh |
绘制水平矩形序列。 |
Axes.vlines |
绘制垂直线。 |
Axes.hlines |
在每个位置绘制水平线 y 从 xmin 到 xmax . |
Axes.fill |
绘制填充多边形。 |
跨距¶
Axes.axhline |
在轴上添加一条水平线。 |
Axes.axhspan |
在轴上添加水平跨距(矩形)。 |
Axes.axvline |
在轴上添加一条垂直线。 |
Axes.axvspan |
在轴上添加一个垂直跨度(矩形)。 |
Axes.axline |
加一条无限长的直线。 |
光谱¶
Axes.acorr |
绘制的自相关 x . |
Axes.angle_spectrum |
绘制角度谱。 |
Axes.cohere |
绘制 x 和 y . |
Axes.csd |
绘制交叉光谱密度。 |
Axes.magnitude_spectrum |
绘制幅度谱。 |
Axes.phase_spectrum |
绘制相位谱。 |
Axes.psd |
绘制功率谱密度。 |
Axes.specgram |
绘制光谱图。 |
Axes.xcorr |
绘制 x 和 y . |
统计¶
Axes.boxplot |
制作一个盒子和胡须图。 |
Axes.violinplot |
画出小提琴的情节。 |
Axes.violin |
小提琴绘图功能。 |
Axes.bxp |
盒状图和胡须图的绘制功能。 |
装箱¶
Axes.hexbin |
制作一个二维六边形分块图 x , y . |
Axes.hist |
绘制柱状图。 |
Axes.hist2d |
绘制二维柱状图。 |
等高线¶
Axes.clabel |
标记轮廓图。 |
Axes.contour |
绘制等高线。 |
Axes.contourf |
绘制等高线。 |
数组¶
Axes.imshow |
将数据显示为图像,即在二维常规栅格上。 |
Axes.matshow |
将二维矩阵或数组的值绘制为彩色编码图像。 |
Axes.pcolor |
使用非规则矩形网格创建伪彩色绘图。 |
Axes.pcolorfast |
使用非规则矩形网格创建伪彩色绘图。 |
Axes.pcolormesh |
使用非规则矩形网格创建伪彩色绘图。 |
Axes.spy |
绘制二维数组的稀疏模式。 |
非结构化三角形¶
Axes.tripcolor |
创建一个非结构化三角形网格的伪彩色图。 |
Axes.triplot |
绘制一个非结构化的三角形网格作为线条和/或标记。 |
Axes.tricontour |
在非结构化三角网格上绘制等高线。 |
Axes.tricontourf |
在非结构化三角网格上绘制等高线区域。 |
文本和注释¶
Axes.annotate |
注释该点 xy 带文字 text . |
Axes.text |
将文本添加到轴。 |
Axes.table |
将表添加到 Axes . |
Axes.arrow |
向轴添加箭头。 |
Axes.inset_axes |
将子插入轴添加到此现有轴。 |
Axes.indicate_inset |
在轴上添加插入指示器。 |
Axes.indicate_inset_zoom |
根据轴的限制向轴添加一个插入指示器矩形 inset_ax 并在 inset_ax 以及矩形。 |
Axes.secondary_xaxis |
向该轴添加第二个x轴。 |
Axes.secondary_yaxis |
向该轴添加第二个y轴。 |
领域¶
Axes.barbs |
绘制一个二维倒钩区域。 |
Axes.quiver |
绘制二维箭头字段。 |
Axes.quiverkey |
在震动图中添加一个键。 |
Axes.streamplot |
绘制矢量流的流线。 |
清除¶
Axes.cla |
清除当前轴。 |
Axes.clear |
清除轴。 |
外观¶
Axes.axis |
获取或设置某些轴属性的方便方法。 |
Axes.set_axis_off |
关闭X轴和Y轴。 |
Axes.set_axis_on |
打开X轴和Y轴。 |
Axes.set_frame_on |
设置是否绘制轴矩形面片。 |
Axes.get_frame_on |
获取是否绘制轴矩形面片。 |
Axes.set_axisbelow |
设置轴刻度线和网格线是在大多数艺术家的上方还是下方。 |
Axes.get_axisbelow |
获取轴刻度线和网格线是在大多数艺术家的上方还是下方。 |
Axes.grid |
配置网格线。 |
Axes.get_facecolor |
获取轴的面颜色。 |
Axes.set_facecolor |
设置轴的面颜色。 |
产权循环¶
Axes.set_prop_cycle |
设置轴的属性循环。 |
轴/极限¶
Axes.get_xaxis |
返回Xaxis实例。 |
Axes.get_yaxis |
返回yaxis实例。 |
轴限制和方向¶
Axes.invert_xaxis |
反转X轴。 |
Axes.xaxis_inverted |
返回X轴是否指向“相反”方向。 |
Axes.invert_yaxis |
反转Y轴。 |
Axes.yaxis_inverted |
返回Y轴是否指向“相反”方向。 |
Axes.set_xlim |
设置X轴视图限制。 |
Axes.get_xlim |
返回X轴视图限制。 |
Axes.set_ylim |
设置Y轴视图限制。 |
Axes.get_ylim |
返回Y轴视图限制。 |
Axes.update_datalim |
扩展 dataLim Bbox包含给定的点。 |
Axes.update_datalim_bounds |
[Deprecated] 扩展 datalim Bbox包含给定的 Bbox . |
Axes.set_xbound |
设置X轴的上下数值边界。 |
Axes.get_xbound |
按递增顺序返回X轴下限和上限。 |
Axes.set_ybound |
设置Y轴的上下数值边界。 |
Axes.get_ybound |
按递增顺序返回Y轴上下边界。 |
坐标轴标签、标题和图例¶
Axes.set_xlabel |
设置X轴的标签。 |
Axes.get_xlabel |
获取XLabel文本字符串。 |
Axes.set_ylabel |
设置Y轴的标签。 |
Axes.get_ylabel |
获取依拉贝尔文本字符串。 |
Axes.set_title |
为轴设置标题。 |
Axes.get_title |
获取轴标题。 |
Axes.legend |
在轴上放置图例。 |
Axes.get_legend |
返回 Legend 实例,如果未定义任何图例,则为无。 |
Axes.get_legend_handles_labels |
返回图例的手柄和标签 |
轴比例尺¶
Axes.set_xscale |
设置X轴比例。 |
Axes.get_xscale |
返回xaxis的刻度(作为str)。 |
Axes.set_yscale |
设置Y轴比例。 |
Axes.get_yscale |
返回yaxis'scale(作为str)。 |
自动缩放和页边距¶
Axes.use_sticky_edges |
自动缩放时,是否全部服从 Artist.sticky_edges . |
Axes.margins |
设置或检索自动调整页边距。 |
Axes.set_xmargin |
在自动缩放之前设置x数据限制的填充。 |
Axes.set_ymargin |
在自动缩放之前设置Y数据限制的填充。 |
Axes.relim |
基于当前艺术家重新计算数据限制。 |
Axes.autoscale |
将轴视图自动缩放为数据(切换)。 |
Axes.autoscale_view |
使用数据限制自动缩放视图限制。 |
Axes.set_autoscale_on |
设置是否对绘图命令应用自动缩放 |
Axes.get_autoscale_on |
获取是否对绘图命令上的两个轴应用自动缩放 |
Axes.set_autoscalex_on |
设置是否在绘图命令上应用X轴的自动缩放 |
Axes.get_autoscalex_on |
获取是否在绘图命令上应用X轴的自动缩放 |
Axes.set_autoscaley_on |
设置是否在绘图命令上应用Y轴的自动缩放 |
Axes.get_autoscaley_on |
获取是否将Y轴的自动缩放应用于绘图命令 |
宽高比¶
Axes.apply_aspect |
根据指定的数据纵横比调整轴。 |
Axes.set_aspect |
设置轴缩放的纵横比,即Y单位与X单位的比率。 |
Axes.get_aspect |
|
Axes.set_box_aspect |
设置轴框纵横比。 |
Axes.get_box_aspect |
获取轴盒外观。 |
Axes.set_adjustable |
设置轴如何调整以达到所需的纵横比。 |
Axes.get_adjustable |
返回轴是调整其物理尺寸(“box”)还是调整其数据限制(“datalim”),以达到所需的纵横比。 |
刻度线和刻度线标签¶
Axes.set_xticks |
设置X轴的刻度位置。 |
Axes.get_xticks |
返回xaxis在数据坐标中的记号位置。 |
Axes.set_xticklabels |
用字符串标签列表设置xaxis标签。 |
Axes.get_xticklabels |
获取xaxis的刻度标签。 |
Axes.get_xmajorticklabels |
返回xaxis的主要刻度标签,作为 Text . |
Axes.get_xminorticklabels |
返回xaxis的次要刻度标签,作为 Text . |
Axes.get_xgridlines |
将xaxis的网格线作为 Line2D S |
Axes.get_xticklines |
返回xaxis的刻度线作为 Line2D S |
Axes.xaxis_date |
设置轴记号和标签,将沿X轴的数据视为日期。 |
Axes.set_yticks |
设置yaxis的刻度位置。 |
Axes.get_yticks |
返回yaxis在数据坐标中的记号位置。 |
Axes.set_yticklabels |
用字符串标签列表设置yaxis标签。 |
Axes.get_yticklabels |
获取yaxis的标签。 |
Axes.get_ymajorticklabels |
返回yaxis的主要刻度标签,作为 Text . |
Axes.get_yminorticklabels |
返回yaxis的小刻度标签,作为 Text . |
Axes.get_ygridlines |
返回yaxis的网格线作为 Line2D S |
Axes.get_yticklines |
返回yaxis的记号行作为 Line2D S |
Axes.yaxis_date |
设置轴记号和标签,将沿Y轴的数据视为日期。 |
Axes.minorticks_off |
从轴上删除次要刻度。 |
Axes.minorticks_on |
在轴上显示小刻度。 |
Axes.ticklabel_format |
配置 ScalarFormatter 默认情况下用于线性轴。 |
Axes.tick_params |
更改刻度线、刻度标签和网格线的外观。 |
Axes.locator_params |
控制主要蜱虫定位器的行为。 |
单位¶
Axes.convert_xunits |
转换 x 使用xaxis的单位类型。 |
Axes.convert_yunits |
转换 y 使用yaxis的单位类型。 |
Axes.have_units |
返回 True 如果在任何轴上设置了单位。 |
添加艺术家¶
Axes.add_artist |
添加一个 Artist 回到斧头上,把艺术家还给我。 |
Axes.add_child_axes |
添加一个 AxesBase 给斧子的孩子们;把孩子们的斧子还给他们。 |
Axes.add_collection |
添加 Collection 到轴的集合;返回集合。 |
Axes.add_container |
添加 Container 放回斧子的容器里;把容器放回原处。 |
Axes.add_image |
添加一个 AxesImage 到轴的图像;返回图像。 |
Axes.add_line |
添加 Line2D 回到轴线上;返回直线。 |
Axes.add_patch |
添加 Patch 到轴的补丁;返回补丁。 |
Axes.add_table |
添加 Table 回到轴心的桌子上;归还桌子。 |
结对与分享¶
Axes.twinx |
创建一个共享X轴的双轴。 |
Axes.twiny |
创建一个共享Y轴的双轴。 |
Axes.sharex |
与共享x轴 其他 . |
Axes.sharey |
与共享y轴 其他 . |
Axes.get_shared_x_axes |
返回对X轴的共享轴Grouper对象的引用。 |
Axes.get_shared_y_axes |
为Y轴返回对共享轴Grouper对象的引用。 |
轴线位置¶
Axes.get_anchor |
获取锚定位置。 |
Axes.set_anchor |
定义定位点位置。 |
Axes.get_axes_locator |
返回轴定位器。 |
Axes.set_axes_locator |
设置轴定位器。 |
Axes.reset_position |
将激活位置重置为原始位置。 |
Axes.get_position |
获取轴矩形的副本作为 Bbox . |
Axes.set_position |
设置轴位置。 |
异步/基于事件¶
Axes.stale |
艺术家是否“过时”,是否需要重新绘制输出以匹配艺术家的内部状态。 |
Axes.pchanged |
调用所有已注册的回调。 |
Axes.add_callback |
添加一个回调函数,当 Artist 的属性更改。 |
Axes.remove_callback |
根据观察者id移除回调。 |
互动式¶
Axes.can_pan |
返回 True 如果此轴支持任何平移/缩放按钮功能。 |
Axes.can_zoom |
返回 True 如果此轴支持缩放框按钮功能。 |
Axes.get_navigate |
获取轴是否响应导航命令 |
Axes.set_navigate |
设置轴是否响应导航工具栏命令 |
Axes.get_navigate_mode |
获取导航工具栏按钮状态:“平移”、“缩放”或“无” |
Axes.set_navigate_mode |
设置导航工具栏按钮状态; |
Axes.start_pan |
在启动PAN操作时调用。 |
Axes.drag_pan |
当鼠标在平移操作期间移动时调用。 |
Axes.end_pan |
当pan操作完成时调用(当鼠标按钮打开时)。 |
Axes.format_coord |
返回格式化字符串 x , y 协调。 |
Axes.format_cursor_data |
返回的字符串表示形式 data . |
Axes.format_xdata |
返回 x 格式化为x值。 |
Axes.format_ydata |
返回 y 格式化为y值。 |
Axes.mouseover |
如果此属性设置为 True ,则当鼠标光标移动到艺术家身上时,将查询该艺术家的自定义上下文信息。 |
Axes.in_axes |
返回 True 如果给定 鼠标移动 (在显示坐标中)在轴中 |
Axes.pick |
处理pick事件。 |
Axes.pickable |
返回艺术家是否可选择。 |
Axes.get_picker |
返回艺术家的拾取行为。 |
Axes.set_picker |
定义艺术家的采摘行为。 |
Axes.set_contains |
[Deprecated] 为艺术家定义自定义包含测试。 |
Axes.get_contains |
[Deprecated] 返回艺术家的自定义包含函数(如果设置),或 None . |
Axes.contains |
测试艺术家是否包含鼠标事件。 |
Axes.contains_point |
返回是否 点 (一对像素坐标)位于轴面片内。 |
Axes.get_cursor_data |
返回游标的给定数据事件。 |
儿童¶
Axes.get_children |
返回孩子的列表 Artist 这是什么 Artist . |
Axes.get_images |
返回的列表 AxesImage 轴所包含的。 |
Axes.get_lines |
返回轴包含的行列表。 |
Axes.findobj |
查找艺术家对象。 |
绘图¶
Axes.draw |
使用给定的渲染器绘制艺术家(及其子对象)。 | ||
Axes.draw_artist |
高效地重画一个艺术家。 | ||
Axes.redraw_in_frame |
有效地重新绘制轴数据,但不绘制轴记号、标签等。 | ||
Axes.get_renderer_cache |
|||
Axes.get_rasterization_zorder |
返回zorder值,低于该值艺术家将被栅格化。 | ||
Axes.set_rasterization_zorder |
|
||
Axes.get_window_extent |
返回显示空间中的轴边界框; args 和 关键字参数 是空的。 | ||
Axes.get_tightbbox |
返回轴的紧边界框,包括轴及其装饰器(xlabel、title等)。 |
投影¶
方法使用 Axis
对于非直线轴必须重写。
Axes.name |
|||
Axes.get_xaxis_transform |
获取用于绘制X轴标签、刻度和网格线的转换。 | ||
Axes.get_yaxis_transform |
获取用于绘制Y轴标签、刻度和网格线的转换。 | ||
Axes.get_data_ratio |
返回缩放数据的纵横比。 | ||
Axes.get_data_ratio_log |
[Deprecated] 以日志刻度返回原始数据的纵横比。 | ||
Axes.get_xaxis_text1_transform |
|
||
Axes.get_xaxis_text2_transform |
|
||
Axes.get_yaxis_text1_transform |
|
||
Axes.get_yaxis_text2_transform |
|
其他¶
Axes.zorder |
|
Axes.get_default_bbox_extra_artists |
返回用于边界框计算的默认艺术家列表。 |
Axes.get_transformed_clip_path_and_affine |
返回剪辑路径,并应用其转换的非仿射部分,以及其转换的剩余仿射部分。 |
Axes.has_data |
返回 True 如果有艺术家被添加到轴。 |