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 see
window_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 to
fft. 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.
- line
Line2D The line created by this function.
- Other Parameters:
- dataindexable object, optional
If given, the following parameters also accept a string
s, which isinterpreted asdata[s]ifsis a key indata:x
- **kwargs
Keyword arguments control the
Line2Dproperties:Property
Description
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
float or None
bool
bool
BboxBaseor Nonebool
Patch or (Path, Transform) or None
CapStyleor {'butt', 'projecting', 'round'}JoinStyleor {'miter', 'round', 'bevel'}sequence of floats (on/off ink in points) or (None, None)
(2, N) array or two 1D arrays
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
color or None
str
bool
object
{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
float
marker style string,
PathorMarkerStylefloat
markersizeormsfloat
None or int or (int, int) or slice or list[int] or float or (float, float) or list[bool]
bool
list of
AbstractPathEffectfloat or callable[[Artist, Event], tuple[bool, dict]]
float
bool
(scale: float, length: float, randomness: float)
bool or None
CapStyleor {'butt', 'projecting', 'round'}JoinStyleor {'miter', 'round', 'bevel'}unknown
str
bool
1D array
1D array
float
See also
magnitude_spectrumPlots the magnitudes of the corresponding frequencies.
angle_spectrumPlots the wrapped version of this function.
specgramCan plot the phase spectrum of segments within the signal in a colormap.
Notes
Note
This is thepyplot wrapper for
axes.Axes.phase_spectrum.