Please visit http://batmass.org for more information.
A small introductory video
Check out http://batmass.org for more info.
Mass spectrometry data visualization tools
BatMass is a mass-spectrometry data visualization tool, with the main focus on being fast and interactive while providing comprehensive visualizations without any parameter tweaking. It is written in pure Java and built on top of the NetBeans Platform.
Please cite the following paper if you used BatMass or MSFTBX (data access library) in your work:
Avtonomov D.M. et al: J. Proteome Res. June 16, 2016. DOI: 10.1021/acs.jproteome.6b00021
It looks like BatMass can't be run on java versions after 8. This is a problem of all NetBeans platform applications, not specific to BatMass.
On Linux, a tried solution is to install JDK 8 and to set java 8 as the java of choice. E.g. on Ubuntu:
sudo apt install openjdk-8-jdk
sudo update-alternatives --config javaand select
java 8manually (if possible)
<batmass-install-path>/etc/batmass.conffile. Uncomment and change
jdkhomevariable to something like:
Important before you begin (Troubleshooting)
The only 2 parameters that you mgiht want to change after installing/unzipping is the amount of memory allowed to be used by BatMass and the path to JRE (Java Runtime Environment) to be used.
The startup parameters are stored in
- To change the memory limit, change
default_optionsparameter, look for
-J-Xmxin its value string. The default is
-J-Xmx4G, which means 4Gb max will be allowed and if your machine does not have enough free memory, the JVM (Java Virtual Machine) might fail to start.
- If you can't start the application and you are sure you have enough memory and a valid JRE/JDK installation, uncomment variable
batmass.conf. Even though it's name starts with
jdkit's actually just a path where
./bin/javabinary can be found. E.g. use
jdkhome="C:\Program Files\Java\jre1.8.0_31"on Windows, or
- Windows users, if you've isntalled BatMass on your system drive in the default folder (most commonly
C:\Program Files\batmass), you might need to run text editor as administrator, otherwise you won't be able to save changes made to
Support for the open standard mzML and mzXML mass spectrometry data types. We are hoping to bring native vendor format support as well.
Viewer synchronization. Link any number of viewers and zooming/panning will be synchronized across them. If you're viewing MS1 data in one view and MS2 data in the other the retention time is synchronized, while m/z is not. Open a detected LC/MS feature table or a peptide identification table, a double click on the row will open the corresponding spectrum, or bring you to the corresponding location in a 2D Map viewer.
Data access layer. For the Java developers out there, the highly optimized mzML/mzXML parsers can be used in any standalone Java program as a simple jar dependency. Parsing has been manually tuned to produce few garbage objects, thus minimizing time spent in GC (Garbage Collection), the speed is comparable to or better than in C/C++ implementations. The API for LC/MS data files gives access to most of the features supported by mzML/mzXML standards.
Download an installer for your system here.
If you choose to use the platform independent zip file (batmass.zip), you'll need to run the launcher for your system in
<install_path>/bin/batmass64.exe if you're running a 64 bit version of Windows. For linux-based systems there is
<install_path>/bin/batmass shell script to start BatMass.
If you have an earlier version of BatMass installed, you have to manually uninstall it.
For more detailed instructions see the getting started guide.