mia-2dmyocard-icaseries(1) Run an ICA analysis on a series of 2D images

SYNOPSIS

mia-2dmyocard-icaseries -i <in-file> [options]

DESCRIPTION

mia-2dmyocard-icaseries This program is used to run a ICA on a series of myocardial perfusion images given in a segmentation set in order to create sythetic references that can be used for motion correction by image registration. If the aim is to run a full motion compensation then it is better run mia-2dmyoica-nonrigid, since this program is essentially the same without the registration bits.

OPTIONS

File-IO

-i --in-file=(input, required); string
input perfusion data set
-r --references=(output); string
File name base for the reference images. Image type and numbering scheme are taken from the input images.
-c --save-cropped=(output); string
save cropped set of the original set to this file, the image files will use the stem of the name as file name base
--save-feature=(output); string
save the features images resulting from the ICA and some intermediate images used for the RV-LV segmentation with the given file name base to PNG files. Also save the coefficients of the initial best and the final IC mixing matrix.

Help & Info

-V --verbose=warning
verbosity of output, print messages of given level and higher priorities. Supported priorities starting at lowest level are:
info - Low level messages
trace - Function call trace
fail - Report test failures
warning - Warnings
error - Report errors
debug - Debug output
message - Normal messages
fatal - Report only fatal errors
--copyright
print copyright information
-h --help
print this help
-? --usage
print a short help
--version
print the version number and exit

ICA

-C --components=0
ICA components 0 = automatic estimationICA components 0 = automatic estimation
--normalize
normalized ICs
--no-meanstrip
don't strip the mean from the mixing curves
-s --segscale=1.4
segment and scale the crop box around the LV (0=no segmentation)segment and scale the crop box around the LV (0=no segmentation)
-k --skip=0
skip images at the beginning of the series as they are of other modalitiesskip images at the beginning of the series as they are of other modalities
-m --max-ica-iter=400
maximum number of iterations in ICAmaximum number of iterations in ICA
-E --segmethod=features
Segmentation method
delta-peak - difference of the peak enhancement images
features - feature images
delta-feature - difference of the feature images

Processing

--threads=-1
Maxiumum number of threads to use for processing,This number should be lower or equal to the number of logical processor cores in the machine. (-1: automatic estimation).Maxiumum number of threads to use for processing,This number should be lower or equal to the number of logical processor cores in the machine. (-1: automatic estimation).

EXAMPLE

Evaluate the synthetic references from set segment.set and save them to refXXXX.??? by using five independend components, and skipping 2 images. Per default a bounding box around the LV will be segmented and scaled by 1.4 and the cropped images will be saved to cropXXXX.??? and a segmentation set cropped.set is created. The image file type ??? is deducted from the input images in segment.set.
mia-2dmyocard-icaseries -i segment.set -r ref -o ref -k 2 -C 5

AUTHOR(s)

Gert Wollny

COPYRIGHT

This software is Copyright (c) 1999-2015 Leipzig, Germany and Madrid, Spain. It comes with ABSOLUTELY NO WARRANTY and you may redistribute it under the terms of the GNU GENERAL PUBLIC LICENSE Version 3 (or later). For more information run the program with the option '--copyright'.