v2.0.0
Loading...
Searching...
No Matches
directed_transfer_function.cpp
Go to the documentation of this file.
1//=============================================================================================================
12
13//=============================================================================================================
14// INCLUDES
15//=============================================================================================================
16
18#include "mvar_model.h"
21#include "../network/network.h"
23
24//=============================================================================================================
25// QT INCLUDES
26//=============================================================================================================
27
28#include <QDebug>
29
30//=============================================================================================================
31// EIGEN INCLUDES
32//=============================================================================================================
33
34#include <Eigen/Dense>
35
36//=============================================================================================================
37// USED NAMESPACES
38//=============================================================================================================
39
40using namespace CONNECTIVITYLIB;
41using namespace Eigen;
42
43//=============================================================================================================
44// DEFINE GLOBAL METHODS
45//=============================================================================================================
46
47//=============================================================================================================
48// DEFINE MEMBER METHODS
49//=============================================================================================================
50
54
55//=============================================================================================================
56
58{
59 Network finalNetwork("DTF");
60
61 if(connectivitySettings.isEmpty()) {
62 qDebug() << "DirectedTransferFunction::calculate - Input data is empty";
63 return finalNetwork;
64 }
65
66 finalNetwork.setSamplingFrequency(connectivitySettings.getSamplingFrequency());
67
68 // Average trial data for MVAR fitting
69 const int nTrials = connectivitySettings.size();
70 MatrixXd matDataAvg = connectivitySettings.at(0).matData;
71 for(int t = 1; t < nTrials; ++t) {
72 matDataAvg += connectivitySettings.at(t).matData;
73 }
74 matDataAvg /= static_cast<double>(nTrials);
75
76 const int nCh = static_cast<int>(matDataAvg.rows());
77 const int iNfft = connectivitySettings.getFFTSize();
78 const int iNFreqs = static_cast<int>(std::floor(iNfft / 2.0)) + 1;
79
80 finalNetwork.setFFTSize(iNFreqs);
81 finalNetwork.setUsedFreqBins(iNFreqs);
82
83 // Create nodes
84 RowVectorXf rowVert = RowVectorXf::Zero(3);
85 for(int i = 0; i < nCh; ++i) {
86 rowVert = RowVectorXf::Zero(3);
87 if(connectivitySettings.getNodePositions().rows() != 0 && i < connectivitySettings.getNodePositions().rows()) {
88 rowVert(0) = connectivitySettings.getNodePositions().row(i)(0);
89 rowVert(1) = connectivitySettings.getNodePositions().row(i)(1);
90 rowVert(2) = connectivitySettings.getNodePositions().row(i)(2);
91 }
92 finalNetwork.append(NetworkNode::SPtr(new NetworkNode(i, rowVert)));
93 }
94
95 // Fit MVAR model
96 MvarModel model;
97 model.fit(matDataAvg);
98
99 // Compute transfer function at normalized frequencies
100 VectorXd vecFreqs = VectorXd::LinSpaced(iNFreqs, 0.0, 0.5);
101 QVector<MatrixXcd> vecH = model.transferFunction(vecFreqs);
102
103 // Compute DTF: DTF_{ij}(f) = |H_{ij}(f)|^2 / sum_k |H_{ik}(f)|^2
104 // (normalized per row i)
105 for(int i = 0; i < nCh; ++i) {
106 for(int j = 0; j < nCh; ++j) {
107 MatrixXd matWeight(iNFreqs, 1);
108
109 for(int fi = 0; fi < iNFreqs; ++fi) {
110 // Row normalization: sum of |H_{ik}(f)|^2 over all k
111 double rowNorm = 0.0;
112 for(int k = 0; k < nCh; ++k) {
113 rowNorm += std::norm(vecH[fi](i, k));
114 }
115
116 if(rowNorm > 0.0) {
117 matWeight(fi, 0) = std::norm(vecH[fi](i, j)) / rowNorm;
118 } else {
119 matWeight(fi, 0) = 0.0;
120 }
121 }
122
123 QSharedPointer<NetworkEdge> pEdge =
124 QSharedPointer<NetworkEdge>(new NetworkEdge(j, i, matWeight));
125
126 finalNetwork.getNodeAt(j)->append(pEdge);
127 finalNetwork.getNodeAt(i)->append(pEdge);
128 finalNetwork.append(pEdge);
129 }
130 }
131
132 return finalNetwork;
133}
Multivariate autoregressive (MVAR) model fit and its frequency-domain decomposition; backbone of the ...
Directed Transfer Function (Kaminski & Blinowska 1991) between every channel pair,...
Input-data and parameter container shared by every functional-connectivity metric in CONNECTIVITYLIB.
Weighted edge between two NetworkNode instances; stores the full per-frequency weight matrix and the ...
Node of a connectivity Network; carries a 3D position and the lists of incident (in / out,...
Graph container that stores the result of one functional-connectivity metric as nodes (sources/sensor...
Functional connectivity metrics (coherence, PLV, cross-correlation, etc.).
Aggregates trial data, spectral cache and node geometry shared by all CONNECTIVITYLIB metrics.
const IntermediateTrialData & at(int i) const
const Eigen::MatrixX3f & getNodePositions() const
static Network calculate(ConnectivitySettings &connectivitySettings)
MVAR model fit; provides H(f) and S(f) for Granger Causality, DTF and PDC.
Definition mvar_model.h:89
QVector< Eigen::MatrixXcd > transferFunction(const Eigen::VectorXd &freqs) const
void fit(const Eigen::MatrixXd &data, int p=0)
Graph container for one connectivity metric; nodes + weighted edges + threshold/visualisation state.
Definition network.h:98
void setUsedFreqBins(int iNumberFreqBins)
Definition network.cpp:493
void append(QSharedPointer< NetworkEdge > newEdge)
void setFFTSize(int iFFTSize)
Definition network.cpp:500
void setSamplingFrequency(float fSFreq)
Definition network.cpp:479
QSharedPointer< NetworkNode > getNodeAt(int i)
Definition network.cpp:143
Weighted, directional edge in a Network; carries per-frequency weights plus a band-averaged scalar.
Definition networkedge.h:82
Graph node carrying a 3D position and its incident in/out, full/thresholded edge lists.
Definition networknode.h:80
QSharedPointer< NetworkNode > SPtr
Definition networknode.h:83