  Travis-CI: # matplotlib.pyplot¶

Provides a MATLAB-like plotting framework.

`pylab` combines pyplot with numpy into a single namespace. This is convenient for interactive work, but for programming it is recommended that the namespaces be kept separate, e.g.:

```import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1);
y = np.sin(x)
plt.plot(x, y)
```

## Functions¶

 `acorr`(x[, hold, data]) Plot the autocorrelation of `x`. `angle_spectrum`(x[, Fs, Fc, window, pad_to, …]) Plot the angle spectrum. `annotate`(*args, **kwargs) Annotate the point `xy` with text `s`. `arrow`(x, y, dx, dy[, hold]) Add an arrow to the axes. `autoscale`([enable, axis, tight]) Autoscale the axis view to the data (toggle). `autumn`() set the default colormap to autumn and apply to current image if any. `axes`(*args, **kwargs) Add an axes to the figure. `axhline`([y, xmin, xmax, hold]) Add a horizontal line across the axis. `axhspan`(ymin, ymax[, xmin, xmax, hold]) Add a horizontal span (rectangle) across the axis. `axis`(*v, **kwargs) Convenience method to get or set axis properties. `axvline`([x, ymin, ymax, hold]) Add a vertical line across the axes. `axvspan`(xmin, xmax[, ymin, ymax, hold]) Add a vertical span (rectangle) across the axes. `bar`(*args, **kwargs) Make a bar plot. `barbs`(*args, **kw) Plot a 2-D field of barbs. `barh`(*args, **kwargs) Make a horizontal bar plot. `bone`() set the default colormap to bone and apply to current image if any. `box`([on]) Turn the axes box on or off. `boxplot`(x[, notch, sym, vert, whis, …]) Make a box and whisker plot. `broken_barh`(xranges, yrange[, hold, data]) Plot horizontal bars. `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`(*args) 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. `colors`() Deprecated since version 2.1. `connect`(s, func) Connect event with string s to func. `contour`(*args, **kwargs) Plot contours. `contourf`(*args, **kwargs) Plot contours. `cool`() set the default colormap to cool and apply to current image if any. `copper`() set the default colormap to copper and apply to current image if any. `csd`(x, y[, NFFT, Fs, Fc, detrend, window, …]) Plot the cross-spectral density. `delaxes`(*args) Remove an axes from the current figure. `disconnect`(cid) Disconnect callback id cid `draw`() Redraw the current figure. `errorbar`(x, y[, yerr, xerr, fmt, ecolor, …]) Plot an errorbar graph. `eventplot`(positions[, orientation, …]) Plot identical parallel lines at the given positions. `figimage`(*args, **kwargs) Adds a non-resampled image to the figure. `figlegend`(*args, **kwargs) Place a legend in the figure. `fignum_exists`(num) `figtext`(*args, **kwargs) Add text to figure. `figure`([num, figsize, dpi, facecolor, …]) Creates a new figure. `fill`(*args, **kwargs) Plot filled polygons. `fill_between`(x, y1[, y2, where, …]) Make filled polygons between two curves. `fill_betweenx`(y, x1[, x2, where, step, …]) Make filled polygons between two horizontal curves. `findobj`([o, match, include_self]) Find artist objects. `flag`() set the default colormap to flag and apply to current image if any. `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`() `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 default colormap to gray and apply to current image if any. `grid`([b, which, axis]) Turn the axes grids on or off. `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`. `hold`([b]) Deprecated since version 2.0. `hot`() set the default colormap to hot and apply to current image if any. `hsv`() set the default colormap to hsv and apply to current image if any. `imread`(*args, **kwargs) Read an image from a file into an array. `imsave`(*args, **kwargs) Save an array as in image file. `imshow`(X[, cmap, norm, aspect, …]) Display an image on the axes. `inferno`() set the default colormap to inferno and apply to current image if any. `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 interactive mode off. `ion`() Turn interactive mode on. `ishold`() Deprecated since version 2.0. `isinteractive`() Return status of interactive mode. `jet`() set the default colormap to jet and apply to current image if any. `legend`(*args, **kwargs) Places 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 default colormap to magma and apply to current image if any. `magnitude_spectrum`(x[, Fs, Fc, window, …]) Plot the magnitude spectrum. `margins`(*args, **kw) 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 current plot. `minorticks_on`() Display minor ticks on the current plot. `nipy_spectral`() set the default colormap to nipy_spectral and apply to current image if any. `over`(func, *args, **kwargs) Deprecated since version 2.0. `pause`(interval) Pause for interval seconds. `pcolor`(*args, **kwargs) Create a pseudocolor plot of a 2-D array. `pcolormesh`(*args, **kwargs) Plot a quadrilateral mesh. `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 default colormap to pink and apply to current image if any. `plasma`() set the default colormap to plasma and apply to current image if any. `plot`(*args, **kwargs) Plot lines and/or markers to the `Axes`. `plot_date`(x, y[, fmt, tz, xdate, ydate, …]) A plot with 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 default colormap to prism and apply to current image if any. `psd`(x[, NFFT, Fs, Fc, detrend, window, …]) Plot the power spectral density. `quiver`(*args, **kw) Plot a 2-D field of arrows. `quiverkey`(*args, **kw) Add a key to a quiver plot. `rc`(*args, **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 defaults. `rgrids`(*args, **kwargs) Get or set the radial gridlines on a 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, …]) Make a scatter plot of `x` vs `y`. `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`(*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. `spectral`() set the default colormap to spectral and apply to current image if any. `spring`() set the default colormap to spring and apply to current image if any. `spy`(Z[, precision, marker, markersize, aspect]) Plot the sparsity pattern on a 2-D array. `stackplot`(x, *args, **kwargs) Draws a stacked area plot. `stem`(*args, **kwargs) Create a stem plot. `step`(x, y, *args, **kwargs) Make a step plot. `streamplot`(x, y, u, v[, density, linewidth, …]) Draws streamlines of a vector flow. `subplot`(*args, **kwargs) Return a subplot axes positioned by the given grid definition. `subplot2grid`(shape, loc[, rowspan, colspan, fig]) Create a subplot in a 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`(*args, **kwargs) Tune the subplot layout. `summer`() set the default colormap to summer and apply to current image if any. `suptitle`(*args, **kwargs) Add a centered title to the figure. `switch_backend`(newbackend) Switch the default 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 locations of the gridlines in a polar plot. `tick_params`([axis]) Change the appearance of ticks and tick labels. `ticklabel_format`(**kwargs) 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`(s, *args, **kwargs) Set a title of the current 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`() Uninstalls the matplotlib display hook. `violinplot`(dataset[, positions, vert, …]) Make a violin plot. `viridis`() set the default colormap to viridis and apply to current image if any. `vlines`(x, ymin, ymax[, colors, linestyles, …]) Plot vertical lines. `waitforbuttonpress`(*args, **kwargs) Blocking call to interact with the figure. `winter`() set the default colormap to winter and apply to current image if any. `xcorr`(x, y[, normed, detrend, usevlines, …]) Plot the cross correlation between x and y. `xkcd`([scale, length, randomness]) Turns on xkcd sketch-style drawing mode. `xlabel`(s, *args, **kwargs) Set the x axis label of the current axis. `xlim`(*args, **kwargs) Get or set the x limits of the current axes. `xscale`(*args, **kwargs) Set the scaling of the x-axis. `xticks`(*args, **kwargs) Get or set the x-limits of the current tick locations and labels. `ylabel`(s, *args, **kwargs) Set the y axis label of the current axis. `ylim`(*args, **kwargs) Get or set the y-limits of the current axes. `yscale`(*args, **kwargs) Set the scaling of the y-axis. `yticks`(*args, **kwargs) Get or set the y-limits of the current tick locations and labels.