DataWarrior User Manual

Program Installation


Installing DataWarrior

DataWarrior installers are available for Linux, Macintosh and Windows. DataWarrior was written in Java and its complete source code is published under the GNU Public License. Installers for the three platforms, and the source code can be downloaded from www.openmolecules.org. The DataWarrior installation contains various example files and a complete user manual, which is accessible from within the application. In addition to the embedded documentation the user manual is also accessible online at www.openmolecules.org.

To install DataWarrior on Windows just double click the downloaded datawarrior.msi file and follow the instructions. Anytime later you may tracelessly uninstall the program using the Control Panel. DataWarrior for Windows is a 64-bit application and includes its own Java Runtime environment.

To install DataWarrior on the Macintosh just double click the downloaded datawarrior.dmg file and drag the DataWarrior application icon onto the Application folder. In the unlikely case you want to de-install the software later, just drag the DataWarrior folder from the application folder into the trash.

To install DataWarrior on Linux you need a working Java runtime environment (JRE) to be installed. To check, whether and which version of a JRE is installed, you may open a terminal or shell and type 'java -version'. If no JRE is installed, you may follow the instructions on the OpenJDK website. DataWarrior is compatible with Java 1.8.0 and newer. We recommend using version 1.8.0_191. From Java 11 on, JavaFX is not part of the official JRE anymore and should be installed in addition. Otherwise DataWarrior won't be able to open its 3D-conformer viewer not its Help window. Both require some JavaFX components.
To install DataWarrior on Linux unpack the downloaded datawarrior.tar.gz file to any location and run the install script with root privileges. To later uninstall DataWarrior you may run /opt/uninstall with root privileges.



Updating DataWarrior

In order to update an existing DataWarrior installation to a newer version, we recommend to uninstall the previous version as described above and then to install the new version. If you have saved or modified any files in the DataWarrior installation directory or any of its subfolders (e.g. 'reference', 'example', or the 'macro' folder), then you should copy these files to a safe place before uninstalling the outdated DataWarrior version.


Look & Feel

When DataWarrior launches for the first time, it uses the Graphite Look & Feel, which means that all user interface elements and the background are drawn in a dark grayish tone. This emphasises in particular color-rich views. Since aesthetic perception depends on the individuum, the Help menu allows to choose from a couple of different Look & Feels. The chosen Look & Feels is stored as part of DataWarrior's settings.

Three different Look & Feels on a Macintosh


Hi-Resolution Monitors

During recent years computer and monitor manufacturers have introduced monitors with substantially higher resolutions than what was common before. DataWarrior supports these monitors on all three platforms, but in a slightly different way, because high resolution monitors are handled differently on different operating systems. In general user interface elements as buttons, combo boxes and menu items are enlarged to make up for the smaller pixel size. Therefore, everything looks much sharper.

On Windows the enlargement factor can be defined for all applications in the in the Display Control Panel under Appearance and Personalization. Under some versions of Windows it is also necessary to disable DPI virtualization for the DataWarrior application. To do so, right-click the name of the DataWarrior executable file, click Properties, click the Compatibility tab, and then select the box labeled Disable display scaling on high DPI settings.

On Retina displays of the Macintosh this factor is predefined as 2.0. And on Linux it depends on the Linux dialect. Usually the scaling factor can be defined in the display settings dialog. On Ubuntu the relevant slider is called Scale for menu and title bars, which is recognized by DataWarrior. For Linux dialects without that setting, or if DataWarrior does not automatically recognize the setting, one may add an 'dpifactor' parameter to the script that launches DataWarrior ('/opt/datawarrior/datawarrior'). For instance to increase all user interface elements by 50% insert a dpifactor of 1.5 into the second line after the -X options. It looks then like:
java -Xms512m -Xmx4096m -Ddpifactor=1.5 ...


Memory Settings

As all Java programs, DataWarrior has a predefined maximum memory setting, which should allow you to work with rather big data files. If these, however, grow into millions of rows, then you may experience 'Out of memory' errors. If your computer has enough physical memory, then you may increase DataWarrior's maximum memory setting the following way:

On Linux this can be easily done by updating the batch file that launches DataWarrior. Open a shell and type 'sudo pico /opt/datawarrior/datawarrior' (if you can't use sudo, then type 'su' followed by the super-user password, then type 'pico /opt/datawarrior/datawarrior'). Look for the '-Xmx4096' setting in the last line, which defines the maximum memory size. Increase the number, press 'Ctrl-o' and 'Enter' to save changes and 'Ctrl-x' to exit the editor.

On the Macintosh you do the following: Open a terminal window, type 'pico /Applications/DataWarrior.app/Contents/Info.plist'. A text editor opens. Use the cursor keys to move close to the end of the file, where you will find the '-Xmx4096M' setting. Increase the number, press 'Ctrl-o' and 'Enter' to save changes and 'Ctrl-x' to exit the editor.

If you use Windows, the procedure is a little more complicated. You need to patch the DataWarrior.exe file. For that start a hex-editor or your choice, search the file for the string '-Xmx3600m' and increase the number part of it, save the file and you are done.