Skip to main content

FineCalibration

Namespace: RTPROCESSINGLIB  ·  Library: DSP Library

Python equivalent

mne.preprocessing.read_fine_calibration in MNE-Python.

#include <dsp/fine_calibration.h>

class UTILSLIB::FineCalibration

Fine calibration data for SSS.

A fine calibration file (.dat) contains one line per MEG sensor with: channel_number gain imbalance_x imbalance_y imbalance_z

Usage:

FineCalibration cal = FineCalibration::read("/path/to/sss_cal.dat");
cal.write("/path/to/output.dat");

Public Methods​

FineCalibration()​

write(sPath)​

Write fine calibration to a .dat file.

Parameters:

  • sPath : const QString & Output file path.

Returns:

  • bool — true if successful.

entries()​

Get the calibration entries.

size()​

Get the number of entries.

isEmpty()​

Check if empty.

findEntry(chNumber, entry)​

Find entry by channel number.

Parameters:

  • chNumber : int Channel number to find.

  • entry : FineCalEntry & Found entry (if any).

Returns:

  • bool — true if found.

addEntry(entry)​

Add an entry.

gainVector()​

Build gain correction diagonal matrix for MEG channels.

Returns a diagonal matrix where each diagonal element is the gain factor for the corresponding MEG channel (in the order of m_entries).

Returns:

  • Eigen::VectorXd — Diagonal gain matrix (n_entries × n_entries).

imbalanceMatrix()​

Build imbalance matrix.

Returns a matrix of cross-talk imbalance vectors (n_entries × 3).

Static Methods​

read(sPath)​

Read a fine calibration file (.dat format).

Expected format: whitespace-separated columns per line: channel_number gain imbalance_x imbalance_y imbalance_z Lines starting with '#' are comments.

Parameters:

  • sPath : const QString & Path to .dat file.

Returns:

Authors of this file​