Document:COMKAT install

From COMKAT wiki
Revision as of 22:09, 3 October 2007 by Deancool (talk | contribs)
Jump to navigation Jump to search

Installation procedures before you use COMKAT

System requirements

Matlab 6 or higher version

(NOTE: Matlab 7 is strongly recommended to use COMKAT with. Althouth COMKAT should be compatible in all matlab versions, COMKAT GUI was developed and test under Matlab 7. If you are using Matlab 7, you should also consider upgrading to the latest service pack.) To check your Matlab version, use command "ver" in the Matlab command window.

Mircosoft Windows installation

1. Download the zip file from COMKAT website (http://comkat.uhrad.com) and save it on your disk.

2. Download the installation script file: install_COMKAT_win32.bat.

3. Double-click install_COMKAT_win32.bat. It will open a new Matlab session and prompt you to specify where you saved the zip file you previously downloaded. Follow the directions.

4. Since this batch file will automatically decompress the file and set the path, you should be able to see a welcome window after installation.

5. Congradulations! You are now free to use COMKAT! Enjoy.

Mac and Linux installation

1. Download the zip file from COMKAT website (http://comkat.uhrad.com) and save it on your disk.

2. Decompress the zip file.

3. Open Matlab. Then open the script "setComkatPath.m" under "utilities" folder. Run it and follow the directions.

Mac users: To display tables in the COMKAT GUI properly, you have to set up your Matlab startup option to show Java elements by following these steps:

1. Find file named "Matlab" under Matlab_root/bin/mac (Matlab_root is your Matlab directory)

2. Press "ctrl" and click on the file "Matlab" (at the same time)

3. Select "Show Package Contents"

4. Another finder window should popup showing "Contents", enter this folder

5. Find a file named " launch_matlab.sh"

6. Open this file by TextEdit or any other editor

7. Modify the following line:

$SHELL -c 'bin/mac/setsid bin/matlab -desktop -display :0.0 &'

to

$SHELL -c 'bin/mac/setsid bin/matlab -useJavaGUI -desktop -display :0.0 &'

8. Save "launch_matlab.sh"


Test COMKAT

You can now test if comkat is properly installed by running the validation suite Manual setting of the search path for COMKAT

NOTE: This step is NOT necessary if you have done the previous steps successfully.

Manual setup for path

If you wish to set up the Matlab search path for COMKAT by yourself, here are the steps:

1. Open Matlab. Go to "File"=>"Set path"

2. Click "Add folder" and add the following folders one by one:

COMKAT_root (where you decompress the files to)

COMKAT_root\ComkatImageTool'

COMKAT_root\ImageReadingFunctions\ECAT

COMKAT_root\ImageReadingFunctions\Philips

COMKAT_root\ImageReadingFunctions\Simens-CTI microPET

COMKAT_root\utilities

COMKAT_root\examples

COMKAT_root\comkat_GUI