matplotlib.axes.Axes.magnitude_spectrum

Axes.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 : 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'.