Installation Notes / Color Tool Kit optional modules / 2018-09-13

The advanced scripts use the Levenberg-Marquardt optimization algorithm, implemented as 'levmar',

http://users.ics.forth.gr/~lourakis/levmar/

This software is written in C language. To access it with our Perl scripts, we made an XS interface
module, ICC::Support::Levmar, which must be compiled and installed.

The ICC::Support::Lapack module is a similar interface to the LAPACK and BLAS libraries. This adds many
useful functions, and dramatically speeds up matrix operations.

These modules were developed for the Mac OS operating system. They may work as-is on other operating
systems, but will probably need modifications. The LAPACK and BLAS libraries are part of the built-in
Accelerate framework on Mac OS. On other operating systems, they will need to be installed and linked in
the 'Build.PL' script.

The following instructions are for Mac OS.

1. Copy the .tar.gz files to a convenient folder and un-zip them by double-clicking. You should now see
two folders, 'ICC-Support-Levmar-0.50' and 'ICC-Support-Lapack-0.6'.

2. Open the Terminal application, and type 'cd ' at the prompt. Drag the 'ICC-Support-Levmar-0.50'
folder to the Terminal window. This will add the path to that folder. Hit return to select that folder
as the working directory.

3. Type 'perl Build.PL' to create the 'Build' script.

4. Type './Build' to compile the interface code.

5. Type 'sudo ./Build install' to install the module. You will need to enter your admin password.

6. Repeat these steps for the Lapack module, using the folder 'ICC-Support-Lapack-0.6', from step 1.

7. The modules are installed in the /Library/Perl folder. You may trash the build folders, if you like.

