Note
Go to the end to download the full example code.
11. Creating BIDS-compatible folder names and filenames#
The Brain Imaging Data Structure (BIDS) has standard conventions for file names and folder hierarchy. MNE-BIDS comes with convenience functions if you wish to create these files/folders on your own.
Note
You may automatically convert Raw objects to BIDS-compatible files with
write_raw_bids
. This example is for manually creating files/folders.
# Authors: Chris Holdgraf <choldgraf@berkeley.edu>
#
# License: BSD-3-Clause
First we will import the relevant functions
from mne_bids import BIDSPath
Creating file names for BIDS#
BIDS requires a specific ordering and structure for metadata fields in file paths, the class BIDSPath allows you to specify many such pieces of metadata, ensuring that they are in the correct order in the final file path. Omitted keys will not be included in the file path.
sub-test/ses-two/sub-test_ses-two_task-mytask_events.tsv
You may also omit the suffix, which will result in only a prefix for a file name. This could then prepended to many more files.
sub-test/sub-test_task-mytask
Creating folders#
You can also use MNE-BIDS to create folder hierarchies.
bids_path = BIDSPath(
subject="01", session="mysession", datatype="meg", root="path/to/project"
).mkdir()
print(bids_path.directory)
path/to/project/sub-01/ses-mysession/meg
Total running time of the script: (0 minutes 0.002 seconds)