matplotlib.pyplot.magnitude_spectrum

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

Построение спектра величины.

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

Параметры:

xОдномерный массив или последовательность Массив или последовательность, содержащая данные. Fsвещественное число, по умолчанию: 2 Частота дискретизации (образец в единицу времени). Она используется для расчета частот Фурье, freqs, в циклах на единицу времени. windowвызываемая функция или массив, по умолчанию: window_hanning Функция или вектор длины NFFT. Для создания векторов окон см. window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window и др. Если в качестве аргумента передается функция, она должна принимать сегмент данных и возвращать оконную версию сегмента. sides{'default', 'onesided', 'twosided'}, необязательно Какие стороны спектра вернуть. 'default' — односторонняя для вещественных данных и двусторонняя для комплексных данных. 'onesided' принудительно возвращает односторонний спектр, а 'twosided' — двусторонний. pad_toint, необязательно Количество точек, до которых дополняется сегмент данных при выполнении преобразования Фурье. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек в графике, что позволит получить более подробную информацию. Это соответствует параметру n в вызове fft(). По умолчанию равно None, что устанавливает pad_to равным длине входного сигнала (т.е. без дополнения). scale{'default', 'linear', 'dB'} Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' возвращает значения в шкале дБ, т.е. амплитуда в дБ (20 * log10). 'default' — 'linear'. Fcint, по умолчанию: 0 Центральная частота x, которая смещает области x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем его фильтрации и сэмплировании до базовой полосы.

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

spectrumОдномерный массив Значения для спектра величины до масштабирования (вещественные). freqsОдномерный массив Частоты, соответствующие элементам в spectrum. lineLine2D Линия, созданная этой функцией.

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

**kwargs Параметры ключевых слов управляют свойствами Line2D: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, а возвращает массив (m, n, 3) alpha скаляр или None animated bool antialiased или aa bool clip_box Bbox clip_on bool clip_path Объект Patch или (Path, Transform) или None color или c цвет contains неизвестно dash_capstyle CapStyle или {'butt', 'projecting', 'round'} dash_joinstyle JoinStyle или {'miter', 'round', 'bevel'} dashes последовательность чисел с плавающей точкой (толщина/пробел в пунктах) или (None, None) data массив (2, N) или два одномерных массива drawstyle или ds {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default' figure Figure fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'} gid строка in_layout bool label объект linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidth или lw число с плавающей точкой marker строка стиля маркера, Path или MarkerStyle markeredgecolor или mec цвет markeredgewidth или mew число с плавающей точкой markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms число с плавающей точкой markevery None или int или (int, int) или срез или список[int] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список[bool] path_effects AbstractPathEffect picker число с плавающей точкой или вызываемая функция [[Artist, Event], tuple[bool, dict]] pickradius число с плавающей точкой rasterized bool sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap bool или None solid_capstyle CapStyle или {'butt', 'projecting', 'round'} solid_joinstyle JoinStyle или {'miter', 'round', 'bevel'} transform matplotlib.transforms.Transform url строка visible bool xdata одномерный массив ydata одномерный массив zorder число с плавающей точкой

См. также

psd

Строит график плотности спектральной мощности.

angle_spectrum

Строит график углов соответствующих частот.

phase_spectrum

Строит график фазы (разобранного угла) соответствующих частот.

specgram

Может строить график спектра величин сегментов внутри сигнала в цветовой шкале.

Примечания

Примечание

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

Объекты, передаваемые как data, должны поддерживать доступ по элементам (data[s]) и проверку на членство (s in data).

Примеры использования matplotlib.pyplot.magnitude_spectrum