matplotlib.axes.Axes.cohere

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

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

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

Параметры:

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 : {'default', 'constant', 'mean', 'linear', 'none'} or callable Функция, применяемая к каждому сегменту перед fft, предназначенная для удаления среднего значения или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в matplotlib он является функцией. Модуль mlab определяет detrend_none(), detrend_mean() и detrend_linear(), но вы также можете использовать пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций. 'default', 'constant' и 'mean' вызывают detrend_mean(). 'linear' вызывает detrend_linear(). 'none' вызывает detrend_none(). scale_by_freq : bool, optional Указывает, следует ли масштабировать значения плотности на частоту масштабирования, что даёт плотность в единицах Hz^-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 булево значение clip_box Bbox clip_on булево значение clip_path [(Path, Transform) | Patch | None] color цвет contains вызываемая функция dash_capstyle {'butt', 'round', 'projecting'} dash_joinstyle {'miter', 'round', 'bevel'} dashes последовательность чисел с плавающей точкой (чернила включения/выключения в точках) или (None, None) drawstyle {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'} figure Figure fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'} gid строка in_layout булево значение label объект linestyle {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidth вещественное число marker неизвестно markeredgecolor цвет markeredgewidth вещественное число markerfacecolor цвет markerfacecoloralt цвет markersize вещественное число markevery неизвестно path_effects AbstractPathEffect picker вещественное число или вызываемая функция [[Artist, Event], Кортеж[bool, dict]] 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 вещественное число

Ссылки

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

Примечание

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

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

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