matplotlib.axes.Axes.magnitude_spectrum

Axes.magnitude_spectrum(self, x, Fs=None, Fc=None, window=None, pad_to=None, sides=None, scale=None, *, data=None, **kwargs) [source]

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

Вычисление спектра амплитуды 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 или aa логическое значение clip_box Bbox clip_on логическое значение clip_path [(Path, Transform) | Patch | None] color или c цвет contains вызываемая функция dash_capstyle {'butt', 'round', 'projecting'} dash_joinstyle {'miter', 'round', 'bevel'} dashes последовательность чисел с плавающей точкой (чернила включения/выключения в пунктах) или (None, None) drawstyle или ds {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default' figure Figure fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'} gid строка in_layout логическое значение label объект linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidth или lw вещественное число marker стиль маркера markeredgecolor или mec цвет markeredgewidth или mew вещественное число markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms вещественное число markevery None или целое число или (целое число, целое число) или срез или список целых чисел или вещественное число или (вещественное число, вещественное число) path_effects AbstractPathEffect picker вещественное число или вызываемая функция[[Художник, Событие], Кортеж[логическое значение, словарь]] 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).