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)

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

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

Параметры:

Параметры:	Fs : скаляр Частота дискретизации (образцов в единицу времени). Используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию — 2. window : вызываемая функция или массив Функция или вектор длиной 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 : целое число Количество точек, до которых заполняется фрагмент данных при выполнении FFT. Это может отличаться от NFFT, которое определяет количество точек данных, используемых. NFFT : целое число Количество точек данных, используемых в каждом блоке для FFT. Мощность 2 является наиболее эффективной. Значение по умолчанию — 256. Это НЕ следует использовать для получения нулевого заполнения, иначе масштабирование результата будет неверным. Для этого используйте pad_to. detrend : {‘default’, ‘constant’, ‘mean’, ‘linear’, ‘none’} или вызываемая функция Функция, применяемая к каждому фрагменту перед выполнением fft, предназначенная для удаления среднего значения или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в matplotlib он является функцией. Модуль `pylab` определяет `detrend_none()`, `detrend_mean()`, и `detrend_linear()`, но вы также можете использовать пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций. ‘default’, ‘constant’ и ‘mean’ вызывают `detrend_mean()`. ‘linear’ вызывает `detrend_linear()`. ‘none’ вызывает `detrend_none()`. scale_by_freq : boolean, необязательно Указывает, должны ли значения плотности масштабироваться с учетом частоты масштабирования, что дает плотность в единицах Hz^-1. Это позволяет интегрировать возвращаемые значения частоты. Значение по умолчанию — True для совместимости с MATLAB. noverlap : целое число Количество перекрывающихся точек между блоками. Значение по умолчанию — 0 (без перекрытия). Fc : целое число Центральная частота x (по умолчанию 0), которая смещает границы оси x для отражения диапазона частот, используемых при получении сигнала, а затем фильтрации и дискретизации до базовой полосы.
Возвращает:	Возвращаемое значение — кортеж (Cxy, f), где f — частоты вектора когерентности. kwargs применяются к линиям.
Другие параметры:

Fs : скаляр

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

window : вызываемая функция или массив

Функция или вектор длиной 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 : целое число

Количество точек, до которых заполняется фрагмент данных при выполнении FFT. Это может отличаться от NFFT, которое определяет количество точек данных, используемых.

NFFT : целое число

Количество точек данных, используемых в каждом блоке для FFT. Мощность 2 является наиболее эффективной. Значение по умолчанию — 256. Это НЕ следует использовать для получения нулевого заполнения, иначе масштабирование результата будет неверным. Для этого используйте pad_to.

detrend : {‘default’, ‘constant’, ‘mean’, ‘linear’, ‘none’} или вызываемая функция

Функция, применяемая к каждому фрагменту перед выполнением fft, предназначенная для удаления среднего значения или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в matplotlib он является функцией. Модуль pylab определяет detrend_none(), detrend_mean(), и detrend_linear(), но вы также можете использовать пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций. ‘default’, ‘constant’ и ‘mean’ вызывают detrend_mean(). ‘linear’ вызывает detrend_linear(). ‘none’ вызывает detrend_none().

scale_by_freq : boolean, необязательно

Указывает, должны ли значения плотности масштабироваться с учетом частоты масштабирования, что дает плотность в единицах Hz^-1. Это позволяет интегрировать возвращаемые значения частоты. Значение по умолчанию — True для совместимости с MATLAB.

noverlap : целое число

Количество перекрывающихся точек между блоками. Значение по умолчанию — 0 (без перекрытия).

Fc : целое число

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

Возвращает:

Возвращаемое значение — кортеж (Cxy, f), где f — частоты вектора когерентности.

kwargs применяются к линиям.

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

**kwargs :

Ключевые аргументы управляют свойствами Line2D:

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
`animated`	[True \| False]
`antialiased` или aa	[True \| False]
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[True \| False]
`clip_path`	[ (`Path`, `Transform`) \| `Patch` \| None ]
`color` или c	любой цвет matplotlib
`contains`	вызываемая функция
`dash_capstyle`	[‘butt’ \| ‘round’ \| ‘projecting’]
`dash_joinstyle`	[‘miter’ \| ‘round’ \| ‘bevel’]
`dashes`	последовательность включений/выключений чернил в точках
`drawstyle`	[‘default’ \| ‘steps’ \| ‘steps-pre’ \| ‘steps-mid’ \| ‘steps-post’]
`figure`	экземпляр `matplotlib.figure.Figure`
`fillstyle`	[‘full’ \| ‘left’ \| ‘right’ \| ‘bottom’ \| ‘top’ \| ‘none’]
`gid`	строка-идентификатор
`label`	строка или любой печатаемый объект с преобразованием ‘%s’
`linestyle` или ls	[‘solid’ \| ‘dashed’, ‘dashdot’, ‘dotted’ \| (смещение, последовательность включений/выключений) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или lw	вещественное значение в точках
`marker`	`A valid marker style`
`markeredgecolor` или mec	любой цвет matplotlib
`markeredgewidth` или mew	вещественное значение в точках
`markerfacecolor` или mfc	любой цвет matplotlib
`markerfacecoloralt` или mfcalt	любой цвет matplotlib
`markersize` или ms	вещественное число
`markevery`	[None \| целое число \| кортеж длины 2 из целых чисел \| срез \| список/массив целых чисел \| вещественное число \| кортеж длины 2 из вещественных чисел]
`path_effects`	неизвестно
`picker`	вещественное расстояние в точках или вызываемая функция выбора `fn(artist, event)`
`pickradius`	вещественное расстояние в точках
`rasterized`	[True \| False \| None]
`sketch_params`	неизвестно
`snap`	неизвестно
`solid_capstyle`	[‘butt’ \| ‘round’ \| ‘projecting’]
`solid_joinstyle`	[‘miter’ \| ‘round’ \| ‘bevel’]
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка url
`visible`	[True \| False]
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	любое число

Ссылки

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

Примечание

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

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