channel_derivation.h File Reference

Linear channel derivations — bipolar montages and arbitrary weighted recombinations. More...

#include "dsp_global.h"
#include <QMap>
#include <QPair>
#include <QString>
#include <QStringList>
#include <QVector>
#include <Eigen/Core>

Include dependency graph for channel_derivation.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	UTILSLIB::DerivationRule
	A single derivation rule mapping input channels (with weights) to one output channel. More...
class	UTILSLIB::ChannelDerivation
	Channel derivation and re-referencing utilities. More...

Namespaces
namespace	UTILSLIB
	Shared utilities (I/O helpers, spectral analysis, layout management, warp algorithms).

Detailed Description

Linear channel derivations — bipolar montages and arbitrary weighted recombinations.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2026 MNE-CPP Authors

Author

Christoph Dinh chris.nosp@m.toph.nosp@m..dinh.nosp@m.@mne.nosp@m.-cpp..nosp@m.org

Since

2.2.0

Date

April 2026

ChannelDerivation builds an explicit derivation matrix D so that derived = D · raw, where each output row is a weighted linear combination of one or more input channels. Two common use cases are supported directly: bipolar derivations of the form (anode − cathode) (Fp1-F7, F7-T3, …), which are standard in clinical EEG, and arbitrary sparse re-referencing schemes such as Hjorth Laplacian, double-banana, or custom multi-channel sums.

The derivation matrix is built once and then applied to every incoming block; channel labels and types are updated consistently so downstream processing (averaging, source localisation) sees a coherent montage.

Definition in file channel_derivation.h.