You are reading an old version of the documentation (v2.0.2). For the latest version see https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.acorr.html
matplotlib

Travis-CI:

This Page

matplotlib.axes.Axes.acorr

Axes.acorr(x, **kwargs)

Plot the autocorrelation of x.

Parameters:

x : sequence of scalar

hold : boolean, optional, deprecated, default: True

detrend : callable, optional, default: mlab.detrend_none

x is detrended by the detrend callable. Default is no normalization.

normed : boolean, optional, default: True

if True, input vectors are normalised to unit length.

usevlines : boolean, optional, default: True

if True, Axes.vlines is used to plot the vertical lines from the origin to the acorr. Otherwise, Axes.plot is used.

maxlags : integer, optional, default: 10

number of lags to show. If None, will return all 2 * len(x) - 1 lags.

Returns:

(lags, c, line, b) : where:

  • lags are a length 2`maxlags+1 lag vector.
  • c is the 2`maxlags+1 auto correlation vectorI
  • line is a Line2D instance returned by plot.
  • b is the x-axis.
Other Parameters:
 

linestyle : Line2D prop, optional, default: None

Only used if usevlines is False.

marker : string, optional, default: ‘o’

Notes

The cross correlation is performed with numpy.correlate() with mode = 2.

Examples

xcorr is top graph, and acorr is bottom graph.

(Source code, png, pdf)

../../_images/xcorr_demo.png

Note

In addition to the above described arguments, this function can take a data keyword argument. If such a data argument is given, the following arguments are replaced by data[<arg>]:

  • All arguments with the following names: ‘x’.