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.

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 > 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)

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