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. Когерентность — это нормированная взаимная спектральная плотность:

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

Параметры:

Fsfloat, по умолчанию: 2 Частота дискретизации (образцов в единицу времени). Она используется для вычисления частот Фурье, freqs, в циклах на единицу времени. windowвызываемый объект или массив, по умолчанию: window_hanning Функция или вектор длиной NFFT. Для создания векторов окна см. window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window и т. д. Если в качестве аргумента передается функция, она должна принимать фрагмент данных и возвращать оконную версию фрагмента. sides{'default', 'onesided', 'twosided'}, необязательно Какие стороны спектра возвращать. 'default' — односторонняя для вещественных данных и двусторонняя для комплексных данных. 'onesided' принудительно возвращает односторонний спектр, а 'twosided' — двусторонний. pad_toint, необязательно Количество точек, до которых фрагмент данных дополняется при выполнении БПФ. Это может отличаться от NFFT, которое определяет количество используемых точек данных. Несмотря на то, что это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может обеспечить больше точек на графике, что позволит получить больше деталей. Это соответствует параметру n в вызове fft(). По умолчанию значение None, что устанавливает pad_to равным NFFT NFFTint, по умолчанию: 256 Количество точек данных, используемых в каждом блоке для БПФ. Мощность 2 наиболее эффективна. Это НЕ следует использовать для получения нулевого заполнения, так как масштабирование результата будет неверным; используйте pad_to для этого вместо этого. detrend{'none', 'mean', 'linear'} или вызываемый объект, по умолчанию: 'none' Функция, применяемая к каждому фрагменту перед выполнением БПФ, предназначенная для удаления среднего значения или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в Matplotlib он является функцией. Модуль mlab определяет detrend_none, detrend_mean и detrend_linear, но вы можете использовать и пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций: 'none' вызывает detrend_none. 'mean' вызывает detrend_mean. 'linear' вызывает detrend_linear. scale_by_freqbool, по умолчанию: True Указывает, следует ли масштабировать полученные значения плотности с учётом масштабирующей частоты, что даёт плотность в единицах Hz^-1. Это позволяет интегрировать по возвращённым значениям частоты. По умолчанию True для совместимости с MATLAB. noverlapint, по умолчанию: 0 (без перекрытия) Количество перекрывающихся точек между блоками. Fcint, по умолчанию: 0 Центральная частота x, которая смещает области x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем его фильтрации и дискретизации до полосы основного сигнала.

Возвращает:

CxyОдномерный массив Вектор когерентности. freqsОдномерный массив Частоты для элементов в Cxy.

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

**kwargs Параметры ключевых слов управляют свойствами Line2D: Свойство Описание agg_filter функция фильтра, которая принимает массив чисел с плавающей запятой (m, n, 3) и значение dpi и возвращает массив чисел с плавающей запятой (m, n, 3) alpha скаляр или None animated bool antialiased или aa bool clip_box Bbox clip_on bool clip_path Patch или (Path, Transform) или None color или c цвет contains неизвестно dash_capstyle CapStyle или {'butt', 'projecting', 'round'} dash_joinstyle 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 строка стиля маркера, Path или MarkerStyle markeredgecolor или mec цвет markeredgewidth или mew число с плавающей запятой markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms число с плавающей запятой markevery None или целое число или (целое число, целое число) или срез или список[целое число] или число с плавающей запятой или (число с плавающей запятой, число с плавающей запятой) или список[bool] path_effects AbstractPathEffect picker число с плавающей запятой или вызываемая функция[[Artist, Event], tuple[bool, dict]] pickradius число с плавающей запятой rasterized bool sketch_params (масштаб: число с плавающей запятой, длина: число с плавающей запятой, случайность: число с плавающей запятой) snap bool или None solid_capstyle CapStyle или {'butt', 'projecting', 'round'} solid_joinstyle JoinStyle или {'miter', 'round', 'bevel'} transform matplotlib.transforms.Transform url строка visible bool xdata одномерный массив ydata одномерный массив zorder число с плавающей запятой

Примечания

Примечание

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

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

Ссылки

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

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