matplotlib.pyplot.cohere

matplotlib.pyplot.cohere(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 Количество точек данных, используемых в каждом блоке для БПФ. Степень 2 наиболее эффективна. Значение по умолчанию — 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 функция фильтра, принимающая массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращающая массив (m, n, 3) alpha вещественное число или None animated булево значение antialiased или aa булево значение clip_box Bbox clip_on булево значение clip_path Объект Patch или (объект Path, преобразование) или 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 булево значение 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).

Ссылки

Bendat & Piersol -- Random Data: Analysis and Measurement Procedures, John Wiley & Sons (1986)