Download:COMKAT R4.2a

From COMKAT wiki

Jump to: navigation, search

Contents

About COMKAT R4.2a

COMKAT R4.2a is released in July 2017. It is an alpha release version of COMKAT (This new version has not been compiled and tested in Mac OS).

This alpha version is now in the trial stage. Please report bugs to us [1] and help us make COMKAT better.

COMKAT on MATLAB

Click here to download COMKAT R4.2a (For-MATLAB version).
NOTE: You must log in first to download.


System requirement

OS: Windows (64-bit only).
MATLAB: As the mex files are compiled under different versions of MATLAB, COMKAT on different platforms requires different MATLAB release.

  • Windows: MATLAB R2006a and above
  • Windows 64-bit: MATLAB R2008a and above

New features (COMKAT R4.2a)

1. Greatly improve the performance of VOI processing using c-mex functions.

2. Misc bug fixes for new MATLAB version compatibility (tested up to MATLAB R2016b).


New features recap (COMKAT R4.1b)

1. Display/handle data with multiple bands (the fifth dimension). This can be used to view an image volume data set collected with several MR sequences [2].

2. K-means & Fuzzy C-means analysis[3].

3. DICOM images import and export functions.

4. Import a matrix or an ImageVolumeData (IVD) object from the MATLAB Workspace [4].

5. Export Image to Matlab Workspace[5].

6. MR phase unwrapping algorithm.

7. Add-ins[6].

8. Some useful tools[7]:

  • Fast slice viewing sliders.
  • Match IVD centers.
  • Temporarily save and retrieve view orientation and position.

9. Save VOI masks[8].

10. Automatic image registration[9].

11. New colormap options:

  • hot-winter
  • rainbow
  • PinkGreen (float)

12. Improve the performance of VOI display

13. Misc bug fixes.


Installation

COMKAT on MATLAB

To install COMKAT to your system, follow these steps.

1. Download COMKAT_R4.2a.zip from http://comkat.case.edu

2. Unzip it to your computer.

3. Set up search path for COMKAT. You may do either of the following:

(1) Automatic (recommended): Open MATLAB, run 'SetComkatPath.m' under the COMKAT root folder.

(2) Manual: You may set up the paths manually. First, open MATLAB and go to File -> Set Path. Click 'Add folder' and select the following folders.

(COMKATROOT is the root folder that you unzip COMKAT files under.)

COMKATROOT/

COMKATROOT/comkat_GUI

COMKATROOT/ComkatImageTool

COMKATROOT/ComkatImageTool/models

COMKATROOT/utilities

COMKATROOT/validation

COMKATROOT/examples

COMKATROOT/add-ins

After that, click 'Add subfolders' and select COMKATROOT/ImageReadingFunctions.

4. Re-start MATLAB. Go to "File -> Set Path". Check if the COMKAT folders are in the paths. If not, that means you do not have the 'owner' access to a file called "pathdef.m" on your system. To solve this, type 'which pathdef.m' in MATLAB. It will show the location of this file. Ask your system administrator to give you write access to this file, and then set the path again.

5. In MATLAB, execute command 'validate'. Validation suite should pop up and allow you to examine if results are correctly generated on your computer.

6. If you are having trouble running the validation suite associated with'pxEval' or 'cvodesGenmod5' functions, that means you have a compatibility issue with these mex function. It's either that your MATLAB version is older than the one we used to compile these mex functions, or your platform is not supported by COMKAT yet. You may use the makefile to re-compile these mex functions again. Run the script 'makefile.m' under COMKAT root folder. Please contact us if you are having trouble running it.

NOTE: If you are running MATLAB versions before R2006, we strongly recommend you to re-compile the mex functions again to ensure every function is working properly.

Within the MATLAB File -> Set Path tool you might need to use "Move Up" and "Move Down" to get the folders into the preferred order given above.

4. In MATLAB, execute command 'validate'. Validation Suite should pop up and allow you to select various computations to perform. The generated results are shown in a report displayed in a Web browser. Pay particular attention to the Results section of the report and compare new results generated on Your Computer (to the left) to ones previously generated on a COMKAT Developer's Computer (to the right) and deemed to be correct. Note that minor differences are expected due to finite numeric precision obtained with computers.

NOTE 64-bit Windows users: When you install 64-bit MATLAB, it does not automatically install the Visual C re-distributable for you. But for 32-bit MATLAB it does. Since we compiled our mex files using Visual Studio 2008 for Windows, you will have to install the Visual Studio 2008 re-distributable in order to run the mex files. Otherwise you may get a mex file error.
Please go to Microsoft website: http://www.microsoft.com/downloads/details.aspx?familyid=bd2a6171-e2d6-4230-b809-9a8d7548c1b6&displaylang=en to download and install the re-distributables. If the link is broken, google Microsoft Visual C++ 2008 Redistributable Package x64.