caps.diffusion_estimation.tensor_estimation.QUARTICTensorEstimation

QUARTICTensorEstimation

class caps.diffusion_estimation.tensor_estimation.QUARTICTensorEstimation

Fits a diffusion tensor given diffusion-weighted signals and gradient info using a quartic decomposition and non negative least square estimation strategy [R2].

References

[R2]	A. Barmpoutis et B. Vermuri : A unified framework for estimating diffusion tensors of any order with symmetric positive-definite constraints. In IEEE Internaional Symposium on Biomedical Imaging, Rotterdam, ISBI, p1385-1388, 2010.

Inputs

[Mandatory]

bvals_file: a file name (mandatory) the the diffusion b-values

bvecs_file: a file name (mandatory) the the diffusion b-vectors

dwi_file: a file name (mandatory) an existing diffusion weighted image

mask_file: a file name (mandatory) a mask image

model_order: an integer (mandatory) the estimated model order (even)

reference_file: a file name (mandatory) the referecne b=0 image

[Optional]

estimate_odf: a boolean (optional) estimate the odf

model_name: a string (optional) the name of the output tensor model file

number_of_workers: an integer (optional) the number of CPUs to use during the execution

output_directory: a directory name (optional) the output directory where the tensor model will be written

Outputs

tensor_file: a file name the result file containing the tensor model coefficients