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

interfaces.mrtrix3.connectivity
===============================


.. _nipype.interfaces.mrtrix3.connectivity.BuildConnectome:


.. index:: BuildConnectome

BuildConnectome
---------------

`Link to code <file:///build/nipype-1.1.8/nipype/interfaces/mrtrix3/connectivity.py#L98>`__

Wraps the executable command ``tck2connectome``.

Generate a connectome matrix from a streamlines file and a node
parcellation image

Example
~~~~~~~

>>> import nipype.interfaces.mrtrix3 as mrt
>>> mat = mrt.BuildConnectome()
>>> mat.inputs.in_file = 'tracks.tck'
>>> mat.inputs.in_parc = 'aparc+aseg.nii'
>>> mat.cmdline                               # doctest: +ELLIPSIS
'tck2connectome tracks.tck aparc+aseg.nii connectome.csv'
>>> mat.run()                                 # doctest: +SKIP

Inputs::

        [Mandatory]
        out_file: (a file name, nipype default value: connectome.csv)
                output file after processing
                argument: ``%s``, position: -1
        in_file: (an existing file name)
                input tractography
                argument: ``%s``, position: -3

        [Optional]
        vox_lookup: (a boolean)
                use a simple voxel lookup value at each streamline endpoint
                argument: ``-assignment_voxel_lookup``
        keep_unassigned: (a boolean)
                By default, the program discards the information regarding those
                streamlines that are not successfully assigned to a node pair. Set
                this option to keep these values (will be the first row/column in
                the output matrix)
                argument: ``-keep_unassigned``
        nthreads: (an integer (int or long))
                number of threads. if zero, the number of available cpus will be
                used
                argument: ``-nthreads %d``
        in_parc: (an existing file name)
                parcellation file
                argument: ``%s``, position: -2
        metric: (u'count' or u'meanlength' or u'invlength' or
                  u'invnodevolume' or u'mean_scalar' or u'invlength_invnodevolume')
                specify the edge weight metric
                argument: ``-metric %s``
        args: (a unicode string)
                Additional parameters to the command
                argument: ``%s``
        search_forward: (a float)
                project the streamline forwards from the endpoint in search of
                aparcellation node voxel. Argument is the maximum traversal length
                in mm.
                argument: ``-assignment_forward_search %f``
        zero_diagonal: (a boolean)
                set all diagonal entries in the matrix to zero (these represent
                streamlines that connect to the same node at both ends)
                argument: ``-zero_diagonal``
        search_radius: (a float)
                perform a radial search from each streamline endpoint to locate the
                nearest node. Argument is the maximum radius in mm; if no node is
                found within this radius, the streamline endpoint is not assigned to
                any node.
                argument: ``-assignment_radial_search %f``
        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
        search_reverse: (a float)
                traverse from each streamline endpoint inwards along the streamline,
                in search of the last node traversed by the streamline. Argument is
                the maximum traversal length in mm (set to 0 to allow search to
                continue to the streamline midpoint).
                argument: ``-assignment_reverse_search %f``
        in_weights: (an existing file name)
                specify a text scalar file containing the streamline weights
                argument: ``-tck_weights_in %s``
        in_scalar: (an existing file name)
                provide the associated image for the mean_scalar metric
                argument: ``-image %s``

Outputs::

        out_file: (an existing file name)
                the output response file

.. _nipype.interfaces.mrtrix3.connectivity.LabelConfig:


.. index:: LabelConfig

LabelConfig
-----------

`Link to code <file:///build/nipype-1.1.8/nipype/interfaces/mrtrix3/connectivity.py#L180>`__

Wraps the executable command ``labelconfig``.

Re-configure parcellation to be incrementally defined.

Example
~~~~~~~

>>> import nipype.interfaces.mrtrix3 as mrt
>>> labels = mrt.LabelConfig()
>>> labels.inputs.in_file = 'aparc+aseg.nii'
>>> labels.inputs.in_config = 'mrtrix3_labelconfig.txt'
>>> labels.cmdline                               # doctest: +ELLIPSIS
'labelconfig aparc+aseg.nii mrtrix3_labelconfig.txt parcellation.mif'
>>> labels.run()                                 # doctest: +SKIP

Inputs::

        [Mandatory]
        out_file: (a file name, nipype default value: parcellation.mif)
                output file after processing
                argument: ``%s``, position: -1
        in_file: (an existing file name)
                input anatomical image
                argument: ``%s``, position: -3

        [Optional]
        nthreads: (an integer (int or long))
                number of threads. if zero, the number of available cpus will be
                used
                argument: ``-nthreads %d``
        spine: (a file name)
                provide a manually-defined segmentation of the base of the spine
                where the streamlines terminate, so that this can become a node in
                the connection matrix.
                argument: ``-spine %s``
        args: (a unicode string)
                Additional parameters to the command
                argument: ``%s``
        lut_basic: (a file name)
                get information from a basic lookup table consisting of index / name
                pairs
                argument: ``-lut_basic %s``
        lut_itksnap: (a file name)
                get information from an ITK - SNAP lookup table(this includes the
                IIT atlas file "LUT_GM.txt")
                argument: ``-lut_itksnap %s``
        in_config: (an existing file name)
                connectome configuration file
                argument: ``%s``, position: -2
        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
        lut_aal: (a file name)
                get information from the AAL lookup table (typically
                "ROI_MNI_V4.txt")
                argument: ``-lut_aal %s``
        lut_fs: (a file name)
                get information from a FreeSurfer lookup table(typically
                "FreeSurferColorLUT.txt")
                argument: ``-lut_freesurfer %s``

Outputs::

        out_file: (an existing file name)
                the output response file

.. _nipype.interfaces.mrtrix3.connectivity.LabelConvert:


.. index:: LabelConvert

LabelConvert
------------

`Link to code <file:///build/nipype-1.1.8/nipype/interfaces/mrtrix3/connectivity.py#L267>`__

Wraps the executable command ``labelconvert``.

Re-configure parcellation to be incrementally defined.

Example
~~~~~~~

>>> import nipype.interfaces.mrtrix3 as mrt
>>> labels = mrt.LabelConvert()
>>> labels.inputs.in_file = 'aparc+aseg.nii'
>>> labels.inputs.in_config = 'mrtrix3_labelconfig.txt'
>>> labels.inputs.in_lut = 'FreeSurferColorLUT.txt'
>>> labels.cmdline
'labelconvert aparc+aseg.nii FreeSurferColorLUT.txt mrtrix3_labelconfig.txt parcellation.mif'
>>> labels.run()                                 # doctest: +SKIP

Inputs::

        [Mandatory]
        in_lut: (an existing file name)
                get information from a basic lookup table consisting of index / name
                pairs
                argument: ``%s``, position: -3
        out_file: (a file name, nipype default value: parcellation.mif)
                output file after processing
                argument: ``%s``, position: -1
        in_file: (an existing file name)
                input anatomical image
                argument: ``%s``, position: -4

        [Optional]
        num_threads: (an integer (int or long))
                number of threads. if zero, the number of available cpus will be
                used
                argument: ``-nthreads %d``
        spine: (a file name)
                provide a manually-defined segmentation of the base of the spine
                where the streamlines terminate, so that this can become a node in
                the connection matrix.
                argument: ``-spine %s``
        args: (a unicode string)
                Additional parameters to the command
                argument: ``%s``
        in_config: (an existing file name)
                connectome configuration file
                argument: ``%s``, position: -2
        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

Outputs::

        out_file: (an existing file name)
                the output response file
