matplotlib.pyplot.magnitude_spectrum

matplotlib.pyplot.magnitude_spectrum(x, Fs=None, Fc=None, window=None, pad_to=None, sides=None, scale=None, *, data=None, **kwargs)[source]

Построение спектра амплитуды.

Вычисление спектра амплитуды для x. Данные дополняются до длины pad_to, и к сигналу применяется функция окна window.

Параметры:

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целое число, необязательно

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

scale{'default', 'linear', 'dB'}

Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' возвращает значения в шкале дБ, т. е. амплитуду в дБ (20 * log10). 'default' — 'linear'.

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

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

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

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

Значения для спектра амплитуды до масштабирования (вещественные).

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

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

lineLine2D

Линия, созданная этой функцией.

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

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 или целое число или (целое число, целое число) или срез или список [целое число] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список [bool]
mouseover	bool
path_effects	список AbstractPathEffect
picker	число с плавающей точкой или вызываемая функция [[Художник, Событие], кортеж [bool, словарь]]
pickradius	число с плавающей точкой
rasterized	bool
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
solid_capstyle	CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
transform	неизвестно
url	строка
visible	bool
xdata	одномерный массив

ydata	Одномерный массив
zorder	вещественное число

См. также

psd

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

angle_spectrum

Строит углы соответствующих частот.

phase_spectrum

Строит фазу (неупакованный угол) соответствующих частот.

specgram

Может строить спектр величин отрезков сигнала на цветовой карте.