Spec-Zone.ru › Matplotlib 3.2

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

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

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 функция фильтра, которая принимает (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 или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой)
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).

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

Spec-Zone.ru

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