This documentation is for development version 0.18.dev0.

mne.read_forward_solution

mne.read_forward_solution(fname, include=(), exclude=(), verbose=None)[source]

Read a forward solution a.k.a. lead field.

Parameters:
fname : string

The file name, which should end with -fwd.fif or -fwd.fif.gz.

include : list, optional

List of names of channels to include. If empty all channels are included.

exclude : list, optional

List of names of channels to exclude. If empty include all channels.

verbose : bool, str, int, or None

If not None, override default verbose level (see mne.verbose() and Logging documentation for more).

Returns:
fwd : instance of Forward

The forward solution.

Notes

Forward solutions, which are derived from an original forward solution with free orientation, are always stored on disk as forward solution with free orientation in X/Y/Z RAS coordinates. To apply any transformation to the forward operator (surface orientation, fixed orientation) please apply convert_forward_solution() after reading the forward solution with read_forward_solution().

Forward solutions, which are derived from an original forward solution with fixed orientation, are stored on disk as forward solution with fixed surface-based orientations. Please note that the transformation to surface-based, fixed orientation cannot be reverted after loading the forward solution with read_forward_solution().