matplotlib.pyplot
matplotlib.pyplot is a state-based interface to matplotlib. It provides a MATLAB-like way of plotting.
pyplot is mainly intended for interactive plots and simple cases of programmatic plot generation:
import numpy as np
import matplotlib.pyplot as plt
x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)
The object-oriented API is recommended for more complex plots.
Functions
acorr(x, *[, data]) |
Plot the autocorrelation of x. |
angle_spectrum(x[, Fs, Fc, window, pad_to, ...]) |
Plot the angle spectrum. |
annotate(text, xy, *args, **kwargs) |
Annotate the point xy with text s. |
arrow(x, y, dx, dy, **kwargs) |
Add an arrow to the axes. |
autoscale([enable, axis, tight]) |
Autoscale the axis view to the data (toggle). |
autumn() |
Set the colormap to "autumn". |
axes([arg]) |
Add an axes to the current figure and make it the current axes. |
axhline([y, xmin, xmax]) |
Add a horizontal line across the axis. |
axhspan(ymin, ymax[, xmin, xmax]) |
Add a horizontal span (rectangle) across the axis. |
axis(*v, **kwargs) |
Convenience method to get or set some axis properties. |
axvline([x, ymin, ymax]) |
Add a vertical line across the axes. |
axvspan(xmin, xmax[, ymin, ymax]) |
Add a vertical span (rectangle) across the axes. |
bar(x, height[, width, bottom, align, data]) |
Make a bar plot. |
barbs(*args[, data]) |
Plot a 2-D field of barbs. |
barh(y, width[, height, left, align]) |
Make a horizontal bar plot. |
bone() |
Set the colormap to "bone". |
box([on]) |
Turn the axes box on or off on the current axes. |
boxplot(x[, notch, sym, vert, whis, ...]) |
Make a box and whisker plot. |
broken_barh(xranges, yrange, *[, data]) |
Plot a horizontal sequence of rectangles. |
cla() |
Clear the current axes. |
clabel(CS, *args, **kwargs) |
Label a contour plot. |
clf() |
Clear the current figure. |
clim([vmin, vmax]) |
Set the color limits of the current image. |
close([fig]) |
Close a figure window. |
cohere(x, y[, NFFT, Fs, Fc, detrend, ...]) |
Plot the coherence between x and y. |
colorbar([mappable, cax, ax]) |
Add a colorbar to a plot. |
connect(s, func) |
Connect event with string s to func. |
contour(*args[, data]) |
Plot contours. |
contourf(*args[, data]) |
Plot contours. |
cool() |
Set the colormap to "cool". |
copper() |
Set the colormap to "copper". |
csd(x, y[, NFFT, Fs, Fc, detrend, window, ...]) |
Plot the cross-spectral density. |
delaxes([ax]) |
Remove the Axes ax (defaulting to the current axes) from its figure. |
disconnect(cid) |
Disconnect callback id cid |
draw() |
Redraw the current figure. |
errorbar(x, y[, yerr, xerr, fmt, ecolor, ...]) |
Plot y versus x as lines and/or markers with attached errorbars. |
eventplot(positions[, orientation, ...]) |
Plot identical parallel lines at the given positions. |
figimage(*args, **kwargs) |
Add a non-resampled image to the figure. |
figlegend(*args, **kwargs) |
Place a legend in the figure. |
fignum_exists(num) |
Return whether the figure with the given id exists. |
figtext(x, y, s, *args, **kwargs) |
Add text to figure. |
figure([num, figsize, dpi, facecolor, ...]) |
Create a new figure. |
fill(*args[, data]) |
Plot filled polygons. |
fill_between(x, y1[, y2, where, ...]) |
Fill the area between two horizontal curves. |
fill_betweenx(y, x1[, x2, where, step, ...]) |
Fill the area between two vertical curves. |
findobj([o, match, include_self]) |
Find artist objects. |
flag() |
Set the colormap to "flag". |
gca(**kwargs) |
Get the current Axes instance on the current figure matching the given keyword args, or create one. |
gcf() |
Get a reference to the current figure. |
gci() |
Get the current colorable artist. |
get_current_fig_manager() |
Return the figure manager of the active figure. |
get_figlabels() |
Return a list of existing figure labels. |
get_fignums() |
Return a list of existing figure numbers. |
get_plot_commands() |
Get a sorted list of all of the plotting commands. |
ginput(*args, **kwargs) |
Blocking call to interact with a figure. |
gray() |
Set the colormap to "gray". |
grid([b, which, axis]) |
Configure the grid lines. |
hexbin(x, y[, C, gridsize, bins, xscale, ...]) |
Make a hexagonal binning plot. |
hist(x[, bins, range, density, weights, ...]) |
Plot a histogram. |
hist2d(x, y[, bins, range, normed, weights, ...]) |
Make a 2D histogram plot. |
hlines(y, xmin, xmax[, colors, linestyles, ...]) |
Plot horizontal lines at each y from xmin to xmax. |
hot() |
Set the colormap to "hot". |
hsv() |
Set the colormap to "hsv". |
imread(fname[, format]) |
Read an image from a file into an array. |
imsave(fname, arr, **kwargs) |
Save an array as in image file. |
imshow(X[, cmap, norm, aspect, ...]) |
Display an image, i.e. |
inferno() |
Set the colormap to "inferno". |
install_repl_displayhook() |
Install a repl display hook so that any stale figure are automatically redrawn when control is returned to the repl. |
ioff() |
Turn the interactive mode off. |
ion() |
Turn the interactive mode on. |
isinteractive() |
Return the status of interactive mode. |
jet() |
Set the colormap to "jet". |
legend(*args, **kwargs) |
Place a legend on the axes. |
locator_params([axis, tight]) |
Control behavior of tick locators. |
loglog(*args, **kwargs) |
Make a plot with log scaling on both the x and y axis. |
magma() |
Set the colormap to "magma". |
magnitude_spectrum(x[, Fs, Fc, window, ...]) |
Plot the magnitude spectrum. |
margins(*margins[, x, y, tight]) |
Set or retrieve autoscaling margins. |
matshow(A[, fignum]) |
Display an array as a matrix in a new figure window. |
minorticks_off() |
Remove minor ticks from the axes. |
minorticks_on() |
Display minor ticks on the axes. |
nipy_spectral() |
Set the colormap to "nipy_spectral". |
pause(interval) |
Pause for interval seconds. |
pcolor(*args[, alpha, norm, cmap, vmin, ...]) |
Create a pseudocolor plot with a non-regular rectangular grid. |
pcolormesh(*args[, alpha, norm, cmap, vmin, ...]) |
Create a pseudocolor plot with a non-regular rectangular grid. |
phase_spectrum(x[, Fs, Fc, window, pad_to, ...]) |
Plot the phase spectrum. |
pie(x[, explode, labels, colors, autopct, ...]) |
Plot a pie chart. |
pink() |
Set the colormap to "pink". |
plasma() |
Set the colormap to "plasma". |
plot(*args[, scalex, scaley, data]) |
Plot y versus x as lines and/or markers. |
plot_date(x, y[, fmt, tz, xdate, ydate, data]) |
Plot data that contains dates. |
plotfile(fname[, cols, plotfuncs, comments, ...]) |
Plot the data in a file. |
polar(*args, **kwargs) |
Make a polar plot. |
prism() |
Set the colormap to "prism". |
psd(x[, NFFT, Fs, Fc, detrend, window, ...]) |
Plot the power spectral density. |
quiver(*args[, data]) |
Plot a 2-D field of arrows. |
quiverkey(Q, X, Y, U, label, **kw) |
Add a key to a quiver plot. |
rc(group, **kwargs) |
Set the current rc params. |
rc_context([rc, fname]) |
Return a context manager for managing rc settings. |
rcdefaults() |
Restore the rc params from Matplotlib's internal default style. |
rgrids(*args, **kwargs) |
Get or set the radial gridlines on the current polar plot. |
savefig(*args, **kwargs) |
Save the current figure. |
sca(ax) |
Set the current Axes instance to ax. |
scatter(x, y[, s, c, marker, cmap, norm, ...]) |
A scatter plot of y vs x with varying marker size and/or color. |
sci(im) |
Set the current image. |
semilogx(*args, **kwargs) |
Make a plot with log scaling on the x axis. |
semilogy(*args, **kwargs) |
Make a plot with log scaling on the y axis. |
set_cmap(cmap) |
Set the default colormap. |
setp(obj, *args, **kwargs) |
Set a property on an artist object. |
show(*args, **kw) |
Display a figure. |
specgram(x[, NFFT, Fs, Fc, detrend, window, ...]) |
Plot a spectrogram. |
spring() |
Set the colormap to "spring". |
spy(Z[, precision, marker, markersize, ...]) |
Plot the sparsity pattern of a 2D array. |
stackplot(x, *args[, data]) |
Draw a stacked area plot. |
stem(*args[, linefmt, markerfmt, basefmt, ...]) |
Create a stem plot. |
step(x, y, *args[, where, data]) |
Make a step plot. |
streamplot(x, y, u, v[, density, linewidth, ...]) |
Draw streamlines of a vector flow. |
subplot(*args, **kwargs) |
Add a subplot to the current figure. |
subplot2grid(shape, loc[, rowspan, colspan, fig]) |
Create an axis at specific location inside a regular grid. |
subplot_tool([targetfig]) |
Launch a subplot tool window for a figure. |
subplots([nrows, ncols, sharex, sharey, ...]) |
Create a figure and a set of subplots. |
subplots_adjust([left, bottom, right, top, ...]) |
Tune the subplot layout. |
summer() |
Set the colormap to "summer". |
suptitle(t, **kwargs) |
Add a centered title to the figure. |
switch_backend(newbackend) |
Close all open figures and set the Matplotlib backend. |
table(**kwargs) |
Add a table to the current axes. |
text(x, y, s[, fontdict, withdash]) |
Add text to the axes. |
thetagrids(*args, **kwargs) |
Get or set the theta gridlines on the current polar plot. |
tick_params([axis]) |
Change the appearance of ticks, tick labels, and gridlines. |
ticklabel_format(*[, axis, style, ...]) |
Change the ScalarFormatter used by default for linear axes. |
tight_layout([pad, h_pad, w_pad, rect]) |
Automatically adjust subplot parameters to give specified padding. |
title(label[, fontdict, loc, pad]) |
Set a title for the axes. |
tricontour(*args, **kwargs) |
Draw contours on an unstructured triangular grid. |
tricontourf(*args, **kwargs) |
Draw contours on an unstructured triangular grid. |
tripcolor(*args, **kwargs) |
Create a pseudocolor plot of an unstructured triangular grid. |
triplot(*args, **kwargs) |
Draw a unstructured triangular grid as lines and/or markers. |
twinx([ax]) |
Make a second axes that shares the x-axis. |
twiny([ax]) |
Make a second axes that shares the y-axis. |
uninstall_repl_displayhook() |
Uninstall the matplotlib display hook. |
violinplot(dataset[, positions, vert, ...]) |
Make a violin plot. |
viridis() |
Set the colormap to "viridis". |
vlines(x, ymin, ymax[, colors, linestyles, ...]) |
Plot vertical lines. |
waitforbuttonpress(*args, **kwargs) |
Blocking call to interact with the figure. |
winter() |
Set the colormap to "winter". |
xcorr(x, y[, normed, detrend, usevlines, ...]) |
Plot the cross correlation between x and y. |
xkcd([scale, length, randomness]) |
Turn on xkcd sketch-style drawing mode.This will only have effect on things drawn after this function is called.. |
xlabel(xlabel[, fontdict, labelpad]) |
Set the label for the x-axis. |
xlim(*args, **kwargs) |
Get or set the x limits of the current axes. |
xscale(value, **kwargs) |
Set the x-axis scale. |
xticks([ticks, labels]) |
Get or set the current tick locations and labels of the x-axis. |
ylabel(ylabel[, fontdict, labelpad]) |
Set the label for the y-axis. |
ylim(*args, **kwargs) |
Get or set the y-limits of the current axes. |
yscale(value, **kwargs) |
Set the y-axis scale. |
yticks([ticks, labels]) |
Get or set the current tick locations and labels of the y-axis. |
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.pyplot.html