Known bugs

Main window and database

"Java heap space" error in Matlab.
Workaround: In the Matlab preferences, increase the Java Heap Space memory.
Brainstorm gets very slow after a while, you have to restart Matlab to make it work again.
Workaround: Increase the Java Heap Space memory.
Automatic updates crash while downloading the new software version.
Workaround: Increase the Java Heap Space memory.
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
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.

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 > Edit 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)
"Save image" may capture a blank image on Linux and MacOS (functions getscreen and getframe do not work properly on many systems)

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