PoincarePlot: Poincare Plot

In RHRV: Heart Rate Variability Analysis of ECG Data

Poincare Plot

Description

The Poincare plot is a graphical representation of the dependance between successive RR intervals obtained by plotting the RR_{j+\tau} as a function of RR_j. This dependance is often quantified by fitting an ellipse to the plot. In this way, two parameters are obtained: SD_1 and SD_2. SD_1 characterizes short-term variability whereas that SD_2 characterizes long-term variability.

Usage

PoincarePlot(HRVData,
  indexNonLinearAnalysis = length(HRVData$NonLinearAnalysis), timeLag = 1,
  confidenceEstimation = FALSE, confidence = 0.95, doPlot = FALSE,
  main = "Poincare plot", xlab = "RR[n]", ylab = paste0("RR[n+", timeLag,
  "]"), pch = 1, cex = 0.3, type = "p", xlim = NULL, ylim = NULL, ...)

Arguments

HRVData	Data structure that stores the beats register and information related to it
indexNonLinearAnalysis	Reference to the data structure that will contain the nonlinear analysis
timeLag	Integer denoting the number of time steps that will be use to construct the dependance relation: RR_{j+timeLag} as a function of RR_j.
confidenceEstimation	Logical value. If TRUE, the covariance matrix is used for fitting the ellipse and computing the SD_1 and SD_2 parameters (see details). Default: FALSE.
confidence	The confidence used for plotting the confidence ellipse.
doPlot	Logical value. If TRUE (default), the PoincarePlot is shown.
main	An overall title for the Poincare plot.
xlab	A title for the x axis.
ylab	A title for the y axis.
pch	Plotting character (symbol to use).
cex	Character (or symbol) expansion.
type	What type of plot should be drawn. See plot.default.
xlim	x coordinates range. If not specified, a proper x range is selected.
ylim	y coordinates range. If not specified, a proper y range is selected.
...	Additional parameters for the Poincare plot figure.

Details

In the HRV literature, when timeLag = 1, the SD_1 and SD_2 parameters are computed using time domain measures. This is the default approach in this function if timeLag=1. This function also allows the user to fit a ellipse by computing the covariance matrix of (RR_{j},RR_{j+\tau}) (by setting confidenceEstimation = TRUE). In most cases, both approaches yield similar results.

Value

A HRVData structure containing a PoincarePlot field storing the SD_1 and SD_2 parameters. The PoincarePlot field is stored under the NonLinearAnalysis list.

Examples

## Not run: 
 data(HRVProcessedData)
 # rename for convenience
 hd = HRVProcessedData
 hd = CreateNonLinearAnalysis(hd)
 hd = PoincarePlot(hd, doPlot = T)

## End(Not run)

RHRV documentation built on Jan. 16, 2024, 3:05 a.m.