matplotlib.pyplot.xcorr

matplotlib.pyplot.xcorr(x, y, *, normed=True, detrend=<function detrend_none>, usevlines=True, maxlags=10, data=None, **kwargs)

Plottet die Kreuzkorrelation zwischen x und y.

Die Korrelation mit Lag k ist definiert als \(\sum_n x[n+k] \cdot y^*[n]\), wobei \(y^*\) die komplexe Konjugierte von \(y\) ist.

Parameter:

x, yarray-ähnlich der Länge n

Weder x noch y werden durch Matplotlibs Einheitenkonvertierung verarbeitet, daher sollten dies einheitenlose Arrays sein.

detrendcallable, Standard: mlab.detrend_none (kein Detrending)

Eine Enttrend-Funktion, die auf x und y angewendet wird. Sie muss die Signatur haben

detrend(x: np.ndarray) -> np.ndarray

normedbool, Standard: True

Wenn True, werden Eingabevektoren auf Einheitslänge normiert.

usevlinesbool, Standard: True

Bestimmt den Zeichenstil.

Wenn True, werden vertikale Linien von 0 bis zum xcorr-Wert gezeichnet, wobei Axes.vlines verwendet wird. Zusätzlich wird eine horizontale Linie bei y=0 gezeichnet, wobei Axes.axhline verwendet wird.

Wenn False, werden Markierungen bei den xcorr-Werten gezeichnet, wobei Axes.plot verwendet wird.

maxlagsint, Standard: 10

Anzahl der anzuzeigenden Lags. Wenn None, werden alle 2 * len(x) - 1 Lags zurückgegeben.

Gibt zurück:

lagsarray (Länge 2*maxlags+1)

Der Lag-Vektor.

carray (Länge 2*maxlags+1)

Der Autokorrelations-Vektor.

lineLineCollection oder Line2D

Artist, der den Achsen der Korrelation hinzugefügt wird

• LineCollection, wenn usevlines True ist.

• Line2D, wenn usevlines False ist.

bLine2D oder None

Horizontale Linie bei 0, wenn usevlines True ist, None, wenn usevlines False ist.

Andere Parameter:

linestyleLine2D Eigenschaft, optional

Der Linienstil zum Zeichnen der Datenpunkte. Nur verwendet, wenn usevlines False ist.

markerstr, Standard: 'o'

Der Marker zum Zeichnen der Datenpunkte. Nur verwendet, wenn usevlines False ist.

dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren die folgenden Parameter auch einen String s, der als data[s] interpretiert wird, wenn s ein Schlüssel in data ist

x, y

**kwargs

Zusätzliche Parameter werden an Axes.vlines und Axes.axhline übergeben, wenn usevlines True ist; andernfalls werden sie an Axes.plot übergeben.

Anmerkungen

Hinweis

Dies ist der pyplot-Wrapper für axes.Axes.xcorr.

Die Kreuzkorrelation wird mit numpy.correlate mit mode = "full" durchgeführt.

Beispiele für die Verwendung von matplotlib.pyplot.xcorr

Kreuz- und Autokorrelation

Kreuz- und Autokorrelation