mpl_toolkits.axes_grid1.axes_grid.ImageGrid#

class mpl_toolkits.axes_grid1.axes_grid.ImageGrid(fig, rect, nrows_ncols, ngrids=None, direction='row', axes_pad=0.02, *, share_all=False, aspect=True, label_mode='L', cbar_mode=None, cbar_location='right', cbar_pad=None, cbar_size='5%', cbar_set_cax=True, axes_class=None)[源代码][源代码]#

基类:Grid

用于图像显示的 Axes 网格。

此类是 Grid 的一个特化,用于显示图像网格。特别是,它强制同一列中的所有轴共享其 x 轴,同一行中的所有轴共享其 y 轴。此外,它还提供了向部分或所有轴添加颜色条的帮助方法。

参数:
fig

父图。

rect(float, float, float, float) 或 int

轴的位置,作为一个 (左, 底, 宽度, 高度) 元组或作为一个三位数的子图位置代码(例如,“121”)。

nrows_ncols(整数, 整数)

网格中的行数和列数。

ngridsint 或 None, 默认: None

如果不是 None,则只创建网格中的前 ngrids 个轴。

方向{"row", "column"}, 默认: "row"

轴是按行优先(“逐行”)还是按列优先(“逐列”)顺序创建的。这也会影响使用索引(grid[index])访问轴的顺序。

axes_padfloat 或 (float, float),默认值:0.02in

轴之间的填充(或水平填充、垂直填充),以英寸为单位。

share_allbool, 默认: False

所有轴是否共享其 x 轴和 y 轴。请注意,在任何情况下,一列中的所有轴共享其 x 轴,一行中的所有轴共享其 y 轴。

方面bool, 默认值: True

轴的纵横比是否跟随数据限制的纵横比。

label_mode{"L", "1", "all"},默认值:"L"

确定哪些轴将获得刻度标签:

  • "L": 左侧列的所有轴获得垂直刻度标签;底部行的所有轴获得水平刻度标签。

  • 只有左下角的坐标轴被标记。

  • "all": 所有轴都被标记。

cbar_modeeach, single, edge, None}, 默认: None

是否为“每个”轴创建一个颜色条,为整个网格创建一个“单一”颜色条,仅为主轴创建颜色条,这些主轴由 cbar_location 确定,或者不创建颜色条。颜色条存储在 cbar_axes 属性中。

cbar_location{"left", "right", "bottom", "top"},默认值:"right"
cbar_pad浮点数,默认值:None

图像轴与颜色条轴之间的填充。

在 3.10 版本发生变更: cbar_mode="single" 如果 cbar_location 是 "left" 或 "bottom",则不再在轴和颜色条之间添加 axes_pad

cbar_size : 尺寸规格(参见 Size.from_any),默认值:"5%"尺寸规格(参见

颜色条大小。

cbar_set_caxbool, 默认值: True

如果为 True,网格中的每个轴都有一个 cax 属性,该属性绑定到关联的 cbar_axes

axes_class : matplotlib.axes.Axes 的子类, 默认: None子类

使用 mpl_toolkits.axes_grid1.axes_grid.ImageGrid 的示例#

演示轴网格

Demo Axes Grid

坐标轴网格2

Axes Grid2

逐行或逐列的颜色条

Per-row or per-column colorbars

具有固定纵横比的 ImageGrid 单元格

ImageGrid cells with a fixed aspect ratio

简单的图像网格

Simple ImageGrid

简单的 ImageGrid 2

Simple ImageGrid 2