Software Open Access
Dynamical Density Delay Maps
Published: Jan. 31, 2015. Version: 1.0.0
Please include the standard citation for PhysioNet:
(show more options)
Goldberger, A., Amaral, L., Glass, L., Hausdorff, J., Ivanov, P. C., Mark, R., ... & Stanley, H. E. (2000). PhysioBank, PhysioToolkit, and PhysioNet: Components of a new research resource for complex physiologic signals. Circulation [Online]. 101 (23), pp. e215–e220.
Software Description
This directory contains Matlab functions for visualizing the behavior of complex systems by means of the dynamical density delay mapping ("D3Map") technique . This simpletoimplement visualization method provides an animated representation of a system's dynamics. The method is based on a generalization of conventional twodimensional (2D) Poincaré plots, which are scatter plots where each data point,x(n),in a time series is plotted against the adjacent one x (n + 1). First, we divide the original time series, x(n) (n=1,...,N), into a sequence of segments (windows). Next, for each segment, a threedimensional (3D) Poincaré surface plot of x(n), x(n + 1), h[x(n), x(n + 1)] is generated, in which the third dimension, h,represents the relative frequency of occurrence of each (x(n),x(n + 1)) point. This 3D Poincaré surface is then chromatized by mapping the relative frequency h values onto a color scheme. We also generate a colorized 2D contour plot from each time series segment using the same colormap scheme as for the 3D Poincaré surface. Finally, the original time series graph, the colorized 3D Poincaré surface plot, and its projection as a colorized 2D contour map for each segment, are animated to create the full "D3Map".
This visualization technique can be applied to cardiac interval time series, to uncover complex dynamical changes, e.g. transitions between sleep stages, or to detect hidden temporal patterns, e.g, RR patterns in atrial fibrillation.
 D3M2Dfun.m generates colorized contour Poincaré plots
 D3M3Dfun.m generates colorized 3D Poincaré surface maps
 dscatter2.m is a support function for creating a scatter plot colored by density
 D3Mdemo.m is a demo script to show how to generate videos with D3M3Dfun.m
The functions have been tested on Matlab R2013b.
Sample Input
The folders includes 3 cardiac interval time series for testing the functions:
 Sleep_RR.dat ASCII file with the cardiac interbeat (RR) intervals obtained from the electrocardiographic recording of a healthy subject during sleep (~6 h)
 Typical_AF.dat ASCII file with the cardiac interbeat (RR) intervals obtained from the electrocardiographic recording of a subject with atrial fibrillation
 Atypical_AF.dat ASCII file with the cardiac interbeat (RR) intervals obtained from the electrocardiographic recording of a subject with atrial fibrillation, whose contour and 3D maps show atypical (i.e., periodic) dynamical patterns
Acknowledgments
This package was developed at the Wyss Institute at Harvard by A. Burykin, L. Citi, T. Silva, M.D. Costa and A.L. Goldberger. S. Mariani and T. Henriques contributed to the modification and packaging of the software and the creation of this tutorial.
Users of our software should cite: Burykin A, Costa MD, Citi L, and Goldberger AL, "Dynamical density delay maps: simple, new method for visualising the behaviour of complex systems." BMC Medical Informatics and Decision Making, 14.1 (2014): 6.
Access
Access Policy:
Anyone can access the files, as long as they conform to the terms of the specified license.
License (for files):
Open Data Commons Attribution License v1.0
Discovery
Topics:
complexity
visualization
Corresponding Author
Files
Total uncompressed size: 47.1 MB.
Access the files

Download the files using your terminal:
wget r N c np https://physionet.org/files/dddmaps/1.0.0/
Name  Size  Modified 

Parent Directory  
Atypical_AF.dat (download)  3.2 MB  20190412 
D3M_2Dfun.m (download)  3.0 KB  20190412 
D3M_3Dfun.m (download)  3.1 KB  20190412 
D3Mdemo.m (download)  1.2 KB  20190412 
Sleep_RR.dat (download)  700.9 KB  20190412 
Typical_AF.dat (download)  3.7 MB  20190412 
dscatter2.m (download)  6.6 KB  20190412 