NIPY logo
Home · Quickstart · Documentation · Citation · NiPy
Loading

Table Of Contents

Versions

ReleaseDevel
0.6.0pre-0.7
Download Github

Links

interfaces.ants.segment

Atropos

Code: file:///build/buildd/nipype-0.6.0/nipype/interfaces/ants/segment.py#L53

Wraps command Atropos

A finite mixture modeling (FMM) segmentation approach with possibilities for specifying prior constraints. These prior constraints include the specification of a prior label image, prior probability images (one for each class), and/or an MRF prior to enforce spatial smoothing of the labels. Similar algorithms include FAST and SPM.

Examples

>>> from nipype.interfaces.ants import Atropos
>>> at = Atropos()
>>> at.inputs.dimension = 3
>>> at.inputs.intensity_images = 'structural.nii'
>>> at.inputs.mask_image = 'mask.nii'
>>> at.inputs.initialization = 'PriorProbabilityImages'
>>> at.inputs.prior_probability_images = ['rc1s1.nii', 'rc1s2.nii']
>>> at.inputs.number_of_tissue_classes = 2
>>> at.inputs.prior_weighting = 0.8
>>> at.inputs.prior_probability_threshold = 0.0000001
>>> at.inputs.likelihood_model = 'Gaussian'
>>> at.inputs.mrf_smoothing_factor = 0.2
>>> at.inputs.mrf_radius = [1, 1, 1]
>>> at.inputs.icm_use_synchronous_update = True
>>> at.inputs.maximum_number_of_icm_terations = 1
>>> at.inputs.n_iterations = 5
>>> at.inputs.convergence_threshold = 0.000001
>>> at.inputs.posterior_formulation = 'Socrates'
>>> at.inputs.use_mixture_model_proportions = True
>>> at.inputs.save_posteriors = True
>>> at.cmdline
'Atropos --image-dimensionality 3 --icm [1,1] --initialization PriorProbabilityImages[2,priors/priorProbImages%02d.nii,0.8,1e-07] --intensity-image structural.nii --likelihood-model Gaussian --mask-image mask.nii --mrf [0.2,1x1x1] --convergence [5,1e-06] --output [structural_labeled.nii,POSTERIOR_%02d.nii.gz] --posterior-formulation Socrates[1]'

Inputs:

[Mandatory]
initialization: ('Random' or 'Otsu' or 'KMeans' or 'PriorProbabilityImages' or
         'PriorLabelImage')
        requires: number_of_tissue_classes
mask_image: (an existing file name)
number_of_tissue_classes: (an integer)

[Optional]
args: (a string)
        Additional parameters to the command
convergence_threshold: (a float)
        requires: n_iterations
dimension: (3 or 2 or 4, nipype default value: 3)
        image dimension (2, 3, or 4)
environ: (a dictionary with keys which are a value of type 'str' and with values which
         are a value of type 'str', nipype default value: {})
        Environment variables
icm_use_synchronous_update: (a boolean)
ignore_exception: (a boolean, nipype default value: False)
        Print an error message instead of throwing an exception in case the interface fails to
        run
intensity_images: (an existing file name)
likelihood_model: (a string)
maximum_number_of_icm_terations: (an integer)
        requires: icm_use_synchronous_update
mrf_radius: (a list of items which are an integer)
        requires: mrf_smoothing_factor
mrf_smoothing_factor: (a float)
n_iterations: (an integer)
num_threads: (an integer, nipype default value: 1)
        Number of ITK threads to use
out_classified_image_name: (a file name)
output_posteriors_name_template: (a string, nipype default value: POSTERIOR_%02d.nii.gz)
posterior_formulation: (a string)
prior_probability_images: (an existing file name)
prior_probability_threshold: (a float)
        requires: prior_weighting
prior_weighting: (a float)
save_posteriors: (a boolean)
use_mixture_model_proportions: (a boolean)
        requires: posterior_formulation

Outputs:

classified_image: (an existing file name)
posteriors: (a file name)