{"id":24055,"library":"mne-bids","title":"MNE-BIDS","description":"MNE-BIDS is a Python package for converting, organizing, and processing MEG, EEG, and iEEG data according to the Brain Imaging Data Structure (BIDS) specification. It integrates with MNE-Python for analysis. Current version: 0.18.0. Released approximately every 3-6 months.","status":"active","version":"0.18.0","language":"python","source_language":"en","source_url":"https://github.com/mne-tools/mne-bids","tags":["bids","neuroimaging","meg","eeg","ieeg","mne"],"install":[{"cmd":"pip install mne-bids","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Core dependency for data handling and analysis","package":"mne","optional":false},{"reason":"Numerical operations","package":"numpy","optional":false},{"reason":"Scientific computing","package":"scipy","optional":false},{"reason":"Writing BrainVision data","package":"pybv","optional":false},{"reason":"BIDS specification validation","package":"formatspec","optional":false}],"imports":[{"note":"mne-bids is a separate package, not part of mne","wrong":"from mne.bids import read_raw_bids","symbol":"read_raw_bids","correct":"from mne_bids import read_raw_bids"},{"note":"","wrong":"","symbol":"BIDSPath","correct":"from mne_bids import BIDSPath"}],"quickstart":{"code":"from mne_bids import BIDSPath, read_raw_bids\nbids_path = BIDSPath(subject='01', session='01', task='audiovisual', root='/path/to/bids')\nraw = read_raw_bids(bids_path=bids_path)\nprint(raw)  # prints info about the raw data","lang":"python","description":"Minimal example: define a BIDS path and read raw data."},"warnings":[{"fix":"Use Python >=3.9","message":"Version 0.15.0 dropped support for Python 3.8. Upgrade Python to 3.9+.","severity":"breaking","affected_versions":">=0.15.0"},{"fix":"Set overwrite=False explicitly if you want the old behavior","message":"Version 0.12.0 changed the default behavior of write_raw_bids to overwrite files. Previously it raised an error if a file existed.","severity":"breaking","affected_versions":">=0.12.0"},{"fix":"Upgrade MNE to >=1.0","message":"Using MNE-BIDS with MNE <1.0 is deprecated. MNE-BIDS 0.12+ requires MNE >=1.0.","severity":"deprecated","affected_versions":">=0.12.0, <1.0.0"},{"fix":"Always specify the root parameter explicitly.","message":"BIDSPath does not automatically infer the root directory. If root is not set, write_raw_bids may default to current working directory.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run pip install mne-bids","cause":"Package not installed.","error":"ModuleNotFoundError: No module named 'mne_bids'"},{"fix":"Ensure the root path is a valid directory. Use absolute paths.","cause":"Root path specified does not exist or is incorrect.","error":"ValueError: The provided BIDS root directory does not exist"},{"fix":"Update mne-bids to >=0.11.0 and use the keyword argument 'bids_path'.","cause":"Using too old version (prior to v0.11) where read_raw_bids accepted positional args.","error":"TypeError: read_raw_bids() got an unexpected keyword argument 'bids_path'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}