matplotlib.axes.Axes.csd

Axes.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, *, 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, которое задаёт количество используемых точек данных. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может дать больше точек на графике, позволяя получить больше деталей. Соответствует параметру n в вызове fft(). Значение по умолчанию None, которое устанавливает pad_to равным 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, которое задаёт количество используемых точек данных. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может дать больше точек на графике, позволяя получить больше деталей. Соответствует параметру n в вызове fft(). Значение по умолчанию None, которое устанавливает pad_to равным 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 \| int \| длина-2 кортеж из int \| срез \| список/массив из int \| float \| длина-2 кортеж из float]
`path_effects`	`AbstractPathEffect`
`picker`	расстояние в пунктах или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в пунктах
`rasterized`	логическое значение или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`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 -- Random Data: Analysis and Measurement Procedures, John Wiley & Sons (1986)

Примечание

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

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