Spec-Zone.ru › Matplotlib 3.3

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

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

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

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

END_OF_DOCUMENT_MARKER
Другие параметры:
**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, 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 логическое значение
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.pyplot.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.pyplot.magnitude_spectrum.html

Spec-Zone.ru

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