eelbrain.SourceSpace

class eelbrain.SourceSpace(vertices, subject=None, src=None, subjects_dir=None, parc='aparc', connectivity='custom', name='source', filename='{subject}-{src}-src.fif')

MNE surface-based source space

Parameters
  • vertices (list of 2 int arrays) – The vertex identities of the dipoles in the source space (left and right hemisphere separately).

  • subject (str) – The mri-subject name.

  • src (str) – The kind of source space used (e.g., ‘ico-4’; only ico is currently supported.

  • subjects_dir (str) – The path to the subjects_dir (needed to locate the source space file).

  • parc (None | str) – Add a parcellation to the source space to identify vertex location. Only applies to ico source spaces, default is ‘aparc’.

  • connectivity ('grid' | 'none' | array of int, (n_edges, 2)) – Connectivity between elements. Set to "none" for no connections or "grid" to use adjacency in the sequence of elements as connection. Set to numpy.ndarray to specify custom connectivity. The array should be of shape (n_edges, 2), and each row should specify one connection [i, j] with i < j, with rows sorted in ascending order. If the array’s dtype is uint32, property checks are disabled to improve efficiency.

  • name (str) – Dimension name (default "source").

  • filename (str) – Filename template for the MNE source space file.

Variables
  • coordinates (array (n_sources, 3)) – Spatial coordinate for each source.

  • normals (array (n_sources, 3)) – Orientation (direction) of each source.

  • parc (Factor) – Parcellation (one label for each source).

See also

VolumeSourceSpace

volume source space

Notes

besides numpy indexing, the following indexes are possible:

  • mne Label objects

  • ‘lh’ or ‘rh’ to select an entire hemisphere

Methods

circular_index(seeds[, extent, name])

Return an index into all vertices closer than extent of a seed

connectivity([disconnect_parc])

Create source space connectivity

coordinates

dimindex(arg)

Convert a dimension index to an array index

from_file(subjects_dir, subject, src[, …])

SourceSpace dimension from MNE source space file

from_mne_source_spaces(source_spaces, src, …)

SourceSpace dimension from :cls:`mne.SourceSpaces` object

get_source_space([subjects_dir])

Read the corresponding MNE source space

hemi

index_for_label(label)

Return the index for a label

index_into_dim(dim)

Index into a subset dimension

intersect(dim[, check_dims])

Create a Source dimension that is the intersection with dim

normals

subjects_dir

surface_coordinates([surf])

Load surface coordinates for any FreeSurfer surface