= What's new =
A log of major improvements to Brainstorm's distribution.

See also: the full list of the daily add-ons and fixes: [[Updates|brainstorm3/doc/updates.txt]]

Brainstorm is in a very active development state: small or major bug fixes and improvements are issued almost everyday. We do not maintain a stable version of the software because it takes a lot of resources. Please use the [[http://neuroimage.usc.edu/forums/|forum]] to notify our team of bugs and crashes: we think we are pretty good at addressing issues and providing fixes in the shortest turnaround time !  The [[http://neuroimage.usc.edu/brainstorm/Installation?highlight=(update)|update feature]] in Brainstorm makes version updating seamless and very convenient to users.

== February 2013 ==
=== Intra-cranial EEG ===
=== Yokogawa/KIT MEG recordings ===
=== Figure layouts ===
=== Save surface snapshot ===
== January 2013 ==
=== Documentation ===
Many new step-by-step tutorials are now available, that cover mainly the processing and epoching of continuous files, the artifact rejection and the graphical scripting:

 * [[Tutorials/TutRawViewer|Review continuous recordings and edit markers]]
 * [[Tutorials/TutRawSsp|Detect and remove artifacts]]
 * [[Tutorials/TutRawAvg|Epoching and averaging]]
 * [[Tutorials/TutRawScript|Full analysis with one script]]

=== Pipeline editor: recall ===
A reports is generated each time an operation is executed from the Process1 or Process2 tabs, and saved automatically in the user folder ($HOME/.brainstorm/reports). All the previous reports can be reviewed using the Report Viewer ('''File > Report viewer''').

Now they can be re-loaded easily: the menu "'''File > Recall last pipeline'''" selects again all the files that were selected previously, and opens the Pipeline Editor window with the previous pipeline reloaded.

The new '''button "Recall pipeline"''' in the toolbar of the Report Viewer allows you to reload any of the previously executed operations.

=== Processing continuous FIF files ===
Some important pre-processing operations are now available directly on continuous recordings in FIF format (usually Elekta-Neuromag MEG/EEG recordings). The new available processes include: the band-pass filter, the sinusoid removal (notch filter) and the baseline correction.

To process a continuous FIF file: link it to the Brainstorm database (right-click on the subject > Review RAW file), then drag and drop the "Link to raw file" in the Process1 box. Select a process in the Pre-process category. In output, it would create a new native continuous FIF file in the same folder, and also link it into the Brainstorm database.

This feature is also available for CTF recordings, and is one of the key elements of our recommended pre-processing pipeline, as illustrated in the tutorial [[Tutorials/TutRawSsp|Detect and remove artifacts]].

=== Copy of the noise covariance ===
=== MRI registration ===
=== Subdivide scouts ===
== December 2012 ==
=== FreeSurfer and BrainVISA ===
Improvements were made for handling !FreeSurfer and BrainVISA segmentations. Both software packages generate a tree of folders that contain all the intermediate steps of the reconstruction, the top folder being the subject name or id. It is now possible to import the entire segmentation folders with just one click. Additionally, new menus are available to generate head surfaces from the MRI.<<BR>>More details: [[Tutorials/LabelFreeSurfer|Freesurfer]] and [[Tutorials/SegBrainVisa|BrainVISA]].

{{attachment:import1.gif|importAnnot1.gif}}

=== Importing MRI masks ===
By "MRI masks", we refer to MRI volumes that contain either only 0 and 1 (binary mask) or integer values (labelled atlas). Both type of MRI masks can be imported directly:

 * as surfaces: Right-click on subject > Import surfaces > Select the file type "Volume mask (all MRI files)". The tesselation is generated automatically by Brainstorm. This works well only in the case of convex envelopes, it is not recommended for complex objects
 * as scouts: In the Scout tab, menu Atlas > Load atlas > Select the file type "Volume mask (all MRI files)". For each label in the volume, a scout is created, containing all the vertices that are in this region.

=== New file types supported ===
 * GIfTI .gii surface files, used by default in BrainVISA
 * Curry event files (.cef)

== November 2012 ==
=== Updated topography plots ===
The rendering of the 2D topography plots is slightly improved, with a new option to set the number of coutour lines.

{{attachment:newTopo.gif|importAnnot1.gif}}

=== New processes ===
 * Standardize > Uniform epoch time: Sets the same time vector for all the input files
 * Pre-process > Scale values: Multiply the values of one or several sensors by a fixed factor
 * Average > Average frequency bands: Average values across frequency bands
 * Extract > Measure from complex values: Apply a function to complex values (typically Morlet or Hilbert coefficients)

=== Miscelanous ===
 * Processing of time-frequency decompositions of source files is now supported (including for the projection on a default anatomy)
 * Copy-paste operations are extended to most of the files available in the database explorer
 * All the keyboard shortcuts have been adapted for Mac systems

== October 2012 ==
=== New interface for the scouts ===
The scouts  interface has been redesigned to integrated the logic of atlases, and the classification of each scout in an anatomical region. You are welcome to visit the following tutorials for more information:<<BR>>[[Tutorials/TutScouts]]<<BR>>[[Tutorials/TutScouts|Tutorials/LabelFreeSurfer]]

{{attachment:figureCortex.gif|importAnnot1.gif}}

=== Project sources to an atlas ===
One of the main problems when dealing with source time series is the size of files. A new process lets you reduce the dimension of your sources by keeping only one value for each scout instead of one value for each vertex: Source > Downsample to atlas. It works well in the case of a set of scouts covering the entire cortex surface, either with a !FreeSurfer atlas, or with a random clustering of the surface (menu Atlas>Surface clustering in the Scout tab).

{{attachment:downsampleAtlas.gif|importAnnot1.gif}}

== September 2012 ==
=== Support for Biosemi BDF files ===
Brainstorm can now import and review native BDF/BDF+ files from Biosemi.

=== Support for MANSCAN files ===
Brainstorm can now import and review native MANSCAN EEG files (SAM Technology, Microamp amplifiers): .mbi/.mb2

== August 2012 ==
=== Drive your Polhemus from Brainstorm ===
For accurate source localization in MEG and EEG with registration to anatomical MRI image volume and efficient head localization in MEG, a 3D digitization solution such as the Polhemus-Fastrak is required. This new, simple Brainstorm feature will help you save time and is efficient for error-checking while digitizing sensor positions and the subject's head shape. See the [[Tutorials/TutDigitize|Digitize tutorial]] for more information.

{{attachment:summary.gif}}

== June 2012 ==
=== Graphical batching interface: final version ===
All the features available from the Brainstorm interface are now also available as "processes", including the import of the data, the artifact cleaning and the source estimation. A full analysis pipeline, starting from the raw continuous file, can be edited graphically and saved as a Matlab script, easy to read an edit. Those scripts can now run on distant servers without any user interaction.

The status of all the computations and the information messages that are generated during the execution of an batch script are now saved in detailed reports that can be reviewed as HTML pages, including screen captures of the data for quality control.

See the two tutorials: [[Tutorials/TutProcesses|Processes]] and [[Tutorials/TutFullAnalysis|Automated processing]].

== April 2012 ==
=== Matlab 2012a ===
The compiled version of Brainstorm is now based on Matlab 2012a. It provides more stability and fixes some issues with the Signal Processing Toolbox. However, if you were previously running the stand-alone verison of Brainstorm, you may have to install a newer version of the Matlab Compiler Runtime. See the [[Installation|Installation page]].

=== New processes ===
 * '''Combine events: stim/reponse''': Create new categories of events to group the markers by pairs (stimulus / response)
 * '''Z-score''' with two sets of file in input:
  1. Compute the variance ''s'' and average ''m'' of the baseline from files A,
  1. Center on ''m'' and divide by ''s'' all the files B

== March 2012 ==
=== Frequency analysis ===
The interface for computing and displaying spectrum and time-frequency information has been largely improved. Two new types of windows are available, allowing the display of the time-frequency matrices as [time x amplitude] or [frequency x amplitude] graphs, for one given frequency or time. Four new processes are available, in the Frequency menu:

 * '''Fast Fourier Transform''' (FFT)
 * '''Power spectrum density''' (Welch)
 * '''Hilbert transform'''
 * '''Time-frequency''' (Morlet wavelets)

All those processes can run on any type of time series: recordings, sources, scouts.They all generate complex values, on which we need to apply a function to extract values that can be represented easily. This function can be changed easily after the computation, as a display parameter:

 * '''Power''': Most common measure to represent the power of a signal for a given frequency bin
 * '''Magnitude''': Energy of the signal for a frequency bin = sqrt(power)
 * '''Log''': Convert to decibels (dB) = 10 * log10(power)
 * '''Phase''': Extract the phase information for a given frequency bin = the angle of the complex value

=== Improvements made to the continuous viewer ===
 * User-defined keyboard shortcuts to create events (keys 1-9)
 * New buttons and keybord shortcuts to explore the time series
 * Bug fix: Automatic positioning of the windows for MacOSX and Linux is now working

 . {{attachment:eventShortcuts.gif||height="400px",width="484px"}}

== February 2012 ==
=== New interface for the artifact removal with SSP ===
The SSP projectors are now saved in a more sophisticated way, allowing a dynamic selection of the projectors to apply on the recordings.

{{attachment:sspExample.gif||height="328px",width="624px"}}

=== Co-registration of MEG runs ===
One of the problems related with the MEG analysis is that the subject's head can move with respect with the sensors during the acquisition. Hence, for the same subject, the position of a given sensor is different for two different runs or two different days of acquisition. We added a process ('''Standardize > Co-register MEG runs''') to compensate for those head movements between acquisition runs, and register all the runs on one fixed head position. For now this process is limited to one head position per run, but we will soon work on using the continuous head localisation information to compensate for the head movements at each time point.

 . {{attachment:megReg.gif||height="189px",width="349px"}}

Another issue with the data acquisition is the sensors selection: depending on the acquisition system or the day of acquisition, one may end up having lists of channels that do not match across runs or subjects. For instance: there were more auxiliary channels recorded for a few files, or different EEG amplifiers listed the electrodes in a different order. In those cases, it is very difficult to average or compare the information at the sensor level. The new process "'''Standardize > Uniformize list of channels'''" fixes all those issues automatically by matching the sensors by name in the different files, and makes them compatible in terms on channel names and indices.

== January 2012 ==
=== Import FreeSurfer cortical parcellation ===
!FreeSurfer is one of the many great academic software applications available to perform MRI image analysis. Brainstorm users can now use !FreeSurfer to generate surface envelopes of head tissues to generate a model of MEG or EEG sources. Brainstorm now features the possibility to  import the labels for regions of the cortex generated by !FreeSurfer's analysis, which correspond to the regions of the Desikan-Killiany and Destrieux cortical parcellation atlases. The corresponding surface areas can subsequently be treated as scouts in Brainstorm, and therefore be used as anatomical ROIs to guide the exploration of MEG/EEG source maps.

See tutorial: [[Tutorials/LabelFreeSurfer|Use FreeSurfer cortical parcellation]]

=== Import Nifti-compressed MRI images ===
We have added the possibility to import  compressed Nifti MR images directly into Brainstorm's MRI Viewer and export MR volumes as Nifti.

=== Improved user interface for time series visualization ===
We have added new, convenient features to navigate through trials, time samples and files in your Brainstorm database. Buttons have been added to the main Brainstorm panel and also into the figure window that display time series: navigate through complex data structures with just a click! You can also adjust the amplitude gain using buttons now, or readily set the scale of time-series displays. As always, feedback is alsways welcome through our [[http://neuroimage.usc.edu/forums/|forum]].

== December 2011 ==
=== Brainstorm on Facebook! ===
'Like Us' on Facebook to stay in touch: [[http://www.facebook.com/brainstormsoftware|{{attachment:facebook_logo.gif|http://www.facebook.com/brainstormsoftware|align="middle",height="30px",width="62px"}}]]<<BR>>

== November 2011 ==
=== New tools for artifact detection and correction ===
1) Specific channels can be scanned     for automatic detection of ocular and cardiac artifacts from    continuous recordings; this feature works best with dedicated   control channels (i.e. ECG and EOG),

2) Artifact modeling and attenuation    using a signal space projection (SSP) approach.

=== Stand-alone distribution for Linux and MacOSX ===
We introduced a new packaging logic for the distribution of Brainstorm executable (i.e., which does require the user to run a Matlab license). The entire set of application files (Matlab scripts and compiled executable) are now integrated in the same unique archive.

The executable is now platform (OS) independent as it has been reduced to a single .jar file created with Matlab's !JavaBuilder, that runs on any platform supporting Matlab. To run the stand-alone version of Brainstorm, you just need to install the free, Matlab Compiler Runtime (version 7.16) foryour operating system.

Read more on the [[Installation]] page.

=== Brainstorm course in Montreal ===
Part of the Brainstorm development team has moved to the[[http://www.bic.mni.mcgill.ca/ResearchLabsNeuroSPEED/HomePage|McConnell Brain Imaging Centre]] at !McGill University's Montreal Neurological Institute, in Montreal, Canada. At this occasion, a full-day training session with 70 participants from across Canada has been organized for new users, back-to-back with the first MEG training workshop of the [[http://www.canada-meg-consortium.org/|Canada MEG Consortium]] ([[http://www.canada-meg-consortium.org/EN/WorkshopPictures|see pictures here]]).

For more training opportunities, visit our [[http://neuroimage.usc.edu/brainstorm/Training|Training]] pages.

== May 2011 ==
=== Brainstorm reference article ===
Publication of a special issue of the journal'' '''''Computational Intelligence and Neuroscience''':[[http://www.hindawi.com/journals/cin/2011/si.ebm/|Academic Software Applications for Electromagnetic Brain Mapping Using MEG and EEG]], co-edited by[[http://www.bic.mni.mcgill.ca/PeopleFaculty/BailletSylvain|Sylvain Baillet]], Karl Friston & Robert Oostenveld. We encourage Brainstorm users to cite this reference in their publications featuring analyses performed using Brainstorm (see How to cite Brainstorm).

Tadel F, Baillet S, Mosher JC, Pantazis D, Leahy RM (2011) ''Brainstorm: A User-Friendly Application for MEG/EEG Analysis'', '''Computational Intelligence and Neuroscience''', vol. 2011, Article ID 879716, 13 pages, 2011. doi:10.1155/2011/879716,[[http://downloads.hindawi.com/journals/cin/2011/879716.pdf|pdf]]]

=== Great improvements in navigating the database ===
The file manager has been extended to support drag-and-drop and copy-paste operations. Users can now move or copy easily files from a condition or subject entry to another using the mouse, keyboard shortcuts [CTRL+C (copy), CTRL+X (cut) and CTRL+V (paste)], or the File section from the contextual menus from the GUI.

=== No MRI for your participants? ===
No worries: Brainstorm can adjust a template anatomy to individual scalp points (MEG) / electrode locations (EEG).

It is now possible to generate pseudo-individual anatomies from a template, for participants for whom the anatomical MRI volume is not available. This operation is possible if digitized head (scalp) points were acquired using a tracking system (e.g., Polhemus Isotrak), which is commonplace in most MEG labs. The default anatomy (volume and surface envelopes) distributed with Brainstorm (MNI/Colin27) can be transformed (warped) to match the subject's scalp points. This is a great cost-saving alternative when individual anatomy is not accessible to investigators (not recommended for accurate, local mapping of the loci of activity though).

See tutorial: [[Tutorials/TutWarping|Warping default anatomy]].

{{attachment:warp.jpg||height="128px",width="377px"}}

=== Refine MRI/MEG registration autoamtically using digitized scalp points ===
When importing MEG recordings, the registration between the MRI volume and the MEG was formerly based only on three fiducial points only (nasion, left ear, right ear). This approach is known be potentially of poor accuracy. If multiple (>60, typically) scalp points were digitized, the transformation between the MEG's and the MRI's referential can be refined by minimizing the average distance between the scalp surface obtained from MRI and the actual digitized head points. This operation is performed automatically in Brainstorm.

See tutorial: [[http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer#Access_to_the_raw_file|Review raw recordings]].

== April 2011 ==
=== Improved, realistic boundary-element-modeling (BEM) head models for EEG ===
A new feature has been made available for a more accurate computation of EEG forward models with realistic geometry (strongly recommended). OpenMEEG generates forward models using a symmetric boundary element method that was developed by the INRIA team [[http://www-sop.inria.fr/athena/software/OpenMEEG/|ATENA]]. It considers three realistic layers (scalp, inner skull, outer skull), which can all be generated from the MRI volume using Brainstorm.

See tutorial: [[Tutorials/TutBem|BEM head model]].

{{attachment:openmeeg.gif||height="67px",width="248px"}}

=== Source estimation in full brain volume ===
 . Source models computed in Brainstorm were until now restricted to the cortical surface. To extend the range of analyses made possible with Brainstorm, and to compare Brainstorm's source estimates with those obtained using other software, source models based on dipole grids sampling the entire brain volume can be obtained and reviewed, using the same efficient tools featured in Brainstorm.
 See tutorial: [[Tutorials/TutVolSource|Volume source estimation]].

{{attachment:grid.jpg||height="163px",width="191px"}} {{attachment:sourcevol.jpg||height="162px",width="178px"}} {{attachment:mriviewer_vol.jpg||height="162px",width="157px"}}

== March 2011 ==
=== Combined MEG/EEG source reconstruction ===
The approach to combine concurrent MEG and EEG recordings to obtain a joint source model has been substantially improved.

=== Display of source maps in MRI volume ===
Added multiple options to review and visualize source maps using contact sheets and volume smoothing of activity maps. 1) source maps are spatially smoothed after interpolation in the MRI voxels. The size of the smoothing kernel can be configured: right-click on the figure > MRI display; 2) the resulting volumescan be used to create contact sheets along all viewing directions, either in time or across the volume.

See tutorial: [[Tutorials/TutSourceEstimation|Source estimation]].

== December 2010 ==
=== Statistical inference: correction for multiple comparisons ===
When displaying the outcome of a t-test, there is now a new tab "stat" that is shown in the main window, which allows to adjust dynamically the type of correction applied to multiple comparisons and the p-value of the test.

=== Unique feature: Graphical batching interface ===
A brand new version of the "Process" tab is available. Processing pipelines can now be elaborated in a convivial way, in just a few clicks! You can also save and export your pipeline as Matlab scripts. The processes available are now written as plug-ins: you can contribute your own process and it will list automatically to your menu of available tasks that can be performed on data.

See tutorial: [[Tutorials/TutProcesses|Processes]].

== September 2010 ==
=== Continuous/RAW file viewer and event editor ===
Brainstorm can now be used to visualize and process full length continous/raw files in native format. See tutorial: [[Tutorials/TutRawViewer|Review raw recordings and edit markers]].

{{attachment:raw.jpg}}

=== Detection of bad trials / bad channels ===
New process available to detect bad trials or bad trials based on peak-to-peak values. The peak-to-peak threshold can be set by channel type.

=== Estimation of the noise covariance from continuous files ===
The interface that computes the noise covariance matrix can be called on continuous recordings. Right-click on link to raw file > Noise covariance.

=== Import/export protocols and subjects ===
New menus to help users exchange data easily. A full protocol can be exported as a single zip file (menu File > Export protocol), and then imported in another database (menu File > Load protocol > Load from .zip file). Same thing for a single subject: right-click on the subject > File > Export subject. The subject .zip file is actually a full protocol zip file with only the exported subject, hence it should be loaded as a protocol.

== June 2010 ==
=== Time-frequency ===
Computation and visualization of time-frequency decompositions of MEG/EEG and source signals using Morlet wavelets. See tutorial: [[Tutorials/TutTimefreq|Time-frequency]].

{{attachment:tf.gif}}

=== Brodman and Tzourio-Mazoyer atlases ===
Two lists of scouts have been created for the default anatomy (MNI/Colin27), inspired from the atlases of Tzourio-Mazoyer and Brodman. To access those files: display the cortex surface of the default anatomy, then in the "Scout" tab click on the "Load scouts" button, on the right of the scouts list.

=== Recordings visualization: 2D Layout ===
The 2D Layout display for recordings has been re-writen to include many tools: sensors selection, interactive gain change, zoom in time and space... See tutorial: [[Tutorials/TutExploreRecodings|Exploring the recordings]].

== March 2010 ==
=== Support for Xfit dipoles files ===
Dipoles localizations from the Neuromag Xfit software can be imported in Brainstorm database and displayed on the same figures as Brainstorm cortical maps. See tutorial: [[Tutorials/TutXfit|Import and visualize dipoles from Neuromag Xfit]].

=== Minimum norm solution ===
Integration of a new minimum norm solution, with more and better tuned parameters. This algorithm is now similar to the one implemented in [[http://www.nmr.mgh.harvard.edu/martinos/userInfo/data/sofMNE.php|MNE software]].

== Januray 2010 ==
=== Project sources on default anatomy ===
Any source file estimated for a given surface can be re-projected on another surface. This allows to project sources of individual subjects on the default anatomy to compare subjects. See tutorial: [[http://neuroimage.usc.edu/brainstorm/Tutorials/TutSourceEstimation#Project_sources_on_default_anatomy|Project sources on default anatomy]].

=== Display channels in columns ===
The time series can be displayed in columns. The displayed sensors can be edited with an interface similar to the selection editor in MNE software.

== December 2009 ==
=== Automatic updates ===
Brainstorm is now self-updating. It tests at each startup if your version is older than a month; if so, it downloads a new version. The software can also be updated manually very easily (menu Help > Update Brainstorm).