nipype.interfaces.diffusion_toolkit.dti module¶
Provides interfaces to various commands provided by diffusion toolkit
DTIRecon¶
Bases: CommandLine
Wrapped executable:
dti_recon
.Use dti_recon to generate tensors and other maps
- DWIa pathlike object or string representing an existing file
Input diffusion volume. Maps to a command-line argument:
%s
(position: 1).- bvalsa pathlike object or string representing an existing file
B values file.
- bvecsa pathlike object or string representing an existing file
B vectors file. Maps to a command-line argument:
-gm %s
.
- argsa string
Additional parameters to the command. Maps to a command-line argument:
%s
.- b0_thresholda float
Program will use b0 image with the given threshold to mask out high background of fa/adc maps. by default it will calculate threshold automatically. but if it failed, you need to set it manually. Maps to a command-line argument:
-b0_th
.- environa dictionary with keys which are a bytes or None or a value of class ‘str’ and with values which are a bytes or None or a value of class ‘str’
Environment variables. (Nipype default value:
{}
)- image_orientation_vectorsa list of from 6 to 6 items which are a float
Specify image orientation vectors. if just one argument given, will treat it as filename and read the orientation vectors from the file. If 6 arguments are given, will treat them as 6 float numbers and construct the 1st and 2nd vector and calculate the 3rd one automatically. This information will be used to determine image orientation, as well as to adjust gradient vectors with oblique angle when. Maps to a command-line argument:
-iop %f
.- n_averagesan integer
Number of averages. Maps to a command-line argument:
-nex %s
.- oblique_correctiona boolean
When oblique angle(s) applied, some SIEMENS DTI protocols do not adjust gradient accordingly, thus it requires adjustment for correct diffusion tensor calculation. Maps to a command-line argument:
-oc
.- out_prefixa string
Output file prefix. Maps to a command-line argument:
%s
(position: 2). (Nipype default value:dti
)- output_type‘nii’ or ‘analyze’ or ‘ni1’ or ‘nii.gz’
Output file type. Maps to a command-line argument:
-ot %s
. (Nipype default value:nii
)ADC : a pathlike object or string representing an existing file B0 : a pathlike object or string representing an existing file FA : a pathlike object or string representing an existing file FA_color : a pathlike object or string representing an existing file L1 : a pathlike object or string representing an existing file L2 : a pathlike object or string representing an existing file L3 : a pathlike object or string representing an existing file V1 : a pathlike object or string representing an existing file V2 : a pathlike object or string representing an existing file V3 : a pathlike object or string representing an existing file exp : a pathlike object or string representing an existing file tensor : a pathlike object or string representing an existing file
DTITracker¶
Bases: CommandLine
Wrapped executable:
dti_tracker
.
- mask1_filea pathlike object or string representing a file
First mask image. Maps to a command-line argument:
-m %s
(position: 2).
- angle_thresholda float
Set angle threshold. default value is 35 degree. Maps to a command-line argument:
-at %f
.- angle_threshold_weighta float
Set angle threshold weighting factor. weighting will be applied on top of the angle_threshold. Maps to a command-line argument:
-atw %f
.- argsa string
Additional parameters to the command. Maps to a command-line argument:
%s
.- environa dictionary with keys which are a bytes or None or a value of class ‘str’ and with values which are a bytes or None or a value of class ‘str’
Environment variables. (Nipype default value:
{}
)- input_data_prefixa string
For internal naming use only. Maps to a command-line argument:
%s
(position: 0). (Nipype default value:dti
)- input_type‘nii’ or ‘analyze’ or ‘ni1’ or ‘nii.gz’
Input and output file type. Accepted values are:
analyze -> analyze format 7.5
ni1 -> nifti format saved in separate .hdr and .img file
nii -> nifti format with one .nii file
nii.gz -> nifti format with compression
Default type is ‘nii’ Maps to a command-line argument:
-it %s
.- invert_xa boolean
Invert x component of the vector. Maps to a command-line argument:
-ix
.- invert_ya boolean
Invert y component of the vector. Maps to a command-line argument:
-iy
.- invert_za boolean
Invert z component of the vector. Maps to a command-line argument:
-iz
.- mask1_thresholda float
Threshold value for the first mask image, if not given, the program will try automatically find the threshold.
- mask2_filea pathlike object or string representing a file
Second mask image. Maps to a command-line argument:
-m2 %s
(position: 4).- mask2_thresholda float
Threshold value for the second mask image, if not given, the program will try automatically find the threshold.
- output_filea pathlike object or string representing an existing file
Maps to a command-line argument:
%s
(position: 1). (Nipype default value:tracks.trk
)- output_maska pathlike object or string representing a file
Output a binary mask file in analyze format. Maps to a command-line argument:
-om %s
.- primary_vector‘v2’ or ‘v3’
Which vector to use for fibre tracking: v2 or v3. If not set use v1. Maps to a command-line argument:
-%s
.- random_seedan integer
Use random location in a voxel instead of the center of the voxel to seed. can also define number of seed per voxel. default is 1. Maps to a command-line argument:
-rseed %d
.- step_lengtha float
Step length, in the unit of minimum voxel size. default value is 0.5 for interpolated streamline method and 0.1 for other methods. Maps to a command-line argument:
-l %f
.- swap_xya boolean
Swap x & y vectors while tracking. Maps to a command-line argument:
-sxy
.- swap_yza boolean
Swap y & z vectors while tracking. Maps to a command-line argument:
-syz
.- swap_zxa boolean
Swap x & z vectors while tracking. Maps to a command-line argument:
-szx
.- tensor_filea pathlike object or string representing an existing file
Reconstructed tensor file.
- tracking_method‘fact’ or ‘rk2’ or ‘tl’ or ‘sl’
Tracking algorithm.
fact -> use FACT method for tracking. This is the default method.
rk2 -> use 2nd order Runge-Kutta method for tracking.
tl -> use tensorline method for tracking.
sl -> use interpolated streamline method with fixed step-length
Maps to a command-line argument:
-%s
.mask_file : a pathlike object or string representing an existing file track_file : a pathlike object or string representing an existing file