matplotlib.axes.Axes.cohere

Axes.cohere(self, x, y, NFFT=256, Fs=2, Fc=0, detrend=<function detrend_none at 0x7f6160382f70>, window=<function window_hanning at 0x7f6160382700>, 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}}\]

Параметры:

Fsscalar Частота дискретизации (образцов в единицу времени). Используется для расчёта частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию — 2. windowcallable 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_toint Количество точек, на которое фрагмент данных дополняется при выполнении преобразования Фурье. Это может отличаться от NFFT, которое определяет количество точек данных. Несмотря на то, что это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может обеспечить больше точек в графике, позволяя получить больше деталей. Соответствует параметру n в вызове fft(). Значение по умолчанию — None, что устанавливает pad_to равным NFFT NFFTint Количество точек данных, используемых в каждом блоке для преобразования Фурье. Степень двойки наиболее эффективна. Значение по умолчанию — 256. Не следует использовать для получения нулевого заполнения, так как масштабирование результата будет неверным. Используйте pad_to для этой цели. detrend{'none', 'mean', 'linear'} or callable, default 'none' Функция, применяемая к каждому сегменту перед преобразованием Фурье, предназначенная для удаления среднего или линейной тенденции. В отличие от MATLAB, где параметр detrend — вектор, в Matplotlib он — функция. Модуль mlab определяет detrend_none, detrend_mean и detrend_linear, но вы также можете использовать пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций: 'none' вызывает detrend_none. 'mean' вызывает detrend_mean. 'linear' вызывает detrend_linear. scale_by_freqbool, optional Указывает, следует ли масштабировать значения плотности с помощью частоты масштабирования, что даёт плотность в единицах Hz^-1. Это позволяет интегрировать по возвращаемым значениям частоты. По умолчанию True для совместимости с MATLAB. noverlapint Количество точек перекрытия между блоками. Значение по умолчанию — 0 (нет перекрытия). Fcint Центральная частота x (по умолчанию 0), которая смещает пределы по оси x графика для отражения диапазона частот, используемого при получении сигнала, а затем фильтрации и дискретизации до базовой полосы.

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

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

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

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

Примечания

Примечание

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

• Все аргументы с именами: 'x', 'y'.

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

Ссылки

Bendat & Piersol -- Случайные данные: анализ и процедуры измерения, издательство John Wiley & Sons (1986)