Difference between revisions of "Getting started with COMKAT"

Latest revision as of 14:33, 14 October 2012

Getting started with COMKAT

Please carefully read through this document for instructions of setting up and using COMKAT for your specific needs of analysis

Glossary

Here are some terms you may first need to know about COMKAT:

GUI: Graphical user interface
COMKAT GUI: Modeling GUI of COMKAT. The central GUI for kinetic modeling and parameter estimation. COMKAT GUI does not require you to do MATLAB programming.
COMKAT command-line functions: Functions to call from MATLAB command window or MATLAB scripts and functions. You need to write MATLAB code to call those functions
COMKAT Image Tool: The imaging GUI for COMKAT. You can load images with it, draw ROI, display and fuse multiple image data sets.
COMKAT Input Function GUI: This GUI is called by COMKAT GUI for specifying the input function
Standalone application: COMKAT has two types of releases now. It can run under MATLAB or run independently as a executable file. If you do not have a MATLAB license, you will need this COMKAT standalone application. However, some functionality is limited in the standalone application mode as listed in here.
MATLAB path: You need to set up MATLAB path so that it knows where to find COMKAT functions when needed. Therefore, if you use COMKAT under MATLAB you will have to set up your MATLAB path for COMKAT. For standalone applications, COMKAT does not need this process.
ROI: region of interest. Sometimes in COMKAT we call it 'Volume of interest' (VOI).

Define your task

First thing you do is to analyze this: How would you like to use COMKAT? Application can be categorized into the following:

Parameter estimation for image quantification
You have some image data that you would like to draw a region (or regions) of interest and estimate parameters.
1. ROI data
  You may use COMKAT Image Tool to draw ROI. Or you may use other tiers to draw ROI, save data as files and load it into COMKAT GUI.
2. Parameter estimation with COMKAT GUI
  Using COMKAT GUI is the most straight forward method. It has some built-in kinetic models, and you may add new compartment models to COMKAT GUI.
3. Parameter estimation with scripts and COMKAT command-line functions
  For advanced users that can program MATLAB scripts, using COMKAT command-line functions may sometimes provide more flexibilities and advanced functionality.
Image processing
If you only need to load images and draw ROI, you can simply use COMKAT Image Tool as an independent suite.
Model development
If you don't have experimental data and simply wish to evaluate a kinetic model, you can either do it with COMKAT GUI or COMKAT command-line functions.
1. COMKAT GUI: You can create new models with graphical interfaces without programming.
2. COMKAT command-line function: You can create new

models with scripts. This is more appropriate for advanced users and does provide more powerful functions and special kinetics.

Parametric imaging
You can now use COMKAT GUI to calculate the parametric imaging. If you have access to a cluster and MATLAB distributed computing, you can use distributed computing to accelerate this computation.
Input function estimation
COMKAT Input Function GUI now incorporates a GUI for estimating input functions based on our publications for input function estimation for small animal [1].

Prepare your data

Here lists the data requirement for COMKAT GUI. For scripting with COMKAT command-line functions, data requirement is more flexible and therefore not described here.

Input Function

You may either have a measured input function or a simulated input function. For the measured input function, refer to Support:Documents:Manual:COMKAT GUI for requirement of file format and storage. By simulated input function, the input function is generated from a equation (such as a Feng input function or exponential function) or some interpolation. You may use the COMKAT Input Function GUI for simulating the input function.

Experimental data

The experimental data may be either from ROI on images or files. Refer to Support:Documents:Manual:COMKAT GUI for requirement of file format and storage.

Examine your environment

Operating sytem

COMKAT is currently supported on Windows, Linux and MacOS. Because the compiled solvers in COMKAT are much faster and recommended to use, those compiled solvers are platform-dependent and only supported on Windows, Linux and MacOS.
We do provide functions for users to compile those mex files on their platform.

For standalone releases of COMKAT, currently we have them ready for Windows, Linux and MacOS, too.

MATLAB version

We recommend to use the latest version of MATLAB. Although we try to support earlier version of givenchy as well, sometimes due to MATLAB compatibility we will choose to support more recent versions of MATLAB. In the download page of each COMKAT version we will describe the version requirement of MATLAB.

The alternative is to use a standalone version of COMKAT. Once you use the MCR that comes with that COMKAT, there is no MATLAB version issue.

Distributed computing

If you would like to use COMKAT with distributed computing capabilities, * how to make a crepe you need to have access to a cluster that has MATLAB Distributed Computing Toolbox installed and configured. You also need Parallel Computing Toolbox. For more details refer to Support:Documents:Manual:Distributed Computing with COMKAT.

MATLAB Toolbox

The minimum requirement for COMKAT (running under MATLAB) is simply MATLAB itself. In theory COMKAT does not require any toolbox, although we do recommend users to have Optimization Toolbox and Image Processing Toolbox.

For standalone COMKAT, the MCR we ship includes all toolboxes COMKAT needs.

Install COMKAT

We currently offer two types of COMKAT distribution:
COMKAT on MATLAB runs under standard MATLAB and requires MATLAB licensing.
COMKAT Standalone Application does not require MATLAB license and runs as an executable file. (It does, though, require installation of MATLAB Compiler Runtime, or MCR) You may request MCR from us. Go to MATLAB Compiler Runtime for details and instructions of MCR request.

COMKAT on MATLAB

Download and install COMKAT -> Download:COMKAT R3.2.
Please read and follow instructions on that page to set up COMKAT paths.

COMKAT Standalone Application

Download and install COMKAT Standalone -> Download:COMKAT R3.2

Validation

Why do you need to validate COMKAT on your computer?

The validation suite of COMKAT makes sure that the COMKAT command-line functions run correctly on your computer. Also you would like to make sure that results from model solving is accurate.

How to validate COMKAT?

Validate COMKAT on your computer -> Support:Documents:Validation

Using COMKAT

The COMKAT manual can be found at Support:Documents:User manual. Or here are some quick links to topics you may be interested in:

COMKAT GUI

We have a complete page that goes through all necessary steps to load a complete data set into COMKAT GUI for data analysis. Support:Step-by-step COMKAT GUI Example.
Or refer to the general manual of COMKAT GUI: Support:Documents:Manual:COMKAT GUI.

Command line functions

Please refer to Support:Documents:Manual:COMKAT Command Line Interface.
Looking at examples may also be a good start: Support:Documents:COMKAT Examples.

Other COMKAT functions

See manuals for other COMKAT functions: Support:Documents:User manual

@@ Line 1: / Line 1: @@
 <big><big>'''''Getting started with COMKAT'''''</big></big>
-Please carefully read through this document for instructions of setting up and using COMKAT for your specific needs of analysis.
+Please carefully read through this document for instructions of setting up and using COMKAT for your specific needs of analysis
 == Glossary ==
-Here are some terms <span class="plainlinks">[http://www.ardenwoodforest.com/<span style="color:black;font-weight:normal; text-decoration:none!important;background:none!important; text-decoration:none;">condo rentals fremont california</span>] you may first need to know about COMKAT:
+Here are some terms you may first need to know  about COMKAT:
-# GUI: Graphical user interface [http://favoritefilipinofoods.blogspot.com/2011/10/fried-fish-experience-typical-filipino.html Fried Fish Recipe]
+# GUI: Graphical user interface
-# COMKAT GUI: Modeling GUI of COMKAT. The central GUI for kinetic modeling and <span class="plainlinks">[http://www.bankerslifeinsurance.com/<span style="color:black;font-weight:normal; text-decoration:none!important;background:none!important; text-decoration:none;">bankers life</span>]parameter estimation. COMKAT GUI does not require you to do MATLAB programming.
+# COMKAT GUI: Modeling GUI of COMKAT. The central GUI for kinetic modeling and parameter estimation. COMKAT GUI does not require you to do MATLAB programming.
-# COMKAT command-line functions: Functions to call from MATLAB command window or MATLAB scripts and functions. You need to write MATLAB code to call those functions <span class="plainlinks">[http://www.andrewflusche.com/services/virginia-reckless-driving-ticket-defense/<span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">Virginia reckless driving</span>].
+# COMKAT command-line functions: Functions to call from MATLAB command window or MATLAB scripts and functions. You need to write MATLAB code to call those functions
 # COMKAT Image Tool: The imaging GUI for COMKAT. You can load images with it, draw ROI, display and fuse multiple image data sets.
-# COMKAT Input Function GUI: This GUI is called by COMKAT GUI for specifying the input function.
+# COMKAT Input Function GUI: This GUI is called by COMKAT GUI for specifying the input function
-# Standalone application: COMKAT has two types of releases now. It can run under MATLAB or run independently <span class="plainlinks">[http://www.carouseldayschool.org/<span style="color:black;font-weight:normal; text-decoration:none!important;background:none!important; text-decoration:none;">Carousel Day School</span>] as a executable file. If you do not have a MATLAB license, you will need this COMKAT standalone application <span class="plainlinks">[http://www.bankerslifeinsurance.com/<span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">bankers life</span>]. However, some functionality is limited in the standalone application mode as listed in [[Support:Limitations of COMKAT standalone application]].
+# Standalone application: COMKAT has two types of releases now. It can run under MATLAB or run independently as a executable file. If you do not have a MATLAB license, you will need this COMKAT standalone application. However, some functionality is limited in the standalone application mode as listed in here.
-# MATLAB path: You need to set up MATLAB path so that it knows<span class="plainlinks">[http://www.andrewflusche.com/services/virginia-reckless-driving-ticket-defense/<span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">Virginia reckless driving</span>]  where to find COMKAT functions when needed. Therefore, if you use COMKAT under MATLAB you will have to set up your MATLAB path for COMKAT. For standalone applications, COMKAT does not need this process.
+# MATLAB path: You need to set up MATLAB path so that it knows where to find COMKAT functions when needed. Therefore, if you use COMKAT under MATLAB you will have to set up your MATLAB path for COMKAT. For standalone applications, COMKAT does not need this process.
 # ROI: region of interest. Sometimes in COMKAT we call it 'Volume of interest' (VOI).
@@ Line 17: / Line 17: @@
 First thing you do is to analyze this: '''How would you like to use COMKAT?''' Application can be categorized into the following:
 # Parameter estimation for image quantification<br>You have some image data that you would like to draw a region (or regions) of interest and estimate parameters.
-## ROI data<br>You may use COMKAT Image Tool to draw ROI. Or you may use other software to draw ROI, save data as files and load it into COMKAT GUI.
+## ROI data<br>You may use COMKAT Image Tool to draw ROI. Or you may use other tiers to draw ROI, save data as files and load it into COMKAT GUI.
-## Parameter estimation with COMKAT GUI<br>Using COMKAT GUI is the most straight <span class="plainlinks">[http://www.premierrivercruises.com/cruise_lines/tauck_river_cruises <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">Luxury river cruises</span>] forward method. It has some built-in kinetic models, and you may add new compartment models to COMKAT GUI.
+## Parameter estimation with COMKAT GUI<br>Using COMKAT GUI is the most straight forward method. It has some built-in kinetic models, and you may add new compartment models to COMKAT GUI.
 ## Parameter estimation with scripts and COMKAT command-line functions<br>For advanced users that can program MATLAB scripts, using COMKAT command-line functions may sometimes provide more flexibilities and advanced functionality.
-# Image processing<br>If you only need to load <span class="plainlinks">[http://www.drsusanlim.com/<span style="color:black;font-weight:normal; text-decoration:none!important;background:none!important; text-decoration:none;">Dr Susan Lim</span>] images and draw ROI, you can simply use COMKAT Image Tool as an independent suite.
+# Image processing<br>If you only need to load images and draw ROI, you can simply use COMKAT Image Tool as an independent suite.
-# Model development<br>If you don't have experimental data and <span class="plainlinks">[http://www.diamondlinks.net/ <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">link building</span>] simply wish to evaluate a kinetic model, you can either do it with COMKAT GUI or COMKAT command-line functions.
+# Model development<br>If you don't have experimental data and simply wish to evaluate a kinetic model, you can either do it with COMKAT GUI or COMKAT command-line functions.
 ## COMKAT GUI: You can create new models with graphical interfaces without programming.
-## COMKAT command-line function: You can create new <span class="plainlinks">[http://www.espycamera.com/<span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">spy equipment</span>]
+## COMKAT command-line function: You can create new
 models with scripts. This is more appropriate for advanced users and does provide more powerful functions and special kinetics.
 # Parametric imaging<br>You can now use COMKAT GUI to calculate the parametric imaging. If you have access to a cluster and MATLAB distributed computing, you can use distributed computing to accelerate this computation.
@@ Line 32: / Line 32: @@
 ==== Input Function ====
 You may either have a '''measured''' input function or a '''simulated''' input function. For the measured input function, refer to [[Support:Documents:Manual:COMKAT GUI]] for requirement of file format and storage.
-By simulated input function, the input function is generated from a <span class="plainlinks">[http://marcdmanoff.biz/<span style="color:black;font-weight:normal; text-decoration:none!important;background:none!important; text-decoration:none;">marc d manoff</span>] equation (such as a Feng input function or exponential function) or some interpolation. You may use the COMKAT Input Function GUI for simulating the input function.
+By simulated input function, the input function is generated from a equation (such as a Feng input function or exponential function) or some interpolation. You may use the COMKAT Input Function GUI for simulating the input function.
 ==== Experimental data ====
-The experimental data may be either from ROI on images or files. Refer to [[Support:Documents:Manual:COMKAT GUI]] for requirement of file format and storage.
+The experimental data may be either from ROI on images or files. Refer to [[Support:Documents:Manual:COMKAT GUI]] for requirement of file format and  storage.
-[http://sirkus-seo.blogspot.com/2011/07/meriahkan-pesta-ulang-tahun-bersama.html Meriahkan pesta ulang tahun bersama GarudaFood]
-[http://sirkus-seo.blogspot.com/2011/07/amikomus-tempat-belanja-hosting-murah.html Amikom.us Tempat Belanja Hosting Murah]
 == Examine your environment ==
 ==== Operating sytem ====
-COMKAT is currently supported on Windows, Linux and MacOS. Because the compiled solvers in COMKAT are much faster and <span class="plainlinks">[http://www.proposable.com <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">proposal software</span>] recommended to use, those compiled solvers are platform-dependent and only supported on Windows, Linux and MacOS. <br>We do provide functions for users to compile those mex files on their platform.
+COMKAT is currently supported on Windows, Linux and MacOS. Because the compiled solvers in COMKAT are much faster and recommended to use, those compiled solvers are platform-dependent and only supported on Windows, Linux and MacOS. <br>We do provide functions for users to compile those mex files on their platform.
-For standalone releases of COMKAT, currently we have them <span class="plainlinks">[http://www.mycaal.com <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">loan modification</span>] ready for Windows, Linux and MacOS, too.
+For standalone releases of COMKAT, currently we have them ready for Windows, Linux and MacOS, too.
 ==== MATLAB version ====
-We recommend to use the latest version of MATLAB. Although we try to support earlier version of MATLAB as well, sometimes due to MATLAB compatibility we will choose <span class="plainlinks">[http://www.valleypistachio.com/ <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">California pistachios</span>] to support more recent versions of MATLAB. In the download page of each COMKAT version we will describe the version requirement of MATLAB.
+We recommend to use the latest version of MATLAB. Although we try to support earlier version of givenchy as well, sometimes due to MATLAB compatibility we will choose to support more recent versions of MATLAB. In the download page of each COMKAT version we will describe the version requirement of MATLAB.
 The alternative is to use a standalone version of COMKAT. Once you use the MCR that comes with that COMKAT, there is no MATLAB version issue.
 ==== Distributed computing ====
-If you would like to use COMKAT with distributed <span class="plainlinks">[http://xTiburon.com/ <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">technology news</span>] computing capabilities, you need to have access to a cluster that has MATLAB Distributed Computing Toolbox installed and configured. You also need Parallel Computing Toolbox. For more details refer to [[Support:Documents:Manual:Distributed Computing with COMKAT]].
+If you would like to use COMKAT with distributed computing capabilities, <span class="plainlinks">[http://www.makecrepes.net<span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">* how to make a crepe</span>] you need to have access to a cluster that has MATLAB Distributed Computing Toolbox installed and configured. You also need Parallel Computing Toolbox. For more details refer to [[Support:Documents:Manual:Distributed Computing with COMKAT]].
 ==== MATLAB Toolbox ====
@@ Line 64: / Line 63: @@
 ==== COMKAT Standalone Application ====
 Download and install COMKAT Standalone ->  [[Download:COMKAT R3.2]]
-<code>[http://forum.androidcentral.com/members/johnmobile-phones.htm/ android] : </code>
 == Validation ==
 ==== Why do you need to validate COMKAT on your computer? ====
-The validation suite of COMKAT makes sure that the COMKAT command-line functions run correctly on your computer. Also you would like to make sure that results from <span class="plainlinks">[http://naturaltestosteroneboosters.co/ <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">testosterone boosters</span>] model solving is accurate.
+The validation suite of COMKAT makes sure that the COMKAT command-line functions run correctly on your computer. Also you would like to make sure that results from model solving is accurate.
 ==== How to validate COMKAT? ====
 Validate COMKAT on your computer -> [[Support:Documents:Validation]]
@@ Line 74: / Line 72: @@
 The COMKAT manual can be found at [[Support:Documents:User manual]]. Or here are some quick links to topics you may be interested in:
 ==== COMKAT GUI ====
-We have a complete page that goes through all necessary steps to <span class="plainlinks">[http://www.bestpills4weightloss.com/ <span style="color:black;font-weight:normal;text-decoration:none!important; background:none!important; text-decoration:none;">weight loss pills</span>] load a complete data set into COMKAT GUI for data analysis. [[Support:Step-by-step COMKAT GUI Example]].
+We have a complete page that goes through all necessary steps to load a complete data set into COMKAT GUI for data analysis. [[Support:Step-by-step COMKAT GUI Example]].
 <br>Or refer to the general manual of COMKAT GUI: [[Support:Documents:Manual:COMKAT GUI]].
 ==== Command line functions ====
@@ Line 81: / Line 79: @@
 ==== Other COMKAT functions ====
 See manuals for other COMKAT functions: [[Support:Documents:User manual]]
-[http://www.hundeshagen.de Rechtsanwalt Göttingen] [http://www.rechtsanwalt-24.net Rechtsanwalt] [http://www.ehescheidung-jetzt.de Scheidung]
-[http://www.yourfoothealth.com Foot Health] [http://www.spinestenosis.net Spinal Stenosis] [http://www.niazmandi.com Niazmandi] [http://tripadvisorbali.com/ Tripadvisor Bali] [http://www.luxus-finca-mallorca.de Finca Mallorca]