v2.0.0
Loading...
Searching...
No Matches
CONNECTIVITYLIB::PhaseLockingValue Class Reference

Phase Locking Value estimator (Lachaux et al. 1999); amplitude-independent phase coupling, sensitive to zero-lag. More...

#include <phaselockingvalue.h>

Public Types

typedef QSharedPointer< PhaseLockingValueSPtr
typedef QSharedPointer< const PhaseLockingValueConstSPtr
Public Types inherited from CONNECTIVITYLIB::AbstractMetric
typedef QSharedPointer< AbstractMetricSPtr
typedef QSharedPointer< const AbstractMetricConstSPtr

Public Member Functions

 PhaseLockingValue ()
Public Member Functions inherited from CONNECTIVITYLIB::AbstractMetric
 AbstractMetric ()

Static Public Member Functions

static Network calculate (ConnectivitySettings &connectivitySettings)

Static Protected Member Functions

static void compute (ConnectivitySettings::IntermediateTrialData &inputData, QVector< QPair< int, Eigen::MatrixXcd > > &vecPairCsdSum, QVector< QPair< int, Eigen::MatrixXcd > > &vecPairCsdNormalizedSum, QMutex &mutex, int iNRows, int iNFreqs, int iNfft, const QPair< Eigen::MatrixXd, Eigen::VectorXd > &tapers)
static void computePLV (ConnectivitySettings &connectivitySettings, Network &finalNetwork)

Additional Inherited Members

Static Public Attributes inherited from CONNECTIVITYLIB::AbstractMetric
static bool m_bStorageModeIsActive = false
static int m_iNumberBinStart = -1
static int m_iNumberBinAmount = -1

Detailed Description

Phase Locking Value estimator (Lachaux et al. 1999); amplitude-independent phase coupling, sensitive to zero-lag.

Computes the Phase Locking Value of Lachaux et al. (HBM 1999).

Each cross-spectral sample is divided by its magnitude (yielding a unit complex number that encodes only the instantaneous phase difference) and averaged across trials; PLV is the magnitude of that average. Per- trial normalised cross-spectra are accumulated in ConnectivitySettings::IntermediateSumData and the resulting edge weights are averaged over the frequency window defined on AbstractMetric.

Definition at line 94 of file phaselockingvalue.h.

Inheritance diagram for CONNECTIVITYLIB::PhaseLockingValue:
Inheritance graph

Member Typedef Documentation

◆ ConstSPtr

Const shared pointer type for PhaseLockingValue.

Definition at line 99 of file phaselockingvalue.h.

◆ SPtr

Shared pointer type for PhaseLockingValue.

Definition at line 98 of file phaselockingvalue.h.

Constructor & Destructor Documentation

◆ PhaseLockingValue()

PhaseLockingValue::PhaseLockingValue ( )
explicit

Constructs a PhaseLockingValue object.

Definition at line 56 of file phaselockingvalue.cpp.

Member Function Documentation

◆ calculate()

Network PhaseLockingValue::calculate ( ConnectivitySettings & connectivitySettings)
static

Calculates the phase locking value between the rows of the data matrix.

Parameters
[in]connectivitySettingsThe input data and parameters.
Returns
The connectivity information in form of a network structure.

Definition at line 62 of file phaselockingvalue.cpp.

◆ compute()

void PhaseLockingValue::compute ( ConnectivitySettings::IntermediateTrialData & inputData,
QVector< QPair< int, Eigen::MatrixXcd > > & vecPairCsdSum,
QVector< QPair< int, Eigen::MatrixXcd > > & vecPairCsdNormalizedSum,
QMutex & mutex,
int iNRows,
int iNFreqs,
int iNfft,
const QPair< Eigen::MatrixXd, Eigen::VectorXd > & tapers )
staticprotected

Computes the PLV values. This function gets called in parallel.

Parameters
[in]inputDataThe input data.
[out]

The sum of all CSD matrices for each trial.

Parameters
[out]

The sum of all normalized CSD matrices for each trial.

Parameters
[in]mutexThe mutex used to safely access vecPairCsdSum.
[in]iNRowsThe number of rows.
[in]iNFreqsThe number of frequenciy bins.
[in]iNfftThe FFT length.
[in]tapersThe taper information.

Definition at line 165 of file phaselockingvalue.cpp.

◆ computePLV()

void PhaseLockingValue::computePLV ( ConnectivitySettings & connectivitySettings,
Network & finalNetwork )
staticprotected

Reduces the PLV computation to a final result.

Parameters
[out]connectivitySettingsThe input data.
[in]finalNetworkThe final network.

Definition at line 287 of file phaselockingvalue.cpp.


The documentation for this class was generated from the following files: