matplotlib.axes.Axes.magnitude_spectrum

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

Количество точек, до которого дополняется сегмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может обеспечить больше точек на графике, что позволит получить более подробную информацию. Это соответствует параметру 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	Bbox
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'}
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) или slice или список[int] или вещественное число или (вещественное число, вещественное число) или список[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	bool
xdata	одномерный массив
ydata	одномерный массив
zorder	вещественное число

См. также

psd

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

angle_spectrum

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

phase_spectrum

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

specgram

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