matplotlib.image和matplotlib.pyplot

matplotlib.image

图像模块支持基本的图像加载、重新缩放和显示操作。
来源：https://www.osgeo.cn/matplotlib/api/image_api.html

类 AxesImage

class matplotlib.image.AxesImage(ax, cmap=None, norm=None, interpolation=None, origin=None, extent=None, filternorm=1, filterrad=4.0, resample=False, **kwargs)

基类：matplotlib.image._ImageBase
插值和CMAP默认为其RC设置
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
范围是数据轴（左、右、下、上），用于将图像绘图注册到数据绘图中。默认设置是使用基于零的行和列索引标记像素中心。
其他Kwarg是Matplotlib.Artist属性

方法

方法	说明
get_cursor_data(event)	获取给定事件的光标数据
get_extent()	获取图像范围：左、右、下、上
get_window_extent(renderer=None)	获取显示空间中的轴边界框。子类应覆盖以包含在边界框“紧密”计算中。默认值是返回0、0处的空边界框。使用此函数时要小心，如果艺术家窗口的范围发生更改，结果将不会更新。范围可能因变换堆栈中的任何更改而更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做）。这可能会导致意想不到的行为，在屏幕上交互式图形看起来很好，但保存不正确。
make_image(renderer, magnification=1.0, unsampled= False)	对该图像的数据进行规范化，重新缩放和颜色映射，以使用渲染器以给定的放大倍数进行 渲染。如果unsampled为True，则不会缩放图像，但是将返回适当的仿射变换。
set_extent(extent)	范围是用于绘制图像绘图的数据轴（左、右、下、上.这将更新ax.datalim，如果自动缩放，则将viewlim设置为与图像紧密匹配，而不考虑datalim。自动缩放状态未更改，因此使用ax.autoscale_视图执行此操作后，将根据datalim重新进行自动缩放。

类 BboxImage

class matplotlib.image.BboxImage(bbox, cmap=None, norm=None, interpolation=None, origin=None, filternorm=1, filterrad=4.0, resample=False, interp_at_native=True, **kwargs)
基类：matplotlib.image._ImageBase
其大小由给定bbox确定的图像类。
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
interp_at_native是一个标志，用于确定当图像以其本机分辨率显示时，是否仍应应用插值。这种方法的一个常见使用案例是，为了注释目的显示图像时；它的处理方式与Photoshop类似（仅当以非本机分辨率显示图像时才使用插值）。
Kwargs是艺术家关键字args的可选列表

contains(mouseevent)

测试鼠标事件是否发生在图像中。

get_transform()

返回 Transform 此艺术家使用的实例。

get_window_extent(renderer=None)[源代码]

获取显示空间中的轴边界框。子类应覆盖以包含在边界框“紧密”计算中。默认值是返回0、0处的空边界框。
使用此函数时要小心，如果艺术家窗口的范围发生更改，结果将不会更新。范围可能因变换堆栈中的任何更改而更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做）。这可能会导致意想不到的行为，在屏幕上交互式图形看起来很好，但保存不正确。

make_image(renderer, magnification=1.0, unsampled=False)

类 FigureImage

class matplotlib.image.FigureImage(fig, cmap=None, norm=None, offsetx=0, offsety=0, origin=None, **kwargs)[源代码]
基类：matplotlib.image._ImageBase
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
Kwargs是艺术家关键字args的可选列表
get_extent()[源代码]
获取图像范围：左、右、下、上
make_image(renderer, magnification=1.0, unsampled=False)
set_data(A)
设置图像数组。
zorder = 0

类 NonUniformImage

class matplotlib.image.NonUniformImage(ax, *, interpolation=‘nearest’, **kwargs)
基类：matplotlib.image.AxesImage
Kwarg与Axesimage的Kwarg相同，只是“最近”和“双线性”是唯一受支持的“插值”选项。

get_extent()

获取图像范围：左、右、下、上

make_image(renderer, magnification=1.0, unsampled=False)

set_array(*args)

保留为向后兼容-使用set_data代替。
参数: A : 类数组

set_cmap(cmap)

为亮度数据设置颜色映射
参数: cmap : 颜色映射或注册的颜色映射名称

set_data(x, y, A)[源代码]

为像素中心和像素值设置网格。
x 和 y 是长度n和m的单调一维Ndarrays，
分别指定像素中心
A 是（m，n）ndarray或屏蔽的值数组
颜色映射，或A（m，n，3）RGB数组，或A（m，n，4）RGBA数组。
set_filternorm(s)[源代码]
设置调整大小过滤器是否规范化权重。
查看帮助 imshow .
参数: 滤波器范数 : 布尔
set_filterrad(s)[源代码]
设置只适用于某些插值方案的调整大小过滤器半径–有关imshow，请参阅帮助
参数: 菲尔特拉德 : 正浮标
set_interpolation(s)[源代码]
参数: s : 没有
“最近”、“双线性”或 None .
set_norm(norm)[源代码]
设置规范化实例。
参数: norm ： Normalize : 归一化

类 PcolorImage

class matplotlib.image.PcolorImage(ax, x=None, y=None, A=None, cmap=None, norm=None, **kwargs)
基类：matplotlib.image.AxesImage
使用不规则的矩形网格绘制PColor样式的绘图。
它使用原始不规则图像代码的变体，并由pcolorfast用于对应的网格类型。
CMAP默认为其RC设置
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
其他Kwarg是Matplotlib.Artist属性
get_cursor_data(event)
获取给定事件的光标数据

make_image(renderer, magnification=1.0, unsampled=False)

set_array(*args)
保留为向后兼容-使用set_data代替。
参数: A : 类数组
set_data(x, y, A)[源代码]
设置矩形边界的网格和数据值。
x 和 y 是长度n+1和m+1的单调一维Ndarrays，
分别指定矩形边界。如果没有，它们将分别创建为从0到n和0到m的均匀数组。
A 是（m，n）ndarray或屏蔽的值数组
颜色映射，或A（m，n，3）RGB数组，或A（m，n，4）RGBA数组。

matplotlib.image.composite_images(images, renderer, magnification=1.0)

将多个rgba图像合成一个。这些图像按它们在 images 名单。
参数: 图像 : 图像列表
每个都必须有一个 make_image 方法。对于每个图像， can_composite 应该返回 True 尽管此函数不强制执行。每个图像必须有一个纯仿射变换，没有剪切。
渲染器 : renderBase实例
放大倍率 : 浮点数
要应用于正在使用的渲染器的附加放大倍数。
返回: 元组 : 图像，偏移量x，偏移量y
返回元组：
图像：与输入图像类型相同的numpy数组。
offset_x，offset_y：输出图形中图像（左，下）的偏移量。

matplotlib.image.imread(fname, format=None)

将文件中的图像读取到数组中。
参数: 文件名 : str或类似文件
要读取的图像文件。这可以是以读二进制模式打开的文件名、URL或类似于python文件的对象。
format : 可选的STR
用于读取数据的图像文件格式。如果没有给出，则从文件名中推断格式。如果无法推导出任何结果，则尝试使用png。
返回: 意象意象 : numpy.array : numpy.array
图像数据。返回的数组具有形状
（m，n）用于灰度图像。
（m，n，3）对于RGB图像。
（m，n，4）对于rgba图像。
笔记
Matplotlib只能本机读取PNG。通过对枕头的可选依赖性支持进一步的图像格式。注意，URL字符串与枕头不兼容。检查 Pillow documentation 更多信息。

matplotlib.image.imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None, origin=None, dpi=100)

将数组另存为图像文件。
可用的输出格式取决于所使用的后端。
参数: 文件名 : str或类似文件
要存储图像的文件名或类似于python文件的对象。从文件扩展名推断出必要的输出格式，但可以使用 格式 .
arr : 类数组
图像数据。形状可以是MXN（亮度）、MXNX3（RGB）或MXNX4（RGBA）之一。
VMN，Vmax : 标量，可选
vmin 和 vmax 通过将映射到颜色映射颜色限制的值固定，设置图像的颜色缩放。如果任一 vmin 或 vmax为“无”，该限制由 arr 最小/最大值。
cmap STR或 Colormap 可选 : str或colormap，可选
颜色映射实例或注册的颜色映射名称。颜色映射将标量数据映射到颜色。对于RGB（A）数据，它被忽略。默认为 rcParams[“image.cmap”] （ViRIDIS）。
format : 可选的STR
文件格式，例如“png”、“pdf”、“svg”、…。如果未给出，则从文件扩展名中推断格式。 文件名 . 见 Figure.savefig 有关详细信息。
origin : ‘upper’、‘lower’，可选
指示是否 (0, 0) 数组的索引位于轴的左上角或左下角。默认为 rcParams[“image.origin”] （上）。
dpi : 利息
要存储在文件元数据中的DPI。这不会影响输出图像的分辨率。

matplotlib.image.pil_to_array(pilImage)

加载A PIL image 并将其作为numpy数组返回。
返回: numpy.array
数组形状取决于图像类型：
（m，n）用于灰度图像。
（m，n，3）对于RGB图像。
（m，n，4）对于rgba图像。

matplotlib.image.thumbnail(infile, thumbfile, scale=0.1, interpolation=‘bilinear’, preview=False)

在中制作图像的缩略图 因循守旧 带输出文件名 拇指文件 .
见 图像缩略图 .
参数: 因循守旧 : str或类似文件
图像文件——必须是PNG，枕头可读，如果您有 Pillow 安装。
拇指文件 : str或类似文件
缩略图文件名。
scale : 可选浮动
缩略图的比例因子。
插值 : 可选的STR
重采样中使用的插值方案。见 插值 参数 imshow 对于可能的值。
预览 : 可选的布尔
如果为真，则将使用默认的后端（可能是用户界面后端），如果 show 被称为。如果为假，则使用 FigureCanvasBase 绘图后端被选为 savefig 通常是这样。
返回: 图形 ： Figure : 图形包含缩略图的Figure实例。

© Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2018 The Matplotlib development team.
最后更新于 7月 02, 2019. Created using Sphinx 1.8.5. Doc version v3.0.3-5-gff4a64cff-dirty.

matplotlib.pyplot

matplotlib.pyplot是Matplotlib的基于状态的接口。它提供了一种类似于matlab的绘图方法。
Pyplot主要用于交互式绘图和程序绘图生成的简单案例：
import numpy as npimport matplotlib.pyplot as plt
x = np.arange(0, 5, 0.1)y = np.sin(x)plt.plot(x, y)
对于更复杂的绘图，建议使用面向对象的API。
功能

方法	说明
acorr （x）	* [, data] ）
angle_spectrum （x） [, Fs, Fc, window, pad_to, …] ）	绘制角度谱。
annotate （S，XY’， * ARGs， * * 克瓦格斯）	注释该点 xy 带文字 s .
arrow \（x，y，dx，dy， * * 克瓦格斯）	向轴添加箭头。
autoscale \ [enable, axis, tight] ）	将轴视图自动缩放为数据（切换）。
autumn （）	将颜色映射设置为“秋季”。
axes \ [arg] ）	将轴添加到当前图形并使其成为当前轴。
axhline \ [y, xmin, xmax] ）	在轴上添加一条水平线。
axhspan \（Ymin，Ymax）[, xmin, xmax] ）	在轴上添加水平跨距（矩形）。
axis * V， * * 克瓦格斯）	获取或设置某些轴属性的方便方法。
axvline \ [x, ymin, ymax] ）	在轴上添加一条垂直线。
axvspan \（xmin、xmax）[, ymin, ymax] ）	在轴上添加一个垂直跨度（矩形）。
bar （x，高度） [, width, bottom, align, data] ）	绘制条形图。
barbs * ARGs [, data] ）	绘制二维倒钩图。
barh \（宽度） [, height, left, align] ）	绘制水平条形图。
bone （）	将颜色映射设置为“骨骼”。
box \ [on] ）	在当前轴上打开或关闭轴框。
boxplot （x） [, notch, sym, vert, whis, …] ）	制作一个盒子和胡须图。
broken_barh \（xranges，yrange， * [, data] ）	绘制水平矩形序列。
cla （）	清除当前轴。
clabel （CS）， * ARGs， * * 克瓦格斯）	标记轮廓图。
clf （	清除当前数字。
clim \ [vmin, vmax]	设置当前图像的颜色限制。
close \ [fig] ）	关闭图形窗口。
cohere （x，y） [, NFFT, Fs, Fc, detrend, …] ）	绘制 x 和 y .
colorbar \ [mappable, cax, ax] ）	在绘图中添加颜色条。
connect （S，FUNC）	用字符串连接事件 s 到 func .
contour * ARGs [, data] ）	绘制等高线。
contourf * ARGs [, data] ）	绘制等高线。
cool （）	将颜色映射设置为“酷”。
copper （）	将颜色映射设置为“铜色”。
csd （x，y） [, NFFT, Fs, Fc, detrend, window, …] ）	绘制交叉光谱密度。
delaxes \ [ax] ）	移除 Axes ax （默认为当前轴）。
disconnect （CID）	断开回拨ID cid
draw （）	重新绘制当前图形。
errorbar （x，y） [, yerr, xerr, fmt, ecolor, …] ）	将Y和X绘制为带有附加误差线的直线和/或标记。
eventplot [职位] [, orientation, …] ）	在给定位置绘制相同的平行线。
figimage * ARGs， * * 克瓦格斯）	将未重新采样的图像添加到图中。
figlegend * ARGs， * * 克瓦格斯）	在图形中放置图例。
fignum_exists （num）	返回具有给定ID的图形是否存在。
figtext （x，y，s） * ARGs， * * 克瓦格斯）	将文本添加到图中。
figure \ [num, figsize, dpi, facecolor, …] ）	创建新图形。
fill * ARGs [, data] ）	绘制填充多边形。
fill_between （x，y1） [, y2, where, …] ）	填充两条水平曲线之间的区域。
fill_betweenx （y，x1） [, x2, where, step, …]	填充两条垂直曲线之间的区域。
findobj \ [o, match, include_self]	查找艺术家对象。
flag （	将颜色映射设置为“标志”。
gca * *	克瓦格斯 得到电流 Axes 当前图形上与给定关键字参数匹配的实例，或创建一个。
gcf （	获取对当前图形的引用。
gci （）	获取当前的着色艺术家。
get_current_fig_manager （）	返回活动图形的图形管理器。
get_figlabels （	返回现有图形标签的列表。
get_fignums （	返回现有数字的列表。
get_plot_commands （）	获取所有打印命令的排序列表。
ginput * ARGs， *	克瓦格斯 阻止调用以与图形交互。
gray （	将颜色映射设置为“灰色”。
grid \ [b, which, axis]	配置网格线。
hexbin （x，y） [, C, gridsize, bins, xscale, …]	做一个六角形的料位图。
hist （x） [, bins, range, density, weights, …]	绘制柱状图。
hist2d （x，y） [, bins, range, normed, weights, …]	绘制二维柱状图。
hlines \（Y、Xmin、Xmax）[, colors, linestyles, …]	在每个位置绘制水平线 y 从 xmin 到 xmax .
hot （	将颜色映射设置为“热”。
hsv （	将颜色映射设置为“hsv”。
imread （FNEXT） [, format] ）	将文件中的图像读取到数组中。
imsave \（fname，arr，	* * 克瓦格斯 将数组另存为图像文件。
imshow （x） [, cmap, norm, aspect, …]	显示图像，即
inferno （	将颜色映射设置为“Inferno”。
install_repl_displayhook （）	安装一个repl显示挂钩，以便在控件返回repl时自动重新绘制任何过时的图形。
ioff （）	关闭交互模式。
ion （）	打开交互模式。
isinteractive （）	返回交互模式的状态。
jet （）	将颜色映射设置为“jet”。
legend * ARGs， * * 克瓦格斯）	在轴上放置图例。
locator_params \ [axis, tight] ）	控制勾号定位器的行为。

loglog * ARGs， * * 克瓦格斯） 在X轴和Y轴上绘制对数比例图。
magma （） 将颜色映射设置为“magma”。
magnitude_spectrum （x） [, Fs, Fc, window, …] ） 绘制幅度谱。
margins * 利润率 [, x, y, tight] ） 设置或检索自动调整页边距。
matshow （a） [, fignum] ） 在新的图形窗口中将数组显示为矩阵。
minorticks_off （） 从轴上删除次要刻度。
minorticks_on （） 在轴上显示小刻度。
nipy_spectral （） 将颜色映射设置为“nipy_spectral”。
pause （区间） 暂停 间隔 秒。
pcolor * ARGs [, alpha, norm, cmap, vmin, …] ） 使用非规则矩形网格创建伪彩色绘图。
pcolormesh * ARGs [, alpha, norm, cmap, vmin, …] ） 使用非规则矩形网格创建伪彩色绘图。
phase_spectrum （x） [, Fs, Fc, window, pad_to, …] ） 绘制相位谱。
pie （x） [, explode, labels, colors, autopct, …] ） 绘制饼图。
pink （） 将颜色映射设置为“粉色”。
plasma （） 将颜色映射设置为“Plasma”。
plot * ARGs [, scalex, scaley, data] ） 绘制Y和X作为直线和/或标记。
plot_date （x，y） [, fmt, tz, xdate, ydate, data] ） 包含日期的绘图数据。
plotfile （FNEXT） [, cols, plotfuncs, comments, …] ） 在文件中绘制数据。
polar * ARGs， * * 克瓦格斯） 绘制极坐标图。
prism （） 将颜色映射设置为“棱镜”。
psd （x） [, NFFT, Fs, Fc, detrend, window, …] ） 绘制功率谱密度。
quiver * ARGs [, data] ） 绘制一个二维箭头字段。
quiverkey \（Q，X，Y，U，标签， * * 千瓦） 在震动图中添加一个键。
rc [（组）， * * 克瓦格斯） 设置当前的rc参数。
rc_context \ [rc, fname] ） 返回用于管理RC设置的上下文管理器。
rcdefaults （） 从matplotlib的内部默认样式恢复rc参数。
rgrids * ARGs， * * 克瓦格斯） 获取或设置当前极坐标图上的径向网格线。
savefig * ARGs， * * 克瓦格斯） 保存当前图形。
sca \（AX） 将当前轴实例设置为 ax .
scatter （x，y） [, s, c, marker, cmap, norm, …] ） 散点图 y VS x 标记大小和/或颜色不同。
sci （IM） 设置当前图像。
semilogx * ARGs， * * 克瓦格斯） 在X轴上绘制对数比例图。
semilogy * ARGs， * * 克瓦格斯） 在Y轴上绘制对数比例图。
set_cmap [（CMAP]） 设置默认颜色映射。
setp （Obj’， * ARGs， * * 克瓦格斯） 在艺术家对象上设置属性。
show * ARGs， * * 千瓦） 显示数字。
specgram （x） [, NFFT, Fs, Fc, detrend, window, …] ） 绘制光谱图。
spring （） 将颜色映射设置为“Spring”。
spy （z） [, precision, marker, markersize, …] ） 绘制二维数组的稀疏模式。
stackplot （x） * ARGs [, data] ） 绘制堆积面积图。
stem * ARGs [, linefmt, markerfmt, basefmt, …] ） 创建一个茎图。
step （x，y）， * ARGs [, where, data] ） 绘制一个步进图。
streamplot \（X、Y、U、V）[, density, linewidth, …] ） 绘制矢量流的流线。
subplot * ARGs， * * 克瓦格斯） 在当前图形中添加子批次。
subplot2grid \（形状，位置[, rowspan, colspan, fig] ） 在规则网格内的特定位置创建轴。
subplot_tool \ [targetfig] ） 启动图的子批次工具窗口。
subplots \ [nrows, ncols, sharex, sharey, …] ） 创建一个数字和一组子批次。
subplots_adjust \ [left, bottom, right, top, …] ） 调整子批次布局。
summer （） 将颜色映射设置为“Summer”。
suptitle \（t） * * 克瓦格斯） 在图形中添加居中的标题。
switch_backend \（新后端） 关闭所有打开的图形并设置matplotlib后端。
table * * 克瓦格斯） 将表格添加到当前轴。
text （x，y，s） [, fontdict, withdash] ） 将文本添加到轴。
thetagrids * ARGs， * * 克瓦格斯） 获取或设置当前极坐标图上的theta网格线。
tick_params \ [axis] ） 更改刻度线、刻度标签和网格线的外观。
ticklabel_format * [, axis, style, …] ） 改变 ScalarFormatter 默认情况下用于线性轴。
tight_layout \ [pad, h_pad, w_pad, rect] ） 自动调整子批次参数以提供指定的填充。
title [标签] [, fontdict, loc, pad] ） 为轴设置标题。
tricontour * ARGs， * * 克瓦格斯） 在非结构化三角形网格上绘制轮廓。
tricontourf * ARGs， * * 克瓦格斯） 在非结构化三角形网格上绘制轮廓。
tripcolor * ARGs， * * 克瓦格斯） 创建一个非结构化三角形网格的伪彩色图。
triplot * ARGs， * * 克瓦格斯） 绘制一个非结构化的三角形网格作为线条和/或标记。
twinx \ [ax] ） 制作共享的第二个轴 x 轴。
twiny \ [ax] ） 制作共享的第二个轴 y 轴。
uninstall_repl_displayhook （） 卸载Matplotlib显示挂钩。
violinplot [数据集] [, positions, vert, …] ） 画出小提琴的情节。
viridis （） 将颜色映射设置为“Viridis”。
vlines \（X、Ymin、Ymax）[, colors, linestyles, …] ） 绘制垂直线。
waitforbuttonpress * ARGs， * * 克瓦格斯） 阻止调用以与图形交互。
winter （） 将颜色映射设置为“冬季”。
xcorr （x，y） [, normed, detrend, usevlines, …] ） 绘制 x 和 y .
xkcd \ [scale, length, randomness] ） 打开 xkcd 草图样式绘制模式。这只对调用此函数后绘制的内容有影响。
xlabel xLab[] [, fontdict, labelpad] ） 设置X轴的标签。
xlim * ARGs， * * 克瓦格斯） 获取或设置当前轴的X限制。
xscale 值（ * * 克瓦格斯） 设置X轴比例。
xticks \ [ticks, labels] ） 获取或设置X轴的当前刻度位置和标签。
ylabel [标签] [, fontdict, labelpad] ） 设置Y轴的标签。
ylim * ARGs， * * 克瓦格斯） 获取或设置当前轴的Y限制。
yscale 值（ * * 克瓦格斯） 设置Y轴比例。
yticks \ [ticks, labels] ） 获取或设置Y轴的当前刻度位置和标签。

© Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2018 The Matplotlib development team.
最后更新于 7月 02, 2019. Created using Sphinx 1.8.5. Doc version v3.0.3-5-gff4a64cff-dirty.