### Matplotlib `colorbar` 函数参数详解 Matplotlib 的 `plt.colorbar()` 方法用于创建并显示颜色条，通常与图像绘制方法（如 `imshow` 或 `contourf`）配合使用。以下是该函数的主要参数及其功能说明： #### 基本参数 - **mappable**: 这是一个必需的参数，表示要附加颜色条的对象，通常是通过 `imshow`, `pcolormesh`, 或其他绘图命令返回的对象[^1]。 - **ax**: 可选参数，指定颜色条关联的轴对象或轴对象列表。如果未提供，则默认为当前活动的轴。 - **cax**: 可选参数，指定放置颜色条的具体子图区域 (Axes instance)[^1]。 - **use_gridspec**: 如果设置为 `True` 并且提供了 `ax` 参数，则会尝试调整布局以适应网格规格 (GridSpec) 中的颜色条位置。 #### 颜色条尺寸控制参数 - **fraction**: 控制颜色条相对于父级 Axes 对象宽度的比例，默认值为 0.15。较大的数值会使颜色条更宽。 - **pad**: 设置颜色条与其关联图形之间的间距，默认值为 0.05。单位为字体大小的倍数。 - **shrink**: 调整颜色条的高度比例因子，默认值为 1.0 表示不缩放高度。 - **aspect**: 定义颜色条框的纵横比，默认值为 20。较小的值会产生较短而宽的颜色条。 #### 刻度和标签定制参数 - **ticks**: 自定义颜色条上的刻度位置，可以传入一个数组或者 Locator 实例来设定具体的刻度点[^2]。 - **format**: 指定如何格式化颜色条中的数值字符串，接受 Formatter 类型实例作为输入。 - **drawedges**: 是否在分立色彩区间之间画出边界线，默认关闭此选项。 - **orientation**: 设定颜色条的方向，“vertical”代表垂直方向（默认），“horizontal”则对应水平方向。 #### 示例代码展示 下面给出一段综合运用上述部分参数的例子： ```python import numpy as np from matplotlib import pyplot as plt data = np.random.rand(4, 4) im = plt.imshow(data, cmap="viridis") # 创建带有自定义属性的颜色条 cbar = plt.colorbar( im, ax=plt.gca(), orientation='vertical', fraction=0.046, pad=0.04, shrink=1.0, aspect=20, ticks=[0.2, 0.4, 0.6, 0.8], ) # 修改颜色条刻度标签样式 cbar.ax.tick_params(labelsize=10) plt.show() ```