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)

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

Вызов:

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

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

Параметры:

Параметры:	x : одномерный массив или последовательность Массив или последовательность, содержащая данные Fs : скаляр Частота дискретизации (образцов в единицу времени). Используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию — 2. window : вызываемая функция или одномерный массив Функция или вектор длиной 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 : целое число Количество точек, до которых дополняется фрагмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может обеспечить больше точек в графике, что позволит получить более подробную информацию. Соответствует параметру n в вызове fft(). Значение по умолчанию — None, что устанавливает pad_to равным длине входного сигнала (т.е. без дополнения). scale : [ ‘default’ \| ‘linear’ \| ‘dB’ ] Масштабирование значений в spec. ‘linear’ — без масштабирования. ‘dB’ возвращает значения в шкале дБ, т.е. амплитуда в дБ (20 * log10). ‘default’ — ‘linear’. Fc : целое число Центральная частота x (по умолчанию 0), которая смещает пределы x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем его фильтрации и понижении частоты до полосы пропускания.
Возвращаемое значение:	spectrum : одномерный массив Значения спектра амплитуды до масштабирования (вещественные) freqs : одномерный массив Частоты, соответствующие элементам в spectrum line : экземпляр `Line2D` Линия, созданная этой функцией
Другие параметры:

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

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

Fs : скаляр

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

window : вызываемая функция или одномерный массив

Функция или вектор длиной 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 : целое число

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

scale : [ ‘default’ | ‘linear’ | ‘dB’ ]

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

Fc : целое число

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

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

spectrum : одномерный массив

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

freqs : одномерный массив

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

line : экземпляр Line2D

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

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

**kwargs :

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

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
`animated`	[True \| False]
`antialiased` или aa	[True \| False]
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[True \| False]
`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`	экземпляр `matplotlib.figure.Figure`
`fillstyle`	[‘full’ \| ‘left’ \| ‘right’ \| ‘bottom’ \| ‘top’ \| ‘none’]
`gid`	строка-идентификатор
`label`	строка или что-то, что можно распечатать с помощью преобразования ‘%s’.
`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 \| int \| кортеж длиной 2 из int \| срез \| список/массив из int \| вещественное число \| кортеж длиной 2 из вещественных чисел]
`path_effects`	неизвестно
`picker`	вещественное расстояние в точках или функция выбора `fn(artist, event)`
`pickradius`	вещественное расстояние в точках
`rasterized`	[True \| False \| None]
`sketch_params`	неизвестно
`snap`	неизвестно
`solid_capstyle`	[‘butt’ \| ‘round’ \| ‘projecting’]
`solid_joinstyle`	[‘miter’ \| ‘round’ \| ‘bevel’]
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка url
`visible`	[True \| False]
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	любое число

END_OF_DOCUMENT_MARKER

См. также

psd(): psd() строит плотность спектральной мощности.
angle_spectrum(): angle_spectrum() строит углы соответствующих частот.
phase_spectrum(): phase_spectrum() строит фазу (разобранный угол) соответствующих частот.
specgram(): specgram() может строить спектр величины сегментов сигнала в цветовой шкале.; В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]: * Все аргументы с такими именами: ‘x’.