sep_beats: sep_beats

In stw32/PulseWaveform: Extraction of Photoplethysmography Waveform Features and Decomposition Modeling of Pulse Waveforms

sep_beats

Description

sep_beats segments the PPG time series into individual pulse waveforms, allowing for an average morphology to be elucidated as well as the later extraction of individual waveform features. Segmented beats undergo a cleaning process to exclude beats with aberrant morphology (thresholds have been determined empirically). There is also an optional subsetting routine which allows for identification of periods of increased heart rate (or lower IBI) in a time series and subsequent selection of the corresponding waveforms - for more details on this see supplementary material.

Usage

sep_beats(odiff, bc, samp, wuv, wvlen, inx, o, ibi, scale = TRUE, q = FALSE, subset = FALSE, boundaries = NULL)

Arguments

odiff	vector of intervals between successive O (trough) points
bc	the baseline corrected time series
samp	sampling rate
wuv	dataframe of w, u and v values for each identified beat
wvlen	the median of O-diff +/- empirically determined value
inx	vector of inflection points (x/time coordinates)
o	vector of o points
ibi	vector of interbeat intervals (as determined by w points (peaks in 1st derivative))
scale	logical, determines if pulse waveforms are scaled / normalized for amplitude
q	logical, if TRUE number of beats excluded for each reason will be reported (useful for determining when thresholds may be to liberal/conservative)
subset	logical, determines if subsetting (as described above) is carried out
boundaries	ISO analysis specific argument (for carrying over subsetting constants between time series)

Value

average_wave	vector of values for the averaged waveform
pulse	dataframe of all individual pulse waveforms in segmented form
wuv	dataframe of w, u and v values (updated for excluded beats) for all waveforms
rejects	list of vectors, each comrprised of waves excluded for a particular reason

Examples

tmp <- sep_beats(odiff = oDiff, bc = baseCor, samp = samplingRate, wuv = wuv, wvlen = waveLen,
                 ibi=ibi, o=o_orig, inx = inflexX, scale = T, q = F, subset = FALSE, boundaries)

stw32/PulseWaveform documentation built on Dec. 6, 2022, 2:50 a.m.