Recent Changes - Search:

Homepage

This is the old Camino website, please visit our new page to download the code and get the latest documentation.









UCL MIG Home

UCL CS Home

UCL Home

edit SideBar

Man /

Dt2nii

Content-type: text/html Manpage of dt2nii

dt2nii

Section: User Commands (1)
Index Return to Main Contents

 

NAME

dt2nii - Converts Camino tensors to nii files.

 

SYNOPSIS

dt2nii -inputfile <file> -outputroot <root> -header <header>

 

EXAMPLES

Straight pipeline


    cat data.Bfloat | dtfit - schemefile | dt2nii -header image.nii -outputroot camino_

Convert an existing tensor file dt.Bfloat


    dt2nii -inputfile dt.Bfloat -inputdatatype float -header image.nii -outputroot camino_
 

 

DESCRIPTION

Reads Camino diffusion tensors, and converts them to NIFTI format. The output is dependent on the input model. For all input models, the output includes


   
  ${root}exitcode.nii[.gz] - exit codes from Camino reconstruction.
  ${root}lns0.nii[.gz] - estimated lns0 from Camino reconstruction.

For input model "dt" (the default), the diffusion tensors are written to


  ${root}dt.nii[.gz]

For multi-tensor data, additional files are written:


  ${root}dt${i}.nii[.gz] - tensor component i
  ${root}mix${i}.nii[.gz] - estimated mixing fraction for tensor i

The supplied nii header (which may or may not be attached to an image) is used to initialize NIFTI header fields for the output. The header should correctly describe the physical space of the tensor image. The following fields are overwritten:


  dim[0]      - set to 5 for the dt file, 3 for other images
  intent_code - set to NIFTI_INTENT_SYMMATRIX for the dt, NIFTI_INTENT_NONE for the others
  scl_slope   - set to 1
  scl_inter   - set to 0

The output data type can be set at run time.

 

OPTIONS

-outputroot <root>
Prepended onto output file names.

-header <header>
A Nifti .nii or .nii.gz file containing the header information. Usually this will be the header of the raw data file from which the diffusion tensors were reconstructed.

-outputdatatype <type>
Overrides the defaut output data type of "float" for all images.

-inputmodel <model>
Either "dt" (default), "twotensor", "threetensor", "multitensor".

-maxcomponents <comps>
Maximum tensor components, for use with input model "multitensor".

-gzip
Write .nii.gz files instead of .nii, even if the input header is .nii.

 

AUTHORS

Philip Cook <camino@cs.ucl.ac.uk>

 

SEE ALSO

voxel2image(1), nii2dt(1)

 

BUGS


 

Index

NAME
SYNOPSIS
EXAMPLES
DESCRIPTION
OPTIONS
AUTHORS
SEE ALSO
BUGS

This document was created by man2html, using the manual pages.
Time: 02:07:11 GMT, December 04, 2017

Edit - History - Print - Recent Changes - Search
Page last modified on October 26, 2009, at 02:47 PM