UTILSLIB::EpochExtractor Class Reference

Segments continuous raw data into fixed-length epochs locked to events. More...

#include <epoch_extractor.h>

Public Types
using	Params = EpochExtractorParams

Static Public Member Functions
static QVector< MNELIB::MNEEpochData >	extract (const Eigen::MatrixXd &matData, const QVector< int > &eventSamples, double dSFreq, const Params &params=Params(), const QVector< int > &eventCodes=QVector< int >())
static Eigen::MatrixXd	average (const QVector< MNELIB::MNEEpochData > &epochs)
static QVector< MNELIB::MNEEpochData >	rejectMarked (const QVector< MNELIB::MNEEpochData > &epochs)

Detailed Description

Segments continuous raw data into fixed-length epochs locked to events.

EpochExtractor::Params p;
p.dTmin      = -0.2;     // 200 ms pre-stimulus
p.dTmax      =  0.8;     // 800 ms post-stimulus
p.dBaseMin   = -0.2;
p.dBaseMax   =  0.0;
p.dThreshold = 150e-6;   // 150 µV peak-to-peak rejection
 
QVector<MNELIB::MNEEpochData> epochs =
    EpochExtractor::extract(matRawData, eventSamples, sFreq, p);
 
// Good epochs only
QVector<MNELIB::MNEEpochData> clean =
    EpochExtractor::rejectMarked(epochs);

Definition at line 105 of file epoch_extractor.h.

Member Typedef Documentation

Params

using UTILSLIB::EpochExtractor::Params = EpochExtractorParams

Convenience alias so callers can still write EpochExtractor::Params.

Definition at line 108 of file epoch_extractor.h.

Member Function Documentation

average()

MatrixXd EpochExtractor::average ( const QVector< MNELIB::MNEEpochData > & epochs )

static

Compute the grand average (ERP/ERF) across all non-rejected epochs.

Parameters

[in]

epochs

Vector of extracted epochs (output of extract()).

Returns

Mean data matrix (n_channels × n_epoch_samples), or empty matrix if no good epochs.

Definition at line 157 of file epoch_extractor.cpp.

extract()

QVector< MNEEpochData > EpochExtractor::extract ( const Eigen::MatrixXd & matData, const QVector< int > & eventSamples, double dSFreq, const Params & params = Params(), const QVector< int > & eventCodes = QVector<int>() )

static

Extract epochs from a continuous raw data matrix.

For each event sample index the function:

1. Cuts a window [tmin, tmax] around the event.
2. Applies mean baseline correction over [baseMin, baseMax] (if bApplyBaseline and the window is valid).
3. Marks the epoch for rejection if any channel has peak-to-peak > dThreshold (and dThreshold > 0).

Epochs whose window extends outside the data boundaries are silently skipped.

Parameters

[in]	matData	Continuous raw data (n_channels × n_samples), calibrated (SI units).
[in]	eventSamples	0-based sample indices of events.
[in]	dSFreq	Sampling frequency in Hz.
[in]	params	Extraction parameters.
[in]	eventCodes	Optional per-event integer codes stored in MNEEpochData::event. Must be empty or the same length as eventSamples.

Returns

Vector of MNEEpochData (one per valid event). Rejected epochs are included with MNEEpochData::bReject == true so callers can choose whether to exclude them.

Definition at line 84 of file epoch_extractor.cpp.

rejectMarked()

QVector< MNEEpochData > EpochExtractor::rejectMarked ( const QVector< MNELIB::MNEEpochData > & epochs )

static

Return only the epochs that are NOT marked for rejection.

Parameters

[in]

epochs

Input epoch vector.

Returns

Subset of epochs with bReject == false.

Definition at line 182 of file epoch_extractor.cpp.

---

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

• src/libraries/dsp/epoch_extractor.h
• src/libraries/dsp/epoch_extractor.cpp