Version 1.13.0.dev107+gf6a95f966 (development) (2026-06-24)

Dependencies

• Updated minimum for:

  • Core dependency matplotlib >= 3.9

  Changes implemented via CI action created by Thomas Binns. (#13899)

• Updated minimum for:

  • Optional dependency scikit-learn >= 1.5

  Changes implemented via CI action created by Thomas Binns. (#13916)

• Switch the default Qt bindings from PyQt6 to PySide6. As a result, mne[full] now includes PySide6 instead of PyQt6. Users who prefer PyQt6 can continue to use mne[full-pyqt6], and mne[full-pyside6] remains available as an alias for mne[full]. Changes by Clemens Brunner. (#13960)

• PyQt5 is no longer an officially supported Qt binding, by Eric Larson. (#13981)

Bugfixes

• Fix mode parameter in get_point_spread() and get_cross_talk() to correctly map public mode names ('max', 'svd') to internal names, expose previously hidden modes 'sum' and 'maxval' in the public API, and raise ValueError for invalid mode values, by new contributor Famous077. (#13754)

• Improved colocated OPM topomap handling by recognizing additional OPM coil types (FieldLine and Kernel), by Pragnya Khandelwal. (#13825)

• Fix bug where logging messages were sometimes errantly printed, by Eric Larson. (#13843)

• Fixed incorrect label orientation for nodes in the 0–90° polar range (the 12–3 o’clock quadrant) of the connectivity circle plot, by new contributor Pavel Popov. (#13855)

• Fixed an indexing bug in fNIRS support in mne.io.BaseRaw.interpolate_bads() (and related methods) that could errantly use incorrect donor channels, by new contributor Kalle Makela. (#13856)

• Add a memmap keyword argument to mne.io.BaseRaw.load_data(), allowing loading deferred raw data into a memory-mapped file after object creation, by Aniket Singh Yadav. (#13858)

• Fix handling of optional dependencies that don’t specify a version attribute, by new contributor Baris Talar. (#13870)

• Improved error message when FreeSurfer executable is not found, by new contributor Ayushi Satodiya. (#13874)

• Fix bug with mne.preprocessing.ICA.plot_properties() when using reject in mne.preprocessing.ICA.fit(), by Eric Larson. (#13885)

• Fix bug where picks was ignored in mne.Epochs.apply_function() when channel_wise=False, by Thomas Binns. (#13894)

• Fix iteration errors in mne.io.read_raw_nihon() when reading log files, by Tom Ma. (#13915)

• Fix bug with mne.set_eeg_reference() not working when passing a single channel name as string, by Michael Straube. (#13917)

• Fix mne.set_eeg_reference() so that passing a list of channel types with projection=False and ref_channels="average" now references each channel type independently by default (matching the projection=True path), by new contributor Ben Tang. Previously a single average was computed across the union of the listed types. Pass joint=True for the previous behavior. (#13920)

• Use mffpy-backed parsing for EGI MFF event tracks while tolerating nanosecond timestamps that some files store in beginTime, by Pragnya Khandelwal. (#13932)

• Fix mne.preprocessing.eyetracking.interpolate_blinks() so that all annotation descriptions passed via match are interpolated over, rather than only BAD_blink ones, by new contributor Vincent Gao. (#13940)

• Fix channel ordering bug in mne.viz.plot_compare_evokeds() when axes="topo", by Lifeng Qiu Lin. (#13943)

• Fix bug in mne.read_annotations() where reading a .txt file containing a single channel-specific annotation raised an AttributeError, by new contributor Piotr Durka. (#13962)

• Fixed bug where mne.sys_info() would silently change the active Matplotlib backend (e.g. when ipympl is installed) as an import-time side effect, by Stefan Appelhoff. (#13963)

API changes by deprecation

• Rename standard_1005 and standard_1020 montages to colin27_1005 and colin27_1020, respectively. If you used standard_1005 or standard_1020, either switch to the new names colin27_1005 and colin27_1020 or use the new spherical montages spherical_1005, spherical_1010, or spherical_1020, which provide idealized template locations on a sphere (useful for plotting). By Clemens Brunner. (#13903)

• In mne.Evoked.animate_topomap() the vmin and vmax keyword arguments have been deprecated in favor of vlim, by Eric Larson. (#13905)

New features

• Add mne.preprocessing.eyetracking.find_blinks() to detect blinks in eye-tracking data from pupil dropouts and return them as Annotations, by Stefan Appelhoff. (#12946)

• It is now possible to concatenate raw objects with mne.concatenate_raws() as long as they inherit from BaseRaw, even if their specific types differ (e.g., Raw and RawArray), by Clemens Brunner. (#13263)

• Add a preprocessing example showing how to explore epoch quality before rejection using robust statistics (peak-to-peak amplitude, variance, and kurtosis) inspired by FASTER (Nolan et al., 2010) and Delorme et al. (2007), by Aman Srivastava. (#13710)

• Add annotation_colors parameter to mne.io.Raw.plot() and mne.Epochs.plot() to allow users to specify custom colors for annotations by passing a dict mapping annotation description strings to colors (for example, annotation_colors=dict(bad_segment="orange")), by Clemens Brunner. (#13838)

• Add dark theme support (theme="light", "dark", or "auto") to the 'matplotlib' browser backend used by mne.io.Raw.plot(), mne.Epochs.plot(), and mne.preprocessing.ICA.plot_sources(), by Clemens Brunner. (#13861)

• Fix mne.preprocessing.nirs.beer_lambert_law() to support explicitly provided sd_distances during Beer-Lambert conversion. When valid source-detector distances are already present in raw.info, overriding them now emits a warning, and when all inferred distances are invalid and no explicit distances are provided, a ValueError is raised instead of silently producing zero concentrations, by new contributor Kalle Makela. (#13875)

• Add overrides parameter to mne.io.read_raw_brainvision() for reading non-spec-compliant .vhdr files where the header contradicts the actual layout (e.g. renamed BIDS siblings, missing MarkerFile=, truncated [Channel Infos]). Accepts a dict with keys data_fname, marker_fname, n_channels, sfreq, ch_names, units_fallback, data_orientation, data_format, and binary_format; see the function docstring for details. Missing or empty MarkerFile= is now also tolerated natively (per the BV Core Data Format spec). When MarkerFile= names a path that does not exist (common after BIDS renames), mne.io.read_raw_brainvision() now falls back to the co-located <stem>.vmrk next to the .vhdr and warns, instead of raising FileNotFoundError, by Bruno Aristimunha. (#13884)

• Add idealized spherical 10–05, 10–10, and 10–20 montages (spherical_1005, spherical_1010, spherical_1020), by Clemens Brunner. (#13903)

• Improved mne.Report by:

  • Using "agg" backend for 2D plots to avoid windows unnecessarily popping up

  • Improving add_stc() by using direct capture of brain images, allowing direct control of image size using stc_plot_kwargs["size"]

  • Improving add_evokeds() evoked topomap plotting by using mne.Evoked.animate_topomap() with butterfly=True rather than re-plotting each topomap in a loop

  Also improved mne.Evoked.animate_topomap() by deduplicating code with mne.Evoked.plot_topomap(). Changes by Eric Larson. (#13905)

• Add support for reading cross-talk and fine-calibration embedded in FIF files during acquisition into raw.info["cross_talk"] and raw.info["fine_calibration"], respectively, by Eric Larson. (#13911)

• Add support for interactive label browsing using hover=True in mne.viz.Brain.add_annotation(), by Eric Larson. (#13931)

• Added 'fsaverage_1005' montage, which is a slightly improved version of the existing 'colin27_1005' montage (known in 1.12 and older as 'standard_1005'). The electrodes have already been mapped to the fsaverage head surface. Changes by Eric Larson. (#13936)

• Added basic support for TD fNIRS data, by new contributor Zahra Aghajan, new contributor Julien Dubois, new contributor John Griffiths, Robert Luke, and Eric Larson. (#13938)

• Add support for automatic cross_talk and fine_calibration adjustments in mne.preprocessing.maxwell_filter() when these are stored in mne.Info during acquisition (e.g., by newer MEGIN acquisition software), by Eric Larson. (#13942)

• Added the n_components parameter to ICA plotting and report generation functions to allow dynamic control over the number of components displayed by Athish M. (#13958)

• Added a volume_options["interpolation"] option to mne.viz.plot_source_estimates() and mne.viz.Brain.add_data() to control the interpolation method used for volume rendering. It can be "linear" (default) or "nearest". Changes by Eric Larson. (#13966)

• Include label and description fields when reading EGI mff files, by Martin Oberg. (#13967)

• Allow subclasses of MNEBrowseFigure to be passed to plot_raw/plot_epochs, as well as the corresponding plot(...) methods of the raw and epochs classes, by new contributor Frankie Robertson (#13979)

Other changes

• Adopting the diataxis framework by improving the phantom dipole tutorial, by Carina Forster. (#13584)

• Reorganized EDF submodule structure by moving private functionality into the public mne.io namespace to improve module consistency and avoid exposing private modules in the Credits page, by Aniket Singh Yadav. (#13673)

• Remove numpy.ndarray from colormap parameter in mne.viz.plot_source_estimates() to solve documentation conflict , by new contributor Lifeng Qiu Lin. (#13797)

• Added cross-references to common modification methods in mne.Info docstring by new contributor Athish M. (#13811)

• Adding checks in mne.stats.permutation_t_test() to warn the user when provided with bad input values, by Himanshu Mahor. (#13813)

• Added regression coverage for colocated triaxial OPM topomap handling in plot_joint() and ICA.plot_components(), by Pragnya Khandelwal. (#13842)

• Added a helper to split colocated OPM overlap sets into radial and tangential channel groups, and updated topomap regression coverage to use shared triaxial OPM fixtures, by Pragnya Khandelwal. (#13847)

• Fixed typos in error messages when reading measurement info, by new contributor Seth Bashford. (#13881)

• Fixed the fun shape description in mne.Epochs.apply_function()’s docstring, by new contributor Bhargav Kowshik. (#13891)

• Batch and vectorise classifier estimation and scoring in mne.decoding.GeneralizingEstimator.score() for scoring=None, "accuracy", "balanced_accuracy" and "roc_auc", by new contributor Mathias Sablé-Meyer. (#13909)

• Convert non-empty drop_log entries from numpy.str_ to regular Python strings, by Clemens Brunner. (#13923)

• Refactor the EGI MFF reader to use mffpy for metadata parsing, improving robustness and maintainability. This includes a shim for PNS sensor parsing to bypass an upstream bug in mffpy and resolves channel naming inconsistencies, by Pragnya Khandelwal. (#13945)

• Converted the remaining percent-style string formatting to f-strings in internal code, by new contributor Théo Castillo. (#13974)