matplotlib.axes.Axes.psd

Axes.psd(x, 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]

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

Плотность спектральной мощности \(P_{xx}\) методом усреднённого периодограммы Уэлча. Вектор x делится на сегменты длиной NFFT. Каждый сегмент сглаживается функцией detrend и окончивается функцией window. noverlap задаёт длину перекрытия между сегментами. \(|\mathrm{fft}(i)|^2\) каждого сегмента \(i\) усредняются для вычисления \(P_{xx}\), с масштабированием для исправления потерь мощности из-за окон.

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

Параметры:

xОдномерный массив или последовательность

Массив или последовательность, содержащая данные

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

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

windowвызываемый объект или одномерный массив, по умолчанию: 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_toцелое число, необязательно

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

NFFTцелое число, по умолчанию: 256

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

detrend{'none', 'mean', 'linear'} или вызываемый объект, по умолчанию: 'none'

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

scale_by_freqлогическое значение, по умолчанию: True

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

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

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

Fcцелое число, по умолчанию: 0

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

return_lineлогическое значение, по умолчанию: False

Определяет, следует ли включать объект линии, нарисованной в возвращаемых значениях.

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

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

Значения для спектра мощности \(P_{xx}\) до масштабирования (вещественные значения).

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

Частоты, соответствующие элементам в Pxx.

lineLine2D

Линия, созданная этой функцией. Возвращается только если return_line равно True.

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

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

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

x

**kwargs

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	bool
antialiased или aa	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или 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 или int или (int, int) или срез или список[int] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список[bool]
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	булево значение
xdata	одномерный массив
ydata	одномерный массив
zorder	вещественное число

См. также

specgram

Отличается по умолчанию перекрытием; не возвращает среднее значение сегментных периодограмм; возвращает моменты сегментов; и отображает цветовое отображение вместо линии.

magnitude_spectrum

Отображает спектр величин.

csd

Отображает спектральную плотность между двумя сигналами.

Примечания

Для построения графика мощность отображается как \(10\log_{10}(P_{xx})\) для децибелов, хотя Pxx само по себе возвращается.

Ссылки

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

Примеры использования matplotlib.axes.Axes.psd

Спектральная плотность мощности (PSD)

Спектральная плотность мощности (PSD)