Post

Matplotlib Visualization

汇总 Matplotlib 的两种绘图接口、常用图表、样式参数、子图、中文显示与图片保存

Matplotlib Visualization

matplotlib是 Python 中绘图工具,使用时需要导入其中的pyplot模块

1
import matplotlib.pyplot as plt

两种绘图接口

matplotlib有两种使用方式:

  • pyplot接口:直接调用plt.plot()、plt.title()等函数,作用于”当前”的图和坐标系,适合快速画一张简单的图
  • 面向对象接口:先用plt.subplots()得到画布Figure和坐标系Axes对象,再调用对象的方法,有多个子图或需要精细控制时更清晰
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 2 * np.pi, 100)

fig, ax = plt.subplots(figsize=(6, 4))
ax.plot(x, np.sin(x), 'b-', label='sin(x)')
ax.plot(x, np.cos(x), color='red', linestyle='--', label='cos(x)')
ax.set_title('Trigonometric Functions')
ax.set_xlabel('x')
ax.set_ylabel('y')
ax.grid(True, linestyle=':')
ax.legend()

fig.savefig('trig.png', dpi=200, bbox_inches='tight')
plt.show()

示例代码绘制的正弦与余弦曲线

两种接口的绘图函数同名(plot()、scatter()、bar()等),参数也相同,下文的参数说明对两者都适用。设置类的函数名称有所不同

pyplot 接口面向对象接口
plt.title()ax.set_title()
plt.xlabel()ax.set_xlabel()
plt.ylabel()ax.set_ylabel()
plt.xlim()ax.set_xlim()
plt.ylim()ax.set_ylim()
plt.xticks()ax.set_xticks()
plt.legend()ax.legend()
plt.grid()ax.grid()

常用的pyplot函数:

函数作用
figure()创建画布
title()设置标题
xlabel()横坐标名称
ylabel()纵坐标名称
legend()添加图例
plot()绘制线图和散点图
scatter()绘制散点图
bar()绘制垂直条形图和水平条形图
hist()绘制直方图
pie()绘制饼图
grid()绘制网格线
imshow()显示图像
subplots()创建子图
savefig()保存图片
show()显示图形窗口

标题标签参数说明

显示位置(loc)

title()、xlabel()、ylabel()默认均为'center'

title()可设置为'left'、'right'和'center'
xlabel()可设置为:'left'、'right'和'center'
ylabel()可设置为:'bottom'、'top'和'center'

字体大小(fontsize)

可以是数值(单位为磅),也可以是'small'、'medium'、'large'等字符串

绘图

线图

1
2
3
4
# 绘制单条线
plot([x], y, [fmt], *, data=None, **kwargs)
# 绘制多条线
plot([x], y, [fmt], [x2], y2, [fmt2], ..., **kwargs)

参数说明:

参数说明
x、y点或线的节点,x为 x 轴数据,y为 y 轴数据,数据可以是列表或数组
fmt可选参数,定义图的基本属性如
color:线条颜色,可以是颜色名称、十六进制颜色、RGB 值
marker:点型
linestyle:线型
**kwargs设置线条样式
label:线条标签
linewidth:线宽
markersize:点标记大小
markeredgecolor:点标记边缘颜色
markeredgewidth:点标记边缘宽度
markerfacecolor:点标记填充颜色
alpha:透明度
zorder:控制绘图顺序

fmt 接收的是每个属性的单个字母缩写,例如:

1
plot(x, y, 'bo-')  # 蓝色圆点实线

若属性用的是全名则不能用fmt参数来组合赋值,应该用关键字参数对单个属性赋值,如

1
2
plot(x,y,color='green', marker='o', linestyle='dashed', linewidth=1, markersize=6)
plot(x,y,color='#900302',marker='+',linestyle='-')

网格线

1
plt.grid(visible=None, which='major', axis='both', **kwargs)

参数说明

参数说明
visible默认为None,可以设置布尔值,True为显示网格线,False为不显示(旧版本中该参数名为b,已弃用)
which应用更改的网格线,默认为'major'
'major':只应用于主刻度网格线
'minor':只应用于次刻度网格线
'both':同时应用于主刻度和次刻度网格线
axis设置显示哪个方向的网格线,可以是取'both'(默认),'x'或'y',分别表示两个方向
**kwargs设置网格样式
color:网格线的颜色
linestyle:网格线的线型
linewidth:网格线的宽度,单位为点

散点图

1
2
3
plt.scatter(x, y, s=None, c=None, marker=None, cmap=None, norm=None, vmin=None, 
vmax=None, alpha=None, linewidths=None, *, edgecolors=None, plotnonfinite=False,
data=None, **kwargs)

参数说明

参数说明
x、y输入数据,长度相同的数组,绘制散点图的数据点
s点的大小,默认为rcParams['lines.markersize'] ** 2,即 36,也可以是个数组,数组每个参数为对应点的大小
c点的颜色,默认使用颜色循环中的下一个颜色(首个为'C0',即#1f77b4),也可以是 RGB 或 RGBA 二维行数组
marker点的样式,默认为小圆圈'o'
cmap颜色映射,默认为None,用于将数据值映射到特定的颜色范围,c为浮点数数组的时生效。如果没有指定cmap,默认为viridis。显示需要使用plt.colorbar()
norm归一化,默认为None,用于将数据值归一化到[0, 1]的范围,c为浮点数数组的时生效
vmin、vmax颜色映射的数据范围,c为浮点数数组时生效;不能与Normalize实例形式的norm同时传入,否则会报错
alpha透明度设置,0-1 之间,默认为None,即不透明
linewidths标记点边框的线宽
edgecolors颜色或颜色序列,默认为'face',可选值有'face','none',None
plotnonfinite布尔值,设置是否使用非限定的c(inf,-inf或nan)绘制点
**kwargs其他参数

cmap的常用取值如下,名称后加_r表示反转

颜色名称反转色描述
AccentAccent_r强调配色,适合分类数据
BluesBlues_r蓝色渐变,适合连续数据
BrBGBrBG_r棕色到蓝绿色渐变,用于两极数据对比
BuGnBuGn_r蓝色到绿色渐变,用于连续数据
BuPuBuPu_r蓝色到紫色渐变,用于连续数据
CMRmapCMRmap_r基于 CMR 的颜色映射
Dark2Dark2_r暗色系配色,用于分类数据
GnBuGnBu_r绿色到蓝色渐变,用于连续数据
GreensGreens_r绿色渐变,适合连续数据
GreysGreys_r灰色渐变,适合背景或无显著差异数据
OrRdOrRd_r橙色到红色渐变,适合强度数据
OrangesOranges_r橙色渐变,适合连续数据
PRGnPRGn_r紫色到绿色渐变,两极对比
PairedPaired_r配对色,适合分类数据
Pastel1Pastel1_r柔和配色,适合分类数据
Pastel2Pastel2_r柔和配色,适合分类数据
PiYGPiYG_r粉色到黄绿色渐变,两极对比
PuBuPuBu_r紫色到蓝色渐变,用于连续数据
PuBuGnPuBuGn_r紫色到蓝绿色渐变,用于连续数据
PuOrPuOr_r紫色到橙色渐变,两极对比
PuRdPuRd_r紫色到红色渐变,用于连续数据
PurplesPurples_r紫色渐变,适合连续数据
RdBuRdBu_r红色到蓝色渐变,两极对比
RdGyRdGy_r红色到灰色渐变,用于两极对比
RdPuRdPu_r红色到紫色渐变,用于连续数据
RdYlBuRdYlBu_r红色到黄色再到蓝色,用于两极对比
RdYlGnRdYlGn_r红色到黄色再到绿色,用于两极对比
RedsReds_r红色渐变,适合强度或热量数据
Set1Set1_r配色集合 1,适合分类数据
Set2Set2_r配色集合 2,适合分类数据
Set3Set3_r配色集合 3,适合分类数据
SpectralSpectral_r多色渐变,用于连续或离散数据
WistiaWistia_r黄色调渐变,适合特殊效果
YlGnYlGn_r黄色到绿色渐变,用于连续数据
YlGnBuYlGnBu_r黄色到蓝绿色渐变,用于连续数据
YlOrBrYlOrBr_r黄色到橙棕渐变,用于连续数据
YlOrRdYlOrRd_r黄色到橙红渐变,用于强度或热量数据
viridisviridis_r蓝绿黄色调,常用于连续数据,视觉友好
plasmaplasma_r高对比蓝黄渐变,适合连续数据
infernoinferno_r高对比橙黄渐变,适合连续数据
magmamagma_r高对比紫黄渐变,适合连续数据
cividiscividis_r色盲友好的蓝黄色渐变
winterwinter_r蓝绿色渐变,适合连续数据

常用颜色映射的色带

柱形图

1
plt.bar(x, height, width=0.8, bottom=None, *, align='center', data=None, **kwargs)

参数说明

参数说明
x浮点型数组,柱形图的x轴数据
height浮点型数组,柱形图的高度
width浮点型数组,柱形图的宽度
bottom浮点型数组,底座的y坐标,默认为 0
align柱形图与x坐标的对齐方式,默认为'center'以x位置为中心。可选'edge'将柱形图的左边缘与x位置对齐。要对齐右边缘,可以传递负的width
tick_label每个柱体的标签名称
alpha柱状填充颜色的透明度
edgecolor柱体的边框颜色
linewidth柱体边框线的宽度

水平方向的柱形图可以使用plt.barh()

饼图

1
2
3
4
plt.pie(x, explode=None, labels=None, colors=None, autopct=None, pctdistance=0.6, 
shadow=False, labeldistance=1.1, startangle=0, radius=1, counterclock=True, 
wedgeprops=None, textprops=None, center=(0, 0), frame=False, rotatelabels=False, 
*, normalize=True, data=None)

参数说明

参数说明
x浮点型数组或列表,用于绘制饼图的数据
explode数组,各个扇形之间的间隔,默认为 0
labels列表,各个扇形的标签,默认为 None
colors数组,各个扇形的颜色,默认为 None
autopct设置饼图内各个扇形百分比显示格式,%d%%整数百分比,%0.1f一位小数,%0.1f%%一位小数百分比,%0.2f%%两位小数百分比
labeldistance标签标记的绘制位置,相对于半径的比例,默认值为1.1,如<1则绘制在饼图内侧
pctdistance类似labeldistance,指定autopct的位置刻度,默认为0.6
shadow布尔值,设置饼图的阴影,默认为False,不设置阴影
radius设置饼图的半径,默认为1
startangle指定饼图的起始角度,默认为从x轴正方向逆时针画起,如设定=90则从y轴正方向画起
counterclock布尔值,指定是否逆时针绘制扇形,默认为True逆时针绘制
wedgeprops字典类型,默认为None。指定扇形的属性
linewidth:扇形边界线的宽度
edgecolor:扇形边界线的颜色,默认不绘制边界线
antialiased:布尔值,默认为True,对扇形边界进行抗锯齿处理
linestyle:边界线的线型,默认为'-'
hatch:扇形的填充图案(如'/','\\','-',' '等,支持组合)
textprops字典类型,指定文本标签的属性,默认为None
fontsize:文本字体大小,可以是整数或字符串(如'small','medium','large'等)默认值由Matplotlib配置决定
color:文本颜色,默认为'black',支持颜色名称、十六进制值、RGB 值或 RGBA 值
weight:字体粗细,默认为'normal',常用值有'normal','bold','light'
style:字体样式,默认为'normal',常用值有'normal','italic','oblique'
family:字体系列,如'serif','sans-serif','monospace'等,使用Matplotlib默认字体
verticalalignment:文本垂直对齐方式,默认为'center',可选'center','top','bottom'
horizontalalignment:文本水平对齐方式,默认为'center',可选'center','left','right'
rotation:文本旋转角度,以度为单位,正值为逆时针,负值为顺时针,默认值由布局决定
center浮点型列表,指定饼图的中心位置,默认(0,0)
frame布尔类型,指定是否绘制饼图的边框,默认False不绘制带有表的轴框架
rotatelabels布尔类型,指定是否旋转文本标签,默认为False不旋转
normalize布尔类型,默认为True,指定是否对输入的数据进行归一化处理,为True会将所有值的和归一化为1.0,然后按比例绘制饼图
data指定数据。如果设置data参数,则可以直接使用数据框中的列作为x、labels等参数的值,无需再次传递

除此之外,pie()函数还可以返回三个参数

返回值说明
wedges包含扇形对象的列表
texts一个包含文本标签对象的列表
autotexts一个包含自动生成的文本标签对象的列表

直方图

1
2
3
plt.hist(x, bins=None, range=None, density=False, weights=None, cumulative=False, 
bottom=None, histtype='bar', align='mid', orientation='vertical', rwidth=None, 
log=False, color=None, label=None, stacked=False, **kwargs)

参数说明

参数说明
x要绘制直方图的数据,一维数组或列表
bins直方图的箱数。默认为 10
range直方图的值域范围,二元数组或列表。默认为None,即使用数据中的最小值和最大值
density是否将直方图归一化。默认为False,即直方图的高度为每个箱子内的样本数,而不是频率或概率密度
weights每个数据点的权重,默认为None
cumulative是否绘制累积分布图。默认为False
bottom直方图的起始高度。默认为None
histtype直方图的类型,默认为'bar',可选
'bar':传统柱状图
'barstacked':堆叠柱状图
'step':无填充的折线图
'stepfilled':有填充的折线图
align直方图箱子的对齐方式,默认为'mid',可以是'left'、'mid'、'right'
orientation直方图方向,默认为'vertical',可以是'vertical'、'horizontal'
rwidth柱体宽度占箱子宽度的比例(0 到 1 之间),默认为None,即柱体之间没有间隙
log是否在 y 轴上使用对数刻度,默认为False
color直方图的颜色
label直方图的标签
stacked是否堆叠不同的直方图,默认为False
**kwargs可选参数
edgecolor:柱体边框颜色,默认不绘制边框
linewidth:柱体边框线宽(单位:点),默认由rcParams['patch.linewidth']决定(1.0)
linestyle:柱体边框的线型,默认为'-'实线
alpha:透明度(0.0 到 1.0),值越小越透明,默认为None,即不透明
hatch:填充图案
color:柱体颜色,可以是单个值或颜色列表,默认使用颜色循环中的下一个颜色(首个为'C0')

设置参数

常用的标记、线型与填充图案

颜色字符(color)

取值含义
'b'或'blue'蓝色
'm'或'magenta'洋红色
'g'或'green'绿色
'y'或'yellow'黄色
'r'或'red'红色
'k'或'black'黑色
'w'或'white'白色
'c'或'cyan'青绿色
#008000RGB 颜色字符串。多条曲线不指定颜色时,会自动选择不同颜色
(0.1, 0.2, 0.5)或(0.1, 0.2, 0.5, 0.8)RGB 或 RGBA 值
'0.5'灰色

线型参数(linestyle)

取值含义
'-'或'solid'实线
'--'或'dashed'虚线
'-.'或'dashdot'点划线
':'或'dotted'点线
'None'、' '或''不划线

标记字符(marker)

取值含义
'.'点
','像素点
'o'实心圆
'v'下三角
'^'上三角
'<'左三角
'>'右三角
'1'下三叉
'2'上三叉
'3'左三叉
'4'右三叉
'8'八角形
's'正方形
'p'五边形
'P'加号(填充)
'*'星号
'h'六边形 1
'H'六边形 2
'+'加号
'x'乘号 x
'X'乘号 x (填充)
'D'菱形
'd'瘦菱形
'|'竖线
'_'横线
0左横线
1右横线
2上竖线
3下竖线
4左箭头
5右箭头
6上箭头
7下箭头
8左箭头 (中间点为基准)
9右箭头 (中间点为基准)
10上箭头 (中间点为基准)
11下箭头 (中间点为基准)
None,' ',''没有任何标记
$...$渲染指定的字符。例如'$f$'以字母f为标记

填充图案(hatch)

取值含义
'/'斜线
'\'反斜线
'-'横线
'|'竖线
'+'十字线
'x'交叉线
'o'圆圈
'.'点
'*'星形
'-/--'可重复符号形成更密集的图案

绘制多图

subplot()在绘图时需要指定位置,subplots()可以一次生成多个,在调用时只需要调用生成对象的ax即可

subplot()

1
2
3
4
plt.subplot(nrows, ncols, index, **kwargs)
plt.subplot(pos, **kwargs)
plt.subplot(**kwargs)
plt.subplot(ax)

以上函数将整个绘图区域分成nrows行和ncols列,然后从左到右,从上到下的顺序对每个子区域进行编号1...N,左上的子区域的编号为 1、右下的区域编号为 N,编号可以通过参数index来设置

subplots()

1
2
plt.subplots(nrows=1, ncols=1, *, sharex=False, sharey=False, squeeze=True, 
subplot_kw=None, gridspec_kw=None, **fig_kw)

参数说明

参数说明
nrows默认为 1,设置图表的行数
ncols默认为 1,设置图表的列数
sharex、sharey设置x、y轴是否共享属性,默认为False,可设置为'none'、'all'、'row'或'col'。none每个子图的x轴或y轴都是独立的,'all'所有子图共享x轴或y轴,'row'设置每个子图行共享一个x轴或y轴,'col'每个子图列共享一个x轴或y轴
squeeze默认为True,表示额外的维度从返回的 Axes(轴)对象中挤出,对于N*1或1*N个子图,返回一个 1 维数组,对于N*M,N>1和M>1返回一个 2 维数组。如果设置为False,则不进行挤压操作,返回一个元素为 Axes 实例的 2 维数组,即使它最终是 1x1
subplot_kw把字典的关键字传递给add_subplot()来创建每个子图
gridspec_kw把字典的关键字传递给GridSpec构造函数创建子图放在网格里
**fig_kw把详细的关键字参数传给figure()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import matplotlib.pyplot as plt
import numpy as np

rng = np.random.default_rng(0)
x = np.linspace(0, 2 * np.pi, 50)

fig, axes = plt.subplots(2, 2, figsize=(8, 6))

axes[0, 0].plot(x, np.sin(x), 'b-', label='sin(x)')
axes[0, 0].plot(x, np.cos(x), 'r--', label='cos(x)')
axes[0, 0].set_title('plot')
axes[0, 0].legend()

points = rng.normal(size=(100, 2))
axes[0, 1].scatter(points[:, 0], points[:, 1], c=points[:, 0], cmap='viridis', s=20)
axes[0, 1].set_title('scatter')

axes[1, 0].bar(['A', 'B', 'C', 'D'], [3, 7, 5, 2], color='C1', edgecolor='black')
axes[1, 0].set_title('bar')

axes[1, 1].hist(rng.normal(size=1000), bins=30, color='C2', alpha=0.8)
axes[1, 1].set_title('hist')

fig.tight_layout()
fig.savefig('subplots.png', dpi=150)

2x2 子图:线图、散点图、柱形图与直方图

多个子图的标题和坐标轴标签容易重叠,fig.tight_layout()会自动调整子图间距

保存图片

1
fig.savefig(fname, dpi='figure', bbox_inches=None, transparent=False)

参数说明

参数说明
fname文件路径,格式由扩展名决定,支持png、jpg、pdf、svg等。pdf和svg为矢量图,放大不失真
dpi分辨率,默认使用画布的dpi(100),用于文档或印刷时可设为 200 到 300
bbox_inches设为'tight'时自动裁掉四周多余的空白
transparent设为True时背景透明

savefig()要在show()之前调用,窗口关闭后画布内容会被清空,之后保存得到的是空白图片

显示中文

默认字体不包含中文字形,标题和标签中的中文会显示为方框,需要指定一个已安装的中文字体

1
2
plt.rcParams['font.sans-serif'] = ['Noto Sans CJK SC', 'Noto Sans CJK JP', 'SimHei', 'Microsoft YaHei']
plt.rcParams['axes.unicode_minus'] = False
  • font.sans-serif是一个按顺序查找的字体列表,Windows 自带SimHei和Microsoft YaHei;Ubuntu 可通过sudo apt install fonts-noto-cjk安装Noto Sans CJK,较旧版本的matplotlib只能识别该字体文件中的第一个字体,注册的名称是Noto Sans CJK JP,同样包含简体中文字形
  • axes.unicode_minus设为False后负号使用普通的连字符,避免部分中文字体中负号显示为方框
1
2
3
from matplotlib import font_manager

print(sorted({font.name for font in font_manager.fontManager.ttflist}))
This post is licensed under CC BY 4.0 by the author.