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целое число, необязательно: Количество точек, до которого дополняется сегмент данных при выполнении 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] (если это не вызывает исключение):

**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`	str
`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], tuple[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`	логическое значение
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей точкой

См. также

psd: Строит график плотности спектральной мощности.
angle_spectrum: Строит график углов соответствующих частот.
phase_spectrum: Строит график фазы (разворачиваемый угол) соответствующих частот.
specgram: Может строить график спектра величины сегментов внутри сигнала в цветовой шкале.

Примечания

Примечание

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