Spec-Zone.ru › Matplotlib 3.0

matplotlib.axes.Axes.magnitude_spectrum

Axes.magnitude_spectrum(x, Fs=None, Fc=None, window=None, pad_to=None, sides=None, scale=None, *, data=None, **kwargs) [source]

Построение спектра величин.

Вызов:

magnitude_spectrum(x, Fs=2, Fc=0,  window=mlab.window_hanning,
                   pad_to=None, sides='default', **kwargs)

Вычисление спектра величин 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

Количество точек, до которых дополняется сегмент данных при выполнении БПФ. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Это соответствует параметру 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 логическое значение
clip_box Bbox
clip_on логическое значение
clip_path [(Path, Transform) | Patch | None]
color цвет
contains вызываемая функция
dash_capstyle {'butt', 'round', 'projecting'}
dash_joinstyle {'miter', 'round', 'bevel'}
dashes последовательность чисел с плавающей точкой (чернила/пробел в пунктах) или (None, None)
drawstyle {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}
figure Figure
fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'}
gid строка
in_layout логическое значение
label объект
linestyle {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
linewidth вещественное число
marker неизвестно
markeredgecolor цвет
markeredgewidth вещественное число
markerfacecolor цвет
markerfacecoloralt цвет
markersize вещественное число
markevery неизвестно
path_effects AbstractPathEffect
picker вещественное число или вызываемая функция [[Artist, Event], Tuple[bool, dict]]
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).

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

Spec-Zone.ru

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