matplotlib.pyplot.phase_spectrum#

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

Plot the phase spectrum.

Compute the phase spectrum (unwrapped angle spectrum) ofx.Data is padded to a length ofpad_to and the windowing functionwindow is applied to the signal.

Parameters:
x1-D array or sequence

Array or sequence containing the data

Fsfloat, default: 2

The sampling frequency (samples per time unit). It is used to calculatethe Fourier frequencies,freqs, in cycles per time unit.

windowcallable or ndarray, default:window_hanning

A function or a vector of lengthNFFT. To create window vectors seewindow_hanning,window_none,numpy.blackman,numpy.hamming,numpy.bartlett,scipy.signal,scipy.signal.get_window, etc. If afunction is passed as the argument, it must take a data segment as anargument and return the windowed version of the segment.

sides{'default', 'onesided', 'twosided'}, optional

Which sides of the spectrum to return. 'default' is one-sided for realdata and two-sided for complex data. 'onesided' forces the return of aone-sided spectrum, while 'twosided' forces two-sided.

pad_toint, optional

The number of points to which the data segment is padded when performingthe FFT. While not increasing the actual resolution of the spectrum (theminimum distance between resolvable peaks), this can give more points inthe plot, allowing for more detail. This corresponds to then parameterin the call tofft. The default is None, which setspad_toequal to the length of the input signal (i.e. no padding).

Fcint, default: 0

The center frequency ofx, which offsets the x extents of theplot to reflect the frequency range used when a signal is acquiredand then filtered and downsampled to baseband.

Returns:
spectrum1-D array

The values for the phase spectrum in radians (real valued).

freqs1-D array

The frequencies corresponding to the elements inspectrum.

lineLine2D

The line created by this function.

Other Parameters:
dataindexable object, optional

If given, the following parameters also accept a strings, which isinterpreted asdata[s] ifs is a key indata:

x

**kwargs

Keyword arguments control theLine2D properties:

Property

Description

agg_filter

a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array and two offsets from the bottom left corner of the image

alpha

float or None

animated

bool

antialiased oraa

bool

clip_box

BboxBase or None

clip_on

bool

clip_path

Patch or (Path, Transform) or None

color orc

color

dash_capstyle

CapStyle or {'butt', 'projecting', 'round'}

dash_joinstyle

JoinStyle or {'miter', 'round', 'bevel'}

dashes

sequence of floats (on/off ink in points) or (None, None)

data

(2, N) array or two 1D arrays

drawstyle ords

{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'

figure

Figure orSubFigure

fillstyle

{'full', 'left', 'right', 'bottom', 'top', 'none'}

gapcolor

color or None

gid

str

in_layout

bool

label

object

linestyle orls

{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

linewidth orlw

float

marker

marker style string,Path orMarkerStyle

markeredgecolor ormec

color

markeredgewidth ormew

float

markerfacecolor ormfc

color

markerfacecoloralt ormfcalt

color

markersize orms

float

markevery

None or int or (int, int) or slice or list[int] or float or (float, float) or list[bool]

mouseover

bool

path_effects

list ofAbstractPathEffect

picker

float or callable[[Artist, Event], tuple[bool, dict]]

pickradius

float

rasterized

bool

sketch_params

(scale: float, length: float, randomness: float)

snap

bool or None

solid_capstyle

CapStyle or {'butt', 'projecting', 'round'}

solid_joinstyle

JoinStyle or {'miter', 'round', 'bevel'}

transform

unknown

url

str

visible

bool

xdata

1D array

ydata

1D array

zorder

float

See also

magnitude_spectrum

Plots the magnitudes of the corresponding frequencies.

angle_spectrum

Plots the wrapped version of this function.

specgram

Can plot the phase spectrum of segments within the signal in a colormap.

Notes

On this page