`matplotlib.pyplot`#

matplotlib.pyplot is a state-based interface to matplotlib. It providesan implicit, MATLAB-like, way of plotting. It also opens figures on yourscreen, and acts as the figure GUI manager.

pyplot is mainly intended for interactive plots and simple cases ofprogrammatic plot generation:

importnumpyasnpimportmatplotlib.pyplotaspltx=np.arange(0,5,0.1)y=np.sin(x)plt.plot(x,y)plt.show()

The explicit object-oriented API is recommended for complex plots, thoughpyplot is still usually used to create the figure and often the Axes in thefigure. Seepyplot.figure,pyplot.subplots, andpyplot.subplot_mosaic to create figures, andAxes API for the plotting methods on an Axes:

importnumpyasnpimportmatplotlib.pyplotaspltx=np.arange(0,5,0.1)y=np.sin(x)fig,ax=plt.subplots()ax.plot(x,y)plt.show()

SeeMatplotlib Application Interfaces (APIs) for an explanation of the tradeoffs between theimplicit and explicit interfaces.

Managing Figure and Axes#

`axes`	Add an Axes to the current figure and make it the current Axes.
`cla`	Clear the current Axes.
`clf`	Clear the current figure.
`close`	Close a figure window, and unregister it from pyplot.
`delaxes`	Remove an`Axes` (defaulting to the current Axes) from its figure.
`fignum_exists`	Return whether the figure with the given id exists.
`figure`	Create a new figure, or activate an existing figure.
`gca`	Get the current Axes.
`gcf`	Get the current figure.
`get_figlabels`	Return a list of existing figure labels.
`get_fignums`	Return a list of existing figure numbers.
`sca`	Set the current Axes toax and the current Figure to the parent ofax.
`subplot`	Add an Axes to the current figure or retrieve an existing Axes.
`subplot2grid`	Create a subplot at a specific location inside a regular grid.
`subplot_mosaic`	Build a layout of Axes based on ASCII art or nested lists.
`subplots`	Create a figure and a set of subplots.
`twinx`	Make and return a second Axes that shares thex-axis.
`twiny`	Make and return a second Axes that shares they-axis.

Adding data to the plot#

Basic#

`plot`	Plot y versus x as lines and/or markers.
`errorbar`	Plot y versus x as lines and/or markers with attached errorbars.
`scatter`	A scatter plot ofy vs.
`step`	Make a step plot.
`loglog`	Make a plot with log scaling on both the x- and y-axis.
`semilogx`	Make a plot with log scaling on the x-axis.
`semilogy`	Make a plot with log scaling on the y-axis.
`fill_between`	Fill the area between two horizontal curves.
`fill_betweenx`	Fill the area between two vertical curves.
`bar`	Make a bar plot.
`barh`	Make a horizontal bar plot.
`bar_label`	Label a bar plot.
`stem`	Create a stem plot.
`eventplot`	Plot identical parallel lines at the given positions.
`pie`	Plot a pie chart.
`stackplot`	Draw a stacked area plot or a streamgraph.
`broken_barh`	Plot a horizontal sequence of rectangles.
`vlines`	Plot vertical lines at eachx fromymin toymax.
`hlines`	Plot horizontal lines at eachy fromxmin toxmax.
`fill`	Plot filled polygons.
`polar`	Make a polar plot.

Spans#

`axhline`	Add a horizontal line spanning the whole or fraction of the Axes.
`axhspan`	Add a horizontal span (rectangle) across the Axes.
`axvline`	Add a vertical line spanning the whole or fraction of the Axes.
`axvspan`	Add a vertical span (rectangle) across the Axes.
`axline`	Add an infinitely long straight line.

Spectral#

`acorr`	Plot the autocorrelation ofx.
`angle_spectrum`	Plot the angle spectrum.
`cohere`	Plot the coherence betweenx andy.
`csd`	Plot the cross-spectral density.
`magnitude_spectrum`	Plot the magnitude spectrum.
`phase_spectrum`	Plot the phase spectrum.
`psd`	Plot the power spectral density.
`specgram`	Plot a spectrogram.
`xcorr`	Plot the cross correlation betweenx andy.

Statistics#

`ecdf`	Compute and plot the empirical cumulative distribution function ofx.
`boxplot`	Draw a box and whisker plot.
`violinplot`	Make a violin plot.

Binned#

`hexbin`	Make a 2D hexagonal binning plot of pointsx,y.
`hist`	Compute and plot a histogram.
`hist2d`	Make a 2D histogram plot.
`stairs`	Draw a stepwise constant function as a line or a filled plot.

Contours#

`clabel`	Label a contour plot.
`contour`	Plot contour lines.
`contourf`	Plot filled contours.

2D arrays#

`imshow`	Display data as an image, i.e., on a 2D regular raster.
`matshow`	Display a 2D array as a matrix in a new figure window.
`pcolor`	Create a pseudocolor plot with a non-regular rectangular grid.
`pcolormesh`	Create a pseudocolor plot with a non-regular rectangular grid.
`spy`	Plot the sparsity pattern of a 2D array.
`figimage`	Add a non-resampled image to the figure.

Unstructured triangles#

`triplot`	Draw an unstructured triangular grid as lines and/or markers.
`tripcolor`	Create a pseudocolor plot of an unstructured triangular grid.
`tricontour`	Draw contour lines on an unstructured triangular grid.
`tricontourf`	Draw contour regions on an unstructured triangular grid.

Text and annotations#

`annotate`	Annotate the pointxy with texttext.
`text`	Add text to the Axes.
`figtext`	Add text to figure.
`table`	Add a table to an`Axes`.
`arrow`	[Discouraged] Add an arrow to the Axes.
`figlegend`	Place a legend on the figure.
`legend`	Place a legend on the Axes.

Vector fields#

`barbs`	Plot a 2D field of wind barbs.
`quiver`	Plot a 2D field of arrows.
`quiverkey`	Add a key to a quiver plot.
`streamplot`	Draw streamlines of a vector flow.

Axis configuration#

`autoscale`	Autoscale the axis view to the data (toggle).
`axis`	Convenience method to get or set some axis properties.
`box`	Turn the Axes box on or off on the current Axes.
`grid`	Configure the grid lines.
`locator_params`	Control behavior of major tick locators.
`minorticks_off`	Remove minor ticks from the Axes.
`minorticks_on`	Display minor ticks on the Axes.
`rgrids`	Get or set the radial gridlines on the current polar plot.
`thetagrids`	Get or set the theta gridlines on the current polar plot.
`tick_params`	Change the appearance of ticks, tick labels, and gridlines.
`ticklabel_format`	Configure the`ScalarFormatter` used by default for linear Axes.
`xlabel`	Set the label for the x-axis.
`xlim`	Get or set the x limits of the current Axes.
`xscale`	Set the xaxis' scale.
`xticks`	Get or set the current tick locations and labels of the x-axis.
`ylabel`	Set the label for the y-axis.
`ylim`	Get or set the y-limits of the current Axes.
`yscale`	Set the yaxis' scale.
`yticks`	Get or set the current tick locations and labels of the y-axis.
`suptitle`	Add a centered super title to the figure.
`title`	Set a title for the Axes.

Layout#

`margins`	Set or retrieve margins around the data for autoscaling axis limits.
`subplots_adjust`	Adjust the subplot layout parameters.
`subplot_tool`	Launch a subplot tool window for a figure.
`tight_layout`	Adjust the padding between and around subplots.

Colormapping#

`clim`	Set the color limits of the current image.
`colorbar`	Add a colorbar to a plot.
`gci`	Get the current colorable artist.
`sci`	Set the current image.
`get_cmap`	Get a colormap instance, defaulting to rc values ifname is None.
`set_cmap`	Set the default colormap, and applies it to the current image if any.
`imread`	Read an image from a file into an array.
`imsave`	Colormap and save an array as an image file.

Colormaps are available via the colormap registrymatplotlib.colormaps. Forconvenience this registry is available inpyplot as

matplotlib.pyplot.colormaps[source]#

Container for colormaps that are known to Matplotlib by name.

The universal registry instance ismatplotlib.colormaps. There should beno need for users to instantiateColormapRegistry themselves.

Read access uses a dict-like interface mapping names toColormaps:

importmatplotlibasmplcmap=mpl.colormaps['viridis']

ReturnedColormaps are copies, so that their modification does notchange the global definition of the colormap.

Additional colormaps can be added viaColormapRegistry.register:

mpl.colormaps.register(my_colormap)

To get a list of all registered colormaps, you can do:

frommatplotlibimportcolormapslist(colormaps)

Additionally, there are shortcut functions to set builtin colormaps; e.g.plt.viridis() is equivalent toplt.set_cmap('viridis').

matplotlib.pyplot.color_sequences[source]#

Container for sequences of colors that are known to Matplotlib by name.

The universal registry instance ismatplotlib.color_sequences. Thereshould be no need for users to instantiateColorSequenceRegistrythemselves.

Read access uses a dict-like interface mapping names to lists of colors:

importmatplotlibasmplcolors=mpl.color_sequences['tab10']

For a list of built in color sequences, seeNamed color sequences.The returned lists are copies, so that their modification does not changethe global definition of the color sequence.

Additional color sequences can be added viaColorSequenceRegistry.register:

mpl.color_sequences.register('rgb',['r','g','b'])

Configuration#

`rc`	Set the current`rcParams`.group is the grouping for the rc, e.g., for`lines.linewidth` the group is`lines`, for`axes.facecolor`, the group is`axes`, and so on. Group may also be a list or tuple of group names, e.g., (xtick,ytick).kwargs is a dictionary attribute name/value pairs, e.g.,::.
`rc_context`	Return a context manager for temporarily changing rcParams.
`rcdefaults`	Restore the`rcParams` from Matplotlib's internal default style.

Output#

`draw`	Redraw the current figure.
`draw_if_interactive`	Redraw the current figure if in interactive mode.
`ioff`	Disable interactive mode.
`ion`	Enable interactive mode.
`install_repl_displayhook`	Connect to the display hook of the current shell.
`isinteractive`	Return whether plots are updated after every plotting command.
`pause`	Run the GUI event loop forinterval seconds.
`savefig`	Save the current figure as an image or vector graphic to a file.
`show`	Display all open figures.
`switch_backend`	Set the pyplot backend.
`uninstall_repl_displayhook`	Disconnect from the display hook of the current shell.

Other#

`connect`	Bind functionfunc to events.
`disconnect`	Disconnect the callback with idcid.
`findobj`	Find artist objects.
`get`	Return the value of an`Artist`'sproperty, or print all of them.
`getp`	Return the value of an`Artist`'sproperty, or print all of them.
`get_current_fig_manager`	Return the figure manager of the current figure.
`ginput`	Blocking call to interact with a figure.
`new_figure_manager`	Create a new figure manager instance.
`set_loglevel`	Configure Matplotlib's logging levels.
`setp`	Set one or more properties on an`Artist`, or list allowed values.
`waitforbuttonpress`	Blocking call to interact with the figure.
`xkcd`	Turn onxkcd sketch-style drawing mode.

On this page

Movatterモバイル変換

matplotlib.pyplot#