matplotlib 的艺术家显示颜色条
项目描述
为 matplotlib 提供一个新的艺术家来显示颜色条，而不是轴，因为它是 matplotlib 中的默认值。彩条艺术家的位置可以根据图例来决定。
艺术家支持直接从Colorbar对象或 matplotlibrc 进行自定义。
安装
使用pip安装的最简单方法：
$ pip install matplotlib-colorbar
从 git 存储库进行开发安装：
$ git clone git@github.com:ppinard/matplotlib-colorbar.git $ pip install -e matplotlib-colorbar
例子
以下是如何添加颜色条的示例：
>>> import numpy as np
>>> import matplotlib.pyplot as plt
>>> import matplotlib.cbook as cbook
>>> from matplotlib_colorbar.colorbar import Colorbar
>>> plt.figure()
>>> data = np.array(plt.imread(cbook.get_sample_data('grace_hopper.png')))
>>> mappable = plt.imshow(data[...,0], cmap='viridis')
>>> colorbar = Colorbar(mappable, location='lower left')
>>> colorbar.set_ticks([0.0, 0.5, 1.0])
>>> plt.gca().add_artist(colorbar)
>>> plt.show()
颜色条参数
下面是Colorbar类构造函数的参数。
mappable : 实现get_cmap和get_array方法的标量可映射对象（默认值：None，稍后可以指定可映射对象）
label：颜色条顶部的标签（默认值：None，不显示标签）
方向：方向，垂直或水平（默认：垂直）
length_fraction：颜色条的长度作为轴宽度（水平）或高度（垂直）的一部分，具体取决于方向（默认值：0.2）
width_fraction：颜色条的宽度作为轴高度（水平）或宽度（垂直）的一部分，具体取决于方向（默认值：0.02）
location：位置代码（与图例相同）（默认值：右上角）
pad：字体大小的分数（默认值：0.2）
border_pad : 字体大小的分数（默认值：0.1）
sep：颜色条和标签之间的分隔点（默认值：5）
frameon：如果为 True，将在颜色条周围绘制一个框（默认值：True）
color : 刻度文本和标签的颜色（默认值：k）
box_color：盒子的颜色（如果frameon）（默认值：w）
box_alpha : 盒子的透明度（默认值：1.0）
font_properties：标签文本的字体属性，指定为 dict 或fontconfig模式 (XML)。
ticks：刻度位置（默认值：最小值和最大值）
ticklabels ：刻度标签列表（与刻度参数相同的长度）
ticklocation：刻度的位置：left或right用于垂直方向的颜色条，bottom或top 用于水平方向的颜色条，或 ``auto用于自动调整（right用于垂直方向，bottom用于水平方向颜色条）。（默认：自动）
matplotlibrc 参数
以下是可以在 matplotlibrc 文件中自定义的参数。
方向：方向，垂直或水平（默认：垂直）
length_fraction：颜色条的长度作为轴宽度（水平）或高度（垂直）的一部分，具体取决于方向（默认值：0.2）
width_fraction：颜色条的宽度作为轴高度（水平）或宽度（垂直）的一部分，具体取决于方向（默认值：0.02）
location：位置代码（与图例相同）（默认值：右上角）
pad：字体大小的分数（默认值：0.2）
border_pad : 字体大小的分数（默认值：0.1）
sep：颜色条和标签之间的分隔点（默认值：5）
frameon：如果为 True，将在颜色条周围绘制一个框（默认值：True）
color : 刻度文本和标签的颜色（默认值：k）
box_color：盒子的颜色（如果frameon）（默认值：w）
box_alpha : 盒子的透明度（默认值：1.0）
ticklocation：刻度的位置（默认值：auto）
发行说明
0.4
修复 matplotlib 3.x 的错误
删除对 Python 2 和 matplotlib < 3 的支持
使用 pytest-mpl 进行测试
使用黑色代码样式
0.3.6
修复不推荐使用的 is_string_like
0.3.5
修复：UserWarning 对 matplotlib.use() 的调用无效（#9）
贡献者
执照
BSD 许可证下的许可证，与 matplotlib 兼容。
版权所有 (c) 2015-2017 Philippe Pinard
下载文件
下载适用于您平台的文件。如果您不确定要选择哪个，请了解有关安装包的更多信息。