matplotlib.pyplot.phase_spectrum

matplotlib.pyplot.phase_spectrum(x, Fs=None, Fc=None, window=None, pad_to=None, sides=None, hold=None, data=None, **kwargs) [source]

Построение фазового спектра.

Вызов функции:

phase_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 : integer` Количество точек, до которых дополняется сегмент данных при выполнении преобразования Фурье. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может обеспечить больше точек в графике, позволяя получить больше деталей. Это соответствует параметру n в вызове fft(). Значение по умолчанию — None, которое устанавливает pad_to равным длине входного сигнала (т. е. без дополнения). `Fc : integer` Центральная частота x (по умолчанию 0), которая смещает границы оси x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем фильтрации и дискретизации до базовой полосы.
Возвращаемые значения:	`spectrum : 1-D array` Значения фазового спектра в радианах (вещественные значения) `freqs : 1-D array` Частоты, соответствующие элементам в spectrum `line : a Line2D instance` Линия, созданная этой функцией

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 : integer: Количество точек, до которых дополняется сегмент данных при выполнении преобразования Фурье. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может обеспечить больше точек в графике, позволяя получить больше деталей. Это соответствует параметру n в вызове fft(). Значение по умолчанию — None, которое устанавливает pad_to равным длине входного сигнала (т. е. без дополнения).
Fc : integer: Центральная частота x (по умолчанию 0), которая смещает границы оси x графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем фильтрации и дискретизации до базовой полосы.

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

spectrum : 1-D array: Значения фазового спектра в радианах (вещественные значения)
freqs : 1-D array: Частоты, соответствующие элементам в spectrum
line : a Line2D instance: Линия, созданная этой функцией

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

**kwargs :

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
`animated`	логическое значение
`antialiased` или aa	логическое значение
`clip_box`	экземпляр `Bbox`
`clip_on`	логическое значение
`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`	экземпляр `Figure`
`fillstyle`	['full' \| 'left' \| 'right' \| 'bottom' \| 'top' \| 'none']
`gid`	строка-идентификатор
`label`	объект
`linestyle` или ls	['solid' \| 'dashed', 'dashdot', 'dotted' \| (offset, on-off-dash-seq) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или lw	вещественное значение в пунктах
`marker`	`A valid marker style`
`markeredgecolor` или mec	любой цвет matplotlib
`markeredgewidth` или mew	вещественное значение в пунктах
`markerfacecolor` или mfc	любой цвет matplotlib
`markerfacecoloralt` или mfcalt	любой цвет matplotlib
`markersize` или ms	вещественное число
`markevery`	[None \| целое число \| кортеж длиной 2 из целых чисел \| срез \| список/массив целых чисел \| вещественное число \| кортеж длиной 2 из вещественных чисел]
`path_effects`	`AbstractPathEffect`
`picker`	расстояние в пунктах или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в пунктах
`rasterized`	логическое значение или None
`sketch_params`	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
`snap`	логическое значение или None
`solid_capstyle`	['butt' \| 'round' \| 'projecting']
`solid_joinstyle`	['miter' \| 'round' \| 'bevel']
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка url
`visible`	логическое значение
`xdata`	массив 1D
`ydata`	массив 1D
`zorder`	вещественное число

См. также

magnitude_spectrum(): magnitude_spectrum() строит график величин соответствующих частот.
angle_spectrum(): angle_spectrum() строит график обернутой версии этой функции.
specgram(): specgram() может строить график спектра фаз отрезков сигнала с помощью цветовой карты.

Примечания

Примечание

Помимо описанных выше аргументов, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

Все аргументы со следующими именами: 'x'.