Matplotlib is hiring a Research Software Engineering Fellow! See discourse for details. Apply by January 3, 2020

Version 3.1.1
matplotlib
Fork me on GitHub

目录

Related Topics

colors

有关matplotlib颜色映射的视觉表示,请参见:

  • 这个 颜色 使用matplotlib控制颜色的示例。
  • 这个 颜色 关于控制颜色的深入指南教程。

matplotlib.colors

用于将数字或颜色参数转换为 RGBRGBA

RGBRGBA 分别是3或4个浮点数在0-1范围内的序列。

此模块包括用于颜色规格转换的函数和类,以及用于将数字映射为一维颜色数组(称为颜色映射)中的颜色的函数和类。

使用颜色映射将数据映射到颜色通常需要两个步骤:首先使用子类将数据数组映射到范围0-1 Normalize ,然后使用子类将此数字映射到颜色 Colormap . 这里提供两个: LinearSegmentedColormap ,使用分段线性插值定义颜色映射,以及 ListedColormap 从颜色列表中生成颜色映射。

参见

在Matplotlib中创建颜色映射 例如如何制作彩色地图和

在Matplotlib中选择颜色映射 获取内置颜色映射列表。

颜色映射规范化 有关数据规范化的详细信息

更多颜色地图可在 palettable

该模块还提供检查对象是否可以解释为颜色的功能。 (is_color_like() ,用于将此类对象转换为rgba元组 (to_rgba() )或者像HTML一样的十六进制字符串 #rrggbb 格式 (to_hex() 以及一系列的颜色 (n, 4) RGBA阵列 (to_rgba_array() )缓存用于提高效率。

matplotlib识别以下格式以指定颜色:

  • 中浮点值的rgb或rgba元组 [0, 1] (例如, (0.1, 0.2, 0.5)(0.1, 0.2, 0.5, 0.3)
  • 十六进制rgb或rgb a字符串(例如, '#0F0F0F''#0F0F0F0F'
  • 浮点值的字符串表示形式 [0, 1] 包括灰级(例如, '0.5'
  • 什么之中的一个 {{'b', 'g', 'r', 'c', 'm', 'y', 'k', 'w'}}
  • x11/css4颜色名称;
  • 名字来自 xkcd color survey 前缀 'xkcd:' (例如, 'xkcd:sky blue'
  • 什么之中的一个 {{'tab:blue', 'tab:orange', 'tab:green', 'tab:red', 'tab:purple', 'tab:brown', 'tab:pink', 'tab:gray', 'tab:olive', 'tab:cyan'}} 这是“t10”分类调色板中的表格颜色(默认颜色周期);
  • “CN”颜色规格,即 'C' 后跟一个数字,这是默认属性循环的索引 (matplotlib.rcParams['axes.prop_cycle'] );索引发生在艺术家创建时,如果循环不包括颜色,则默认为黑色。

除“cn”之外,所有颜色的字符串规范都不区分大小写。

Classes

BoundaryNorm \(边界,颜色[, clip] ) 基于离散区间生成颜色映射索引。
Colormap (姓名) [, N] ) 所有标量到rgba映射的基类。
LightSource \ [azdeg, altdeg, hsv_min_val, ...] ) 从指定的方位角和高度创建光源。
LinearSegmentedColormap \(名称,段数据[, ...] ) 基于使用线性段的查找表的颜色映射对象。
ListedColormap [颜色] [, name, N] ) 从颜色列表生成的颜色映射对象。
LogNorm \ [vmin, vmax, clip] ) 以对数刻度将给定值规范化为0-1范围
NoNorm \ [vmin, vmax, clip] ) 对于我们希望直接在 ScalarMappable .
Normalize \ [vmin, vmax, clip] ) 当调用时,可以将数据规范化为 [0.0, 1.0] 间隔。
PowerNorm (γ) [, vmin, vmax, clip] ) 将给定值线性映射到0-1范围,然后在该范围内应用幂律规范化。
SymLogNorm “林阈” [, linscale, vmin, ...] ) 对称对数刻度从原点的正负方向都是对数。

功能

from_levels_and_colors \(级别,颜色[, extend] ) 用于生成cmap和norm实例的helper例程,其行为类似于contourf的级别和颜色参数。
hsv_to_rgb (HSV) 将numpy数组中的hsv值转换为rgb值所有假定在范围内的值 [0, 1]
rgb_to_hsv (ARR) 转换浮动RGB值(在范围内 [0, 1] ,在numpy数组中转换为hsv值。
to_hex (C) [, keep_alpha] ) 转换 c 到十六进制颜色。
to_rgb (c) 转换 c 以RGB颜色,静默地删除alpha通道。
to_rgba (C) [, alpha] ) 转换 c 到rgba颜色。
to_rgba_array (C) [, alpha] ) 转换 c 到(n,4)个rgba颜色数组。
is_color_like (c) 返回是否 c 可以解释为RGB(A)颜色。
makeMappingArray \(n,data) [, gamma] ) 创建一个 N -元素一维查找表
get_named_colors_mapping () 返回名称到命名颜色的全局映射。