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

Количество точек, до которого дополняется фрагмент данных при выполнении преобразования Фурье. Не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), но может обеспечить больше точек в графике, что позволит получить больше деталей. Соответствует параметру 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	функция фильтра, которая принимает массив float (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'}
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 или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список булевых значений
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	bool
xdata	одномерный массив

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

См. также

psd

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

angle_spectrum

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

phase_spectrum

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

specgram

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