6. matplotlib.colorbar

  1. matplotlib.colorbar模块包含了创建colorbar的一些方法和类。

    • ColorbarBase:绘制colorbar的基类
    • Colorbar:用于imges/contour等的colorbar
    • make_axes():用于调整Axes并向其中添加一个colorbar
  2. matplotlib.colorbar.Colorbar(ax, mappable, **kw)Colorbar类。通常没必要显式调用构造函数,而应该调用下面两个方式:

    • Figure.colorbar(mappable, cax=None, ax=None, use_gridspec=True, **kw)
    • pyplot.colorbar(mappable=None, cax=None, ax=None, **kw)

    参数为:

    • mappable:为Image/ContourSet对象。它是你将要应用colorbar的对象
    • cax:它指定了你将在哪个Axes内绘制colorbar
    • ax:你的新的colorbar Axes从该ax中拿到绘制空间。
    • use_gridspec:一个布尔值。如果cax=None,则如果use_gridspec=True,则创建一个Subplot对象。如果为False,则创建一个Axes对象。

    额外的参数参与设置两个对象:

    • axes对象:

      • orientation :设置为垂直'vertical'还是水平'horizontal'
      • fraction :一个浮点数,指定从原始的Axes中窃取多少倍的空间来绘制colorbar 。默认为 0.15
      • pad :0.05 if vertical, 0.15 if horizontal; 一个浮点数,指定两个Axes的间距
      • shrink : 指定colorbar的伸缩比。默认为 1.0
      • aspect :指定colorbar的长宽比。默认为 20
    • colorbar对象:

      • extend:一个字符串。可以为'neither'/'both'/'min'/'max'。如果不是'neither',则它会在colorbar对应端添加箭头(如果extendrect=False
      • extendfraccolorbar指示超出部分的箭头的长度。
      • extendrect:一个布尔值。如果为True,则超出部分不用箭头。
      • drawedges:一个布尔值,如果为True,则绘制colorbar的边。
      • ticks:给出你要显示哪些tick
      • format:指定格式化方式。可以为格式化字符串如%.3f,或者Formatter对象。

    colorbar colorbar