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.

Когерентность — это нормированная взаимная спектральная плотность:

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

Параметры:

Fsfloat, по умолчанию: 2

Частота дискретизации (образец в единицу времени). Используется для вычисления частот Фурье, freqs, в циклах на единицу времени.

windowcallable или ndarray, по умолчанию: 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

Количество точек данных, используемых в каждом блоке для преобразования Фурье. Степень двойки наиболее эффективна. Этого не следует использовать для получения нулевого заполнения, так как масштабирование результата будет неправильным; для этого используйте pad_to вместо этого.

detrend{'none', 'mean', 'linear'} или callable, по умолчанию: 'none'

Функция, применяемая к каждому сегменту перед преобразованием Фурье, предназначенная для удаления среднего или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в Matplotlib он является функцией. Модуль mlab определяет detrend_none, detrend_mean и detrend_linear, но вы также можете использовать пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций: 'none' вызывает detrend_none. 'mean' вызывает detrend_mean. 'linear' вызывает detrend_linear.

scale_by_freqbool, по умолчанию: True

Являются ли значения плотности масштабируемыми по частоте масштабирования, что дает плотность в единицах 1/Гц. Это позволяет интегрировать по возвращаемым значениям частоты. По умолчанию True для совместимости с MATLAB.

noverlapint, по умолчанию: 0 (без перекрытия)

Количество перекрывающихся точек между блоками.

Fcint, по умолчанию: 0

Центральная частота x, которая смещает границы по оси x графика для отражения диапазона частот, используемых при получении сигнала, а затем фильтрации и понижении частоты до базовой полосы.

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

Cxyодномерный массив

Вектор когерентности.

freqsодномерный массив

Частоты для элементов в Cxy.

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

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

x, y

**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, преобразование) или None
color или c	цвет
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'}
gapcolor	цвет или 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 или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список булевых значений
mouseover	bool
path_effects	AbstractPathEffect
picker	число с плавающей точкой или вызываемый объект [[Artist, Event], кортеж[bool, dict]]
pickradius	неизвестно
rasterized	bool
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
solid_capstyle	CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
transform	неизвестно
url	строка
visible	bool
xdata	одномерный массив

ydata	Одномерный массив
zorder	вещественное число

Ссылки

Бендат и Пирсол — Случайные данные: методы анализа и измерения, John Wiley & Sons (1986)