matplotlib中axes和figure

matplotlib中axes和figure的作用

Axes类

用法：

class matplotlib.axes.Axes(fig, rect, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, box_aspect=None, **kwargs)[source]

Axes包含大多数图形元素：’轴‘，’刻度‘，”文本“，’多边形‘，并设置坐标系统。

Axes实例通过CallbackRegistry实例的callbacks属性支持回调。 您可以连接的事件是“ xlim_changed”和“ ylim_changed”，将使用func（ax）调用回调，其中ax是一个Axes实例。

属性：

• dataLim： Bbox包围框包含所有显示在轴中的数据
• viewLim： Bbox数据坐标中的视图限制。

参数：

• fig: Figure ，轴必须建立在Figure中
• rect: [left, bottom, width, height], 轴在矩形rect中构建。 rect在fig坐标中
• sharex, sharey：x或y轴与输入轴中的x或y轴共享。
• frameon: bool, 轴框架是否可见。
• box_aspect: None 或一个数字， 设置轴框的外观。 有关详细信息，请参见set_box_aspect。
• **kwargs： 其他可选参数

Subplots:SubplotBase子图的基类，子图是具有其他方法的Axes实例，以方便在图形中生成和操作一组Axes。

basic方法（Plotting）

• Axes.plot() 将y对x绘制为线条和/或标记。
• Axes.errorbar 将y和x绘制为线条和/或带有其他误差线的标记。
• Axes.scatter 轴散点图和散点图
• 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 绘制填充的多边形。

跨度（Spans):

• Axes.axhline 在轴上添加一条水平线。
• Axes.axhspan在轴上添加水平跨度（矩形）。
• Axes.axvline在轴上添加一条垂直线。
• Axes.axvspan在轴上添加垂直跨度（矩形）。
• Axes.axline添加无限长的直线。

谱(Spectral)：

• 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之间的互相关。

统计（Statistics):

• Axes.boxplot 制作方框图和晶须图。
• Axes.violinplot 绘制小提琴图。
• Axes.violin 小提琴图的绘制函数。
• Axes.bxp 箱形图和晶须图的绘制函数。

装箱（Binned）：

• Axes.hexbin 绘制点x，y的2D六角形装箱图。
• Axes.hist 绘制直方图。
• Axes.hist2d 绘制2D直方图。

等高线（Contours):

• Axes.clabel标注轮廓图。
• Axes.contour绘制轮廓。
• Axes.contourf绘制轮廓。

数组（Array):

• Axes.imshow 将数据显示为图像，即在2D常规栅格上。
• Axes.matshow 将2D矩阵或数组的值绘制为颜色编码的图像。
• Axes.pcolor 创建具有非规则矩形网格的伪彩色图。
• Axes.pcolorfast 使用非规则矩形网格创建伪色图。
• Axes.pcolormesh 创建具有非规则矩形网格的伪色图。
• Axes.spy 绘制2D阵列的稀疏模式。

非结构三角形（Unstructured Triangles):

• Axes.tripcolor 创建非结构化三角形网格的伪色图。
• Axes.triplot 绘制非结构化的三角形网格作为线和/或标记。
• Axes.tricontour 在非结构化三角形网格上绘制轮廓线。
• Axes.tricontourf 在非结构化三角形网格上绘制轮廓区域。

文字和注释(Text and Annotations)

• Axes.annotate 用文本文本注释点xy。
• Axes.text 将文本添加到轴。
• Axes.table 将表添加到轴。
• Axes.arrow 向轴添加箭头。
• Axes.inset_axes 将子插入轴添加到此现有轴。
• Axes.indicate_inset 向轴添加插入指示器。
• Axes.indicate_inset_zoom 根据inset_ax的轴限制向轴添加插入指示器矩形，并在inset_ax和矩形之间绘制连接器。
• Axes.secondary_xaxis 在此轴上添加第二个x轴。
• Axes.secondary_yaxis 在此轴上添加第二个y轴。

领域(Fields):

• Axes.barbs绘制一个2D倒刺字段。
• Axes.quiver绘制箭头的二维字段。
• Axes.quiverkey将键添加到颤动图。
• Axes.streamplot绘制矢量流的流线。

清除（Clearing):

• Axes.cla 清除当前轴。
• Axes.clear 清除轴。

属性值（Appearance):

• 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设置轴的面色。

轴/极限Axis / limits):

• Axes.get_xaxis返回XAxis实例。
• Axes.get_yaxis返回YAxis实例。

轴限制和方向(Axis Limits and direction)

• Axes.invert_xaxis 反转x轴。
• Axes.xaxis_inverted 返回x轴是否沿“反”方向定向。
• Axes.invert_yaxis 反转y轴。
• Axes.yaxis_inverted 返回yaxis是否沿“反”方向定向。
• 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 [不建议使用]扩展datalim Bbox以包括给定的Bbox。
• Axes.set_xbound 设置x轴的上下边界。
• Axes.get_xbound 以递增顺序返回x轴的上限和下限。
• Axes.set_ybound 设置y轴的上下数字边界。
• Axes.get_ybound 以升序返回y轴的上下边界。

轴标签，标题和图例（Axis Labels, title, and legend）

• Axes.set_xlabel设置x轴的标签。
• Axes.get_xlabel获取xlabel文本字符串。
• Axes.set_ylabel设置y轴的标签。
• Axes.get_ylabel获取ylabel文本字符串。
• Axes.set_title设置轴的标题。
• Axes.get_title获取轴标题。
• Axes.legend在轴上放置图例。
• Axes.get_legend返回图例实例；如果未定义图例，则返回None。

轴刻度(Axis scales)

• Axes.set_xscale设置x轴比例。
• Axes.get_xscale返回x轴的比例（以str表示）。
• Axes.set_yscale设置y轴比例。
• Axes.get_yscale返回yaxis的比例尺（以str表示）。

自动缩放和边距(Autoscaling and margins)

• 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轴的自动缩放

长宽比（Aspect ratio）

• Axes.apply_aspect为指定的数据宽高比调整轴。
• Axes.set_aspect设置轴缩放的方面，
• Axes.get_aspect
• Axes.set_box_aspect设置轴框纵横比。
• Axes.get_box_aspect获取轴框长宽比。
• Axes.set_adjustable设置如何调整轴以实现所需的宽高比。
• Axes.get_adjustable返回轴是否将调整其物理尺寸（“框”）或其数据限制（“ datalim”）以实现所需的宽高比。

刻度和刻度标签（Ticks and tick labels）

• Axes.set_xticks 设置xaxis的刻度位置。
• Axes.get_xticks 返回数据坐标中xaxis的刻度位置。
• Axes.set_xticklabels 设置带有字符串标签列表的xaxis标签。
• Axes.get_xticklabels 获取xaxis的刻度标签。
• Axes.get_xmajorticklabels 以文本列表的形式返回xaxis的主要刻度标签。
• Axes.get_xminorticklabels 作为文本列表返回xaxis的次刻度标签。
• Axes.get_xgridlines 返回xaxis的网格线作为Line2D的列表。
• Axes.get_xticklines 返回xaxis的刻度线作为Line2D的列表。
• Axes.xaxis_date 设置轴刻度和标签，以将沿x轴的数据视为日期。
• Axes.set_yticks 设置yaxis的刻度位置。
• Axes.get_yticks 返回数据坐标中yaxis的刻度位置。
• Axes.set_yticklabels 用字符串标签列表设置yaxis标签。
• Axes.get_yticklabels 获取yaxis的刻度标签。
• Axes.get_ymajorticklabels 返回yaxis的主要刻度标签，作为文本列表。
• Axes.get_yminorticklabels 返回yaxis的次刻度标签，作为文本列表。
• Axes.get_ygridlines 返回yaxis的网格线作为Line2D的列表。
• Axes.get_yticklines 返回yaxis的刻度线作为Line2D的列表。
• Axes.yaxis_date 设置轴刻度和标签，以将沿y轴的数据视为日期。
• Axes.minorticks_off 从轴上删除较小的滴答声。
• Axes.minorticks_on 在轴上显示次刻度。
• Axes.ticklabel_format 配置默认情况下用于线性轴的ScalarFormatter。
• Axes.tick_params 更改刻度线，刻度线标签和网格线的外观。
• Axes.locator_params 控制主要刻度定位器的行为。

还有更多（Units）

Figure 类

matplotlib.figure.Figure

class matplotlib.figure.Figure(figsize=None, dpi=None, facecolor=None, edgecolor=None, linewidth=0.0, frameon=None, subplotpars=None, tight_layout=None, constrained_layout=None)[source]

功能：所有绘图元素的顶层容器。

Figure实例通过作为CallbackRegistry实例的callbacks属性支持回调。 您可以连接的事件是'dpi_changed'，并且回调将通过func（fig）调用，其中fig是Figure实例。

属性：

• patch：表示图形背景不定的Rectangle示例
• suppressComposite: 对于多幅图形图像，图形将根据渲染器option_image_nocomposite函数制作合成图像。 如果preventComposite是布尔值，则它将覆盖渲染器。

参数：

• figsize: 图形尺寸（宽度，高度），以英寸为单位。
• dpi: float: 默认值：rcParams [“ figure.dpi”]（默认值：100.0）每英寸点数。
• facecolor: 默认值：rcParams [“ figure.facecolor”]（默认值：“ white”）图贴面色。
• edgecolor：默认值[“ figure.edgecolor”]（默认值：“ white”）图形补丁边缘颜色。
• line float，线宽
• frameonbool，默认值：rcParams [“ figure.frameon”]（默认值：True），如果为False，则禁止绘制图形背景补丁。
• subplotpars： SubplotParams子图参数。 如果未给出，则使用默认的子图参数rcParams [“ figure.subplot。*”]

方法：

• __ init __：初始化

• add_artist： Add an Artist to the figure.

• add_axes：(self, **args*, **kwargs)

  在图中添加一个轴。

  参数：

  1. rect: 浮点数列表， 新轴尺寸[左，下，宽度，高度]，所有数量均为图形宽度和高度的分数。
  2. projection: 投影
  3. ploar: 布尔值，默认值：False。如果为True，则等效于projection ='polar'。
  4. sharex, sharey：Axes, optional
  5. label：返回值的标签

  返回值：

  • axes:返回的轴类取决于所使用的投影。 如果使用直线投影，则为Axes；如果使用极性投影，则为projections.polar.PolarAxes。

待补充。。。