matplotlib.pyplot.magnitude_spectrum

matplotlib.pyplot.magnitude_spectrum(x, Fs=None, Fc=None, window=None, pad_to=None, sides=None, scale=None, hold=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 : integer` Число точек, до которых дополняется сегмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может обеспечить больше точек в графике, что позволит получить более подробные данные. Это соответствует параметру n в вызове fft(). По умолчанию равно None, что устанавливает pad_to равным длине входного сигнала (т.е. без заполнения). `scale : [ 'default' \| 'linear' \| 'dB' ]` Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' возвращает значения в шкале дБ, т.е. амплитуду в дБ (20 * log10). 'default' — 'linear'. `Fc : integer` Центральная частота 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 : integer: Число точек, до которых дополняется сегмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может обеспечить больше точек в графике, что позволит получить более подробные данные. Это соответствует параметру n в вызове fft(). По умолчанию равно None, что устанавливает pad_to равным длине входного сигнала (т.е. без заполнения).
scale : [ 'default' | 'linear' | 'dB' ]: Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' возвращает значения в шкале дБ, т.е. амплитуду в дБ (20 * log10). 'default' — 'linear'.
Fc : integer: Центральная частота x (по умолчанию 0), которая смещает границы оси x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем фильтрации и понижении частоты дискретизации до базовой полосы.

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

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

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

**kwargs :

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi и возвращает массив (m, n, 3)
`alpha`	числовое значение (от 0.0 - прозрачный до 1.0 - непрозрачный)
`animated`	логическое значение
`antialiased` или aa	логическое значение
`clip_box`	экземпляр `Bbox`
`clip_on`	логическое значение
`clip_path`	[(`Path`, `Transform`) \| `Patch` \| None]
`color` или c	любой цвет matplotlib
`contains`	вызываемая функция
`dash_capstyle`	['butt' \| 'round' \| 'projecting']
`dash_joinstyle`	['miter' \| 'round' \| 'bevel']
`dashes`	последовательность значений включения/выключения чернил в точках
`drawstyle`	['default' \| 'steps' \| 'steps-pre' \| 'steps-mid' \| 'steps-post']
`figure`	экземпляр `Figure`
`fillstyle`	['full' \| 'left' \| 'right' \| 'bottom' \| 'top' \| 'none']
`gid`	строка идентификатора
`label`	объект
`linestyle` или ls	['solid' \| 'dashed', 'dashdot', 'dotted' \| (смещение, последовательность вкл./выкл. чернил) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или lw	числовое значение в пунктах
`marker`	`A valid marker style`
`markeredgecolor` или mec	любой цвет matplotlib
`markeredgewidth` или mew	числовое значение в пунктах
`markerfacecolor` или mfc	любой цвет matplotlib
`markerfacecoloralt` или mfcalt	любой цвет matplotlib
`markersize` или ms	числовое значение
`markevery`	[None \| целое число \| кортеж длиной 2 из целых чисел \| срез \| список/массив целых чисел \| число с плавающей точкой \| кортеж длиной 2 из чисел с плавающей точкой]
`path_effects`	`AbstractPathEffect`
`picker`	расстояние в пунктах или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в пунктах
`rasterized`	логическое значение или None
`sketch_params`	(масштаб: число, длина: число, случайность: число)
`snap`	логическое значение или None
`solid_capstyle`	['butt' \| 'round' \| 'projecting']
`solid_joinstyle`	['miter' \| 'round' \| 'bevel']
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка url
`visible`	логическое значение
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	числовое значение

См. также

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

Примечания

Примечание

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

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