fdPID - frequency domain Partial Information Decomposition
Matlab Tool for the spectral decomposition of
interaction information, redundancy and synergy
While cross-spectral and information-theoretic approaches are widely
used for the multivariate analysis of physiological time series, their
combined utilization is far less developed in the literature.
This toolbox realizes a framework for the spectral decomposition of
multivariate information measures, which provides frequency-specific
quantifications of the information shared between a target and two
source time series and of its expansion into amounts related to how the
sources contribute to the target dynamics with unique, redundant and
synergistic information.
The framework is illustrated in simulations of linearly interacting stochastic processes, showing how it allows to retrieve amounts of information shared by the processes within specific frequency bands which are otherwise not detectable by time-domain information measures, as well as coupling features which are not detectable by spectral measures.
Its application is also illustrated on exemplary time series of
heart period, systolic and diastolic arterial pressure and respiration
variability measured in healthy subjects monitored at rest and during
postural stress.
DOWNLOAD: Zip file with all scripts and functions: fdPID.zip
The code is provided free of charge. It is neither exhaustively tested
nor particularly well documented. The authors accept no liability for
its use. Use, modification and redistribution of the code is allowed in
any way users see fit. Authors ask only that authorship is acknowledged
and ref. [1] is cited upon utilization of the code in integral or
partial form.
DISCLAIMER OF
WARRANTIES AND LIMITATION OF LIABILITY The code is supplied as is and
all use is at your own risk. The authors disclaim all warranties of any
kind, either express or implied, as to the softwares, including, but
not limited to, implied warranties of fitness for a particular purpose,
merchantability or non - infringement of proprietary rights. Neither
this agreement nor any documentation furnished under it is intended to
express or imply any warranty that the operation of the software will
be error - free. Under no circumstances shall the authors of the
softwares provided here be liable to any user for direct, indirect,
incidental, consequential, special, or exemplary damages, arising from
the software, or user' s use or misuse of the softwares. Such
limitation of liability shall apply whether the damages arise from the
use or misuse of the data provided or errors of the software.
References:
L Faes, R Pernice, G Mijatovic, Y Antonacci, J Krohova, M Javorka, A Porta, 'Information decomposition in the frequency domain: a new framework to study cardiovascular and cardiorespiratory oscillations' submitted, 2020; BioRxiv preprint: 10.1101/2020.10.14.338939
Click here to download a zip file with the dataset analized in the above article