matplotlib.pyplot.csd

matplotlib.pyplot.csd(x, y, NFFT=None, Fs=None, Fc=None, detrend=None, window=None, noverlap=None, pad_to=None, sides=None, scale_by_freq=None, return_line=None, hold=None, data=None, **kwargs) [source]

Построение взаимной спектральной плотности.

Вызов функции:

csd(x, y, NFFT=256, Fs=2, Fc=0, detrend=mlab.detrend_none,
    window=mlab.window_hanning, noverlap=0, pad_to=None,
    sides='default', scale_by_freq=None, return_line=None, **kwargs)

Взаимная спектральная плотность методом усреднения периодограммы Велча. Вектора x и y разбиваются на сегменты длиной NFFT. Каждый сегмент обрабатывается функцией detrend и окончивается функцией window. noverlap определяет длину перекрытия между сегментами. Произведение прямых преобразований Фурье x и y усредняется по каждому сегменту для вычисления , с масштабированием для корректировки потерь мощности из-за окон.

Если len(x) < NFFT или len(y) < NFFT, они дополняются нулями до NFFT.

Параметры:

Параметры:	`x, y : 1-D arrays or sequences` Массивы или последовательности, содержащие данные `Fs : scalar` Частота дискретизации (образцов в единицу времени). Она используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию равно 2. `window : callable or ndarray` Функция или вектор длины 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 : integer` Количество точек, до которых дополняется сегмент данных при выполнении преобразования Фурье. Это может отличаться от NFFT, которое определяет количество точек данных, используемых. `NFFT : integer` Количество точек данных, используемых в каждом блоке для преобразования Фурье. Мощность 2 наиболее эффективна. Значение по умолчанию равно 256. Не следует использовать для получения нулевого заполнения, так как масштабирование результата будет неверным. Используйте pad_to для этого вместо этого. `detrend : {'default', 'constant', 'mean', 'linear', 'none'} or callable` Функция, применяемая к каждому сегменту перед преобразованием Фурье, предназначенная для удаления среднего значения или линейной тенденции. В отличие от 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, optional` Определяет, должны ли значения плотности масштабироваться на частоту масштабирования, что дает плотность в единицах Hz^-1. Это позволяет интегрировать по возвращаемым значениям частоты. По умолчанию True для совместимости с MATLAB. `noverlap : integer` Количество перекрывающихся точек между сегментами. Значение по умолчанию — 0 (без перекрытия). `Fc : integer` Центральная частота x (по умолчанию 0), которая смещает x-диапазон графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем фильтрации и понижении частоты до базовой полосы. `return_line : bool` Включать ли объект линии, нарисованной в возвращаемых значениях. По умолчанию False.
Возвращает:	`Pxy : 1-D array` Значения взаимного спектра `P_{xy}` до масштабирования (комплексные значения) `freqs : 1-D array` Частоты, соответствующие элементам в Pxy `line : a Line2D instance` Линия, созданная этой функцией. Возвращается только если return_line равно True.

x, y : 1-D arrays or sequences: Массивы или последовательности, содержащие данные
Fs : scalar: Частота дискретизации (образцов в единицу времени). Она используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию равно 2.
window : callable or ndarray: Функция или вектор длины 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 : integer: Количество точек, до которых дополняется сегмент данных при выполнении преобразования Фурье. Это может отличаться от NFFT, которое определяет количество точек данных, используемых.
NFFT : integer: Количество точек данных, используемых в каждом блоке для преобразования Фурье. Мощность 2 наиболее эффективна. Значение по умолчанию равно 256. Не следует использовать для получения нулевого заполнения, так как масштабирование результата будет неверным. Используйте pad_to для этого вместо этого.
detrend : {'default', 'constant', 'mean', 'linear', 'none'} or callable: Функция, применяемая к каждому сегменту перед преобразованием Фурье, предназначенная для удаления среднего значения или линейной тенденции. В отличие от 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, optional: Определяет, должны ли значения плотности масштабироваться на частоту масштабирования, что дает плотность в единицах Hz^-1. Это позволяет интегрировать по возвращаемым значениям частоты. По умолчанию True для совместимости с MATLAB.
noverlap : integer: Количество перекрывающихся точек между сегментами. Значение по умолчанию — 0 (без перекрытия).
Fc : integer: Центральная частота x (по умолчанию 0), которая смещает x-диапазон графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем фильтрации и понижении частоты до базовой полосы.
return_line : bool: Включать ли объект линии, нарисованной в возвращаемых значениях. По умолчанию False.

Возвращает:

Pxy : 1-D array: Значения взаимного спектра P_{xy} до масштабирования (комплексные значения)
freqs : 1-D array: Частоты, соответствующие элементам в Pxy
line : a Line2D instance: Линия, созданная этой функцией. Возвращается только если return_line равно True.

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

**kwargs :

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
`animated`	логическое значение
`antialiased` или aa	логическое значение
`clip_box`	экземпляр `Bbox`
`clip_on`	логическое значение
`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`	экземпляр `Figure`
`fillstyle`	['full' \| 'left' \| 'right' \| 'bottom' \| 'top' \| 'none']
`gid`	строка идентификатора
`label`	объект
`linestyle` или ls	['solid' \| 'dashed', 'dashdot', 'dotted' \| (offset, on-off-dash-seq) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'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`	`AbstractPathEffect`
`picker`	расстояние в пунктах или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в пунктах
`rasterized`	логическое значение или None
`sketch_params`	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
`snap`	логическое значение или None
`solid_capstyle`	['butt' \| 'round' \| 'projecting']
`solid_joinstyle`	['miter' \| 'round' \| 'bevel']
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка url
`visible`	логическое значение
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	вещественное число

См. также

psd(): psd() эквивалентно установлению y=x.

Примечания

При построении графиков мощность отображается как для децибел, хотя P_{xy} возвращается само по себе.

Ссылки

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

Примечание

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

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