matplotlib.pyplot.phase_spectrum

matplotlib.pyplot.phase_spectrum(x, *, Fs=None, Fc=None, window=None, pad_to=None, sides=None, data=None, **kwargs)[источник]

Строит фазовый спектр.

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

Параметры:

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

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

Fsfloat, по умолчанию: 2

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

windowвызываемый объект или ndarray, по умолчанию: window_hanning

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

sides{'default', 'onesided', 'twosided'}, необязательный

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

pad_toint, необязательный

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

Fcint, по умолчанию: 0

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

Возвращает:

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

Значения фазового спектра в радианах (действительные числа).

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

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

lineLine2D

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

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

dataиндексируемый объект, необязательный

Если этот параметр задан, следующие параметры также принимают строку s, которая интерпретируется как data[s], если s является ключом в data:

x

**kwargs

Аргументы-ключевые слова задают свойства Line2D:

Свойство	Описание
agg_filter	функция фильтра, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения относительно нижнего левого угла изображения
alpha	float или None
animated	bool
antialiased или aa	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
color или c	цвет
dash_capstyle	CapStyle или {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
dashes	последовательность значений float (включение/выключение штрихов в пунктах) или (None, None)
data	массив формы (2, N) или два одномерных массива
drawstyle или ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
figure	Figure или SubFigure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	цвет или None
gid	str
in_layout	bool
label	object
linestyle или ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth или lw	float
marker	строка со стилем маркера, Path или MarkerStyle
markeredgecolor или mec	цвет
markeredgewidth или mew	float
markerfacecolor или mfc	цвет
markerfacecoloralt или mfcalt	цвет
markersize или ms	float
markevery	None или int или (int, int) или slice или list[int] или float или (float, float) или list[bool]
mouseover	bool
path_effects	список объектов AbstractPathEffect
picker	float или callable[[Artist, Event], tuple[bool, dict]]
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
solid_capstyle	CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
transform	неизвестно
url	str
visible	bool
xdata	одномерный массив
ydata	одномерный массив
zorder	float

См. также

magnitude_spectrum

Строит график амплитуд соответствующих частот.

angle_spectrum

Строит график свёрнутой версии этой функции.

specgram

Может строить фазовый спектр сегментов сигнала с использованием цветовой карты.

Примечания

Примечание

Это обёртка pyplot для axes.Axes.phase_spectrum.