Version 1.10.0.dev135+g2e677b122 (development) (2025-06-28)#

Bugfixes#

Fix bug where mne.export.export_raw() does not correct for recording start time (raw.first_time) when exporting Raw instances to EDF or EEGLAB formats, by Qian Chu. (#12656)
Fixed behavior of mne.viz.plot_source_estimates() where the title was not displayed properly, by new contributor Shristi Baral. (#12828)
Fix epoch indexing in mne.time_frequency.EpochsTFRArray when initialising the class with the default drop_log parameter, by Thomas Binns. (#13028)
Fix loading and saving of EpochsSpectrum objects that contain slash-separators in their condition names, by Daniel McCloy. (#13042)
Fix input boxes for the max value not showing when plotting fieldlines with plot_evoked_field() when show_density=False, by Marijn van Vliet. (#13048)
Fix bug with saving of anonymized data when helium info is present in measurement info, by Eric Larson. (#13056)
Fix computation of time intervals in mne.preprocessing.compute_fine_calibration() by Eric Larson. (#13062)
Fix bug in the colorbars created by mne.viz.plot_evoked_topomap() by Santeri Ruuskanen. (#13063)
Improved sklearn class compatibility and compliance, which resulted in some parameters of classes having an underscore appended to their name during fit, such as:
- mne.decoding.FilterEstimator parameter picks passed to the initializer is set as est.picks_
- mne.decoding.UnsupervisedSpatialFilter parameter estimator passed to the initializer is set as est.estimator_
Unused verbose class parameters (that had no effect) were removed from PSDEstimator, TemporalFilter, and FilterEstimator as well. Changes by Eric Larson. (#13065)
Fix bug where taper weights were not correctly applied when computing multitaper power with mne.Epochs.compute_tfr() and mne.time_frequency.tfr_array_multitaper(), by Thomas Binns. (#13067)
Fix bug cause by unnecessary assertion when loading mixed frequency EDFs without preloading mne.io.read_raw_edf() by Simon Kern. (#13069)
Return events when requested even when current matches the desired sfreq in mne.io.Raw.resample() by new contributor Roy Eric Wieske. (#13070)
Fix bug with automated Mesa 3D detection for proper 3D option setting on systems with software rendering, by Eric Larson. (#13082)
Fix bug with reading digitization points from digitization strings with newer MEGIN systems, by Eric Larson. (#13083)
Fix bug when loading certain EEGLAB files that do not contain a nodatchans field, by Clemens Brunner. (#13097)
Do not convert the first “New Segment” marker in a BrainVision file to an annotation, as it only contains the recording date (which is already available in info["meas_date"]), by Clemens Brunner. (#13100)
Take units (m or mm) into account when drawing plot_evoked_field() on top of Brain, by Marijn van Vliet. (#13101)
Fix bug in mne.io.read_raw_gdf(), by new contributor Rongfei Jin. (#13113)
Fixed CTF cHPI coil location detection in mne.chpi.extract_chpi_locs_ctf() by new contributor Shresth Keshari. (#13123)
Improved the handling of problematic MFF files in mne.io.read_raw_egi by Scott Huberty. (#13145)
Fix bug in mne.bem.make_watershed_bem() where function would fail if talairach_with_skull.lta did not exist due to changes in Freesurfer by Peter Molfese. (#13172)
Fix bug where mne.export.export_raw() might allocate huge intermediate arrays unnecessarily, when padding data blocks during export to EDF format, by Daniel McCloy. (#13174)
Fix bug with least-squares fitting of head origin using digitization points in mne.preprocessing.maxwell_filter(), by Eric Larson. (#13178)
Fix bug with mne.viz.plot_alignment() where eeg="projected" was not plotted, by Eric Larson. (#13179)
Fixed bug with filter padding type in mne.io.Raw.plot() and related functions to reduce edge ringing during data display, by Eric Larson. (#13183)
Fix bug with sampling frequency estimation in snirf files, by Daniel McCloy and new contributor Yixiao Shen. (#13184)
Handle channels with potential electrode location in maxwell_filter_prepare_emptyroom(), by Mathieu Scheltienne. (#13208)
Fix bug where mne.gui.coregistration() would emit an error for some CTF datasets, by new contributor Wei Xu. (#13218)
Improved the configuration json to handle with parallel access with file lock configuration by new contributor Bruno Aristimunha. (#13241)
Fixed bug where the file_id is not set when the file contains a directory at the end of the file, by Théodore Papadopoulo. (#13268)
Fix bug with mne.simulation.simulate_raw() and mne.simulation.SourceSimulator where using different head positions with head_pos and a BEM would raise an error, by Eric Larson. (#13276)
Update mne.viz.plot_alignment() and related functions to support PyVista deprecation of positional arguments by new contributor user27182. (#13277)
Fixed bug where mne.preprocessing.maxwell_filter_prepare_emptyroom() would not reliably identify meg channel types for matching bads across emptyroom and task, by Harrison Ritz. (#13280)
Fixed bug where saving FIFF files failed when info["subject_info"]["birthday"] was a pandas.Timestamp instead of datetime.date, by new contributor Laurent Le Mentec. (#13284)
Fixed almost-white (barely visible) channel traces when using spatial_colors=True in mne.io.Raw.plot_psd(), mne.Epochs.plot_psd(), and related PSD-plot helpers, by new contributor Mojackhak. (#13286)

API changes by deprecation#

The backward-compatible defaults in mne.preprocessing.maxwell_filter() of st_overlap=False and `mc_interp=None will change to their smooth variants True and "hann", respectively, in 1.11, by Eric Larson. (#13080)

New features#

Add new select parameter to mne.viz.plot_evoked_topo() and mne.Evoked.plot_topo() to toggle lasso selection of sensors, by Marijn van Vliet. (#12071)
Added the option to return taper weights from mne.time_frequency.tfr_array_multitaper(), and taper weights are now stored in the mne.time_frequency.BaseTFR objects, by Thomas Binns. (#12910)
Add fig.mne container for Colorbar in plot_connectivity_circle to allow users to access it directly, by Santeri Ruuskanen. (#13019)
Add PCA-OBS preprocessing for the removal of heart-artefacts from EEG or ESG datasets via mne.preprocessing.apply_pca_obs(), by new contributor Emma Bailey and new contributor Steinn Hauser Magnusson. (#13037)
Add mne.Evoked.interpolate_to() to allow interpolating EEG data to other montages, by new contributor Antoine Collas. (#13044)
Added mne.time_frequency.combine_tfr() to allow combining TFRs across tapers, by Thomas Binns. (#13054)
Add the function mne.time_frequency.combine_spectrum() for combining data across mne.time_frequency.Spectrum objects, and allow mne.grand_average() to operate on mne.time_frequency.Spectrum objects, by Thomas Binns. (#13058)
Add smooth processing of tSSS windows (using overlap-add) and movement compensation (using smooth interpolation of head positions) in mne.preprocessing.maxwell_filter() via st_overlap and `mc_interp options, respectively, by Eric Larson. (#13080)
The mne.Info.save() method now has an overwrite and a verbose parameter, by Stefan Appelhoff. (#13107)
Allow for topomap plotting of optically pumped MEG (OPM) sensors with overlapping channel locations. When channel locations overlap, plot the most radially oriented channel. By new contributor Harrison Ritz. (#13144)
Add upsampling option to mne.make_field_map() to allow upsampling MEG helmet surfaces for plotting, by Eric Larson. (#13179)
New argument sfreq to mne.io.read_raw_snirf(), to allow overriding the sampling frequency estimated from (possibly jittered) sampling periods in the file, by Daniel McCloy. (#13184)
Add an extras attribute to mne.Annotations for storing arbitrary metadata, by Pierre Guetschel. (#13228)
mne.Report.add_trans() now accepts "auto" and "fsaverage" as arguments for the trans parameter, by Stefan Appelhoff. (#13232)
Improved error message in mne.io.Raw.save() when attempting to overwrite a file, by new contributor Sebastian Jentschke (#13233)
Add a new parameter plot_kwargs to mne.Report.add_trans(), to control low level properties of the visualization, by Stefan Appelhoff. (#13234)
User can set values for fields proj_id and proj_name in Info dict, by new contributor Laurent Le Mentec. (#13261)
channel_indices_by_type() now has an exclude parameter, by Stefan Appelhoff. (#13293)

Other changes#

Add test analytics functionality to track and analyze test performance, by new contributor Katia Al-Amir. (#13225)