View source for Documentation/4.5/Modules/fiberprocess

<noinclude>{{documentation/versioncheck}}</noinclude>
__NOTOC__

===FiberProcess===
FiberProcess

{|
|[[Image:FiberProcess.png|thumb|280px|User Interface]]
|[[Image:FiberTrack-fibers.png|thumb|280px|Output]]
|}

== General Information ==

===Module Type & Category===

Type: CLI

Category: Diffusion.NIRALPipeline


===Authors, Collaborators & Contact===

Author: Casey Goodlett

Contributors: Francois Budin

Contact: name, email

===Module Description===
{| style="color:green" border="1"
|Program title || FiberProcess
|-
|Program description || fiberprocess is a tool that manage fiber files extracted from the fibertrack tool or any fiber tracking algorithm. It takes as an input .fib and .vtk files (--fiber_file) and saves the changed fibers (--fiber_output) into the 2 same formats. The main purpose of this tool is to deform the fiber file with a transformation field as an input (--displacement_field or --h_field depending if you deal with dfield or hfield). To use that option you need to specify the tensor field from which the fiber file was extracted with the option --tensor_volume. The transformation applied on the fiber file is the inverse of the one input. If the transformation is from one case to an atlas, fiberprocess assumes that the fiber file is in the atlas space and you want it in the original case space, so it's the inverse of the transformation which has been computed. \nYou have 2 options for fiber modification. You can either deform the fibers (their geometry) into the space OR you can keep the same geometry but map the diffusion properties (fa, md, lbd's...) of the original tensor field along the fibers at the corresponding locations. This is triggered by the --no_warp option. To use the previous example: when you have a tensor field in the original space and the deformed tensor field in the atlas space, you want to track the fibers in the atlas space, keeping this geometry but with the original case diffusion properties. Then you can specify the transformations field (from original case -> atlas) and the original tensor field with the --tensor_volume option. \nWith fiberprocess you can also binarize a fiber file. Using the --voxelize option will create an image where each voxel through which a fiber is passing is set to 1. The output is going to be a binary image with the values 0 or 1 by default but the 1 value voxel can be set to any number with the --voxel_label option. Finally you can create an image where the value at the voxel is the number of fiber passing through. (--voxelize_count_fibers)
|-
|Program version || 1.0.0
|-
|Program documentation-url || http://www.google.com/
|-
|}

== Usage ==

===Quick Tour of Features and Use===

A list panels in the interface, their features, what they mean, and how to use them.
{|
|
* <span style="color:blue">'''''I/O'''''</span>: 
** <span style="color:green">'''Fiber File'''</span> [<span style="color:orange">----fiber_file</span>] : DTI fiber file

** <span style="color:green">'''Fiber Output'''</span> [<span style="color:orange">----fiber_output</span>] [<span style="color:pink">-o</span>]: Output fiber file. May be warped or updated with new data depending on other options used.

** <span style="color:green">'''Tensor Volume'''</span> [<span style="color:orange">----tensor_volume</span>] [<span style="color:pink">-T</span>]: Interpolate tensor values from the given field

** <span style="color:green">'''HField'''</span> [<span style="color:orange">----h_field</span>] [<span style="color:pink">-H</span>]: HField for warp and statistics lookup. If this option is used tensor-volume must also be specified.

** <span style="color:green">'''DisplacementField'''</span> [<span style="color:orange">----displacement_field</span>] [<span style="color:pink">-D</span>]: Displacement Field for warp and statistics lookup.  If this option is used tensor-volume must also be specified.

* <span style="color:blue">'''''Options'''''</span>: 
** <span style="color:green">'''No Warp'''</span> [<span style="color:orange">----no_warp</span>] [<span style="color:pink">-n</span>]: Do not warp the geometry of the tensors only obtain the new statistics. ''Default value: 0''
** <span style="color:green">'''Radius for all fibers'''</span> [<span style="color:orange">----fiber_radius</span>] [<span style="color:pink">-R</span>]: set radius of all fibers to this value ''Default value: 0.4''
** <span style="color:green">'''Index Space'''</span> [<span style="color:orange">----index_space</span>] : Use index-space for fiber output coordinates, otherwise us world space for fiber output coordinates (from tensor file). ''Default value: 0''
* <span style="color:blue">'''''Voxelize'''''</span>: 
** <span style="color:green">'''Voxelize'''</span> [<span style="color:orange">----voxelize</span>] [<span style="color:pink">-V</span>]: Voxelize fiber into a label map (the labelmap filename is the argument of -V). The tensor file must be specified using -T for information about the size, origin, spacing of the image. The deformation is applied before the voxelization 

** <span style="color:green">'''Voxelize Count Fibers'''</span> [<span style="color:orange">----voxelize_count_fibers</span>] : Count number of fibers per-voxel instead of just setting to 1 ''Default value: 0''
** <span style="color:green">'''Label for voxelized fiber'''</span> [<span style="color:orange">----voxel_label</span>] : Label for voxelized fiber ''Default value: 1''
* <span style="color:blue">'''''Advanced options'''''</span>: 
** <span style="color:green">'''Verbose'''</span> [<span style="color:orange">----verbose</span>] [<span style="color:pink">-v</span>]: produce verbose output ''Default value: 0''
** <span style="color:green">'''No Data Change'''</span> [<span style="color:orange">----noDataChange</span>] : Do not change data ???  ''Default value: 0''
|[[Image:FiberProcess.png|thumb|280px|User Interface]]
|}

== More Information ==

More information is available on the project webpage: http://www.nitrc.org/projects/dtiprocess