= Known bugs =
== Main window and database ==
 * "Java heap space" error in Matlab. <<BR>>__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. <<BR>>__Workaround__: Increase the Java Heap Space memory.
 * Automatic updates crash while downloading the new software version. <<BR>>__Workaround__: Increase the Java Heap Space memory.
 * Any error related with the function "fminsearch"<<BR>>__Cause__: You have a toolbox in your Matlab path, such as EEGLAB, that redefines the basic Matlab function "fminsearch".<<BR>>__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<<BR>>__Cause__: Too many possible configuration possible (each version of Linux and Matlab handle this in a different way) <<BR>>__Workaround__: work only with your main screen.

 * Tree is not updated well and some nodes are missing<<BR>>__Cause__: Unpredictible order of execution of Java/Matlab operations<<BR>>__Workaround__: Press F5 to refresh
 * Popup menus and "Open file" dialog may generate the following error: <<BR>>The class "BstFileSelector" is undefined. Perhaps Java is not running.<<BR>>__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...).<<BR>>__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.<<BR>>__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<<BR>>__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.<<BR>>__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)<<BR>>__Workaround__: Use the Colormaps menu in the main Brainstorm window.
 * Colormap sliders for contrast / brightness do not work with versions of Matlab < 7.4<<BR>>__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.<<BR>>__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<<BR>>__Workaround__: register them well...
  * The scalp surface is not very clean (some garbage inside the head)<<BR>>__Workaround__: do your scalp extraction with FreeSurfer