layoutmaker.h File Reference

Generator that projects 3-D electrode positions onto a 2-D .lout topographic layout via least-squares sphere fitting. More...

#include "utils_global.h"
#include <vector>
#include <string>
#include <fstream>
#include <QVector>
#include <QList>
#include <QStringList>
#include <QFile>
#include <Eigen/Core>

Include dependency graph for layoutmaker.h:

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

Go to the source code of this file.

Classes
struct	UTILSLIB::fitUserRec
	Workspace for sphere-fitting used by the layout maker, holding 3-D point coordinates and fit parameters. More...
class	UTILSLIB::LayoutMaker
	Make layout files from given 3D points. More...

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

Typedefs
using	UTILSLIB::fitUser = fitUserRec*

Detailed Description

Generator that projects 3-D electrode positions onto a 2-D .lout topographic layout via least-squares sphere fitting.

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

Author

Lorenz Esch loren.nosp@m.z.es.nosp@m.ch@tu.nosp@m.-ilm.nosp@m.enau..nosp@m.de; Christoph Dinh chris.nosp@m.toph.nosp@m..dinh.nosp@m.@mne.nosp@m.-cpp..nosp@m.org; Juan GPC jgarc.nosp@m.iapr.nosp@m.ieto@.nosp@m.mgh..nosp@m.harva.nosp@m.rd.e.nosp@m.du; Gabriel Motta gabri.nosp@m.elbe.nosp@m.nmott.nosp@m.a@gm.nosp@m.ail.c.nosp@m.om

Since

0.1.0

Date

November 2014

UTILSLIB::LayoutMaker is the counterpart of UTILSLIB::LayoutLoader: given the 3-D coordinates of an EEG cap (typically captured with the Polhemus digitizer or loaded from a vendor .elc file) it produces the 2-D channel layout file used by every topographic widget in mne-cpp — butterfly plots, sensor maps, time-frequency heatmaps in DISPLIB and DISP3DLIB.

The projection is done by first fitting a sphere to the supplied head-frame points (helper struct fitUserRec carries the working set for the non-linear fit), then applying an azimuthal projection of every electrode onto the tangent plane at the sphere apex. Optional mirroring flags exist for caps whose left/right convention differs from MNE's defaults.

Definition in file layoutmaker.h.