Version 0.14 (2017-03-24)#
Changelog#
Add example of time-frequency decoding with CSP by Laura Gwilliams
Automatically create a legend in
mne.viz.plot_evoked_topo()
by Jussi NurminenAdd I/O support for Artemis123 infant/toddler MEG data by Luke Bloy
Add filter plotting functions
mne.viz.plot_filter()
andmne.viz.plot_ideal_filter()
as well as filter creation functionmne.filter.create_filter()
by Eric LarsonAdd HCP-MMP1.0 parcellation dataset downloader by Eric Larson
Add option to project EEG electrodes onto the scalp in
mne.viz.plot_trans
by Eric LarsonAdd option to plot individual sensors in
mne.io.Raw.plot_psd()
by Alex Gramfort and Eric LarsonAdd option to plot ECoG electrodes in
mne.viz.plot_trans
by Eric LarsonAdd convenient default values to
mne.io.Raw.apply_hilbert()
andmne.io.Raw.apply_function()
by Denis EngemannRemove MNE-C requirement for mne make_scalp_surfaces by Eric Larson
Add support for FastTrack Polhemus
.mat
file outputs inhsp
argument ofmne.channels.read_dig_montage
by Eric LarsonAdd option to convert 3d electrode plots to a snapshot with 2d electrode positions with
mne.viz.snapshot_brain_montage()
by Chris HoldgrafAdd skull surface plotting option to
mne.viz.plot_trans
by Jaakko LeppakangasAdd minimum-phase filtering option in
mne.io.Raw.filter()
by Eric LarsonAdd support for reading ASCII BrainVision files in
mne.io.read_raw_brainvision()
by Eric LarsonAdd method of ICA objects for retrieving the component maps
mne.preprocessing.ICA.get_components()
by Jona SassenhagenAdd option to plot events in
mne.viz.plot_epochs()
by Jaakko LeppakangasAdd dipole definitions for older phantom at Otaniemi in
mne.dipole.get_phantom_dipoles()
by Eric LarsonAdd spatial colors option for
mne.viz.plot_raw_psd()
by Jaakko LeppakangasAdd functions like
get_volume_labels_from_src()
to handle mixed source spaces by Annalisa PascarellaAdd convenience function for opening MNE documentation
open_docs()
by Eric LarsonAdd option in
mne.io.Raw.plot()
to display the time axis relative toraw.first_samp
by Mainak JasAdd new
mne.datasets.visual_92_categories
dataset by Jaakko LeppakangasAdd option in
mne.io.read_raw_edf()
to allow channel exclusion by Jaakko LeppakangasAllow integer event codes in
mne.read_epochs_eeglab()
by Jaakko LeppakangasAdd ability to match channel names in a case insensitive manner when applying a
mne.channels.Montage
by Marijn van VlietAdd
yscale
keyword argument tomne.time_frequency.AverageTFR.plot()
that allows specifying whether to present the frequency axis in linear ('linear'
) or log ('log'
) scale. The default value is'auto'
which detects whether frequencies are log-spaced and sets yscale to log. Added by Mikołaj MagnuskiAdd Representational Similarity Analysis (RSA) example on
mne.datasets.visual_92_categories.data_path
dataset by Jaakko Leppakangas, Jean-Rémi King and Alex GramfortAdd support for NeuroScan files with event type 3 in
mne.io.read_raw_cnt()
by Marijn van VlietAdd interactive annotation mode to
mne.io.Raw.plot()
(accessed by pressing ‘a’) by Jaakko LeppakangasAdd support for deleting all projectors or a list of indices in
mne.io.Raw.del_proj()
by Eric LarsonAdd source space plotting with
mne.SourceSpaces.plot()
usingmne.viz.plot_trans
by Eric LarsonAdd
mne.decoding.get_coef()
to retrieve and inverse the coefficients of a linear model - typically a spatial filter or pattern, by Jean-Rémi KingAdd support for reading in EGI MFF digitization coordinate files in
mne.channels.read_dig_montage
by Matt BoggessAdd
n_per_seg
keyword argument tomne.time_frequency.psd_welch
andmne.time_frequency.psd_array_welch()
that allows to control segment length independently ofn_fft
and use zero-padding whenn_fft > n_per_seg
by Mikołaj MagnuskiAdd annotation aware data getter
mne.io.Raw.get_data()
by Jaakko LeppakangasAdd support of dipole location visualization with MRI slice overlay with matplotlib to
mne.viz.plot_dipole_locations()
via mode=’orthoview’ parameter by Jaakko Leppakangas and Alex GramfortAdd plotting of head positions as a function of time in
mne.viz.plot_head_positions()
by Eric LarsonAdd
real_filter
option tomne.beamformer.dics
,mne.beamformer.dics_source_power
,mne.beamformer.tf_dics
andmne.beamformer.dics_epochs
by Eric Larson, Alex Gramfort and Andrea Brovelli.Add a demo script showing how to use a custom inverse solver with MNE by Alex Gramfort
Functions
mne.preprocessing.create_ecg_epochs()
,mne.preprocessing.create_eog_epochs()
,mne.compute_raw_covariance()
and ICA methodsmne.preprocessing.ICA.score_sources()
,mne.preprocessing.ICA.find_bads_ecg()
,mne.preprocessing.ICA.find_bads_eog()
are now annotation aware by Jaakko LeppakangasAllow using
spatial_colors
for non-standard layouts by creating custom layouts from channel locations and addto_sphere
keyword tomne.viz.plot_sensors()
to allow plotting sensors that are not on the head surface by Jaakko LeppakangasConcatenating raws with
mne.concatenate_raws()
now creates boundary annotations automatically by Jaakko Leppakangasmne.viz.plot_projs_topomap()
now supports plotting EEG topomaps by passing inmne.Info
by Eric Larson
BUG#
Fix bug with DICS and LCMV (e.g.,
mne.beamformer.lcmv
,mne.beamformer.dics
) where regularization was done improperly. The defaultreg=0.01
has been changed toreg=0.05
, by Andrea Brovelli, Alex Gramfort, and Eric LarsonFix callback function call in
mne.viz.topo._plot_topo_onpick
by Erkka HeinilaFix reading multi-file CTF recordings in
mne.io.read_raw_ctf()
by Niklas WilmingFix computation of AR coefficients across channels in
mne.time_frequency.fit_iir_model_raw()
by Eric LarsonFix maxfilter channel names extra space bug in
mne.preprocessing.maxwell_filter()
by Sheraz Khanmne.channels.find_layout()
now leaves out the excluded channels by Jaakko LeppakangasArray data constructors
mne.io.RawArray
andEvokedArray
now make a copy of the info structure by Jaakko LeppakangasFix bug with finding layouts in
mne.viz.plot_projs_topomap()
by Eric LarsonFix bug
mne.io.anonymize_info()
when Info does not contain ‘file_id’ or ‘meas_id’ fields by Jean-Rémi KingFix colormap selection in
mne.viz.plot_evoked_topomap()
when using positive vmin with negative data by Jaakko LeppakangasFix channel name comparison in
mne.channels.read_montage
so that ifch_names
is provided, the returned montage will have channel names in the same letter case by Jaakko LeppakangasFix
inst.set_montage(montage)
to only setinst.info['dev_head_t']
ifdev_head_t=True
inmne.channels.read_dig_montage
by Eric LarsonFix handling of events in
mne.realtime.RtEpochs
when the triggers were split between two buffers resulting in missing and/or duplicate epochs by Mainak Jas and Antti RantalaFix bug with automatic decimation in
mne.io.read_raw_kit()
by Keith DoellingFix bug with
setup_volume_source_space()
where argumentssubject
andsubjects_dir
were ignored by Jaakko LeppakangasFix sanity check for incompatible
threshold
andtail
values in clustering functions likemne.stats.spatio_temporal_cluster_1samp_test()
by Eric LarsonFix
_bad_dropped
not being set when loading eeglab epoched files viamne.read_epochs_eeglab()
which resulted inlen()
not working by Mikołaj MagnuskiFix a bug in
mne.time_frequency.AverageTFR.plot()
when plotting without a colorbar by Jaakko LeppakangasFix
_filenames
attribute in creation ofmne.io.RawArray
withmne.preprocessing.ICA.get_sources()
by Paul PaslerFix contour levels in
mne.viz.plot_evoked_topomap()
to be uniform across topomaps by Jaakko LeppakangasFix bug in
mne.preprocessing.maxwell_filter()
where fine calibration indices were mismatched leading to anAssertionError
by Eric LarsonFix bug in
mne.preprocessing.fix_stim_artifact()
where non-data channels were interpolated by Eric Larsonmne.decoding.Scaler
now scales each channel independently using data from all time points (epochs and times) instead of scaling all channels for each time point. It also now accepts parameterscalings
to determine the data scaling method (default isNone
to use static channel-type-based scaling), by Asish Panda, Jean-Rémi King, and Eric LarsonRaise error if the cv parameter of
mne.decoding.GeneralizationAcrossTime
andmne.decoding.TimeDecoding
is not a partition and the predict_mode is “cross-validation” by Jean-Rémi KingFix bug in
mne.io.read_raw_edf()
whenpreload=False
and channels have different sampling rates by Jaakko LeppakangasFix
mne.read_labels_from_annot()
to setlabel.values[:]=1
rather than 0 for consistency with theLabel
class by Jon HouckFix plotting non-uniform freqs (for example log-spaced) in
mne.time_frequency.AverageTFR.plot()
by Mikołaj MagnuskiFix
mne.minimum_norm.compute_source_psd()
when used withpick_ori=None
by Annalisa Pascarella and Alex GramfortFix bug in
mne.Annotations
where concatenating two raws whereorig_time
of the second run isNone
by Jaakko LeppakangasFix reading channel location from eeglab
.set
files when some of the channels do not provide this information. Previously all channel locations were ignored in such case, now they are read - unless a montage is provided by the user in which case only channel names are read from set file. By Mikołaj MagnuskiFix reading eeglab
.set
files when.chanlocs
structure does not containX
,Y
orZ
fields by Mikołaj MagnuskiFix bug with
mne.simulation.simulate_raw()
wheninterp != 'zero'
by Eric LarsonFix
mne.fit_dipole()
to handle sphere model rank deficiency properly by Alex GramfortRaise error in
mne.concatenate_epochs()
when concatenated epochs have conflicting event_id by Mikołaj MagnuskiFix handling of
n_components=None
inmne.preprocessing.ICA
by Richard HöchenbergerFix reading of fiducials correctly from CTF data in
mne.io.read_raw_ctf()
by Jaakko LeppakangasFix
mne.beamformer.rap_music()
to return dipoles with amplitudes in Am instead of nAm by Jaakko LeppakangasFix computation of duality gap in
mne.inverse_sparse.mxne_optim.dgap_l21
by Mathurin Massias
API#
The filtering functions
band_pass_filter
,band_stop_filter
,low_pass_filter
, andhigh_pass_filter
have been deprecated in favor ofmne.filter.filter_data()
by Eric LarsonEvokedArray
now has default valuetmin=0.
by Jaakko LeppakangasThe
ch_type
argument formne.viz.plot_trans
has been deprecated, useeeg_sensors
andmeg_sensors
instead, by Eric LarsonThe default
tmax=60.
inmne.io.Raw.plot_psd()
will change totmax=np.inf
in 0.15, by Eric LarsonBase classes
mne.io.BaseRaw
andmne.BaseEpochs
are now public to allow easier typechecking, by Daniel McCloymne.io.read_raw_edf()
now combines triggers from multiple tal channels to ‘STI 014’ by Jaakko LeppakangasThe measurement info
Info
no longer contains a potentially misleadinginfo['filename']
entry. Use class properties likemne.io.Raw.filenames
ormne.Epochs.filename
instead by Eric LarsonDefault fiducial name change from ‘nz’ to ‘nasion’ in
mne.channels.read_montage
, so that it is the same for bothmne.channels.Montage
and :class:mne.channels.DigMontage
by Leonardo BarbosaMNE’s additional files for the
fsaverage
head/brain model are now included in MNE-Python, and the now superfluousmne_root
parameter tocreate_default_subject()
has been deprecated by Christian BrodbeckAn
overwrite=False
default parameter has been added towrite_source_spaces()
to protect against accidental overwrites, by Eric LarsonThe
mne.decoding.LinearModel
class will no longer supportplot_filters
andplot_patterns
, usemne.EvokedArray
withmne.decoding.get_coef()
instead, by Jean-Rémi KingMade functions
mne.time_frequency.tfr_array_multitaper()
,mne.time_frequency.tfr_array_morlet()
,mne.time_frequency.tfr_array_stockwell()
,mne.time_frequency.psd_array_multitaper()
andmne.time_frequency.psd_array_welch()
public to allow computing TFRs and PSDs on numpy arrays by Jaakko Leppakangasmne.preprocessing.ICA.fit()
now rejects data annotated bad by default. Turn off withreject_by_annotation=False
, by Jaakko Leppakangasmne.io.read_raw_egi()
now names channels with pattern ‘E<idx>’. This behavior can be changed with parameterchannel_naming
by Jaakko Leppakangasthe
name
parameter inmne.Epochs
is deprecated, by Jaakko Leppakangas