1、matplotlib函数手册星猫译函数 介绍acorr Plot the autocorrelation of x.绘制 X 的自相关annotateCreate an annotation: a piece of text referring to a data point.用箭头在指定的一个数据点创建一个注释或一段文本。arrow Add an arrow to the axes.为 axes添加一个箭头。autoscaleAutoscale the axis view to the data (toggle).自动缩放轴视图的数据（切换）。axes Add an axes to the
2、figure.为当前 figure添加一个 axes。axhlineAdd a horizontal line across the axis.添加一条穿越 axis的水平线。axhspanAdd a horizontal span (rectangle) across the axis.添加一条穿越 axis的水平矩形。axisConvenience method to get or set axis properties.获取或设置轴属性的便捷方法。axvline Add a vertical line across the axes.添加一条穿越 axes的垂线。axvspanAdd a
3、 vertical span (rectangle) across the axes.添加一个与axes交叉的垂直跨度（矩形）。bar Make a bar plot.做一个垂直条形图。barbs Plot a 2-D field of barbs.绘制一个倒钩的二维场（风场）。barh Make a horizontal bar plot.做一个横向条形图。box Turn the axes box on or off.打开或关闭主轴箱。boxplot Make a box and whisker plot.使一盒须图。broken_barh Plot horizontal bars.绘制水
4、平杆。cla Clear the current axes.清除当前 axes。clabelLabel a contour plot.为等值线图设标签clf Clear the current figure.清除当前 figure。climSet the color limits of the current image.设置当前图像的颜色取值范围。close Close a figure window.关闭 figure窗口。coherePlot the coherence between x and y.绘制 X和 Y之间的相关性分析 colorbar Add a colorbar to
5、a plot.为图添加彩条标值。contour Plot contours.绘制等值线。contourf Plot contours.绘制填充等值线。csd Plot cross-spectral density.绘制交叉谱密度。delaxesRemove an axes from the current figure.从目前的 figure删除axes。draw Redraw the current figure.再次绘制当前 figure。errorbar Plot an errorbar graph.绘制 errorbar图。eventplotPlot identical paralle
6、l lines at specific positions.在特定的位置绘制相同的平行线。figimageAdds a non-resampled image to the figure.为 figure添加一个非重采样图像。figlegend Place a legend in the figure.为 figure放置一个标注（legend）figtext Add text to figure.为 figure添加文字。figure Creates a new figure.创建一个新的 figure。fill Plot filled polygons.绘制填充多边形。fill_betwe
7、en Make filled polygons between two curves.使两曲线间填充色彩。fill_betweenxMake filled polygons between two horizontal curves.使两水平线间填充色彩。findobj Find artist objects.发现 artist对象。gcaReturn the current axis instance.返回当前轴实例（axis instance）。gcfReturn a reference to the current figure.返回当前 figure的序号。gci Get the cu
8、rrent colorable artist.获取当前彩条的 artist。get_figlabelsReturn a list of existing figure labels.返回一个当前 figure的标签列表。get_fignumsReturn a list of existing figure numbers.返回一系列 figure的序号。grid(on/off) Turn the axes grids on or off.打开或关闭坐标网格。hexbin Make a hexagonal binning plot.做一个六边形箱图。hist Plot a histogram.绘
9、制直方图。hist2d Make a 2D histogram plot.使一个二维直方图。hlines Plot horizontal lines.绘制水平线。hold Set the hold state.设置 hold状态。imreadRead an image from a file into an array.读取一个图像，从图形文件中提取数组。imsave Save an array as in image file.保存为图像文件中的数组。imshow Display an image on the axes.在 axes上显示图像。ioff Turn interactive m
10、ode off. 关闭互动模式。ion Turn interactive mode on.开启互动模式。isholdReturn the hold status of the current axes.返回当前 axes的hold状态。isinteractive Return status of interactive mode.返回互动模式状态。legend Place a legend on the current axes.为当前 axes放置标注。locator_params Control behavior of tick locators.控制轴刻度标签loglogMake a p
11、lot with log scaling on both the x and y axis.使 X、Y轴为 log刻度。margins Set or retrieve autoscaling margins.设置或检索自动缩放功能。matshowDisplay an array as a matrix in a new figure window.在新figure窗口显示数组矩阵minorticks_offRemove minor ticks from the current plot.移除当前数轴上的次刻度minorticks_onDisplay minor ticks on the cur
12、rent plot.显示当前数轴上的次刻度overCall a function with hold(True).调用一个函数，并且 hold为（True）。pause Pause for interval seconds.Pause的时间间隔（秒）。pcolorCreate a pseudocolor plot of a 2-D array.创建一个二维阵列的伪彩色图。pcolormesh Plot a quadrilateral mesh.绘制一个四边形网格。pie Plot a pie chart.绘制一个饼图。plot Plot lines and/or markers to the
13、Axes.绘制当前 axes。plot_date Plot with data with dates.绘制数据日期。plotfile Plot the data in in a file.将图绘入文件polar Make a polar plot.绘制极坐标图。psd Plot the power spectral density.绘制功率谱密度图。quiver Plot a 2-D field of arrows.绘制二维箭头图（风矢量图）。quiverkey Add a key to a quiver plot.为风矢量图绘制单位标量rc Set the current rc params
14、.设置当前的 RC参数。rc_contextReturn a context manager for managing rc settings.返回一个用于管理 RC设置上下文管理器。rcdefaults Restore the default rc params.恢复默认的 RC参数。rgridsGet or set the radial gridlines on a polar plot.获取或设置径向网格在极坐标图。savefig Save the current figure.保存当前图。scaSet the current Axes instance to ax.为 ax设置当前（a
15、xes）轴实例。scatterMake a scatter plot of x vs y, where x and y are sequence like objects of the same lengths.做一个 X和 Y的散点图，其中X和 Y是相同长度的序列的对象。sci Set the current image.设置当前的图像。semilogx Make a plot with log scaling on the x axis.使 x轴为 log刻度。semilogy Make a plot with log scaling on the y axis.使 y轴为 log刻度。s
16、et_cmap Set the default colormap.设置默认的 colormap。setp Set a property on an artist object.对 artist对象设置属性。show Display a figure.显示图。specgram Plot a spectrogram.绘制谱图。spyPlot the sparsity pattern on a 2-D array.绘制一个二维阵列的稀疏模式。stackplot Draws a stacked area plot.绘制一个堆叠面积图。stem Create a stem plot.创造一个 stem图
17、。step Make a step plot.做一个步阶图streamplot Draws streamlines of a vector flow.绘制一个流场图。subplotReturn a subplot axes positioned by the given grid definition.返回一个 subplot axessubplot2grid Create a subplot in a grid.在网格中创建一个 subplot。subplot_toolLaunch a subplot tool window for a figure.获取 subplot工具窗口。subpl
18、otsCreate a figure with a set of subplots already made.一个图中包含多个子图subplots_adjust Tune the subplot layout.调整 subplot布局suptitle Add a centered title to the figure.在图添加一个中心标题。switch_backend Switch the default backend.交换机默认的后台。table Add a table to the current axes.当前 axes添加 table。text Add text to the ax
19、es.在轴上添加文本。thetagridsGet or set the theta locations of the gridlines in a polar plot.设置极坐标网格线 位置。tick_paramsChange the appearance of ticks and tick labels.改变刻度及刻度标签外观ticklabel_formatChange the ScalarFormatter used by default for linear axes.通过使用默认线性 axes轴更改 scalarformatter 。tight_layoutAutomatically
20、 adjust subplot parameters to give specified padding.自动调节 subplot参数进行指定填充。title Set a title of the current axes.设置当前 axes标题。tricontourDraw contours on an unstructured triangular grid.在非结构三角形网格绘制等值线。tricontourfDraw contours on an unstructured triangular grid.在非结构三角形网格绘制填充等值线。tripcolorCreate a pseudoc
21、olor plot of an unstructured triangular grid.创建一个非结构三角形网格伪彩色图。triplotDraw a unstructured triangular grid as lines and/or markers.画一个非结构三角形网格图（类似 plot函数）。twinxMake a second axes that shares the x-axis.制作第二个 axes，并共用 x轴。twinyMake a second axes that shares the y-axis.制作第二个 axes，并共用 y轴。vlines Plot verti
22、cal lines.绘制垂直线。xcorrPlot the cross correlation between x and y.绘制 x和 y的相关性分析图xkcdTurns on xkcd sketch-style drawing mode.开启 XKCD 草图风格绘画模。xlabelSet the x axis label of the current axis.在当前轴设置 X轴的标签。xlimGet or set the x limits of the current axes.设置当前 axes的x轴取值范围xscale Set the scaling of the x-axis.设
23、置 X 轴缩放。xticksGet or set the x-limits of the current tick locations and labels.设置当前 x轴刻度位置的标签和值。ylabelSet the y axis label of the current axis.设置当前轴 y 轴标签。ylimGet or set the y-limits of the current axes.设置当前 axes的y轴取值范围yscale Set the scaling of the y-axis.设置 Y 轴缩放。yticksGet or set the y-limits of th
24、e current tick locations and labels.设置当前 y轴刻度位置的标签和值。函数：1. matplotlib.pyplot.acorr(x, hold=None, *kwargs)自相关函数acorr(x, normed=True, detrend=mlab.detrend_none, usevlines=True, maxlags=10, *kwargs) #x的 自 相 关如果 normed = True,通过零滞后自相关规范数据，x 通过非趋势可调用（默认没有归一化）的方式除趋势数据绘制形如 plot(lags, c, *kwargs)返回值是元组(lags
25、, c, line)，其中：￥lags 是一个长度为 2maxlags + 1的滞后（lags）向量￥C 是 2maxlags + 1的自相关向量￥line 是一个 line2d实例，通过 plot()返回默认 linestyle是 None，默认的 marker是o，交叉相关性是通过 numpy.correlate()函数、mode = 2 实现的。若 usevlines是 True, vlines()将被调用（而不调用 plot()函数），用来绘制从起点到 acorr的垂线。否则，plot（）由 Line2D properties属性参数（kwargs）决定。maxlags是正整数，决定
26、lags的显示数目。默认值 None将返回（2len（x）- 1）个 lags，返回值是一个元组(lags, c, linecol, b)，其中：linecol是 linecollectionb是 x-axis其他参数参见 Line2D的 kwargs 属性2 . matplotlib.pyplot.annotate(*args, *kwargs)创建一个文本注释：从指定点指向目标点annotate(注 释 内 容 , xy, xytext=None,xycoords=data,textcoords=data, arrowprops=None, *kwargs)xy：被注释点的位置，xytex
27、t：注释文本的位置坐标xycoords 和 textcoords 是字符串，指示 xy 和 xytext 的坐标关系：Property Descriptionfigure pointspoints from the lower left corner of the figure起点从 figure 左下角figure pixelspixels from the lower left corner of the figurepixels（像素）从 figure 左下角figure fraction0,0 is lower left of figure and 1,1 is upper right
28、（0，0）是 figure 的左下方，（1，1）是右上方axes points points from lower left corner of axes 起点从 axes 的左下方axes pixels pixels from lower left corner of axespixels（像素）从 axes 左下角axes fraction0,0 is lower left of axes and 1,1 is upper right（0，0）是 axes 的左下方，（1，1）是右上方datause the coordinate system of the object being ann
29、otated (default)使用被注释对象的坐标系统offset pointsSpecify an offset (in points) from the xy value从 xy 点指定一个偏移量polaryou can specify theta, r for the annotation, even in cartesian plots. Note that if you are using a polar axes, you do not need to specify polar for the coordinate system since that is the native
30、 “data” coordinate system.即使在直角坐标系，也可以指定（，r) 的值。如果使用极坐标，不需要指定极点通用箭头属性：Key Descriptionwidth the width of the arrow in points 箭头宽度fracthe fraction of the arrow length occupied by the head箭头尖端（头部）所占比例headwidththe width of the base of the arrow head in points箭头尖端的尾部宽度shrinkoftentimes it is convenient to
31、 have the arrowtip and base a bit away from the text and point being annotated. If d is the distance between the text and annotated point, shrink will shorten the arrow so the tip and base are shink percent of the distance d away from the endpoints. ie, shrink=0.05 is 5%缩短箭头，以容纳文字。Shrink=0.05 表示缩短 5
32、%?kwargs any key for matplotlib.patches.polygon通用绘图参数，包括facecolor、alpha 等，可查询 kwargs 表格。花式箭头参数：Key Descriptionarrowstyle the arrow style 箭头风格connectionstyle the connection stylerelpos default is (0.5, 0.5) 默认（0.5，0.5）patchA default is bounding box of the text 默认边界框patchB default is None 默认无shrinkA d
33、efault is 2 points 默认 2shrinkB default is 2 points 默认 2mutation_scale default is text size (in points) 默认为字体大小mutation_aspect default is 1. 默认为 1? any key for matplotlib.patches.PathPatch其他参数参见 kwargs3. matplotlib.pyplot.arrow(x, y, dx, dy, hold=None, *kwargs)为 axes 添加箭头arrow(x, y, dx, dy, *kwargs)绘
34、制指定的箭头从（ X， Y）指向（ X + Y + dx， dy）。常用的参数：width（箭头尾部宽度）: 浮点数 (默认: 0.001) length_includes_head（length 值是否包含 head箭头尖部）:True | False (默认: False)head_width（箭 头 head 宽度）: float（浮点数）或 None (默认: 3*width)head_length: float（浮点数）或 None (默认: 1.5 * head_width)shape（箭 头形状）:full(完整的 ), left(左半部分), right(右半部分) (defa
35、ult: full)overhang（箭头尖端形状）: float（浮点数） (默认: 0)可以是负值，也可以大于 1head_starts_at_zero:True | False (默认: False)如果为 True，箭头尖部起点在坐标 0 点，而 False 则终点在坐标 0 点其他参数 参见 matplotlib.patches.Polygon 实例。4. matplotlib.pyplot.autoscale(enable=True, axis=both, tight=None)自动缩放轴视图的数据（切换）， 方便简单的轴视图自动缩放的方法。enable: True | False
36、 | NoneTrue（默认）开启自动缩放，False 关闭， None 离开（自 动缩放状态不改变）axis: x | y | both 选择缩放的轴线，默认bothtight: True | False | None如果 True，根据 data 范围设置视角（view）范围；若为 False，可扩大视角范围；若为 None，只有一个 data 时，按True 处理，其他按 False 对待返回 None5. matplotlib.pyplot.autumn()对 autumn()函数设置默认的 colormap，并应用于当前图像。更多信息查询help(colormaps)。6. matp
37、lotlib.pyplot.axes(*args, *kwargs)对 figure 增加一个 axes由 rect 指定 axes 添加的位置：axes() 创建一个默认的完整的 subplot（111）图轴。axes(rect, axisbg=w)其中 rect = left, bottom, width, height（四个参数取值范围为0,1）axisbg 指背景颜色，默认为 whiteaxes(h) 其中 h 指 axes 实例，包含下列参数：kwarg Accepts Descriptionaxisbg color Axes 图轴背景色frameon True|False 是否绘制
38、图像框架sharex otherax 当前 axes 图轴是否与其它图轴共用 x 轴sharey otherax 当前 axes 图轴是否与其它图轴共用 y 轴polar True|False 使用极坐标轴?7.matplotlib.pyplot.axhline(y=0, xmin=0, xmax=1, hold=None, *kwargs)添加一条穿越 axis 的水平线。axhline(y=0, xmin=0, xmax=1, *kwargs)绘制一条从 xmin 到 xmax 的水平线，其中 0=left, 0.5=middle, 1.0=right，而水平线的长度视水平轴长度而定。该函
39、数返回值为 Line2D（二维曲线）参量，详情查询 Line2D属性。8.matplotlib.pyplot.axhspan(ymin, ymax, xmin=0, xmax=1, hold=None, *kwargs) 添加一条穿越 axis 的水平 span（矩形）。其中 x 轴方向： 0=left, 0.5=middle, 1.0=right，水平线的长度视水平轴长度而定。而 y 轴则根据坐标点确定。返回值为 matplotlib.patches.Polygon实例，详情查询m atplotlib.patches.Polygon 9. matplotlib.pyplot.axis(*v,
40、 *kwargs)获取或设置轴属性的便捷方法。没有输入调用变量: axis() #返 回 当 前 axes范 围 （ limits） xmin, xmax, ymin, ymax.通过输入 v = xmin, xmax, ymin, ymax. 设置 x、y 的取值范围 axis(v) axis(off) #关 闭 轴 线 极 其 标 签 axis(equal) #使 x、 y轴 长 度 一 致 axis(scaled) #调 整 图 框 的 尺 寸 （ 而 不 是 改 变 坐 标 轴 取 值 范 围 ） ， 使 x、 y轴长 度 一 致 axis(tight) #改 变 X和 Y轴 的 限
41、制 ， 使 所 有 数 据 被 展 示 。 如 果 所 有 的 数 据已 经 显 示 ， 它 将 移 动 到 图 形 的 中 心 而 不 修 改 （ XMAX - XMIN） 或 （ YMAX - Ymin） 。 axis(image) #缩 放 axis范 围 （ limits） ， 等 同 于 对 data缩 放 范 围 axis(auto) axis(normal)不推荐使用。他们恢复默认状态；轴限的自动缩放以使数据合适地在图中。10.matplotlib.pyplot.axvline(x=0, ymin=0, ymax=1, hold=None, *kwargs)添加一条穿越 axes
42、 的垂线。axvline(x=0, ymin=0, ymax=1, *kwargs)绘制一条从 ymin 到 ymax 的水平线，其中 0=bottom, 0.5=middle, 1.0=top，而垂线的长度视水平轴长度而定。该函数返回值为 Line2D（二维曲线）参量，与 Line2D属性一致：11.matplotlib.pyplot.axvspan(xmin, xmax, ymin=0, ymax=1, hold=None, *kwargs)添加一个与 axes 交叉的垂直跨度（矩形）。axvspan(xmin, xmax, ymin=0, ymax=1, *kwargs)其中 x 轴方向
43、： 0=bottom, 0.5=middle, 1.0=top，垂线的长度视水平轴长度而定。而 x 轴则根据坐标点确定。返回值为 matplotlib.patches.Polygon实例： 12.matplotlib.pyplot.bar(left, height, width=0.8, bottom=None, hold=None,*kwargs)绘制条形图矩形边界条形图：l eft, left + width, bottom, bottom + height(left, right, bottom and top edges)left : 标量或数组 bar 左端的 x 轴坐标height
44、 : 标量或数组 bar 高度width : 标量或数组 bar 宽度bottom : 标量或数组，可选，默认为 None bar 的底部高度color : 色彩、标量或数组，可选 bar 内部颜色edgecolor : 色彩、标量或数组，可选 bar 边缘颜色linewidth : 标量或数组，可选，默认为 Nonebar 边缘宽度，若为 None，取默认宽度；若 为 0，则无边缘xerr : 标量或数组，可选，默认为 None 若不为 None，将生成 errorbar(s)yerr : 标量或数组，可选，默认为 None 若不为 None，将生成 errorbar(s)ecolor :
45、标量或数组，可选，默认为 None 指定 errorbar(s)的颜色capsize : 整数，可选，默认值：3指定 errorbar(s)的 cap（帽子）的长度error_kw : 字典errorbar 字典，ecolor 和 capsize 可在此指定，而不作为独立参量align : edge | center,可选, 默认: edge若为edge ,对于竖条形图，按 bar 左边缘排列；对于横条形图，按 bar 下边缘排列。若为center ，把左端的参数作为 bar 的中心坐标。orientation :vertical | horizontal,可选, 默认: vertical选择
46、竖条形图、横条形图log :True、False （ 0、1），可选，默认为 False如果 为 True，为对数轴返回:class（类别） :matplotlib.patches.Rectangle实例。其他可选参量，参见m atplotlib.patches.Polygon 实例（完全一致）。13. matplotlib.pyplot.barbs(*args, *kw)绘制二维风向杆barb(X, Y, U, V, C, *kw)X, Y: 风向杆的坐标位置，默认为 barb 的头部U, V: 风向的 x、y 方向分量C: 风向杆颜色length: 风向杆长度，默认为 9pivot（支点）
47、: tip | middle 默认tip 风向杆围绕着指定点旋转barbcolor: color | color 序列、数组 指定除了 flags 部分之外的颜 色，会覆盖 facecolorflagcolor color | color 序列、数组 指定 flags 颜 色，会覆盖 facecolorsizes:（ 该参量 为字典）spacing - flags 间距height - 高度 (shaft 到 top 距离)width - flag 宽度, full barb（完整 barb）的两倍宽度emptybarb - radius of the circle used for low
48、magnitudes 用于低幅度的圆半径fill_empty:A flag on whether the empty barbs (circles) that are drawn should be filled with the flag color. If they are not filled, they will be drawn such that no color is applied to the center. Default is Falserounding:A flag to indicate whether the vector magnitude should be rounded when allocating barb components. If True, the magnitude is rounded to the nearest multiple of the half-barb increment. If False, the magnitude is simply truncated
