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.

Параметры:

x1-D array or sequence Массив или последовательность, содержащая данные. Fsscalar Частота дискретизации (образцов в единицу времени). Она используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию равно 2. windowcallable 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_toint Количество точек, до которого дополняется сегмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Это соответствует параметру n в вызове fft(). По умолчанию значение равно None, что устанавливает pad_to равным длине входного сигнала (т.е. без дополнения). scale{'default', 'linear', 'dB'} Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' возвращает значения в шкале дБ, т.е. амплитуда в дБ (20 * log10). 'default' — 'linear'. Fcint Центральная частота x (по умолчанию 0), которая смещает диапазоны оси x графика для отражения частотного диапазона, используемого при получении сигнала, а затем его фильтрации и понижения частоты до базовой полосы.

Возвращает:

spectrum1-D array Значения для спектра величины до масштабирования (вещественные). freqs1-D array Частоты, соответствующие элементам в 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 {'butt', 'round', 'projecting'} dash_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 стиль маркера markeredgecolor или mec цвет markeredgewidth или mew число с плавающей точкой markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms число с плавающей точкой markevery None или int или (int, int) или срез или список [int] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) path_effects AbstractPathEffect picker число с плавающей точкой или вызываемый объект [[Artist, Event], Tuple[bool, dict]] pickradius число с плавающей точкой rasterized bool или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap bool или None solid_capstyle {'butt', 'round', 'projecting'} solid_joinstyle {'miter', 'round', 'bevel'} transform matplotlib.transforms.Transform url строка visible bool 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).