FWDLIB::FwdFieldMap Class Reference

#include <fwd_field_map.h>

Static Public Member Functions
static QSharedPointer< Eigen::MatrixXf >	computeMegMapping (const FwdCoilSet &coils, const Eigen::MatrixX3f &vertices, const Eigen::MatrixX3f &normals, const Eigen::Vector3f &origin, float intrad=0.06f, float miss=1e-4f)
static QSharedPointer< Eigen::MatrixXf >	computeMegMapping (const FwdCoilSet &coils, const Eigen::MatrixX3f &vertices, const Eigen::MatrixX3f &normals, const Eigen::Vector3f &origin, const FIFFLIB::FiffInfo &info, const QStringList &chNames, float intrad=0.06f, float miss=1e-4f)
static QSharedPointer< Eigen::MatrixXf >	computeEegMapping (const FwdCoilSet &coils, const Eigen::MatrixX3f &vertices, const Eigen::Vector3f &origin, float intrad=0.06f, float miss=1e-3f)
static QSharedPointer< Eigen::MatrixXf >	computeEegMapping (const FwdCoilSet &coils, const Eigen::MatrixX3f &vertices, const Eigen::Vector3f &origin, const FIFFLIB::FiffInfo &info, const QStringList &chNames, float intrad=0.06f, float miss=1e-3f)

Detailed Description

Sphere-model based sensor-to-surface field mapping.

Uses Legendre polynomial series for lead-field dot products and SVD-based pseudo-inverse with eigenvalue truncation, matching the classic MNE field interpolation approach.

Ported from MNE-Python (BSD-3-Clause): _do_self_dots, _do_surface_dots, _fast_sphere_dot_r0 (_lead_dots.py) _compute_mapping_matrix, _pinv_trunc (_field_interpolation.py)

Definition at line 71 of file fwd_field_map.h.

Member Function Documentation

computeEegMapping() [1/2]

QSharedPointer< Eigen::MatrixXf > FWDLIB::FwdFieldMap::computeEegMapping ( const FwdCoilSet & coils, const Eigen::MatrixX3f & vertices, const Eigen::Vector3f & origin, const FIFFLIB::FiffInfo & info, const QStringList & chNames, float intrad = 0.06f, float miss = 1e-3f )

static

Compute EEG electrode-to-surface mapping matrix with SSP projection and average reference.

Parameters

[in]	coils	EEG electrodes (already transformed to target coordinate frame).
[in]	vertices	Surface vertex positions (nvert × 3).
[in]	origin	Sphere origin in the target coordinate frame.
[in]	info	FiffInfo with SSP projectors and channel names.
[in]	chNames	Channel names corresponding to the coils (for projector matching).
[in]	intrad	Base integration radius (default 0.06).
[in]	miss	Eigenvalue truncation threshold (default 1e-3).

Returns

Mapping matrix (nvert × nchan), or null on failure.

computeEegMapping() [2/2]

QSharedPointer< Eigen::MatrixXf > FWDLIB::FwdFieldMap::computeEegMapping ( const FwdCoilSet & coils, const Eigen::MatrixX3f & vertices, const Eigen::Vector3f & origin, float intrad = 0.06f, float miss = 1e-3f )

static

Compute EEG electrode-to-surface mapping matrix.

The effective integration radius is intrad * 0.7, matching MNE-Python's internal scaling in _do_self_dots / _do_surface_dots for EEG.

Parameters

[in]	coils	EEG electrodes (already transformed to target coordinate frame).
[in]	vertices	Surface vertex positions (nvert × 3).
[in]	origin	Sphere origin in the target coordinate frame.
[in]	intrad	Base integration radius (default 0.06, matching MNE-Python _setup_dots).
[in]	miss	Eigenvalue truncation threshold (default 1e-3, matching _make_surface_mapping).

Returns

Mapping matrix (nvert × nchan), or null on failure.

computeMegMapping() [1/2]

QSharedPointer< Eigen::MatrixXf > FWDLIB::FwdFieldMap::computeMegMapping ( const FwdCoilSet & coils, const Eigen::MatrixX3f & vertices, const Eigen::MatrixX3f & normals, const Eigen::Vector3f & origin, const FIFFLIB::FiffInfo & info, const QStringList & chNames, float intrad = 0.06f, float miss = 1e-4f )

static

Compute MEG sensor-to-surface mapping matrix with SSP projection.

Parameters

[in]	coils	MEG coils (already transformed to target coordinate frame).
[in]	vertices	Surface vertex positions (nvert × 3).
[in]	normals	Surface vertex normals (nvert × 3).
[in]	origin	Sphere origin in the target coordinate frame.
[in]	info	FiffInfo with SSP projectors and channel names.
[in]	chNames	Channel names corresponding to the coils (for projector matching).
[in]	intrad	Integration radius (default 0.06).
[in]	miss	Eigenvalue truncation threshold (default 1e-4).

Returns

Mapping matrix (nvert × nchan), or null on failure.

computeMegMapping() [2/2]

QSharedPointer< Eigen::MatrixXf > FWDLIB::FwdFieldMap::computeMegMapping ( const FwdCoilSet & coils, const Eigen::MatrixX3f & vertices, const Eigen::MatrixX3f & normals, const Eigen::Vector3f & origin, float intrad = 0.06f, float miss = 1e-4f )

static

Compute MEG sensor-to-surface mapping matrix.

Parameters

[in]	coils	MEG coils (already transformed to target coordinate frame).
[in]	vertices	Surface vertex positions (nvert × 3).
[in]	normals	Surface vertex normals (nvert × 3).
[in]	origin	Sphere origin in the target coordinate frame.
[in]	intrad	Integration radius (default 0.06, matching MNE-Python _setup_dots).
[in]	miss	Eigenvalue truncation threshold (default 1e-4, matching _make_surface_mapping).

Returns

Mapping matrix (nvert × nchan), or null on failure.

---

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

• src/libraries/fwd/fwd_field_map.h