mne.make_field_map

mne.make_field_map(evoked, trans='auto', subject=None, subjects_dir=None, ch_type=None, mode='fast', meg_surf='helmet', origin=(0.0, 0.0, 0.04), n_jobs=1, verbose=None)[source]

Compute surface maps used for field display in 3D.

Parameters
evokedEvoked | Epochs | Raw

The measurement file. Need to have info attribute.

transstr | ‘auto’ | None

The full path to the *-trans.fif file produced during coregistration. If present or found using ‘auto’ the maps will be in MRI coordinates. If None, map for EEG data will not be available.

subjectstr | None

The subject name corresponding to FreeSurfer environment variable SUBJECT. If None, map for EEG data will not be available.

subjects_dirstr

The path to the freesurfer subjects reconstructions. It corresponds to Freesurfer environment variable SUBJECTS_DIR.

ch_typeNone | ‘eeg’ | ‘meg’

If None, a map for each available channel type will be returned. Else only the specified type will be used.

mode‘accurate’ | ‘fast’

Either 'accurate' or 'fast', determines the quality of the Legendre polynomial expansion used. 'fast' should be sufficient for most applications.

meg_surf‘helmet’ | ‘head’

Should be 'helmet' or 'head' to specify in which surface to compute the MEG field map. The default value is 'helmet'.

originarray_like, shape (3,) | ‘auto’

Origin of the sphere in the head coordinate frame and in meters. Can be 'auto', which means a head-digitization-based origin fit. Default is (0., 0., 0.04).

New in version 0.11.

n_jobsint

The number of jobs to run in parallel (default 1). Requires the joblib package.

verbosebool | str | int | None

If not None, override default verbose level (see mne.verbose() and Logging documentation for more). If used, it should be passed as a keyword-argument only.

Returns
surf_mapslist

The surface maps to be used for field plots. The list contains separate ones for MEG and EEG (if both MEG and EEG are present).