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)[источник]

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

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

Параметры:

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

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

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

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

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

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

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

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

Fcint, по умолчанию: 0

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

Возвращает:

spectrum1-мерный массив

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

freqs1-мерный массив

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

lineLine2D

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

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

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

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

x

**kwargs

Именованные аргументы задают свойства Line2D:

Свойство	Описание
agg_filter	функция фильтра, принимающая массив чисел с плавающей точкой формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения относительно нижнего левого угла изображения
alpha	float или 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	последовательность значений float (отрезки печати/пропуска в пунктах) или (None, None)
data	массив формы (2, N) или два одномерных массива
drawstyle или ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
figure	Figure или SubFigure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	цвет или None
gid	str
in_layout	bool
label	object
linestyle или ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth или lw	float
marker	строка со стилем маркера, Path или MarkerStyle
markeredgecolor или mec	цвет
markeredgewidth или mew	float
markerfacecolor или mfc	цвет
markerfacecoloralt или mfcalt	цвет
markersize или ms	float
markevery	None или int или (int, int) или slice или list[int] или float или (float, float) или list[bool]
mouseover	bool
path_effects	список объектов AbstractPathEffect
picker	float или callable[[Artist, Event], tuple[bool, dict]]
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
solid_capstyle	CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
transform	неизвестно
url	str
visible	bool
xdata	одномерный массив
ydata	одномерный массив
zorder	float

См. также

psd

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

angle_spectrum

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

phase_spectrum

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

specgram

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