What’s new?#

Version 0.12 (2022-12-18)#

This release includes a number of bug fixes as well as several smaller enhancements. Please note some updated requirements, as listed in the details below.

📝 Notable changes#

Nothing out of the ordinary, see below.

👩🏽‍💻 Authors#

The following authors contributed for the first time. Thank you so much! 🤩

Moritz Gerster

The following authors had contributed before. Thank you for sticking around! 🤘

Detailed list of changes#

🚀 Enhancements#

Speed up mne_bids.read_raw_bids() when lots of events are present by Alexandre Gramfort (#1079)
Add mne_bids.BIDSPath.get_empty_room_candidates() to get the candidate empty-room files that could be used by mne_bids.BIDSPath.find_empty_room() by Eric Larson (#1083, #1093)
Add mne_bids.BIDSPath.find_matching_sidecar() to find the sidecar file associated with a given file path by Eric Larson (#1093)
When writing data via write_raw_bids(), it is now possible to specify a custom mapping of mne.Annotations descriptions to event codes via the event_id parameter. Previously, passing this parameter would always require to also pass events, and using a custom event code mapping for annotations was impossible, by Richard Höchenberger (#1084)
Improve error message when fpath cannot be uniquely resolved by Eric Larson (#1097)
Add mne_bids.find_matching_paths() to retrieve all BIDSPaths matching user-specified entities. The functionality partially overlaps with what’s offered through mne_bids.BIDSPath.match(), but is more versatile, by Moritz Gerster (#1103)

🧐 API and behavior changes#

nothing new!

🛠 Requirements#

MNE-BIDS now requires Python 3.8 or higher, because Python 3.7 is soon reaching its end of life.
MNE-BIDS now requires MNE-Python 1.2.0 or higher.

🪲 Bug fixes#

When writing data containing mne.Annotations and passing events to write_raw_bids(), previously, annotations whose description did not appear in event_id were silently dropped. We now raise an exception and request users to specify mappings between descriptions and event codes in this case. It is still possible to omit event_id if no events are passed, by Richard Höchenberger (#1084)
When working with NIRS data, raise the correct error message when a faulty format argument is passed to write_raw_bids(), by Stefan Appelhoff (#1092)
Fixed writing data preloaded from a format that’s not supported by BIDS, by Richard Höchenberger (#1101)
Fixed writing data from neuromag system having 122 sensors, by Alexandre Gramfort (#1109)

Find out what was new in previous releases