Source estimation. More...

#include <inv_source_estimate.h>

Public Types
typedef QSharedPointer< InvSourceEstimate >	SPtr
typedef QSharedPointer< const InvSourceEstimate >	ConstSPtr

Public Member Functions
	InvSourceEstimate ()
	InvSourceEstimate (const Eigen::MatrixXd &p_sol, const Eigen::VectorXi &p_vertices, float p_tmin, float p_tstep)
	InvSourceEstimate (const InvSourceEstimate &p_SourceEstimate)
	InvSourceEstimate (QIODevice &p_IODevice)
void	clear ()
InvSourceEstimate	reduce (qint32 start, qint32 n)
bool	write (QIODevice &p_IODevice)
bool	isEmpty () const
InvSourceEstimate &	operator= (const InvSourceEstimate &rhs)
int	samples () const
Eigen::VectorXi	getIndicesByLabel (const QList< FSLIB::FsLabel > &lPickedLabels, bool bIsClustered) const
bool	hasGridData () const
bool	hasCouplings () const
bool	hasFocalDipoles () const
bool	hasPositions () const
bool	hasConnectivity () const

Static Public Member Functions
static bool	read (QIODevice &p_IODevice, InvSourceEstimate &p_stc)

Public Attributes
Eigen::MatrixXd	data
Eigen::VectorXi	vertices
Eigen::RowVectorXf	times
float	tmin
float	tstep
InvEstimateMethod	method
InvSourceSpaceType	sourceSpaceType
InvOrientationType	orientationType
Eigen::MatrixX3f	positions
std::vector< InvSourceCoupling >	couplings
std::vector< InvFocalDipole >	focalDipoles
std::vector< InvConnectivity >	connectivity

Detailed Description

Source estimation.

Source estimation which holds results of MNE-CPP inverse routines. (Replaces *mneStcData,mneStcDataRec struct of MNE-C mne_types.h).

Definition at line 94 of file inv_source_estimate.h.

Member Typedef Documentation

◆ ConstSPtr

typedef QSharedPointer<const InvSourceEstimate> INVLIB::InvSourceEstimate::ConstSPtr

Const shared pointer type for InvSourceEstimate.

Definition at line 98 of file inv_source_estimate.h.

◆ SPtr

typedef QSharedPointer<InvSourceEstimate> INVLIB::InvSourceEstimate::SPtr

Shared pointer type for InvSourceEstimate.

Definition at line 97 of file inv_source_estimate.h.

Constructor & Destructor Documentation

◆ InvSourceEstimate() [1/4]

InvSourceEstimate::InvSourceEstimate ( )

Default constructor

Definition at line 64 of file inv_source_estimate.cpp.

◆ InvSourceEstimate() [2/4]

INVLIB::InvSourceEstimate::InvSourceEstimate	(	const Eigen::MatrixXd &	p_sol,
		const Eigen::VectorXi &	p_vertices,
		float	p_tmin,
		float	p_tstep )

Constructs a source estimation from given data

Parameters

[in]	p_sol.
[in]	p_vertices.
[in]	p_tmin.
[in]	p_tstep.

◆ InvSourceEstimate() [3/4]

InvSourceEstimate::InvSourceEstimate ( const InvSourceEstimate & p_SourceEstimate )

Copy constructor.

Parameters

[in] p_SourceEstimate Source estimate data which should be copied.

Definition at line 89 of file inv_source_estimate.cpp.

◆ InvSourceEstimate() [4/4]

InvSourceEstimate::InvSourceEstimate ( QIODevice & p_IODevice )

Constructs a source estimation, by reading from a IO device.

Parameters

[in] p_IODevice IO device to read from the source estimation.

Definition at line 107 of file inv_source_estimate.cpp.

Member Function Documentation

◆ clear()

void InvSourceEstimate::clear ( )

Initializes source estimate.

Definition at line 123 of file inv_source_estimate.cpp.

◆ getIndicesByLabel()

VectorXi InvSourceEstimate::getIndicesByLabel	(	const QList< FSLIB::FsLabel > &	lPickedLabels,
		bool	bIsClustered ) const

Returns the indices of sources in the data matrix based on their beloning label.

Parameters

[in]	lPickedLabels	The labels base the selection on.
[in]	bIsClustered	Whether the source space was clustered.

Returns: the indices.

Definition at line 316 of file inv_source_estimate.cpp.

◆ hasConnectivity()

bool INVLIB::InvSourceEstimate::hasConnectivity ( ) const

inline

Returns true if the estimate contains connectivity results.

Returns: true if connectivity data is present.

Definition at line 320 of file inv_source_estimate.h.

◆ hasCouplings()

bool INVLIB::InvSourceEstimate::hasCouplings ( ) const

inline

Returns true if the estimate contains source coupling annotations (e.g. RAP-MUSIC pairs/N-tuples).

Returns: true if couplings are present.

Definition at line 299 of file inv_source_estimate.h.

◆ hasFocalDipoles()

bool INVLIB::InvSourceEstimate::hasFocalDipoles ( ) const

inline

Returns true if the estimate contains focal (off-grid) dipole results.

Returns: true if focal dipoles are present.

Definition at line 306 of file inv_source_estimate.h.

◆ hasGridData()

bool INVLIB::InvSourceEstimate::hasGridData ( ) const

inline

Returns true if the estimate contains grid-based data (distributed methods or RAP-MUSIC amplitudes).

Returns: true if grid data is present.

Definition at line 292 of file inv_source_estimate.h.

◆ hasPositions()

bool INVLIB::InvSourceEstimate::hasPositions ( ) const

inline

Returns true if the estimate carries explicit source positions (discrete source space).

Returns: true if positions are present.

Definition at line 313 of file inv_source_estimate.h.

◆ isEmpty()

bool INVLIB::InvSourceEstimate::isEmpty ( ) const

inline

Returns whether SourceEstimate is empty.

Returns: true if is empty, false otherwise.

Definition at line 285 of file inv_source_estimate.h.

◆ operator=()

InvSourceEstimate & InvSourceEstimate::operator= ( const InvSourceEstimate & rhs )

Assignment Operator

Parameters

[in] rhs SourceEstimate which should be assigned.

Returns: the copied source estimate.

Definition at line 286 of file inv_source_estimate.cpp.

◆ read()

bool InvSourceEstimate::read	(	QIODevice &	p_IODevice,
		InvSourceEstimate &	p_stc )

static

mne_read_stc_file

Reads a source estimate from a given file

Parameters

[in]	p_IODevice	IO device to red the stc from.
[in,out]	p_stc	the read stc.

Returns: true if successful, false otherwise.

Definition at line 167 of file inv_source_estimate.cpp.

◆ reduce()

InvSourceEstimate InvSourceEstimate::reduce	(	qint32	start,
		qint32	n )

Reduces the source estimate to selected samples.

Parameters

[in]	start	The start index to cut the estimate from.
[in]	n	Number of samples to cut from start index.

Definition at line 141 of file inv_source_estimate.cpp.

◆ samples()

int InvSourceEstimate::samples ( ) const

Returns the number of samples.

Returns: the number of samples.

Definition at line 309 of file inv_source_estimate.cpp.

◆ write()

bool InvSourceEstimate::write ( QIODevice & p_IODevice )

mne_write_stc_file

Writes a stc file

Parameters

[in] p_IODevice IO device to write the stc to.

Definition at line 224 of file inv_source_estimate.cpp.

Member Data Documentation

◆ connectivity

std::vector<InvConnectivity> INVLIB::InvSourceEstimate::connectivity

Pairwise connectivity matrices between sources (one per metric / freq band).

Definition at line 231 of file inv_source_estimate.h.

◆ couplings

std::vector<InvSourceCoupling> INVLIB::InvSourceEstimate::couplings

Correlated source groups overlaid on the grid.

Definition at line 225 of file inv_source_estimate.h.

◆ data

Eigen::MatrixXd INVLIB::InvSourceEstimate::data

Matrix of shape [n_dipoles x n_times] which contains the data in source space.

Definition at line 210 of file inv_source_estimate.h.

◆ focalDipoles

std::vector<InvFocalDipole> INVLIB::InvSourceEstimate::focalDipoles

Off-grid focal dipoles (ECD results).

Definition at line 228 of file inv_source_estimate.h.

◆ method

InvEstimateMethod INVLIB::InvSourceEstimate::method

The inverse method that produced this estimate.

Definition at line 217 of file inv_source_estimate.h.

◆ orientationType

InvOrientationType INVLIB::InvSourceEstimate::orientationType

Orientation constraint used (fixed, free, loose).

Definition at line 219 of file inv_source_estimate.h.

◆ positions

Eigen::MatrixX3f INVLIB::InvSourceEstimate::positions

3D positions (m) in head coordinates, one row per source. Empty when positions live in an external source space.

Definition at line 222 of file inv_source_estimate.h.

◆ sourceSpaceType

InvSourceSpaceType INVLIB::InvSourceEstimate::sourceSpaceType

Source space type (surface, volume, mixed, discrete).

Definition at line 218 of file inv_source_estimate.h.

◆ times

Eigen::RowVectorXf INVLIB::InvSourceEstimate::times

The time vector with n_times steps.

Definition at line 212 of file inv_source_estimate.h.

◆ tmin

float INVLIB::InvSourceEstimate::tmin

Time starting point.

Definition at line 213 of file inv_source_estimate.h.

◆ tstep

float INVLIB::InvSourceEstimate::tstep

Time steps within the times vector.

Definition at line 214 of file inv_source_estimate.h.

◆ vertices

Eigen::VectorXi INVLIB::InvSourceEstimate::vertices

The indices of the dipoles in the different source spaces. In the clustered case, holds the ROI indices.

Definition at line 211 of file inv_source_estimate.h.

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

src/libraries/inv/inv_source_estimate.h
src/libraries/inv/inv_source_estimate.cpp

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Detailed Description

Member Typedef Documentation

◆ ConstSPtr

◆ SPtr

Constructor & Destructor Documentation

◆ InvSourceEstimate() [1/4]

◆ InvSourceEstimate() [2/4]

◆ InvSourceEstimate() [3/4]

◆ InvSourceEstimate() [4/4]

Member Function Documentation

◆ clear()

◆ getIndicesByLabel()

◆ hasConnectivity()

◆ hasCouplings()

◆ hasFocalDipoles()

◆ hasGridData()

◆ hasPositions()

◆ isEmpty()

◆ operator=()

◆ read()

◆ reduce()

◆ samples()

◆ write()

Member Data Documentation

◆ connectivity

◆ couplings

◆ data

◆ focalDipoles

◆ method

◆ orientationType

◆ positions

◆ sourceSpaceType

◆ times

◆ tmin

◆ tstep

◆ vertices