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
项目详情
下载文件
下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。