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[‘bads’].


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.


If bids_path points to a symbolic link of a .fif file without a split entity, the link will be resolved before reading.

extra_paramsNone | 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.

verbosebool | str | int | None

Control verbosity of the logging output. If None, use the default verbosity level. See the logging documentation and mne.verbose() for details. Should only be passed as a keyword argument.


The data as MNE-Python Raw object.


If multiple recording data types are present in the dataset, but datatype=None.


If more than one data files exist for the specified recording.


If no data file in a supported format can be located.


If the specified datatype cannot be found in the dataset.

Examples using mne_bids.read_raw_bids