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.

Параметры:

x1-D array or sequence

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

Fsfloat, default: 2

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

windowcallable or ndarray, default: window_hanning

Функция или вектор длины NFFT. Для создания оконных векторов см. window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window и т. д. Если передан аргумент-функция, она должна принимать сегмент данных и возвращать его оконную версию.

sides{'default', 'onesided', 'twosided'}, optional

Какие стороны спектра возвращать. 'default' означает односторонний спектр для вещественных данных и двусторонний для комплексных. 'onesided' принудительно возвращает односторонний спектр, а 'twosided' — двусторонний.

pad_toint, optional

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

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

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

Fcint, default: 0

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

Возвращает:

spectrum1-D array

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

freqs1-D array

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

lineLine2D

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

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

dataindexable object, optional

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

x

**kwargs

Аргументы-ключевые слова задают свойства объекта Line2D:

Свойство	Описание
agg_filter	функция фильтра, принимающая массив float формы (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 or (Path, Transform) or 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	unknown
url	str
visible	bool
xdata	одномерный массив
ydata	одномерный массив
zorder	float

См. также

psd

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

angle_spectrum

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

phase_spectrum

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

specgram

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

Примечания

Примечание

Это обёртка pyplot для axes.Axes.magnitude_spectrum.