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]

Построение спектра величин.

Вызов функции:

magnitude_spectrum(x, Fs=2, Fc=0,  window=mlab.window_hanning,
                   pad_to=None, sides='default', **kwargs)

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

Параметры:

Параметры:	`x : 1-D array or sequence` Массив или последовательность, содержащая данные. `Fs : scalar` Частота дискретизации (образцы в единицу времени). Используется для расчета частот Фурье, freqs, в циклах на единицу времени. Значение по умолчанию — 2. `window : callable or ndarray` Функция или вектор длиной NFFT. Для создания векторов окон см. `window_hanning()`, `window_none()`, `numpy.blackman()`, `numpy.hamming()`, `numpy.bartlett()`, `scipy.signal()`, `scipy.signal.get_window()` и т. д. Значение по умолчанию — `window_hanning()`. Если в качестве аргумента передана функция, она должна принимать сегмент данных и возвращать оконную версию сегмента. `sides : {'default', 'onesided', 'twosided'}` Указывает, какие стороны спектра возвращать. Значение по умолчанию обеспечивает стандартное поведение, возвращая односторонний спектр для вещественных данных и двусторонний для комплексных данных. 'onesided' принудительно возвращает односторонний спектр, а 'twosided' — двусторонний. `pad_to : int` Количество точек, на которое дополняется сегмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может обеспечить больше точек на графике, что позволит получить больше деталей. Это соответствует параметру n в вызове fft(). Значение по умолчанию — None, что устанавливает pad_to равным длине входного сигнала (т.е. без дополнения). `scale : {'default', 'linear', 'dB'}` Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' возвращает значения в шкале дБ, т.е. амплитуду в дБ (20 * log10). 'default' — 'linear'. `Fc : int` Центральная частота x (по умолчанию 0), которая смещает диапазоны оси x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем его фильтрации и дискретизации до базовой полосы.
Возвращаемое значение:	`spectrum : 1-D array` Значения для спектра величин до масштабирования (вещественные). `freqs : 1-D array` Частоты, соответствующие элементам в spectrum. `line : a Line2D instance` Линия, созданная этой функцией.

x : 1-D array or sequence: Массив или последовательность, содержащая данные.
Fs : scalar: Частота дискретизации (образцы в единицу времени). Используется для расчета частот Фурье, freqs, в циклах на единицу времени. Значение по умолчанию — 2.
window : callable or ndarray: Функция или вектор длиной NFFT. Для создания векторов окон см. window_hanning(), window_none(), numpy.blackman(), numpy.hamming(), numpy.bartlett(), scipy.signal(), scipy.signal.get_window() и т. д. Значение по умолчанию — window_hanning(). Если в качестве аргумента передана функция, она должна принимать сегмент данных и возвращать оконную версию сегмента.
sides : {'default', 'onesided', 'twosided'}: Указывает, какие стороны спектра возвращать. Значение по умолчанию обеспечивает стандартное поведение, возвращая односторонний спектр для вещественных данных и двусторонний для комплексных данных. 'onesided' принудительно возвращает односторонний спектр, а 'twosided' — двусторонний.
pad_to : int: Количество точек, на которое дополняется сегмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может обеспечить больше точек на графике, что позволит получить больше деталей. Это соответствует параметру n в вызове fft(). Значение по умолчанию — None, что устанавливает pad_to равным длине входного сигнала (т.е. без дополнения).
scale : {'default', 'linear', 'dB'}: Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' возвращает значения в шкале дБ, т.е. амплитуду в дБ (20 * log10). 'default' — 'linear'.
Fc : int: Центральная частота x (по умолчанию 0), которая смещает диапазоны оси x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем его фильтрации и дискретизации до базовой полосы.

Возвращаемое значение:

spectrum : 1-D array: Значения для спектра величин до масштабирования (вещественные).
freqs : 1-D array: Частоты, соответствующие элементам в spectrum.
line : a Line2D instance: Линия, созданная этой функцией.

Дополнительные параметры:

**kwargs :

Ключевые аргументы управляют свойствами Line2D:

Свойство	Описание
`agg_filter`	функция фильтра, принимающая массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращающая массив (m, n, 3)
`alpha`	число с плавающей точкой
`animated`	булево значение
`antialiased`	булево значение
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	[(`Path`, `Transform`) \| `Patch` \| None]
`color`	цвет
`contains`	вызываемый объект
`dash_capstyle`	{'butt', 'round', 'projecting'}
`dash_joinstyle`	{'miter', 'round', 'bevel'}
`dashes`	последовательность чисел с плавающей точкой (печать/отключeние в точках) или (None, None)
`drawstyle`	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}
`figure`	`Figure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gid`	строка
`in_layout`	булево значение
`label`	объект
`linestyle`	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
`linewidth`	число с плавающей точкой
`marker`	неизвестно
`markeredgecolor`	цвет
`markeredgewidth`	число с плавающей точкой
`markerfacecolor`	цвет
`markerfacecoloralt`	цвет
`markersize`	число с плавающей точкой
`markevery`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	число с плавающей точкой или вызываемый объект [[Artist, Event], Tuple[bool, dict]]
`pickradius`	число с плавающей точкой
`rasterized`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`solid_capstyle`	{'butt', 'round', 'projecting'}
`solid_joinstyle`	{'miter', 'round', 'bevel'}
`transform`	matplotlib.transforms.Transform
`url`	строка
`visible`	булево значение
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей точкой

См. также

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

Примечания

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

Все аргументы со следующими именами: 'x'.

Объекты, передаваемые как data, должны поддерживать доступ к элементам (data[<arg>]) и проверку на членство (<arg> in data).