.. AUTO-GENERATED FILE -- DO NOT EDIT!

interfaces.ants.segment
=======================


.. _nipype.interfaces.ants.segment.Atropos:


.. index:: Atropos

Atropos
-------

Code: http://github.com/nipy/nipype/blob/master/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)
