matplotlib.axes.Axes.cohere

Axes.cohere(self, x, y, NFFT=256, Fs=2, Fc=0, detrend=<function detrend_none at 0x7f8092177c80>, window=<function window_hanning at 0x7f8092177510>, noverlap=0, pad_to=None, sides='default', scale_by_freq=None, *, data=None, **kwargs) [source]

Построение когерентности между x и y.

Построение когерентности между x и y. Когерентность — это нормированная кросс-спектральная плотность:

\[C_{xy} = \frac{|P_{xy}|^2}{P_{xx}P_{yy}}\]

Параметры:

Fs : scalar Частота дискретизации (образцов в единицу времени). Используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию — 2. window : callable or ndarray Функция или вектор длиной NFFT. Для создания векторов окон см. window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window и т. д. Значение по умолчанию — window_hanning. Если в качестве аргумента передаётся функция, она должна принимать сегмент данных в качестве аргумента и возвращать оконную версию сегмента. sides : {'default', 'onesided', 'twosided'} Определяет, какие части спектра возвращать. Значение по умолчанию обеспечивает стандартное поведение, которое возвращает односторонний спектр для вещественных данных и двусторонний для комплексных данных. 'onesided' принудительно возвращает односторонний спектр, а 'twosided' — двусторонний. pad_to : int Количество точек, на которое дополняется сегмент данных при выполнении FFT. Может отличаться от NFFT, которое определяет количество точек данных, используемых для вычислений. Несмотря на то, что это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Соответствует параметру n в вызове fft(). По умолчанию — None, что устанавливает pad_to равным NFFT NFFT : int Количество точек данных, используемых в каждом блоке для FFT. Степень двойки является наиболее эффективной. Значение по умолчанию — 256. Не следует использовать для получения нулевого заполнения, так как это приведёт к неверному масштабированию результата. Для этого следует использовать pad_to. detrend : {'none', 'mean', 'linear'} or callable, default 'none' Функция, применяемая к каждому сегменту перед fft, предназначенная для удаления среднего значения или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в Matplotlib он является функцией. Модуль mlab определяет detrend_none, detrend_mean и detrend_linear, но вы также можете использовать пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций: 'none' вызывает detrend_none, 'mean' вызывает detrend_mean, 'linear' вызывает detrend_linear. scale_by_freq : bool, optional Указывает, следует ли масштабировать значения плотности с учётом масштабирующей частоты, что даёт плотность в единицах Гц^-1. Это позволяет интегрировать по возвращаемым значениям частоты. Значение по умолчанию — True для совместимости с MATLAB. noverlap : int Количество совпадающих точек между блоками. Значение по умолчанию — 0 (без перекрытия). Fc : int Центральная частота x (по умолчанию 0), которая смещает диапазон значений x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем фильтрации и понижении частоты до полосы основного сигнала.

Возвращает:

Cxy : 1-D array Вектор когерентности. freqs : 1-D array Частоты для элементов в Cxy.

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

**kwargs Ключевые аргументы управляют свойствами Line2D: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha число с плавающей точкой animated булево значение antialiased или aa булево значение clip_box Bbox clip_on булево значение clip_path [(Path, Transform) | Patch | None] color или c цвет contains вызываемый объект dash_capstyle {'butt', 'round', 'projecting'} dash_joinstyle {'miter', 'round', 'bevel'} dashes последовательность чисел с плавающей точкой (чернила включены/выключены в точках) или (None, None) drawstyle или ds {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, значение по умолчанию: 'default' figure Figure fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'} gid строка in_layout булево значение label объект linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidth или lw число с плавающей точкой marker стиль маркера markeredgecolor или mec цвет markeredgewidth или mew число с плавающей точкой markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms число с плавающей точкой markevery None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) path_effects AbstractPathEffect picker число с плавающей точкой или вызываемый объект [[Художник, событие], Кортеж[булево, словарь]] pickradius число с плавающей точкой rasterized булево значение или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap булево значение или None solid_capstyle {'butt', 'round', 'projecting'} solid_joinstyle {'miter', 'round', 'bevel'} transform matplotlib.transforms.Transform url строка visible булево значение xdata одномерный массив ydata одномерный массив zorder число с плавающей точкой

Примечания

Примечание

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

• Все аргументы со следующими именами: 'x', 'y'.

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

Ссылки

Бендат и Пирсол — Случайные данные: анализ и методики измерения, John Wiley & Sons (1986)