matplotlib显示颜色条的艺术家
matplotlib-colorbar的Python项目详细描述
为matplotlib提供一个新的艺术家以显示颜色栏, 而不是一个轴,因为它是默认的MatpTLIB。 色条艺术家的位置可以根据传说来决定。
艺术家支持直接从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,不显示标签)
- orientation:方向,vertical或horizontal(默认值:vertical)
- length_fraction:颜色条的长度是轴宽度(水平)或高度(垂直)的一部分,具体取决于方向(默认值:0.2)
- width_fraction:颜色条的宽度,作为轴高度(水平)或宽度(垂直)的一部分,取决于方向(默认值:0.02)
- location:位置代码(与图例相同)(默认值:upper right)
- 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)。
- ticklabels:记号标签列表(与ticks参数长度相同)
- ticklocation:刻度的位置:left或right用于垂直方向的色条,bottom或top for horizontal oriented colorbar, or ``auto用于自动调整(right用于垂直方向的色条,bottom用于水平方向的色条)。(默认值:auto)
matplotlibrc参数
以下是可以在matplotlibrc文件中自定义的参数。
- orientation:方向,vertical或horizontal(默认值:vertical)
- length_fraction:颜色条的长度是轴宽度(水平)或高度(垂直)的一部分,具体取决于方向(默认值:0.2)
- width_fraction:颜色条的宽度,作为轴高度(水平)或宽度(垂直)的一部分,取决于方向(默认值:0.02)
- location:位置代码(与图例相同)(默认值:upper right)
- pad:字体大小的一部分(默认值:0.2)
- border_pad:字体大小的一部分(默认值:0.1)
- sep:颜色条和标签之间的点分隔(默认值:5)
- frameon:如果为true,将在颜色栏周围绘制一个框(默认值:True)
- color:刻度文本和标签的颜色(默认值:k)
- box_color:框的颜色(如果frameon)(默认值:w)
- box_alpha:框的透明度(默认值:1.0)
- ticklocation:记号的位置(默认值:auto)
许可证
bsd许可下的许可证,与matplotlib兼容。
版权所有(c)2015-2017 Philippe Pinard