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 : int -
Количество точек, до которых дополняется сегмент данных при выполнении БПФ. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Это соответствует параметру 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_boxBboxclip_onлогическое значение clip_path[( Path,Transform) |Patch| None]colorцвет containsвызываемая функция dash_capstyle{'butt', 'round', 'projecting'} dash_joinstyle{'miter', 'round', 'bevel'} dashesпоследовательность чисел с плавающей точкой (чернила/пробел в пунктах) или (None, None) drawstyle{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'} figureFigurefillstyle{'full', 'left', 'right', 'bottom', 'top', 'none'} gidстрока in_layoutлогическое значение labelобъект linestyle{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidthвещественное число markerнеизвестно markeredgecolorцвет markeredgewidthвещественное число markerfacecolorцвет markerfacecoloraltцвет markersizeвещественное число markeveryнеизвестно path_effectsAbstractPathEffectpickerвещественное число или вызываемая функция [[Artist, Event], Tuple[bool, dict]] pickradiusвещественное число rasterizedлогическое значение или None sketch_params(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число) snapлогическое значение или None solid_capstyle{'butt', 'round', 'projecting'} solid_joinstyle{'miter', 'round', 'bevel'} transformmatplotlib.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).-
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.axes.Axes.magnitude_spectrum.html