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

interfaces.camino.utils
=======================


.. _nipype.interfaces.camino.utils.ImageStats:


.. index:: ImageStats

ImageStats
----------

`Link to code <file:///build/nipype-fj7ofr/nipype-1.0.0+git69-gdb2670326/nipype/interfaces/camino/utils.py#L65>`__

Wraps command **imagestats**

This program computes voxelwise statistics on a series of 3D images. The images
must be in the same space; the operation is performed voxelwise and one output
is produced per voxel.

Examples
~~~~~~~~

>>> import nipype.interfaces.camino as cam
>>> imstats = cam.ImageStats()
>>> imstats.inputs.in_files = ['im1.nii','im2.nii','im3.nii']
>>> imstats.inputs.stat = 'max'
>>> imstats.run()                  # doctest: +SKIP

Inputs::

        [Mandatory]
        in_files: (a list of items which are an existing file name)
                List of images to process. They must be in the same space and have
                the same dimensions.
                flag: -images %s, position: -1
        output_root: (a file name)
                Filename root prepended onto the names of the output files. The
                extension will be determined from the input.
                flag: -outputroot %s
        stat: (u'min' or u'max' or u'mean' or u'median' or u'sum' or u'std'
                 or u'var')
                The statistic to compute.
                flag: -stat %s

        [Optional]
        args: (a unicode string)
                Additional parameters to the command
                flag: %s
        environ: (a dictionary with keys which are a newbytes or None or a
                 newstr or None and with values which are a newbytes or None or a
                 newstr or None, nipype default value: {})
                Environment variables
        ignore_exception: (a boolean, nipype default value: False)
                Print an error message instead of throwing an exception in case the
                interface fails to run
        out_type: (u'float' or u'char' or u'short' or u'int' or u'long' or
                 u'double', nipype default value: float)
                A Camino data type string, default is "float". Type must be signed.
                flag: -outputdatatype %s
        terminal_output: (u'stream' or u'allatonce' or u'file' or u'none')
                Control terminal output: `stream` - displays to terminal immediately
                (default), `allatonce` - waits till command is finished to display
                output, `file` - writes output to file, `none` - output is ignored

Outputs::

        out_file: (an existing file name)
                Path of the file computed with the statistic chosen
