Spec-Zone.ru › Matplotlib 2.1

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)

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

Вызов:

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

Вычисление спектра величины x. Данные дополняются до длины pad_to, и к сигналу применяется функция оконного фильтра window.

Параметры:

x : одномерный массив или последовательность

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

Fs : скаляр

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

window : вызываемый объект или массив

Функция или вектор длиной 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 : целое число

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

scale : [ ‘default’ | ‘linear’ | ‘dB’ ]

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

Fc : целое число

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

Возвращаемое значение:

spectrum : одномерный массив

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

freqs : одномерный массив

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

line : экземпляр Line2D

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

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

**kwargs :

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

Свойство Описание
agg_filter неизвестно
alpha вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated [True | False]
antialiased или aa [True | False]
clip_box экземпляр matplotlib.transforms.Bbox
clip_on [True | False]
clip_path [ (Path, Transform) | Patch | None ]
color или c любой цвет matplotlib
contains вызываемая функция
dash_capstyle [‘butt’ | ‘round’ | ‘projecting’]
dash_joinstyle [‘miter’ | ‘round’ | ‘bevel’]
dashes последовательность включения/выключения чернил в точках
drawstyle [‘default’ | ‘steps’ | ‘steps-pre’ | ‘steps-mid’ | ‘steps-post’]
figure экземпляр matplotlib.figure.Figure
fillstyle [‘full’ | ‘left’ | ‘right’ | ‘bottom’ | ‘top’ | ‘none’]
gid строка-идентификатор
label строка или любой печатаемый объект с преобразованием ‘%s’
linestyle или ls [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность включения/выключения) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw вещественное значение в точках
marker A valid marker style
markeredgecolor или mec любой цвет matplotlib
markeredgewidth или mew вещественное значение в точках
markerfacecolor или mfc любой цвет matplotlib
markerfacecoloralt или mfcalt любой цвет matplotlib
markersize или ms вещественное число
markevery [None | int | пара чисел int длины 2 | срез | список/массив чисел int | вещественное число | пара чисел float длины 2]
path_effects неизвестно
picker расстояние в точках или вызываемая функция выбора fn(artist, event)
pickradius расстояние в точках
rasterized [True | False | None]
sketch_params неизвестно
snap неизвестно
solid_capstyle [‘butt’ | ‘round’ | ‘projecting’]
solid_joinstyle [‘miter’ | ‘round’ | ‘bevel’]
transform экземпляр matplotlib.transforms.Transform
url строка url
visible [True | False]
xdata одномерный массив
ydata одномерный массив
zorder любое число

См. также

psd()
psd() строит плотность спектральной мощности.
angle_spectrum()
angle_spectrum() строит углы соответствующих частот.
phase_spectrum()
phase_spectrum() строит фазу (неразвёрнутый угол) соответствующих частот.
specgram()
specgram() может строить спектр амплитуды фрагментов сигнала в виде цветовой карты.
В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]: * Все аргументы с именами: ‘x’.

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

Spec-Zone.ru

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