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_pathBIDSPath

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

Returns:
rawmne.io.Raw

The data as MNE-Python Raw object.

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.

Examples using mne_bids.read_raw_bids#

01. Read BIDS datasets

01. Read BIDS datasets

02. Convert MNE sample data to BIDS format

02. Convert MNE sample data to BIDS format

03. Interactive data inspection and bad channel selection

03. Interactive data inspection and bad channel selection

08. Convert iEEG data to BIDS format

08. Convert iEEG data to BIDS format

09. Manually storing empty room data

09. Manually storing empty room data

12. Updating BIDS datasets

12. Updating BIDS datasets