Known bugs

Main window and database

• "Java heap space" error in Matlab.
  Workaround: In the Matlab preferences, increase the Java Heap Space memory from 128Mb to 256Mb.

• Brainstorm gets very slow after a while, you have to restart Matlab to make it work again.
  Workaround: Increase the Java Heap Space memory from 128Mb to 256Mb.

• Automatic updates crash while downloading the new software version.
  Workaround: Increase the Java Heap Space memory from 128Mb to 256Mb.

• Any error related with the function "fminsearch"
  Cause: You have a toolbox in your Matlab path, such as EEGLAB, that redefines the basic Matlab function "fminsearch".
  Workaround: From the Matlab preferences: Remove the folder containing this other fminsearch function from your static Matlab path, or remove entirely EEGLAB from your path.

• Multiple screens: does not work in all the configurations
  Cause: Too many possible configuration possible (each version of Linux and Matlab handle this in a different way)
  Workaround: work only with your main screen

• Tree is not updated well and some nodes are missing
  Cause: Unpredictible order of execution of Java/Matlab operations
  Workaround: Press F5 to refresh

• Some user preferences are not saved in compiled versions
• Popup menus and "Open file" dialog take a few seconds to appear on some XP systems. Unknown cause...

• Popup menus and "Open file" dialog may generate the following error:
  The class "BstFileSelector" is undefined. Perhaps Java is not running.
  Workaround: Restart Matlab.

• Navigator: may not work if more than one condition/subject opened at the same time, and next file do not have the same time definition.
  Only things that this prevents you to do is to review at the same time different raw files that were imported in small time blocks... So not a major issue...

• On some computers, the Matlab folder has to remain the brainstorm3 folder, if not it crashes with weird errors...

Figures and display

• Problems in the display of the figures or the colorbars, especially on 64bit machines or when working on a remote system (X-server, VirtualBox, Windows remote desktop connection...).
  Cause: This might be due to the many bugs of the OpenGL support of Matlab, that appear only with specific combinations of OS/Matlab version/video card.
  Workaround: Change the OpenGL rendering properties. In Brainstorm main window, select menu File > Set preferences, and select "software" or "disable". All the 3D views will be very slow and there will be no transparency, but it may solve all the problems.

• Mouse wheel operations (zoom, scroll, change channel gain) do not work on older Matlab versions
  Cause: Support for mouse wheel was introduced in Matlab 7.4 (R2007a), so there is no way to get the wheel events on previous versions.
  Workaround: Upgrade Matlab or run the compiled version of Brainstorm.

• Colormap menus do not work from the 3D figures with some versions of Matlab (eg. R2007a)
  Workaround: Use the Colormaps menu in the main Brainstorm window.

• Colormap sliders for contrast / brightness do not work with versions of Matlab < 7.4
  Workaround: Manipulate the colormap by clicking on the colorbar and moving up/down (brightness) and left/right (contrast)

• 2D/3D topography of modelized data (Fsynth) are always display with EEG colormap, even it is MEG
• "Save image" may capture a blank image on Linux and MacOS (functions getscreen and getframe do not work properly on many systems)
• "Save file" do not check if file already exists on Linux

Computation issues

• Importing surfaces for an MRI that was re-oriented manually: surfaces are not properly oriented.
  Workaround: Use an MRI that is already properly oriented (BrainVISA and FreeSurfer re-write the MRI in a good orientation before processing them).

• OS_MEG (overlapping spheres) may crash when:

  • The scalp in not very well aligned with sensors
    Workaround: register them well...

  • The scalp surface is not very clean (some garbage inside the head)
    Workaround: do your scalp extraction with FreeSurfer