matplotlib.pyplot.cohere

matplotlib.pyplot.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, hold=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 : целое число Количество точек, до которых дополняется фрагмент данных при выполнении преобразования Фурье. Это может отличаться от NFFT, которое определяет количество точек данных. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Это соответствует параметру n в вызове fft(). По умолчанию None, что устанавливает pad_to равным NFFT NFFT : целое число Количество точек данных, используемых в каждом блоке для преобразования Фурье. Мощность 2 является наиболее эффективной. Значение по умолчанию — 256. Это не должно использоваться для получения нулевого заполнения, иначе масштабирование результата будет неправильным. Используйте pad_to для этого вместо этого. detrend : {‘default’, ‘constant’, ‘mean’, ‘linear’, ‘none’} или вызываемый объект Функция, применяемая к каждому сегменту перед преобразованием Фурье, предназначенная для удаления среднего или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в matplotlib он является функцией. Модуль `pylab` определяет `detrend_none()`, `detrend_mean()`, и `detrend_linear()`, но вы также можете использовать пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций. ‘default’, ‘constant’, и ‘mean’ вызывают `detrend_mean()`. ‘linear’ вызывает `detrend_linear()`. ‘none’ вызывает `detrend_none()`. scale_by_freq : булево, необязательно Указывает, нужно ли масштабировать значения плотности на частоту масштабирования, что даёт плотность в единицах 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 : целое число

Количество точек, до которых дополняется фрагмент данных при выполнении преобразования Фурье. Это может отличаться от NFFT, которое определяет количество точек данных. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Это соответствует параметру n в вызове fft(). По умолчанию None, что устанавливает pad_to равным NFFT

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

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

detrend : {‘default’, ‘constant’, ‘mean’, ‘linear’, ‘none’} или вызываемый объект

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

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

Указывает, нужно ли масштабировать значения плотности на частоту масштабирования, что даёт плотность в единицах 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’ \| (смещение, последовательность on-off-dash) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'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 – Random Data: Analysis and Measurement Procedures, John Wiley & Sons (1986)

Примечание

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

Все аргументы со следующими именами: ‘x’, ‘y’.