find_time_peaks¶

find_time_peaks(fpeak_proms, fpeak_freqs, fpeak_bandwidths, fpeak_bandwidth_bounds, stimes, varargin)¶

FIND_TIME_PEAKS Find peaks in the frequency-domain prominence curve over time to locate TF events

Usage:

[fpeak_proms, tpeak_proms, tpeak_times, tpeak_durations, tpeak_center_times, …: tpeak_central_frequencies, tpeak_bandwidths, tpeak_bandwidth_bounds, … tpeak_sd_central_frequencies, tpeak_sd_bandwidths, tpeak_interpeak_intervals] = …

find_time_peaks(fpeak_proms, fpeak_freqs, fpeak_bandwidths, fpeak_bandwidth_bounds, stimes, ‘Name’, Value, …)

Inputs:

fpeak_proms : 1xT double - peak prominence time series from find_frequency_peaks – required fpeak_freqs : 1xT double - per-timepoint central frequencies (Hz) – required fpeak_bandwidths : 1xT double - per-timepoint spectral bandwidths (Hz) – required fpeak_bandwidth_bounds : Tx2 double - per-timepoint low/high bandwidth bounds (Hz) – required stimes : 1xT double - time axis (s) – required

Name-Value Pairs:

‘valid_time_inds’ : 1xT logical - mask of time points to include (default: all true) ‘smooth_sec’ : double - movmean smoothing of prominence curve in seconds (default: 0.3) ‘min_peak_width_sec’ : double - minimum peak width in seconds (default: 0.3) ‘min_peak_distance_sec’ : double - minimum peak-to-peak distance in seconds (default: 0)

Outputs:

fpeak_proms : 1xT double - (possibly smoothed) prominence curve tpeak_proms : Nx1 double - prominence of each detected time peak tpeak_times : Nx2 double - [start_time, end_time] per event tpeak_durations : Nx1 double - duration of each event (s) tpeak_center_times : Nx1 double - peak time (s) tpeak_central_frequencies : Nx1 double - central frequency at peak time (Hz) tpeak_bandwidths : Nx1 double - bandwidth at peak time (Hz) tpeak_bandwidth_bounds : Nx2 double - bandwidth bounds at peak time (Hz) tpeak_sd_central_frequencies : Nx1 double - SD of central frequency across the event tpeak_sd_bandwidths : Nx1 double - SD of bandwidth across the event tpeak_interpeak_intervals : (N-1)x1 double - end-to-start intervals between consecutive events

Notes

tpeak_times are derived from findpeaks half-height widths and reported as [start, end] with report_width_scale = 0.5. SD and interval outputs are computed only when nargout > 8.

See also: find_frequency_peaks, findpeaks_extents, TF_peak_detection

∿∿∿ Prerau Laboratory MATLAB Codebase · sleepEEG.org ∿∿∿