matplotlib.pyplot.cohere

matplotlib.pyplot.cohere(x, y, NFFT=256, Fs=2, Fc=0, detrend=<function detrend_none at 0x7fba54bf6820>, window=<function window_hanning at 0x7fba54bf6160>, 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, default: 2 Частота дискретизации (образцов в единицу времени). Используется для расчёта частот Фурье, freqs, в циклах на единицу времени. windowcallable or ndarray, default: window_hanning Функция или вектор длиной NFFT. Для создания векторов окна см. window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window и т. д. Если в качестве аргумента передаётся функция, она должна принимать сегмент данных и возвращать окно сегмента. sides{'default', 'onesided', 'twosided'}, optional Какие части спектра возвращать. 'default' — односторонняя для вещественных данных и двусторонняя для комплексных данных. 'onesided' принудительно возвращает односторонний спектр, а 'twosided' — двусторонний. pad_toint, optional Количество точек, на которое дополняется сегмент данных при выполнении БПФ. Это может отличаться от NFFT, которое определяет количество точек данных. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Соответствует параметру n в вызове fft(). По умолчанию None, что устанавливает pad_to равным NFFT. NFFTint, default: 256 Количество точек данных, используемых в каждом блоке для БПФ. Мощность 2 наиболее эффективна. Это НЕ должно использоваться для получения нулевых дополнений, в противном случае масштабирование результата будет некорректным; для этого используйте 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, default: True Необходимо ли масштабировать значения плотности полученного результата с учётом масштабирующей частоты, что даёт плотность в единицах Hz^-1. Это позволяет интегрировать по возвращённым значениям частоты. По умолчанию True для совместимости с MATLAB. noverlapint, default: 0 (no overlap) Количество совпадающих точек между блоками. Fcint, default: 0 Центральная частота x, которая смещает пределы оси 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, 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 логическое значение label объект linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidth или lw число с плавающей точкой marker строка стилей маркера, Path или MarkerStyle markeredgecolor или mec цвет markeredgewidth или mew число с плавающей точкой markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms число с плавающей точкой markevery None или int или (int, int) или срез или Список[int] или float или (float, float) или Список[bool] 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 задан, следующие аргументы также могут быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключение): x, y.

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

Ссылки

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

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