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 : 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 Количество точек, на которое дополняется сегмент данных при выполнении FFT. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Это соответствует параметру 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 или int или (int, int) или срез или список [int] или вещественное число или (вещественное число, вещественное число) 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).