matplotlib.figure.Figure.add_subplot#

Figure.add_subplot(*args, **kwargs)[源]#

将一个 Axes 添加到图形中,作为子图布局的一部分。

调用签名

add_subplot(nrows, ncols, index, **kwargs)
add_subplot(pos, **kwargs)
add_subplot(ax)
add_subplot()
参数:
*args整数, (整数, 整数, 索引), 或 SubplotSpec, 默认值: (1, 1, 1)

由以下之一描述的子图位置

  • 三个整数(nrows, ncols, index)。子图将占据由 nrows 行和 ncols 列组成的网格上的 index 位置。index 从左上角开始,值为 1,然后向右递增。index 也可以是一个二元组,指定子图的(firstlast)索引(从 1 开始,并包含 last),例如,fig.add_subplot(3, 1, (1, 2)) 创建一个占据图形上方 2/3 的子图。

  • 一个三位整数。这些数字将被解释为单独给出的三个一位整数,即 fig.add_subplot(235)fig.add_subplot(2, 3, 5) 相同。请注意,这只能在子图数量不超过 9 个时使用。

  • 一个 SubplotSpec

在极少数情况下,add_subplot 可以只带一个参数调用,该参数是一个已在当前图形中创建但不在图形 Axes 列表中的子图 Axes 实例。

projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, 可选

子图的投影类型(Axes)。str 是自定义投影的名称,请参阅 projections。默认值 None 会生成“rectilinear”(直角坐标系)投影。

polarbool, 默认值: False

如果为 True,相当于 projection='polar'。

axes_classAxes 的子类类型,可选

被实例化的 axes.Axes 子类。此参数与 projectionpolar 不兼容。请参阅 axisartist 获取示例。

sharex, shareyAxes,可选

与 sharex 和/或 sharey 共享 x 或 y 。该轴将与共享 Axes 的轴具有相同的限制、刻度和比例。

label字符串

返回的 Axes 的标签。

返回:
Axes

子图的 Axes(坐标轴)。返回的 Axes 实际上可以是子类的实例,例如用于极坐标投影的 projections.polar.PolarAxes

其他参数:
**kwargs

此方法还接受返回的 Axes 基类的关键字参数;但 figure 参数除外。直角坐标系基类 Axes 的关键字参数可以在下表中找到,但如果使用其他投影,可能还有其他关键字参数。

属性

描述

adjustable

{'box', 'datalim'}

agg_filter

一个过滤函数,它接受一个 (m, n, 3) 浮点数组和一个 dpi 值,并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量

alpha

浮点数或 None

anchor

(float, float) 或 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}

animated

布尔值

aspect

{'auto', 'equal'} 或 float

autoscale_on

布尔值

autoscalex_on

未知

autoscaley_on

未知

axes_locator

Callable[[Axes, Renderer], Bbox]

axisbelow

布尔值 或 'line'

box_aspect

浮点数或 None

clip_box

BboxBase 或 None

clip_on

布尔值

clip_path

Patch 或 (Path, Transform) 或 None

facecolorfc

color

figure

FigureSubFigure

forward_navigation_events

bool 或 "auto"

frame_on

布尔值

gid

字符串

in_layout

布尔值

label

对象

mouseover

布尔值

navigate

布尔值

navigate_mode

未知

path_effects

AbstractPathEffect 列表

picker

None 或 布尔值 或 浮点数 或 可调用对象

位置

[left, bottom, width, height] 或 Bbox

prop_cycle

Cycler

rasterization_zorder

浮点数或 None

rasterized

布尔值

sketch_params

(scale: 浮点数, length: 浮点数, randomness: 浮点数)

snap

布尔值或 None

subplotspec

未知

标题

字符串

transform

变换

url

字符串

可见

布尔值

xbound

(下限: 浮点数, 上限: 浮点数)

xlabel

字符串

xlim

(左侧: 浮点数, 右侧: 浮点数)

xmargin

float 大于 -0.5

xscale

未知

xticklabels

未知

xticks

未知

ybound

(下限: 浮点数, 上限: 浮点数)

ylabel

字符串

ylim

(底部: 浮点数, 顶部: 浮点数)

ymargin

float 大于 -0.5

yscale

未知

yticklabels

未知

yticks

未知

zorder

浮点数

示例

fig = plt.figure()

fig.add_subplot(231)
ax1 = fig.add_subplot(2, 3, 1)  # equivalent but more general

fig.add_subplot(232, frameon=False)  # subplot with no frame
fig.add_subplot(233, projection='polar')  # polar subplot
fig.add_subplot(234, sharex=ax1)  # subplot sharing x-axis with ax1
fig.add_subplot(235, facecolor="red")  # red subplot

ax1.remove()  # delete ax1 from the figure
fig.add_subplot(ax1)  # add ax1 back to the figure

使用 matplotlib.figure.Figure.add_subplot 的示例#

双摆问题

双摆问题

动画三维随机游走

动画三维随机游走

插入定位器演示

插入定位器演示

简单寄生轴2

简单寄生轴2

轴方向

轴方向

轴方向演示

轴方向演示

轴线样式

轴线样式

曲线网格演示

曲线网格演示

曲线网格演示2

曲线网格演示2

floating_axes 特性

floating_axes 特性

浮动轴演示

浮动轴演示

刻度标签对齐

刻度标签对齐

刻度标签方向

刻度标签方向

简单轴方向

简单轴方向

简单轴刻度标签和刻度方向

简单轴刻度标签和刻度方向

简单轴填充

简单轴填充

使用 axisartist 自定义坐标轴脊线

使用 axisartist 自定义坐标轴脊线

简单轴线

简单轴线

简单轴线3

简单轴线3

EventCollection 演示

EventCollection 演示

带直方图的散点图

带直方图的散点图

三维条形图演示

三维条形图演示

在不同平面创建二维条形图

在不同平面创建二维条形图

三维箱体表面图

三维箱体表面图

填充三维线之间

填充三维线之间

创建二维数据的三维直方图

创建二维数据的三维直方图

三维中的二维图像

三维中的二维图像

同一图形中的二维和三维坐标轴

同一图形中的二维和三维坐标轴

在三维图中绘制平面对象

在三维图中绘制平面对象

三维散点图

三维散点图

作为子图的三维图

作为子图的三维图

三维曲面(纯色)

三维曲面(纯色)

极坐标三维曲面

极坐标三维曲面

更多三角三维曲面

更多三角三维曲面

三维线框图

三维线框图

极坐标轴上的误差条渲染

极坐标轴上的误差条渲染

极坐标图例

极坐标图例

极坐标轴上的散点图

极坐标轴上的散点图

重叠坐标轴的平移/缩放事件

重叠坐标轴的平移/缩放事件

Sankey 类

Sankey 类

使用 Sankey 的长连接链

使用 Sankey 的长连接链

朗肯循环

朗肯循环

SkewT-logP 图:使用变换和自定义投影

SkewT-logP 图:使用变换和自定义投影

使用受限布局调整坐标轴大小

使用受限布局调整坐标轴大小

使用紧密布局调整坐标轴大小

使用紧密布局调整坐标轴大小

使用 subplots 和 GridSpec 组合两个子图

使用 subplots 和 GridSpec 组合两个子图

带有可变大小和间距的 GridSpec

带有可变大小和间距的 GridSpec

多列/行子图布局的 GridSpec

多列/行子图布局的 GridSpec

嵌套 GridSpecs

嵌套 GridSpecs

图形子图形

图形子图形

注释极坐标图

注释极坐标图

文本属性

文本属性

带单位的椭圆

带单位的椭圆

CanvasAgg 演示

CanvasAgg 演示

简单图例01

简单图例01

Artist 教程

Artist 教程

变换教程

变换教程

在图中排列多个坐标轴

在图中排列多个坐标轴

约束布局指南

约束布局指南

紧凑布局指南

紧凑布局指南

注解

注解

Matplotlib 中的文本

Matplotlib 中的文本