Version 0.21 (2020-09-21)

Enhancements

• Modified mne.Epochs.pick_types() to remove dropped channel types from reject and flat dictionaries by new contributor Rahul Nadkarni

• Add function mne.preprocessing.regress_artifact() to remove artifacts using linear regression by new contributor Kyle Mathewson and Eric Larson

• Add sources and detectors options for fNIRS use of mne.viz.plot_alignment() allowing plotting of optode locations in addition to channel midpoint channels and path between fNIRS optodes by new contributor Kyle Mathewson

• BrainVision data format files are now parsed for EEG impedance values in mne.io.read_raw_brainvision() and provided as a .impedances attribute of raw by new contributor Jan Sedivy and Stefan Appelhoff

• Add function mne.channels.combine_channels() to combine channels from Raw, Epochs, or Evoked according to ROIs (combinations including mean, median, or standard deviation; can also use a callable) by new contributor Johann Benerradi

• Improved documentation building instructions and execution on Windows by new contributor Martin Schulz, Evgenii Kalenkovich, and Eric Larson

• Speed up reading of annotations in EDF+ files by new contributor Jeroen Van Der Donckt

• Add head to mri and mri to voxel space transform details to Source alignment and coordinate frames tutorial, by Alex Rockhill

• Improve memory efficiency of mne.concatenate_epochs() by Eric Larson

• Allow picking channels in raw instances (e.g., mne.io.Raw.pick_types()) without preloading data, by Eric Larson

• mne.preprocessing.ICA.plot_sources() now plots annotation markers similar to mne.io.Raw.plot() by Luke Bloy

• Add support for scalar multiplication and division of mne.time_frequency.AverageTFR instances by Luke Bloy

• Add support for signals in mV for mne.io.read_raw_brainvision() by Clemens Brunner

• mne.Epochs.plot_psd_topomap() and mne.viz.plot_epochs_psd_topomap() now allow joint colorbar limits across subplots, by Daniel McCloy.

• Add support for using loose-orientation surface priors with free-orientation volume priors in mixed source space inverses by Eric Larson

• Add mne.MixedVectorSourceEstimate for vector source estimates for mixed source spaces, by Eric Larson

• Add mixed and volumetric source estimate plotting using volumetric ray-casting to mne.MixedSourceEstimate.plot() and mne.VolSourceEstimate.plot_3d() by Eric Larson

• Add mne.MixedSourceEstimate.surface() and mne.MixedSourceEstimate.volume() methods to allow surface and volume extraction by Eric Larson

• Add mne.VectorSourceEstimate.project() to project vector source estimates onto the direction of maximum source power by Eric Larson

• Add support to mne.extract_label_time_course() for vector-valued and volumetric source estimates by Eric Larson

• Add method mne.VolSourceEstimate.in_label() by Eric Larson

• Add support for mixed source spaces to mne.compute_source_morph() by Eric Larson

• Add support for volume and mixed source spaces to mne.stats.summarize_clusters_stc() by Eric Larson

• Add support for omitting the SDR step in volumetric morphing by passing n_iter_sdr=() to mne.compute_source_morph by Eric Larson

• Add single_volume argument to mne.setup_volume_source_space() to facilitate creating source spaces with many volumes (e.g., all subvolumes of aseg.mgz) by Eric Larson

• Add support for passing a string argument to bg_img in mne.viz.plot_volume_source_estimates by Eric Larson

• Add support for providing the destination surface source space in the src_to argument of mne.compute_source_morph() by Eric Larson

• Add explained variance logging to mne.inverse_sparse.mixed_norm(), mne.inverse_sparse.gamma_map(), and mne.beamformer.rap_music() by Eric Larson

• Add tol_kind option to mne.compute_rank() by Eric Larson

• Allow resampling raw data with mne.io.Raw.resample() without preloading data, by Eric Larson

• Allow using pick_ori='vector' with a fixed-orientation inverse to facilitate visualization with mne.viz.plot_vector_source_estimates() by Eric Larson

• mne.viz.plot_dipole_locations() and mne.Dipole.plot_locations() gained a title argument to specify a custom figure title in orthoview mode by Richard Höchenberger

• Add orientations projected onto the MRI slices in mne.viz.plot_dipole_locations() in 'orthoview' mode by Eric Larson

• Add temporal derivative distribution repair (TDDR) mne.preprocessing.nirs.temporal_derivative_distribution_repair() with shortened alias mne.preprocessing.nirs.tddr by Robert Luke

• Add mne.read_freesurfer_lut() to make it easier to work with volume atlases by Eric Larson

• Add support for overlap-add processing when method='spectrum_fit' in mne.io.Raw.notch_filter() by Eric Larson

• Add functionality to interpolate bad NIRS channels by Robert Luke

• Add ability to interpolate EEG channels using minimum-norm projection in mne.io.Raw.interpolate_bads() and related functions with method=dict(eeg='MNE') by Eric Larson

• Added ability of mne.io.read_raw_nirx() to open data by passing path to header file Robert Luke

• Add mne.channels.DigMontage.rename_channels() to allow renaming montage channels by Eric Larson

• Document mne.channels.compute_native_head_t() to allow computing the native-to-head transformation that will be applied when doing raw.set_montage and related functions by Eric Larson

• Add support to in mne.io.Raw.plot() for passing clipping as a float to clip to a proportion of the dedicated channel range by Eric Larson

• Add function mne.preprocessing.annotate_muscle_zscore() to annotate periods with muscle artifacts. by Adonay Nunes

• Add mne.stats.ttest_ind_no_p() to mirror mne.stats.ttest_1samp_no_p() with hat correction by Eric Larson

• Add mne.stats.combine_adjacency to combine adjacency matrices for independent data dimensions to enable things like spatio-temporal-time-frequency clustering in mne.stats.permutation_cluster_test by Eric Larson

• Speed up raw data reading without preload in mne.io.read_raw_nirx() by Eric Larson

• Speed up mne.Epochs.copy() and mne.Epochs.__getitem__() by avoiding copying immutable attributes by Eric Larson

• Speed up and reduce memory usage of mne.SourceEstimate.plot() and related functions/methods when show_traces=True by Eric Larson

• Reduce memory usage of plot_psd, mne.time_frequency.psd_welch, and psd_array_welch for long segments of data by Eric Larson

• Support for saving movies of source time courses (STCs) with brain.save_movie method and from graphical user interface by Guillaume Favelier

• Add mri and show_orientation arguments to mne.viz.plot_bem() by Eric Larson

• Add mne.viz.centers_to_edges() to help when using matplotlib.axes.Axes.pcolormesh() with flat shading by Eric Larson

• Add on_missing='raise' to mne.io.Raw.set_montage() and related functions to allow ignoring of missing electrode coordinates by Adam Li

• Add on_missing='raise' to mne.viz.plot_events() to allow ignoring missing events when passing event_id by Eric Larson

• Add REST EEG infinity reference scheme to mne.io.Raw.set_eeg_reference() and related functions by Eric Larson

• Add better sanity checking of max_pca_components and n_components to provide more informative error messages for mne.preprocessing.ICA by Eric Larson

• Add plot option to mne.viz.plot_filter() allowing selection of which filter properties are plotted and added option for user to supply axes by Robert Luke

• Add estimation method legend to mne.viz.plot_snr_estimate() by Eric Larson

• Add support to mne.SourceSpaces.export_volume for mri_resolution='sparse' to color only the nearest-neighbor voxels instead of entire regions by Eric Larson

• Add axes argument to mne.viz.plot_evoked_white(), mne.Evoked.plot_white(), and mne.viz.plot_snr_estimate() by Eric Larson

• Change default to surfaces='auto' from surfaces='head' to allow mne.viz.plot_alignment() to work when just passing a mne.Info as plot_alignment(info) by Eric Larson

• Add ECoG misc EDF dataset to the Working with ECoG data tutorial to show snapshots of time-frequency activity by Adam Li

• Add mne.viz.set_3d_options() and MNE_3D_OPTION_ANTIALIAS environment variable to control full-scene antialiasing (FXAA) in 3D functions like mne coreg, mne.viz.plot_alignment(), and mne.viz.plot_source_estimates(); this can be useful on systems where FXAA does not work well, such as some with MESA software rendering, by Eric Larson

• Add config variable MNE_TQDM to support explicitly setting the TQDM backend to use, for example tqdm or tqdm.auto (default) by Eric Larson

• Add better support for reading corrupted FIF files in mne.io.read_raw_fif() by Eric Larson

• BIDS conformity: When saving FIF files to disk and the files are split into parts, the split_naming='bids' parameter now uses a “_split-%d” naming instead of the previous “_part-%d”, by Stefan Appelhoff

• Add support for whitening and multiple channel types in mne.beamformer.make_dics() by Marijn van Vliet

• Add better error message when trying to save incompatible Evoked objects to the same file by Eric Larson

• Add support for loading complex numbers from mat files by Thomas Hartmann

• Add generic reader function mne.io.read_raw() that loads files based on their extensions (it wraps the underlying specific read_raw_xxx functions) by Clemens Brunner

• Add automatic T3 magnetometer detection and application of mne.io.Raw.fix_mag_coil_types() to mne.preprocessing.maxwell_filter() by Eric Larson

• Add extended SSS (eSSS) support to mne.preprocessing.maxwell_filter() by Eric Larson

• Add 'auto' option to mne.preprocessing.ICA.find_bads_ecg() to automatically determine the threshold for CTPS method by Yu-Han Luo

• Add a notebook 3d backend for visualization in jupyter notebook with mne.viz.set_3d_backend() by Guillaume Favelier

• Add support for reading and writing surfaces in Wavefront .obj format to the mne.read_surface() and mne.write_surface() by Marijn van Vliet

• Add tutorial on how to manually fix BEM meshes in Blender by Marijn van Vliet and Ezequiel Mikulan

• mne.write_evokeds() will now accept mne.Evoked objects with differing channel orders in info['bads'], which would previously raise an exception by Richard Höchenberger

• Add support for reading channel names (e.g., for Ricoh data) to mne.io.read_raw_kit() by Alex Gramfort and Eric Larson

• The reject_tmin and reject_tmax parameters of mne.Epochs are now taken into account when using the reject_by_annotation parameter by Stefan Appelhoff

• mne.preprocessing.find_bad_channels_maxwell() now automatically applies a low-pass filter before running bad channel detection. This can be disabled, restoring previous behavior by Richard Höchenberger

• Add proj='reconstruct' to mne.Evoked.plot() and related functions to apply projectors and then undo the signal bias using field mapping by Eric Larson

• Add writing BEM surfaces and solutions in H5 format in mne.write_bem_surfaces() and mne.write_bem_solution() by Eric Larson

• When picking a subset of channels, or when dropping channels from Raw, Epochs, or Evoked, projectors that can only be applied to the removed channels will now be dropped automatically by Richard Höchenberger

• mne.Report now can add topomaps of SSP projectors to the generated report. This behavior can be toggled via the new projs argument by Richard Höchenberger

• When passing a list of Evoked objects to plot_compare_evokeds, each evoked’s .comment attribute will be used to label the trace. If .comment is empty, a 1-based index is assigned as the label by Richard Höchenberger

• Speed up mne.stats.summarize_clusters_stc() using Numba by Yu-Han Luo

• Add reject_by_annotation=True to mne.make_fixed_length_epochs() and mne.preprocessing.ICA.plot_properties() to reject bad data segments based on annotation by Yu-Han Luo

• parse_folder now accepts a path-like folder name (it used to work with strings only) by Alex Gramfort

• Add component_order parameter to mne.decoding.CSP which allows switching between mutual_info (default) and alternate (a simpler and frequently used option) by Martin Billinger and Clemens Brunner

• Add memory size information to the repr of mne.SourceSpaces and mne.SourceEstimate and related classes by Eric Larson

• Add reader for Persyst (.lay + .dat format) data in mne.io.read_raw_persyst() by Adam Li

• Use PyVista as the default backend for 3D visualization instead of Mayavi by Guillaume Favelier

• Add reader for SNIRF NIRS data in mne.io.read_raw_snirf() by Robert Luke

• Evoked has gained tmin and tmax attributes for more consistency with Epochs by Richard Höchenberger

Bugs

• Fix bug for writing and reading complex evoked data modifying mne.write_evokeds() and mne.read_evokeds() by new contributor Lau Møller Andersen

• Fix bug by adding error message when trying to save complex stc data in a non.-h5 format mne.VolSourceEstimate.save() by new contributor Lau Møller Andersen

• Fix bug with logging in mne.io.Raw.set_eeg_reference() and related functions by new contributor Simeon Wong

• Fix bug with mne.io.read_raw_gdf() where birthdays were not parsed properly, leading to an error by new contributor Svea Marie Meyer

• Fix bug with mne.io.read_raw_edf() where recording ID was not read properly for non-ASCII characters by new contributor Lx37

• Fix bug in mne.set_eeg_reference() and related functions to set info['custom_ref_applied'] to True for ‘ecog’ and ‘seeg’ channels in addition to ‘eeg’ by new contributor Liberty Hamilton

• Fix bug with mne.chpi.compute_chpi_amplitudes() and mne.chpi.filter_chpi() to optimize time window length by new contributor Steven Bierer

• Fix bug with mne.preprocessing.ICA.find_bads_eog() when more than one EOG components are present by Christian O’Reilly

• Fix bug with non-preloaded data when using raw.apply_proj().load_data().get_data() where projectors were not applied by Eric Larson

• Fix bug to permit stc.project('nn', src) to be applied after stc was restricted to an mne.Label by Luke Bloy

• Fix bug with mne.io.Raw.set_meas_date() to support setting meas_date to None, by Luke Bloy

• Fix bug with mne.setup_volume_source_space() when volume_label was supplied where voxels slightly (in a worst case, about 37% times pos in distance) outside the voxel-grid-based bounds of regions were errantly included, by Eric Larson

• Fix bug with mne coreg where reverse scalings were applied to src[0]['src_mri_t'] for volume source spaces, so morphing and plotting did not work correctly by Eric Larson

• Fix bug with mne.io.read_raw_ctf() when reference magnetometers have the compensation grade marked by Eric Larson

• Fix bug with mne.SourceSpaces.export_volume with use_lut=False where no values were written by Eric Larson

• Fix bug with mne.preprocessing.annotate_movement() where bad data segments, specified in raw.annotations, would be handled incorrectly by Luke Bloy

• Fix bug with mne.compute_source_morph() when more than one volume source space was present (e.g., when using labels) where only the first label would be interpolated when mri_resolution=True by Eric Larson

• Fix bug with mne.compute_source_morph() when morphing to a volume source space when src_to is used and the destination subject is not fsaverage by Eric Larson

• Fix bug with mne.compute_source_morph() where outermost voxels in the destination source space could be errantly omitted by Eric Larson

• Fix bug with mne.compute_source_morph() where complex data was cast to real when doing a volumetric morph by Eric Larson

• Fix bug with mne.minimum_norm.compute_source_psd_epochs() and mne.minimum_norm.source_band_induced_power() raised errors when method='eLORETA' by Eric Larson

• Fix bug with mne.minimum_norm.apply_inverse() where the explained variance did not work for complex data by Eric Larson

• Fix bug with mne.preprocessing.compute_current_source_density() where values were not properly computed; maps should now be more focal, by Alex Rockhill and Eric Larson

• Fix bug with mne.combine_evoked() where equal-weighted averages were wrongly computed as equal-weighted sums, by Daniel McCloy

• Fix bug with mne.channels.DigMontage.plot() when reference channels with no defined position are present, by Eric Larson

• Fix bug with mne.channels.read_custom_montage() where "headshape" points in SFP format were not read properly, by Eric Larson

• Fix bug with setting HTML classes when using mne.Report.add_bem_to_section by Eric Larson

• Fix bug with convex-hull based MEG helmet creation where the face area could be covered up, by Eric Larson

• Fix bug with mne.inverse_sparse.mixed_norm() and mne.inverse_sparse.gamma_map() with return_as_dipoles=True and mne.beamformer.rap_music() where dip.gof was the same for all dipoles. GOF values / explained variance across all dipoles now gets split among the dipoles using SVD of the lead fields. To get the total GOF, sum(dip.gof for dip in dipoles) can be used, by Eric Larson

• Fix bug with mne.inverse_sparse.gamma_map() where output data was not assigned properly when using a free-orientation forward and xyz_same_gamma=False by Eric Larson

• Fix to enable interactive plotting with no colorbar with mne.viz.plot_evoked_topomap() by Daniel McCloy

• Fix plotting with mne.viz.plot_evoked_topomap() to pre-existing axes by Daniel McCloy

• Fix bug with mne.viz.plot_vector_source_estimates() using the PyVista backend with time_viewer=True when updating the arrow colormaps by Eric Larson

• Fix bug with mne.viz.plot_vector_source_estimates() where clim='auto' and clim=dict(..., kind='percent') did not take into account the magnitude of the activation, by Eric Larson

• The default plotting mode for mne.io.Raw.plot() and mne browse_raw has been changed to clipping=3. to facilitate data analysis with large deflections, by Eric Larson

• PSD plots will now show non-data channels (e.g., misc) if those channels are explicitly passed to picks, by Daniel McCloy.

• Fix bug with mne.time_frequency.read_tfrs() where info['meas_date'] was not parsed correctly, by Eric Larson

• Fix bug with mne.time_frequency.tfr_array_stockwell() where inputs were not properly validated by Eric Larson

• Fix handling of NaN when using TFCE in clustering functions such as mne.stats.spatio_temporal_cluster_1samp_test() by Eric Larson

• Fix handling of signs when using TFCE by Eric Larson

• The mne.MixedSourceEstimate class has been clarified to contain two cortical surface source spaces, plus at least one other source space. Creating source estimates in other orderings is not supported, by Eric Larson

• Fix bug where VolSourceEstimate.vertices was an instance of ndarray instead of list of one ndarray, by Eric Larson

• Fix default to be foreground=None in mne.viz.plot_source_estimates() to use white or black text based on the background color by Eric Larson

• Fix bug with writing EGI and CTF mne.Info to H5 format, e.g., with mne.time_frequency.AverageTFR.save by Eric Larson

• Fix bug with topomap outlines in mne.time_frequency.AverageTFR.plot_joint() and mne.time_frequency.AverageTFR.plot_topo() by Eric Larson

• Fix bug with mne.io.Raw.plot() where toggling all projectors did not actually take effect by Eric Larson

• Fix bug with mne.write_proj() where the number of columns was incorrectly written by Eric Larson

• Fix bug with mne.read_epochs() when loading data in complex format with preload=False by Eric Larson

• Fix bug with mne.Epochs.save() where the file splitting calculations did not account for the sizes of non-data writes by Eric Larson

• Fix bug with mne.Epochs when metadata was not subselected properly when event_repeated='drop' by Eric Larson

• Fix bug with mne.Epochs where epochs.drop_log was a list of list of str rather than an immutable tuple of tuple of str (not meant to be changed by the user) by Eric Larson

• Fix bug with mne.Report where the BEM section could not be toggled by Eric Larson

• Fix bug when using mne.Epochs.crop() to exclude the baseline period would break mne.Epochs.save() / mne.read_epochs() round-trip by Eric Larson

• Fix bug with mne.Epochs.subtract_evoked where using decimated epochs would lead to an error by Eric Larson

• Fix bug with mne.viz.plot_bem() and mne.Report when plotting BEM contours when MRIs are not in standard FreeSurfer orientation by Eric Larson

• Fix bug with mne.minimum_norm.make_inverse_operator() where it would warn even when an explicit rank was used by Eric Larson

• Fix bugs with mne.beamformer.make_lcmv() and mne.beamformer.make_dics() where:

  • Noise normalization factors weight_norm='unit-noise-gain' and weight_norm='nai' were computed incorrectly

  • pick_ori='max-power' computed the max-power orientation incorrectly

  • pick_ori='normal' did not compute power or noise normalization factors correctly

  • mne.beamformer.apply_lcmv_cov() did not apply whitening and projections properly

• Fix mne setup_forward_model to have it actually compute the BEM solution in addition to creating the BEM model by Eric Larson

• Fix bug with mne.io.read_raw_edf() where null bytes were not properly handled, causing an error when opening a file by Eric Larson

• Fix bug with mne.Report() where unicode characters were not rendered properly (encoding for HTML was not set) by Eric Larson

• Fix bug with mne.preprocessing.nirs.scalp_coupling_index() where filter transition was incorrectly assigned by Robert Luke

• Fix bug with mne.make_forward_dipole() where mne.write_forward_solution() could not be used by Eric Larson

• Fix bug with mne.io.Raw.plot() when scalings='auto' where bad data would prevent channel plotting by Eric Larson

• Default border and extrapolate arguments for mne.Evoked.plot_topomap() and related functions were changed from 0. to 'mean' and 'box' to 'auto', respectively, to help more accurately reflect sensor geometries and boundary conditions. extrapolate='auto' uses extrapolate='local' for MEG data and extrapolate='head' otherwise, by Eric Larson

• Fix bug that prevents n_jobs from being a NumPy integer type, by Daniel McCloy.

• Fix bug with mne.epochs.average_movements() where epoch weights were computed using all basis vectors instead of the internal basis only by Eric Larson

• Fix bug with mne.get_volume_labels_from_aseg() where the returned labels were alphabetical instead of reflecting their volumetric ID-based order by Eric Larson

• Fix bug with mne.preprocessing.find_bad_channels_maxwell() where good data of exactly step duration would lead to an error by Eric Larson

• Fix bug with mne.preprocessing.find_bad_channels_maxwell() where indices were not handled properly when MEG channels were not first in the raw instance, and logging messages incorrectly reported the interval used by Eric Larson

• Make mne.set_config() accept path-like input values by Richard Höchenberger

• Fix bug with mne.write_labels_to_annot() and mne.datasets.fetch_hcp_mmp_parcellation() where label name strings were not properly terminated, leading to problems loading in FreeSurfer by Eric Larson

• Fix bug with mne.beamformer.make_dics() where complex conjugates were not applied properly by Britta Westner and Eric Larson

• Fix bug with mne.bem.make_watershed_bem() where the RAS coordinates of watershed bem surfaces were not updated correctly from the volume file by Yu-Han Luo

• Fix bug with mne.io.Raw.get_channel_types() and related methods where the ordering of picks was not preserved, by Eric Larson

• Fix bug with mne.io.Raw.plot_psd() with average=False and multiple channel types where channel locations were not shown properly by Eric Larson

• Fix bug with mne.viz.plot_sparse_source_estimates() when using 'sphere' mode by Eric Larson and Guillaume Favelier

• Fix bug in FieldTrip reader functions when channels are missing in the info object by Thomas Hartmann

• Throw proper error when trying to import FieldTrip Epochs data with non-uniform time for trials by Thomas Hartmann

• Throw proper error when trying to import FieldTrip data saved by an old, incompatible version by Thomas Hartmann

• Fix bug in mne.read_epochs_fieldtrip() when importing data without a trialinfo field by Thomas Hartmann

• Fix bug in mne.preprocessing.ICA.plot_properties() where time series plot doesn’t start at the proper tmin by Teon Brooks

• Fix bug with mne.preprocessing.ICA.plot_properties() where a mne.io.Raw object with annotations would lead to an error by Yu-Han Luo

• Fix bug with mne.events_from_annotations(raw.annotations) when orig_time of annotations is None and raw.first_time > 0, by Alex Gramfort

API changes

• Python 3.5 is no longer supported, Python 3.6+ is required, by Eric Larson

• adjacency has replaced connectivity in the names of:

  1. Arguments to clustering functions, such as mne.stats.permutation_cluster_test, and

  2. Function names for defining adjacency, such as mne.spatio_temporal_src_adjacency replacing mne.spatio_temporal_src_connectivity.

  The complete list of changed function names is:

  • mne.channels.find_ch_connectivity → find_ch_adjacency

  • mne.channels.read_ch_connectivity → read_ch_adjacency

  • mne.spatial_dist_connectivity → spatial_dist_adjacency

  • mne.spatial_inter_hemi_connectivity → spatial_inter_hemi_adjacency

  • mne.spatial_src_connectivity → spatial_src_adjacency

  • mne.spatial_tris_connectivity → spatial_tris_adjacency

  • mne.spatio_temporal_dist_connectivity → spatio_temporal_dist_adjacency

  • mne.spatio_temporal_src_connectivity → spatio_temporal_src_adjacency

  • mne.spatio_temporal_tris_connectivity → spatio_temporal_tris_adjacency

  “connectivity” is now reserved for discussions of functional and effective connectivity of the brain, and “adjacency” for source or sensor neighbor definitions for cluster-based analyses, by Eric Larson.

• The default for the standardize_names argument of mne.io.read_raw_kit() will change from True to False in 0.22, by Eric Larson

• The normalize_fwd argument of mne.beamformer.make_dics() has been deprecated in favor of depth, by Eric Larson

• The overwrite parameter of mne.write_bem_surfaces() and mne.write_bem_solution() defaults to True in 0.21 but will change to False in 0.22, by Eric Larson

• Add n_cols parameter to mne.preprocessing.ICA.plot_scores() to allow plotting scores in multiple columns, by Luke Bloy

• In mne.stats.permutation_cluster_test() and mne.stats.permutation_cluster_1samp_test() the default parameter value out_type='mask' has changed to None, which in 0.21 means 'mask' but will change to mean 'indices' in the next version, by Daniel McCloy

• The default window size set by filter_length when method='spectrum_fit' in mne.io.Raw.notch_filter() will change from None (use whole file) to '10s' in 0.22, by Eric Larson

• vmin and vmax parameters are deprecated in mne.Epochs.plot_psd_topomap() and mne.viz.plot_epochs_psd_topomap(); use new vlim parameter instead, by Daniel McCloy.

• The method stc_mixed.plot_surface for a mne.MixedSourceEstimate has been deprecated in favor of stc.surface().plot(...) by Eric Larson

• The method stc.normal for mne.VectorSourceEstimate has been deprecated in favor of stc.project('nn', src) by Eric Larson

• Add use_dev_head_trans parameter to mne.preprocessing.annotate_movement() to allow choosing the device to head transform is used to define the fixed cHPI coordinates by Luke Bloy

• The function mne.channels.read_dig_captrack will be deprecated in version 0.22 in favor of mne.channels.read_dig_captrak() to correct the spelling error: “captraCK” -> “captraK”, by Stefan Appelhoff

• The threshold argument in mne.preprocessing.ICA.find_bads_ecg() defaults to None in version 0.21 but will change to 'auto' in 0.22 by Yu-Han Luo

• The function mne.preprocessing.mark_flat has been deprecated in favor of mne.preprocessing.annotate_flat by Eric Larson

• The default argument meg=True in mne.pick_types() will change to meg=False in version 0.22 by Clemens Brunner

• Added mne.io.Raw.get_montage(), which obtains the montage that an instance has, by Adam Li

Authors

People who contributed to this release in alphabetical order (people with a + are first time contributors):

• Adam Li

• Adonay Nunes

• Alejandro Weinstein

• Alex Rockhill

• Alexandre Gramfort

• Anton Nikolas Waniek

• Britta Westner

• Christian O’Reilly

• Clemens Brunner

• Daniel McCloy

• Eric Larson

• Evgenii Kalenkovich

• Fede Raimondo

• Guillaume Favelier

• Hubert Banville

• Jeroen Van Der Donckt +

• Johann Benerradi +

• Kyle Mathewson +

• Lau Møller Andersen +

• Liberty Hamilton +

• Luke Bloy

• Lx37 +

• Mainak Jas

• Marijn van Vliet

• Martin Billinger

• Martin Schulz +

• Martin van Harmelen

• Mikolaj Magnuski

• Olaf Hauk

• Rahul Nadkarni +

• Richard Höchenberger

• Robert Luke

• Sara Sommariva

• Simeon Wong +

• Stefan Appelhoff

• Steven Bierer +

• Svea Marie Meyer +

• Teon Brooks

• Thomas Hartmann

• Yu-Han Luo

• chapochn

• mshader