v2.0.0
Loading...
Searching...
No Matches
debiasedsquaredweightedphaselagindex.cpp
Go to the documentation of this file.
1//=============================================================================================================
15
16//=============================================================================================================
17// INCLUDES
18//=============================================================================================================
19
23#include "../network/network.h"
24
25#include <math/spectral.h>
26
27//=============================================================================================================
28// QT INCLUDES
29//=============================================================================================================
30
31#include <QDebug>
32#include <QtConcurrent>
33
34//=============================================================================================================
35// EIGEN INCLUDES
36//=============================================================================================================
37
38#include <unsupported/Eigen/FFT>
39
40//=============================================================================================================
41// USED NAMESPACES
42//=============================================================================================================
43
44using namespace CONNECTIVITYLIB;
45using namespace Eigen;
46using namespace UTILSLIB;
47
48//=============================================================================================================
49// DEFINE GLOBAL METHODS
50//=============================================================================================================
51
52//=============================================================================================================
53// DEFINE MEMBER METHODS
54//=============================================================================================================
55
59
60//*******************************************************************************************************
61
63{
64// QElapsedTimer timer;
65// qint64 iTime = 0;
66// timer.start();
67
68 Network finalNetwork("DSWPLI");
69
70 if(connectivitySettings.isEmpty()) {
71 qDebug() << "DebiasedSquaredWeightedPhaseLagIndex::calculate - Input data is empty";
72 return finalNetwork;
73 }
74
76 connectivitySettings.clearIntermediateData();
77 }
78
79 finalNetwork.setSamplingFrequency(connectivitySettings.getSamplingFrequency());
80
81 #ifdef EIGEN_FFTW_DEFAULT
82 fftw_make_planner_thread_safe();
83 #endif
84
85 //Create nodes
86 int rows = connectivitySettings.at(0).matData.rows();
87 RowVectorXf rowVert = RowVectorXf::Zero(3);
88
89 for(int i = 0; i < rows; ++i) {
90 rowVert = RowVectorXf::Zero(3);
91
92 if(connectivitySettings.getNodePositions().rows() != 0 && i < connectivitySettings.getNodePositions().rows()) {
93 rowVert(0) = connectivitySettings.getNodePositions().row(i)(0);
94 rowVert(1) = connectivitySettings.getNodePositions().row(i)(1);
95 rowVert(2) = connectivitySettings.getNodePositions().row(i)(2);
96 }
97
98 finalNetwork.append(NetworkNode::SPtr(new NetworkNode(i, rowVert)));
99 }
100
101 // Check that iNfft >= signal length
102 int iSignalLength = connectivitySettings.at(0).matData.cols();
103 int iNfft = connectivitySettings.getFFTSize();
104
105 // Generate tapers
106 QPair<MatrixXd, VectorXd> tapers = Spectral::generateTapers(iSignalLength, connectivitySettings.getWindowType());
107
108 // Initialize
109 int iNRows = connectivitySettings.at(0).matData.rows();
110 int iNFreqs = int(floor(iNfft / 2.0)) + 1;
111
112 // Check if start and bin amount need to be reset to full spectrum
113 if(m_iNumberBinStart == -1 ||
114 m_iNumberBinAmount == -1 ||
115 m_iNumberBinStart > iNFreqs ||
116 m_iNumberBinAmount > iNFreqs ||
118 qDebug() << "DebiasedSquaredWeightedPhaseLagIndex::calculate - Resetting to full spectrum";
121 }
122
123 // Pass information about the FFT length. Use iNFreqs because we only use the half spectrum
124 finalNetwork.setFFTSize(iNFreqs);
126
127 QMutex mutex;
128
129 std::function<void(ConnectivitySettings::IntermediateTrialData&)> computeLambda = [&](ConnectivitySettings::IntermediateTrialData& inputData) {
130 return compute(inputData,
131 connectivitySettings.getIntermediateSumData().vecPairCsdSum,
132 connectivitySettings.getIntermediateSumData().vecPairCsdImagAbsSum,
133 connectivitySettings.getIntermediateSumData().vecPairCsdImagSqrdSum,
134 mutex,
135 iNRows,
136 iNFreqs,
137 iNfft,
138 tapers);
139 };
140
141// iTime = timer.elapsed();
142// qWarning() << "Preparation" << iTime;
143// timer.restart();
144
145 // Compute DSWPLI in parallel for all trials
146 QFuture<void> result = QtConcurrent::map(connectivitySettings.getTrialData(),
147 computeLambda);
148 result.waitForFinished();
149
150// iTime = timer.elapsed();
151// qWarning() << "ComputeSpectraPSDCSD" << iTime;
152// timer.restart();
153
154 // Compute DSWPLI
155 computeDSWPLI(connectivitySettings,
156 finalNetwork);
157
158// iTime = timer.elapsed();
159// qWarning() << "Compute" << iTime;
160// timer.restart();
161
162 return finalNetwork;
163}
164
165//=============================================================================================================
166
168 QVector<QPair<int,MatrixXcd> >& vecPairCsdSum,
169 QVector<QPair<int,MatrixXd> >& vecPairCsdImagAbsSum,
170 QVector<QPair<int,MatrixXd> >& vecPairCsdImagSqrdSum,
171 QMutex& mutex,
172 int iNRows,
173 int iNFreqs,
174 int iNfft,
175 const QPair<MatrixXd, VectorXd>& tapers)
176{
177 if(inputData.vecPairCsd.size() == iNRows &&
178 inputData.vecPairCsdImagSqrd.size() == iNRows &&
179 inputData.vecPairCsdImagAbs.size() == iNRows) {
180 //qDebug() << "DebiasedSquaredWeightedPhaseLagIndex::compute - vecPairCsd, vecPairCsdImagSqrd and vecPairCsdImagAbs were already computed for this trial.";
181 return;
182 }
183
184 int i,j;
185
186 // Calculate tapered spectra if not available already
187 // This code was copied and changed modified Utils/Spectra since we do not want to call the function due to time loss.
188 if(inputData.vecTapSpectra.isEmpty()) {
189 RowVectorXd vecInputFFT, rowData;
190 RowVectorXcd vecTmpFreq;
191
192 MatrixXcd matTapSpectrum(tapers.first.rows(), iNFreqs);
193
194 FFT<double> fft;
195 fft.SetFlag(fft.HalfSpectrum);
196
197 for (i = 0; i < iNRows; ++i) {
198 // Substract mean
199 rowData.array() = inputData.matData.row(i).array() - inputData.matData.row(i).mean();
200
201 // Calculate tapered spectra if not available already
202 for(j = 0; j < tapers.first.rows(); j++) {
203 // Zero padd if necessary. The zero padding in Eigen's FFT is only working for column vectors.
204 if (rowData.cols() < iNfft) {
205 vecInputFFT.setZero(iNfft);
206 vecInputFFT.block(0,0,1,rowData.cols()) = rowData.cwiseProduct(tapers.first.row(j));;
207 } else {
208 vecInputFFT = rowData.cwiseProduct(tapers.first.row(j));
209 }
210
211 // FFT for freq domain returning the half spectrum and multiply taper weights
212 fft.fwd(vecTmpFreq, vecInputFFT, iNfft);
213 matTapSpectrum.row(j) = vecTmpFreq * tapers.second(j);
214 }
215
216 inputData.vecTapSpectra.append(matTapSpectrum);
217 }
218 }
219
220 // Compute CSD
221 if(inputData.vecPairCsd.isEmpty()) {
222 MatrixXcd matCsd(iNRows, m_iNumberBinAmount);
223
224 bool bNfftEven = false;
225 if (iNfft % 2 == 0){
226 bNfftEven = true;
227 }
228
229 double denomCSD = sqrt(tapers.second.cwiseAbs2().sum()) * sqrt(tapers.second.cwiseAbs2().sum()) / 2.0;
230
231 for (i = 0; i < iNRows; ++i) {
232 for (j = i; j < iNRows; ++j) {
233 // Compute CSD (average over tapers if necessary)
234 matCsd.row(j) = inputData.vecTapSpectra.at(i).block(0,m_iNumberBinStart,inputData.vecTapSpectra.at(i).rows(),m_iNumberBinAmount).cwiseProduct(inputData.vecTapSpectra.at(j).block(0,m_iNumberBinStart,inputData.vecTapSpectra.at(j).rows(),m_iNumberBinAmount).conjugate()).colwise().sum() / denomCSD;
235
236 // Divide first and last element by 2 due to half spectrum
237 if(m_iNumberBinStart == 0) {
238 matCsd.row(j)(0) /= 2.0;
239 }
240
241 if(bNfftEven && m_iNumberBinStart + m_iNumberBinAmount >= iNFreqs) {
242 matCsd.row(j).tail(1) /= 2.0;
243 }
244 }
245
246 inputData.vecPairCsd.append(QPair<int,MatrixXcd>(i,matCsd));
247 inputData.vecPairCsdImagSqrd.append(QPair<int,MatrixXd>(i,matCsd.imag().array().square()));
248 inputData.vecPairCsdImagAbs.append(QPair<int,MatrixXd>(i,matCsd.imag().cwiseAbs()));
249 }
250
251 mutex.lock();
252
253 if(vecPairCsdSum.isEmpty()) {
254 vecPairCsdSum = inputData.vecPairCsd;
255 vecPairCsdImagSqrdSum = inputData.vecPairCsdImagSqrd;
256 vecPairCsdImagAbsSum = inputData.vecPairCsdImagAbs;
257 } else {
258 for (int j = 0; j < vecPairCsdSum.size(); ++j) {
259 vecPairCsdSum[j].second += inputData.vecPairCsd.at(j).second;
260 vecPairCsdImagSqrdSum[j].second += inputData.vecPairCsdImagSqrd.at(j).second;
261 vecPairCsdImagAbsSum[j].second += inputData.vecPairCsdImagAbs.at(j).second;
262 }
263 }
264
265 mutex.unlock();
266 } else {
267 if(inputData.vecPairCsdImagSqrd.isEmpty()) {
268 for (i = 0; i < inputData.vecPairCsd.size(); ++i) {
269 inputData.vecPairCsdImagSqrd.append(QPair<int,MatrixXd>(i,inputData.vecPairCsd.at(i).second.imag().array().square()));
270 }
271
272 mutex.lock();
273
274 if(vecPairCsdImagSqrdSum.isEmpty()) {
275 vecPairCsdImagSqrdSum = inputData.vecPairCsdImagSqrd;
276 } else {
277 for (int j = 0; j < vecPairCsdSum.size(); ++j) {
278 vecPairCsdImagSqrdSum[j].second += inputData.vecPairCsdImagSqrd.at(j).second;
279 }
280 }
281
282 mutex.unlock();
283 }
284
285 if(inputData.vecPairCsdImagAbs.isEmpty()) {
286 for (i = 0; i < inputData.vecPairCsd.size(); ++i) {
287 inputData.vecPairCsdImagAbs.append(QPair<int,MatrixXd>(i,inputData.vecPairCsd.at(i).second.imag().cwiseAbs()));
288 }
289
290 mutex.lock();
291
292 if(vecPairCsdImagAbsSum.isEmpty()) {
293 vecPairCsdImagAbsSum = inputData.vecPairCsdImagAbs;
294 } else {
295 for (int j = 0; j < vecPairCsdSum.size(); ++j) {
296 vecPairCsdImagAbsSum[j].second += inputData.vecPairCsdImagAbs.at(j).second;
297 }
298 }
299
300 mutex.unlock();
301 }
302 }
303
305 inputData.vecPairCsd.clear();
306 inputData.vecTapSpectra.clear();
307 inputData.vecPairCsdImagAbs.clear();
308 inputData.vecPairCsdImagSqrd.clear();
309 }
310}
311
312//=============================================================================================================
313
315 Network& finalNetwork)
316{
317 // Compute final DSWPLI and create Network
318 MatrixXd matNom, matDenom;
319 MatrixXd matWeight;
320 QSharedPointer<NetworkEdge> pEdge;
321 int j;
322
323 for (int i = 0; i < connectivitySettings.at(0).matData.rows(); ++i) {
324
325 matNom = connectivitySettings.getIntermediateSumData().vecPairCsdSum.at(i).second.imag().array().square();
326 matNom -= connectivitySettings.getIntermediateSumData().vecPairCsdImagSqrdSum.at(i).second;
327
328 matDenom = connectivitySettings.getIntermediateSumData().vecPairCsdImagAbsSum.at(i).second.array().square();
329 matDenom -= connectivitySettings.getIntermediateSumData().vecPairCsdImagSqrdSum.at(i).second;
330
331 matDenom = (matDenom.array() == 0.).select(INFINITY, matDenom);
332 matDenom = matNom.cwiseQuotient(matDenom);
333
334 for(j = i; j < connectivitySettings.at(0).matData.rows(); ++j) {
335 matWeight = matDenom.row(j).transpose();
336
337 pEdge = QSharedPointer<NetworkEdge>(new NetworkEdge(i, j, matWeight));
338
339 finalNetwork.getNodeAt(i)->append(pEdge);
340 finalNetwork.getNodeAt(j)->append(pEdge);
341 finalNetwork.append(pEdge);
342 }
343
344 }
345}
346
Debiased squared Weighted Phase Lag Index (Vinck et al., 2011) between every channel pair.
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...
Multi-taper spectral estimation: tapered FFT, power and cross-spectral density, DPSS weighting.
Functional connectivity metrics (coherence, PLV, cross-correlation, etc.).
Shared utilities (I/O helpers, spectral analysis, layout management, warp algorithms).
Aggregates trial data, spectral cache and node geometry shared by all CONNECTIVITYLIB metrics.
QList< IntermediateTrialData > & getTrialData()
const IntermediateTrialData & at(int i) const
const Eigen::MatrixX3f & getNodePositions() const
Per-trial intermediate frequency-domain data used during connectivity computation.
QVector< QPair< int, Eigen::MatrixXd > > vecPairCsdImagAbsSum
QVector< QPair< int, Eigen::MatrixXd > > vecPairCsdImagSqrdSum
QVector< QPair< int, Eigen::MatrixXcd > > vecPairCsdSum
static Network calculate(ConnectivitySettings &connectivitySettings)
static void compute(ConnectivitySettings::IntermediateTrialData &inputData, QVector< QPair< int, Eigen::MatrixXcd > > &vecPairCsdSum, QVector< QPair< int, Eigen::MatrixXd > > &vecPairCsdImagAbsSum, QVector< QPair< int, Eigen::MatrixXd > > &vecPairCsdImagSqrdSum, QMutex &mutex, int iNRows, int iNFreqs, int iNfft, const QPair< Eigen::MatrixXd, Eigen::VectorXd > &tapers)
static void computeDSWPLI(ConnectivitySettings &connectivitySettings, Network &finalNetwork)
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
static QPair< Eigen::MatrixXd, Eigen::VectorXd > generateTapers(int iSignalLength, const QString &sWindowType="hanning")
Definition spectral.cpp:270