matplotlib.axes.Axes.xcorr

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

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

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

Параметры:

x, yмассив-подобный объект длиной n

Ни x, ни y не проходят через единицы преобразования Matplotlib, поэтому эти массивы должны быть безразмерными.

detrendвызываемый объект, по умолчанию: mlab.detrend_none (без сглаживания)

Функция сглаживания, применяемая к x и y. Она должна иметь сигнатуру

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

normedbool, по умолчанию: True

Если True, входные векторы нормализуются до единичной длины.

usevlinesbool, по умолчанию: True

Определяет стиль графика.

Если True, вертикальные линии рисуются от 0 до значения xcorr с помощью Axes.vlines. Дополнительно, горизонтальная линия рисуется в y=0 с помощью Axes.axhline.

Если False, маркеры рисуются в значениях xcorr с помощью Axes.plot.

maxlagsint, по умолчанию: 10

Количество лагов для отображения. Если None, будут возвращены все 2 * len(x) - 1 лаги.

Возвращаемое значение:

lagsмассив (длина 2*maxlags+1)

Вектор лагов.

cмассив (длина 2*maxlags+1)

Вектор взаимной корреляции.

lineLineCollection или Line2D

Artist добавлен к оси корреляции:

• LineCollection, если usevlines True.
• Line2D, если usevlines False.

bLine2D или None

Горизонтальная линия в 0, если usevlines True; None, если usevlines False.

Другие параметры:

linestyleLine2D свойство, необязательно

Стиль линии для отображения точек данных. Используется только если usevlines False.

markerstr, по умолчанию: 'o'

Маркер для отображения точек данных. Используется только если usevlines False.

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

x, y

**kwargs

Дополнительные параметры передаются в Axes.vlines и Axes.axhline, если usevlines True; в противном случае они передаются в Axes.plot.

Примечания

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

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

Взаимная и автокорреляция

Взаимная и автокорреляция