v2.0.0
Loading...
Searching...
No Matches
UTILSLIB::MaxwellMovementComp Class Reference

Maxwell movement compensation using SSS. More...

#include <maxwell_movement_comp.h>

Static Public Member Functions

static Eigen::MatrixXd apply (const Eigen::MatrixXd &matData, const FIFFLIB::FiffInfo &fiffInfo, const QList< HeadPosEntry > &headPos, double dSFreq, const MaxwellMoveCompParams &params=MaxwellMoveCompParams())
 Apply movement compensation via SSS.
static QList< HeadPosEntryreadHeadPos (const QString &sPath)
 Read head positions from a file.
static bool writeHeadPos (const QString &sPath, const QList< HeadPosEntry > &headPos)
 Write head positions to a file.

Detailed Description

Maxwell movement compensation using SSS.

Usage:

QList<HeadPosEntry> headPos = ...; // from cHPI fitting
Eigen::MatrixXd compensated = MaxwellMovementComp::apply(
matData, fiffInfo, headPos, params);
Parameters for Maxwell movement compensation.
static Eigen::MatrixXd apply(const Eigen::MatrixXd &matData, const FIFFLIB::FiffInfo &fiffInfo, const QList< HeadPosEntry > &headPos, double dSFreq, const MaxwellMoveCompParams &params=MaxwellMoveCompParams())
Apply movement compensation via SSS.

Definition at line 89 of file maxwell_movement_comp.h.

Member Function Documentation

◆ apply()

MatrixXd MaxwellMovementComp::apply ( const Eigen::MatrixXd & matData,
const FIFFLIB::FiffInfo & fiffInfo,
const QList< HeadPosEntry > & headPos,
double dSFreq,
const MaxwellMoveCompParams & params = MaxwellMoveCompParams() )
static

Apply movement compensation via SSS.

For each time segment (defined by headPos entries), the data is:

  1. Projected into SSS multipole space using the actual head position.
  2. Reconstructed at the reference head position.
Parameters
[in]matDataFull sensor data (n_channels × n_samples).
[in]fiffInfoMeasurement info (channel positions, etc.).
[in]headPosHead positions over time (from cHPI).
[in]dSFreqSampling frequency (Hz).
[in]paramsCompensation parameters.
Returns
Movement-compensated data (n_channels × n_samples).

Definition at line 87 of file maxwell_movement_comp.cpp.

◆ readHeadPos()

QList< HeadPosEntry > MaxwellMovementComp::readHeadPos ( const QString & sPath)
static

Read head positions from a file.

File format: whitespace-separated columns per line: time q1 q2 q3 tx ty tz gof

Parameters
[in]sPathPath to head position file.
Returns
List of head position entries.

Definition at line 176 of file maxwell_movement_comp.cpp.

◆ writeHeadPos()

bool MaxwellMovementComp::writeHeadPos ( const QString & sPath,
const QList< HeadPosEntry > & headPos )
static

Write head positions to a file.

Parameters
[in]sPathOutput file path.
[in]headPosHead positions to write.
Returns
true if successful.

Definition at line 226 of file maxwell_movement_comp.cpp.


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