# Installation procedure - OptiMAS Graphical User Interface (GUI)

As ready-to-use binaries installation packages are provided for Windows and MacOSX platforms, we will only describe the steps for compiling OptiMAS binaries on GNU/Linux systems. More details on the building and installation instructions from the sources for all supported systems are described in the INSTALL file.

- Windows (32 bits)
- Linux (32/64 bits)
- Mac OS X (32 bits)

To set up OptiMAS on your Windows computer, double-click on the install file i.e. optimas_win_x86_v1_12_06_01.exe (i.e. version 1, 1st June 2012) and follow the Wizard procedure. By default, OptiMAS will be installed in "C:\Program Files\OptiMAS" or "C:\Program Files (x86)\OptiMAS" on 32 bits or 64 bits systems respectively. A new folder named ".OptiMAS" containing the two data set examples will be created in your home directory.

You can now launch OptiMAS interface via the "start menu" or the desktop shortcut.

The software has been tested on Debian, Ubuntu and Fedora. We strongly recommend to have g++, make, Qt, qwt and graphviz installed via the package manager of your GNU/Linux distribution (aptitude/apt on Debian and Ubuntu, or yum on Fedora).

Building prerequisite:

- 1. GNU compiler collections (version 4.0.1 or later): http://gcc.gnu.org/
- 2. Qt development package (version 4.4.3 or later): http://qt.nokia.com/products/
- 3. qwt development package (version 5.1.2 or later): http://sourceforge.net/projects/qwt
- 4. graphviz development package (version 2.20.2 or later): http://www.graphviz.org/

e.g.

- Debian/Ubuntu platforms: apt-get install make g++ libqt4-dev libqwt5-qt4-dev libgraphviz-dev.
- Redhat/Fedora/CentOS platforms: yum install make gcc-c++ qt4-devel qwt-devel graphviz-devel.

To build and install "optimas_gui" GUI on your system, extract the zipped file "optimas_gui_linux.zip" by typing (for example):

$ unzip optimas_gui_linux.zip

This will create a new directory called "optimas_gui_linux". Then, open a terminal, move to this directory before attempting to run the program and run the installation shell (bash) script:

$ ./install_optimas_on_linux.sh

As root (or sudoer), it will perform an installation for all users in /usr/local/bin/. The input/output file examples will be stored respectively in /usr/local/share/OptiMAS/input and /usr/local/share/OptiMAS/output.

As a common user, it will perform a local install in user's personal directory $HOME/bin/. The input/output file examples will be stored respectively in $HOME/.OptiMAS/input and $HOME/.OptiMAS/output.

Note: if the installation script fails in finding qwt and/or graphviz libraries paths on your system, you can specify them in the config.in file (see INSTALL and README files for more details).

You can now launch OptiMAS interface from a terminal: optimas_gui or /path/to/optimas_gui or double-click on optimas_gui in your file browser.

Note: it is not necessary to specify the complete path to the binary "optimas_gui" if it is present in the PATH environment variable.

To uninstall OptiMAS, run the script uninstall_optimas.sh located in the same directory as optimas_gui and optimas.

After downloading the application (optimas_gui.app), to install it, you just need to drag it in your “Applications” folder (/Applications). Then, launch OptiMAS by double-clicking on the optimas_gui icon present in your file browser. A new folder named ".OptiMAS" containing the two data set examples will be created in your home directory.