mne_bids.read_raw_bids¶
- mne_bids.read_raw_bids(bids_path, extra_params=None, verbose=None)[source]¶
Read BIDS compatible data.
Will attempt to read associated events.tsv and channels.tsv files to populate the returned raw object with raw.annotations and raw.info[‘bads’].
- Parameters
- bids_path
BIDSPath
The file to read. The
mne_bids.BIDSPath
instance passed here must have the.root
attribute set. The.datatype
attribute may be set. If.datatype
is not set and only one data type (e.g., only EEG or MEG data) is present in the dataset, it will be selected automatically.Note
If
bids_path
points to a symbolic link of a.fif
file without asplit
entity, the link will be resolved before reading.- extra_params
None
|dict
Extra parameters to be passed to MNE read_raw_* functions. Note that the
exclude
parameter, which is supported by some MNE-Python readers, is not supported; instead, you need to subset your channels after reading.- verbose
bool
|str
|int
|None
Control verbosity of the logging output. If
None
, use the default verbosity level. See the logging documentation andmne.verbose()
for details. Should only be passed as a keyword argument.
- bids_path
- Returns
- raw
mne.io.Raw
The data as MNE-Python Raw object.
- raw
- Raises
RuntimeError
If multiple recording data types are present in the dataset, but
datatype=None
.RuntimeError
If more than one data files exist for the specified recording.
RuntimeError
If no data file in a supported format can be located.
ValueError
If the specified
datatype
cannot be found in the dataset.