matplotlib.pyplot.xcorr

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

Построение взаимной корреляции между x и y.

Корреляция с лагом k определяется как \(\sum_n x[n+k] \cdot y^*[n]\), где \(y^*\) — комплексно сопряжённое значение \(y\).

Параметры:	x, yarray-like of length n detrendcallable, default: mlab.detrend_none (no detrending) Функция выравнивания, применяемая к x и y. Она должна иметь сигнатуру detrend(x: np.ndarray) -> np.ndarray normedbool, default: True Если True, векторы-входные данные нормализуются до единичной длины. usevlinesbool, default: True Определяет стиль графика. Если True, рисуются вертикальные линии от 0 до значения xcorr с помощью Axes.vlines. Кроме того, с помощью Axes.axhline рисуется горизонтальная линия в y=0. Если False, точки xcorr отображаются с помощью Axes.plot. maxlagsint, default: 10 Количество отображаемых лагов. Если None, будут возвращены все 2 * len(x) - 1 лаги.
Возвращаемые значения:	lagsarray (length 2*maxlags+1) Вектор лагов. carray (length 2*maxlags+1) Вектор автокорреляций. lineLineCollection or Line2D Artist добавлены к осям корреляции: LineCollection если usevlines равно True. Line2D если usevlines равно False. bLine2D or None Горизонтальная линия в 0, если usevlines равно True, иначе None.
Дополнительные параметры:	linestyleLine2D property, optional Стиль линии для отображения точек данных. Используется только если usevlines равно False. markerstr, default: 'o' Маркер для отображения точек данных. Используется только если usevlines равно False. **kwargs Дополнительные параметры передаются в Axes.vlines и Axes.axhline, если usevlines равно True; в противном случае они передаются в Axes.plot.

Примечания

Взаимная корреляция выполняется с помощью numpy.correlate с mode = "full".

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение): x, y.

Объекты, переданные как data, должны поддерживать доступ к элементам (data[s]) и проверку на вхождение (s in data).

Примеры использования matplotlib.pyplot.xcorr

Демонстрация взаимной и автокорреляции