Skip to main content

WeightedPhaseLagIndex

Namespace: CONNECTIVITYLIB  ·  Library: Connectivity Library

#include <connectivity/weightedphaselagindex.h>

class CONNECTIVITYLIB::WeightedPhaseLagIndex

Computes the Weighted Phase Lag Index of Vinck et al.

(NeuroImage 2011).

Each channel pair is reduced to |sum Im(S_{xy})| / sum |Im(S_{xy})|, weighting every cross-spectrum sample by the magnitude of its imaginary part. This down-weights near-zero-lag samples that dominate the bias of the plain PhaseLagIndex and yields higher detection power for true delayed interactions while preserving the volume-conduction rejection property. Per-trial sums are accumulated in ConnectivitySettings::IntermediateSumData and shared with DebiasedSquaredWeightedPhaseLagIndex when both metrics are requested in one batch.

Weighted Phase Lag Index estimator (Vinck et al. 2011); volume-conduction-robust with lower bias than PLI.

src/examples/ex_connectivity_metrics/main.cpp
Network wpli = WeightedPhaseLagIndex::calculate(settings);
wpli.setFrequencyRange(8.0f, 12.0f);

Inheritance​

Public Methods​

WeightedPhaseLagIndex()​

Constructs a WeightedPhaseLagIndex object.

Static Methods​

calculate(connectivitySettings)​

Calculates the WPLI between the rows of the data matrix.

Parameters:

Returns:

  • Network — The connectivity information in form of a network structure.

Example​

Used in examples​

ex_connectivity_metrics​

Connectivity metrics on synthetic data with a known coupling.

src/examples/ex_connectivity_metrics/main.cpp, line 207
pli.setFrequencyRange(8.0f, 12.0f);
Network wpli = WeightedPhaseLagIndex::calculate(settings);
wpli.setFrequencyRange(8.0f, 12.0f);
Network uspli = UnbiasedSquaredPhaseLagIndex::calculate(settings);
uspli.setFrequencyRange(8.0f, 12.0f);
Network dswpli = DebiasedSquaredWeightedPhaseLagIndex::calculate(settings);
dswpli.setFrequencyRange(8.0f, 12.0f);

Authors of this file​