Difference between revisions of "Support:Documents:Manual:COMKAT GUI"
| Line 35: | Line 35: | ||
| MATLAB files (mat) | | MATLAB files (mat) | ||
| The time and activity must be stored in the same variable. One .mat file may contain more than one variable, even nested. | | The time and activity must be stored in the same variable. One .mat file may contain more than one variable, even nested. | ||
| + | |- | ||
| Excel files (xls) | | Excel files (xls) | ||
| The time and activity must be stored in the same worksheet. But the file can contain multiple worksheets. | | The time and activity must be stored in the same worksheet. But the file can contain multiple worksheets. | ||
| + | |- | ||
| Blood activity monitor (BAM) files (bam) | | Blood activity monitor (BAM) files (bam) | ||
| The unit of activity in the BAM file has to be in counts and the counter sensitivity must be stored in the header | | The unit of activity in the BAM file has to be in counts and the counter sensitivity must be stored in the header | ||
| Line 42: | Line 44: | ||
* Units supported include: | * Units supported include: | ||
| − | {| | + | {| border="1" cellspacing="0" |
!Type | !Type | ||
!Unit | !Unit | ||
Revision as of 22:38, 3 October 2007
General use of COMKAT
Before you use COMKAT GUI
Data Requirements to COMKAT GUI
To use COMKAT GUI, there are some minimum requirements to the file formats and content of the data. Please read the following carefully before you use the GUI.
Input Function
Input functions have to be read from files that meet these requirements:
- Each file MUST contain both the time and activity information.
- Time: The measuring time of the sample.
- Activity: Activity measured at the measuring time of the sample.
- Time and activity has to be stored as columns that are of the same length and in the correct order.
- A sample activity measured at certain time must be on the same row as the measuring time.
- Each column containing data must be continuous. Space between lines will cause errors. Text between numeric data might cause errors as well. (See example files: Correct format, bad file example 1, bad file example 2, bad file example 3)
- For different types of files, some extension-specific requirements may apply. (See below for those requirements)
COMKAT allows you to load the input function from several different files. See Input Function GUI for instructions to load the input function.
- File formats supported include:
| File Type | Specific requirement |
|---|---|
| Text files (txt) | x |
| Comma separated files (csv) | x |
| MATLAB files (mat) | The time and activity must be stored in the same variable. One .mat file may contain more than one variable, even nested. |
| Excel files (xls) | The time and activity must be stored in the same worksheet. But the file can contain multiple worksheets. |
| Blood activity monitor (BAM) files (bam) | The unit of activity in the BAM file has to be in counts and the counter sensitivity must be stored in the header |
- Units supported include:
| Type | Unit |
|---|---|
| Time | Second, minute, hour |
| Activity | milli Ci, micro Ci, nano Ci, Bq, MBq, counts (if counter sensitivity is provided) |
Output Function
Output functions can be either loaded from files or images. Image requirements
You can use the COMKAT Image Tool to draw ROIs or VOIs and extract time-activity curves from PET images. It also supports image fusion between PET and CT images. Image formats supported include: Vendor
Specific requirement
Models we have tested Siemens
ECAT Exact® Philips
Allegro® Concorde MicroPET You must have both the .img and .hdr files for the emission scan. MicroPET P4® DICOM We currently support DICOM PET and DICOM CT images. You can load both dynamic (recommended) and static PET images.
(Can't find your format in this list? We are happy to provide assistence for you to write functions to load your images in COMKAT. Contact Dean Fang or Raymond Muzic for instructions to make your image reading function compatible to COMKAT.) File requirements
* Each file MUST contain both the time and activity concentration information. * Time: The output time can be saved as frame beginning time, frame endding time, frame duration or mid-time points as one column. (Either format is compatible) It can also be saved as two-column frame beginning and ending time. * Activity concentration: The data must be in the format of activity/volume. See below for supported units. * Time and activity has to be stored as columns that are of the same length and in the correct order. * The activity concentration measured or imaged at certain time must be on the same row as the measuring time. * Each column containing data must be continuous. Space between lines will cause errors. Text between numeric data might cause errors as well. (See example files: Correct format, bad file example 1, bad file example 2, bad file example 3) * For different types of files, some extension-specific requirements may apply. (See below for those requirements) * If you want to load multiple ROIs at the same time, all TACs have to stored in the same file.
File formats supported include: File Type
Specific requirement Text files (txt)
Comma separated files (csv)
MATLAB files (mat) The time and activity must be stored in the same variables. If you want to load multiple ROIs at the same time, all TACs have to stored in the same variable. Excel files (xls) The time and activity must be stored in the same worksheet. If you want to load multiple ROIs at the same time, all TACs have to stored in the same worksheet. But the file can contain multiple worksheets.
Units supported include:
Type
Unit Time Second, minute, hour Activity milli Ci/ml, micro Ci/ml, nano Ci/ml, Bq/ml, MBq/ml