Installation and Starting JAABA

JAABA can either be run

Without MATLAB using executables that can be downloaded and clicked on (users without an up-to-date version of MATLAB (>= R2012a)) or
With MATLAB from the MATLAB command line using our source code.

Please follow the appropriate instructions below.

Minimum Computer Requirements
Installation and Start-up: No MATLAB

Software Requirements (No MATLAB)
Installation (No MATLAB)
Start-Up (No MATLAB)

Installation and Start-up: With MATLAB

Software Requirements (With MATLAB)
Installation (With MATLAB)
Start-Up (With MATLAB)

Windows Firewall Security Warning

Minimum Computer Requirements

JAABA can run on Linux (64-bit), Windows (32- or 64-bit), or Mac OS X (64-bit) systems with at least 4GB RAM. JAABA uses parallel computation, and will be faster on multicore machines. JAABA is a computationally intensive program, and will run better on better machines. The amount of memory required scales with the complexity of the behavior. To use the development version of the software, MATLAB version >= R2012a is required.

Installation and Start-up: No MATLAB

Users who do not have an up-to-date version of MATLAB should use the executable version of JAABA. This only requires downloading a program and clicking it.

Software Requirements (No MATLAB)

The only requirement is the freely available Matlab Compiler Runtime (MCR) for R2012a. MCR installers and instructions are available at Mathworks website.

Installation (No MATLAB)

Download and install the Matlab Compiler Runtime (MCR).. MCR installers and instructions are available at Mathworks website.

For Windows, JAABA versions >= 0.6.0, please use MCR R2014b.
For Mac, JAABA versions >= 0.6.0, please use MCR R2014a.
For older versions of JAABA, use MCR R2012a.

Download the JAABA package for your system from http://sourceforge.net/projects/jaaba/files.
Unzip the package zip file.
Leave the executable in the directory in the package. You can move the entire directory, but JAABA relies on other files in that directory, so please leave them in the same directory.

Start-Up (No MATLAB)

Within the package, there is an executable program. The name of this file depends on the OS:

Windows: Double-click JAABA.exe to run JAABA. The first time you run this program, you may receive a Windows Security Warning from your firewall. This is normal, and we recommend allowing JAABA to run. See Windows Firewall Security Warning below for more information.
Mac OS X: Double-click the JAABA application to run JAABA.
Linux: The shell script run_JAABA.sh runs JAABA. It should be run from within the JAABA package directory using the command
```
./run_JAABA.sh [MCR location]
```

Please be patient. Loading the MATLAB MCR is slow, hence once you run the executable it may take some time for JAABA to appear.

Installation and Start-up: (With MATLAB)

Users with an up-to-date version of MATLAB and/or wanting to use the development version of JAABA can run JAABA from the source code within MATLAB.

Software Requirements (With MATLAB)

MATLAB version >= 2012a (7.14.0.739)
MATLAB Parallel Computing, Image Processing, and Statistics Toolboxes

Installation (Advanced)

Download the source code. There are two options:
- git: Clone the JAABA git repository at our github site. There are lots of tutorials on using git. Using git to version JAABA will allow one to easily obtain updates and bug fixes to the code.
- zip file: Download a source code zip file.
Change into the directory perframe:
```
cd [JAABA location]/perframe
```
Run StartJAABA on the command line to start JAABA.

Windows Firewall Security Warning

When JAABA is started for the first time in Windows, it may trigger a Windows Security Warning from your firewall. This is normal, and we recommend you allow JAABA to proceed. This warning is triggered when JAABA calls matlabpool, part of MATLAB's Parallel Computing Toolbox. The Parallel Computing Toolbox can be used to distribute jobs over a many computers over a network, which is why Windows creates a warning. JAABA only uses multiprocessing on a single machine, and thus will not be accessing your network. When JAABA starts, it will ask you whether you want to:

Start a new project
Open an existing project in training mode
Open an existing project in ground-truthing mode

Training mode is the standard mode

If you choose to Start a new project the New... dialog box will open, see Creating a New Project for more information. If you choose to Open an existing project in training mode, you can open a project you have previously created to add new training data and train new classifiers. If you choose to Open an existing project in ground-truthing mode, you can open a project you have previously created to quantitatively evaluate a classifier's performance on data selected in an unbiased manner.