mne.simulation.simulate_sparse_stc#

mne.simulation.simulate_sparse_stc(src, n_dipoles, times, data_fun=<function <lambda>>, labels=None, random_state=None, location='random', subject=None, subjects_dir=None, surf='sphere')[source]#

Generate sparse (n_dipoles) sources time courses from data_fun.

This function randomly selects n_dipoles vertices in the whole cortex or one single vertex (randomly in or in the center of) each label if labels is not None. It uses data_fun to generate waveforms for each vertex.

Parameters:

srcinstance of SourceSpaces: The source space.
n_dipolesint: Number of dipoles to simulate.
timesarray: Time array.
data_funcallable(): Function to generate the waveforms. The default is a 100 nAm, 10 Hz sinusoid as 1e-7 * np.sin(20 * pi * t). The function should take as input the array of time samples in seconds and return an array of the same length containing the time courses.
labelsNone | list of Label: The labels. The default is None, otherwise its size must be n_dipoles.
random_stateNone | int | instance of RandomState: A seed for the NumPy random number generator (RNG). If None (default), the seed will be obtained from the operating system (see RandomState for details), meaning it will most likely produce different output every time this function or method is run. To achieve reproducible results, pass a value here to explicitly initialize the RNG with a defined state.
locationstr: The label location to choose. Can be 'random' (default) or 'center' to use mne.Label.center_of_mass(). Note that for 'center' mode the label values are used as weights.

New in v0.13.
subjectstr | None: The subject the label is defined for. Only used with location='center'.

New in v0.13.
subjects_dirpath-like | None: The path to the directory containing the FreeSurfer subjects reconstructions. If None, defaults to the SUBJECTS_DIR environment variable.

New in v0.13.
surfstr: The surface to use for Euclidean distance center of mass finding. The default here is “sphere”, which finds the center of mass on the spherical surface to help avoid potential issues with cortical folding.

New in v0.13.

Returns: