mne.viz.plot_raw_psd¶

mne.viz.plot_raw_psd(raw, tmin=0.0, tmax=inf, fmin=0, fmax=inf, proj=False, n_fft=None, picks=None, ax=None, color=’black’, area_mode=’std’, area_alpha=0.33, n_overlap=0, dB=True, average=None, show=True, n_jobs=1, line_alpha=None, spatial_colors=None, xscale=’linear’, verbose=None)[source]¶

Plot the power spectral density across channels.

Parameters:

Parameters:	raw : instance of io.Raw The raw instance to use. tmin : float Start time for calculations. tmax : float End time for calculations. fmin : float Start frequency to consider. fmax : float End frequency to consider. proj : bool Apply projection. n_fft : int \| None Number of points to use in Welch FFT calculations. Default is None, which uses the minimum of 2048 and the number of time points. picks : array-like of int \| None List of channels to use. Cannot be None if ax is supplied. If both picks and ax are None, separate subplots will be created for each standard channel type (mag, grad, and eeg). ax : instance of matplotlib Axes \| None Axes to plot into. If None, axes will be created. color : str \| tuple A matplotlib-compatible color to use. Has no effect when spatial_colors=True. area_mode : str \| None Mode for plotting area. If ‘std’, the mean +/- 1 STD (across channels) will be plotted. If ‘range’, the min and max (across channels) will be plotted. Bad channels will be excluded from these calculations. If None, no area will be plotted. If average=False, no area is plotted. area_alpha : float Alpha for the area. n_overlap : int The number of points of overlap between blocks. The default value is 0 (no overlap). dB : bool If True, transform data to decibels. If False, plot amplitudes. average : bool If False, the PSDs of all channels is displayed. No averaging is done and parameters area_mode and area_alpha are ignored. When False, it is possible to paint an area (hold left mouse button and drag) to plot a topomap. show : bool Show figure if True. n_jobs : int Number of jobs to run in parallel. line_alpha : float \| None Alpha for the PSD line. Can be None (default) to use 1.0 when `average=True` and 0.1 when `average=False`. spatial_colors : bool Whether to use spatial colors. Only used when `average=False`. xscale : str Can be ‘linear’ (default) or ‘log’. verbose : bool, str, int, or None If not None, override default verbose level (see `mne.verbose()` and Logging documentation for more).
Returns:	fig : instance of matplotlib figure Figure with frequency spectra of the data channels.

raw : instance of io.Raw

The raw instance to use.

tmin : float

Start time for calculations.

tmax : float

End time for calculations.

fmin : float

Start frequency to consider.

fmax : float

End frequency to consider.

proj : bool

Apply projection.

n_fft : int | None

Number of points to use in Welch FFT calculations. Default is None, which uses the minimum of 2048 and the number of time points.

picks : array-like of int | None

List of channels to use. Cannot be None if ax is supplied. If both picks and ax are None, separate subplots will be created for each standard channel type (mag, grad, and eeg).

ax : instance of matplotlib Axes | None

Axes to plot into. If None, axes will be created.

color : str | tuple

A matplotlib-compatible color to use. Has no effect when spatial_colors=True.

area_mode : str | None

Mode for plotting area. If ‘std’, the mean +/- 1 STD (across channels) will be plotted. If ‘range’, the min and max (across channels) will be plotted. Bad channels will be excluded from these calculations. If None, no area will be plotted. If average=False, no area is plotted.

area_alpha : float

Alpha for the area.

n_overlap : int

The number of points of overlap between blocks. The default value is 0 (no overlap).

dB : bool

If True, transform data to decibels. If False, plot amplitudes.

average : bool

If False, the PSDs of all channels is displayed. No averaging is done and parameters area_mode and area_alpha are ignored. When False, it is possible to paint an area (hold left mouse button and drag) to plot a topomap.

show : bool

Show figure if True.

n_jobs : int

Number of jobs to run in parallel.

line_alpha : float | None

Alpha for the PSD line. Can be None (default) to use 1.0 when average=True and 0.1 when average=False.

spatial_colors : bool

Whether to use spatial colors. Only used when average=False.

xscale : str

Can be ‘linear’ (default) or ‘log’.

verbose : bool, str, int, or None

If not None, override default verbose level (see mne.verbose() and Logging documentation for more).

Returns:

fig : instance of matplotlib figure

Figure with frequency spectra of the data channels.