Spec-Zone.ru › Matplotlib 3.3

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.

Параметры:
x1-D array or sequence

Массив или последовательность, содержащая данные.

Fsfloat, default: 2

Частота дискретизации (образцов в единицу времени). Используется для расчета частот Фурье, freqs, в циклах за единицу времени.

windowcallable or ndarray, default: window_hanning

Функция или вектор длиной NFFT. Для создания векторов окна см. window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window и т. д. Если в качестве аргумента передается функция, она должна принимать фрагмент данных и возвращать оконную версию этого фрагмента.

sides{'default', 'onesided', 'twosided'}, optional

Какие стороны спектра нужно вернуть. 'default' — односторонняя для вещественных данных и двусторонняя для комплексных данных. 'onesided' — односторонняя, 'twosided' — двусторонняя.

pad_toint, optional

Число точек, на которое дополняется фрагмент данных при выполнении FFT. Не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), но может дать больше точек на графике, позволяя получить больше деталей. Соответствует параметру n в вызове fft(). По умолчанию равно None, что устанавливает pad_to равным длине входного сигнала (т. е. без дополнения).

scale{'default', 'linear', 'dB'}

Масштабирование значений в spec. 'linear' — без масштабирования. 'dB' — значения в шкале дБ, т. е. амплитуда в дБ (20 * log10). 'default' — 'linear'.

Fcint, default: 0

Центральная частота x, которая смещает границы оси x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем его фильтрации и сэмплировании с понижением частоты до полосы пропускания.

Возвращает:
spectrum1-D array

Значения спектра величин до масштабирования (вещественные).

freqs1-D array

Частоты, соответствующие элементам в spectrum.

lineLine2D

Линия, созданная этой функцией.

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

Параметры ключевых слов управляют свойствами Line2D:

Свойство Описание
agg_filter функция фильтра, которая принимает массив чисел с плавающей запятой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей запятой (m, n, 3)
alpha число с плавающей запятой или None
animated логическое значение
antialiased или aa логическое значение
clip_box Bbox
clip_on логическое значение
clip_path объект Patch или (объект Path, преобразование) или 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 логическое значение
label объект
linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
linewidth или lw число с плавающей запятой
marker строка стиля маркера, Path или MarkerStyle
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
Строит график плотности спектральной мощности.
angle_spectrum
Строит график углов соответствующих частот.
phase_spectrum
Строит график фазы (раскрученный угол) соответствующих частот.
specgram
Может строить график спектра величины сегментов сигнала в цветовой карте.

Примечания

Примечание

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

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

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

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.axes.Axes.magnitude_spectrum.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API