QIT Module Library
QIT has many modules available on the command line interface through qit and
in the 3D viewer through qitview. This page below provides an index of the
publicly available modules.
AffineCompose
Compose two affine transforms
Input:
| Flag | Type | Description |
|---|---|---|
--inner |
Affine | input inner |
--outer |
Affine | input outer |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine |
AffineConvert
Convert an affine transform between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Affine | input affine |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine |
AffineCreate
Create an affine transform based on user specified parameters
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--transX |
double | 0.0 |
(optional) translation in x |
--transY |
double | 0.0 |
(optional) translation in y |
--transZ |
double | 0.0 |
(optional) translation in z |
--rotX |
double | 0.0 |
(optional) rotation axis in x |
--rotY |
double | 0.0 |
(optional) rotation axis in y |
--rotZ |
double | 0.0 |
(optional) rotation axis in z |
--rotA |
double | 0.0 |
(optional) rotation angle |
--scaleX |
double | 1.0 |
(optional) scaleCamera in x |
--scaleY |
double | 1.0 |
(optional) scaleCamera in y |
--scaleZ |
double | 1.0 |
(optional) scaleCamera in z |
--skewX |
double | 0.0 |
(optional) skew in x |
--skewY |
double | 0.0 |
(optional) skew in y |
--skewZ |
double | 0.0 |
(optional) skew in z |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine |
AffineInvert
Invert an affine transform
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Affine | input affine |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine |
AffinePrintInfo
Print basic information about an affine transform
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Affine | the input affine |
AffineReduce
Reduce an affine transform to a simpler affine transform in one of several possible ways
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Affine | an affine transform |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--translation |
flag | (optional) include the translation part | |
--linear |
flag | (optional) include the linear part | |
--orthogonalize |
flag | (optional) orthogonalize the linear part |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine |
CurvesAttributeMap
Compute an attribute map, that is, a volume that represents the most likely value of a given curves attribute for each voxel.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--refvolume |
Volume | (optional) input reference volume (exclusive with refmask) |
--refmask |
Mask | (optional) input reference mask (exclusive with refvolume) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | attr |
(optional) the name of attribute to extract from the curves |
--threads |
int | 1 |
(optional) the number of threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output attribute map |
--outputDensity |
Volume | (optional) output density map |
--outputMask |
Mask | (optional) output mask |
CurvesAttributes
Manipulate curves vertex attributes. Operations support comma-delimited lists
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--copy |
String | (optional) copy attribute (x=y syntax) | |
--rename |
String | (optional) rename attribute (x=y syntax) | |
--remove |
String | (optional) remove attribute (- for all) | |
--retain |
String | (optional) retain the given attributes and remove others) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
CurvesBox
Compute a bounding box from curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output box |
CurvesCat
Concatenate multiple curves datasets to a single larger dataset
Input:
| Flag | Type | Description |
|---|---|---|
--a |
Curves | input curves a |
--b |
Curves | (optional) input curves b |
--c |
Curves | (optional) input curves c |
--d |
Curves | (optional) input curves d |
--e |
Curves | (optional) input curves e |
--f |
Curves | (optional) input curves f |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesCatPattern
Concatenate curves using a filename pattern
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pattern |
String | a pattern to read curves filenames (should contains %s for substitution) | |
--names |
String | a list of identifiers (will be substituted in the input pattern) | |
--along |
String | (optional) optionally use the given attribute to account for along bundle parameterization | |
--bundleName |
String | bundle_name |
(optional) use the given bundle attribute/field name |
--alongName |
String | along_name |
(optional) use the given along attribute/field name |
--bundleIndex |
String | bundle_index |
(optional) use the given bundle attribute/field index |
--alongIndex |
String | along_index |
(optional) use the given along attribute/field index |
Output:
| Flag | Type | Description |
|---|---|---|
--curves |
Curves | the output combined curves |
--table |
Table | the table to store labels |
CurvesClusterFeature
Cluster curves using simple curve features (length, endpoints, position, shape) using K-means
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--length |
flag | (optional) include the length | |
--endpoints |
flag | (optional) include tensor product of endpoints | |
--gaussian |
flag | (optional) include the Gaussian shape | |
--num |
Integer | 2 |
(optional) the number of clusters |
--thresh |
Double | (optional) the threshold size for clusters (enables DP-means) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--iters |
Integer | 100 |
(optional) the maxima number of iterations |
--restarts |
Integer | (optional) the number of restarts | |
--relabel |
flag | (optional) relabel to reflect cluster size | |
--largest |
flag | (optional) keep only the largest cluster |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | (optional) the output curves |
--protos |
Curves | (optional) the prototypical curves for each cluster |
CurvesClusterGraph
Curve bundle segmentation with graph-based thresholding
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dist |
String | meanhaus |
(optional) the name of the inter-curve distance |
--thresh |
double | 1.0 |
(optional) the threshold for grouping |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--largest |
flag | (optional) retain the largest group | |
--relabel |
flag | (optional) relabel to reflect cluster size |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
Citation: Felzenszwalb, P. F., & Huttenlocher, D. P. (2004). Efficient graph-based image segmentation. International journal of computer vision, 59(2), 167-181.
CurvesClusterHierarchical
Cluster curves with hierarchical clustering.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dist |
String | meanhaus |
(optional) the name of the inter-curve distance |
--num |
Integer | (optional) the number of clusters | |
--thresh |
Double | (optional) the threshold for grouping |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--density |
Double | (optional) resample the curves to speed up computation | |
--epsilon |
Double | (optional) simplify the curves to speed up computation | |
--relabel |
flag | (optional) relabel to reflect cluster size |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
Citation: Zhang, S., Correia, S., & Laidlaw, D. H. (2008). Identifying white-matter fiber bundles in DTI data using an automated proximity-based fiber-clustering method. IEEE transactions on visualization and computer graphics, 14(5), 1044-1053.
CurvesClusterQuickBundle
Cluster curves with the quicksbundles algorithm
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--subset |
Integer | (optional) take a subset of curves before clustering (not applicable if you provide fewer) | |
--samples |
Integer | 5 |
(optional) the number of sample vertices |
--thresh |
Double | 1000.0 |
(optional) the separation threshold |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--relabel |
flag | (optional) relabel to reflect cluster size |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | (optional) the output curves |
--centers |
Curves | (optional) the output centers (the centroid curves for each cluster) |
Citation: Garyfallidis, E., Brett, M., Correia, M. M., Williams, G. B., & Nimmo-Smith, I. (2012). Quickbundles, a method for tractography simplification. Frontiers in neuroscience, 6, 175.
CurvesClusterSCPT
Cluster curves with a sparse closest point transform.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--subset |
Integer | (optional) take a subset of curves before clustering (not applicable if you provide fewer) | |
--thresh |
Double | 22.0 |
(optional) the threshold size for clusters |
--largest |
flag | (optional) retain only the largest cluster | |
--fraction |
Double | (optional) retain only clusters that are a given proportion of the total (zero to one) | |
--iters |
Integer | 100 |
(optional) the maxima number of iterations |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--preeps |
Double | 1.0 |
(optional) preprocess by simplifying the curves |
--lmsub |
Integer | 5000 |
(optional) the number of curves for landmarking |
--lmeps |
Double | 1.0 |
(optional) the simplifification threshold for landmarking |
--lmthresh |
Double | 30.0 |
(optional) the landmarking threshold |
--restarts |
Integer | (optional) the number of restarts | |
--num |
Integer | 2 |
(optional) the number of clusters |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | (optional) the output curves |
--landmarks |
Vects | (optional) the computed landmarks |
--protos |
Curves | (optional) the prototypical curves for each cluster |
CurvesClusterSpectral
Cluster curves with spectral clustering.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dist |
String | meanhaus |
(optional) the name of the inter-curve distance |
--num |
Integer | (optional) the number of clusters |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--density |
Double | (optional) resample the curves to speed up computation | |
--epsilon |
Double | (optional) simplify the curves to speed up computation | |
--relabel |
flag | (optional) relabel to reflect cluster size |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
Citation: Cluster curves with spectral clustering. O’Donnell, L. J., & Westin, C. F. (2007). Automatic tractography segmentation using a high-dimensional white matter atlas. IEEE transactions on medical imaging, 26(11), 1562-1575.
CurvesCompare
Compare a pair of curves objects quantitatively
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Curves | input curves |
--right |
Curves | the other curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
double | 1.0 |
(optional) the volume resolution |
--thresh |
double | 0.5 |
(optional) the density threshold |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
CurvesConnectRegions
Extract the connecting segments between the given regions
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--regions |
Mask | input regions (should have two distinct labels) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--shortest |
flag | (optional) extract only the shortest connection | |
--simple |
flag | (optional) extract only simple connections |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesConvert
Convert curves between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesCreateHelix
Create a curves dataset consisting of a helix bundle
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--radius |
double | 10.0 |
(optional) the radius of the helix |
--length |
double | 5.0 |
(optional) the length of one loop of the helix |
--loops |
int | 2 |
(optional) the number of loops in the helix |
--steps |
int | 100 |
(optional) the number of steps sampled along each loop of the helix |
--sigma |
double | 1.0 |
(optional) the width of the helix bundle |
--samples |
int | 1 |
(optional) the number of samples in the helix bundle |
--startx |
double | 0.0 |
(optional) the starting position in x |
--starty |
double | 0.0 |
(optional) the starting position in y |
--startz |
double | 0.0 |
(optional) the starting position in z |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesCrop
Crop curves to retain only portions inside the selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
--mask |
Mask | (optional) a mask |
--solids |
Solids | (optional) some solids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--invert |
flag | (optional) invert the selection | |
--and |
flag | (optional) require that curves are inside all solids (logical AND) | |
--attr |
String | (optional) specify an attribute for cropping | |
--above |
Double | (optional) require that the given attribute at each vertex is above this value | |
--below |
Double | (optional) require that the given attribute at each vertex is below this value | |
--equals |
Double | (optional) require that the given attribute approximately equals this value | |
--delta |
Double | 0.001 |
(optional) the threshold distance for approximate cropping |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
CurvesCull
Cull redundant curves. This can be done using SCPT (scpt) or pairwise distance-based clustering (haus, cham, end, or cutoff). DistanceExtrinsic based clustering is much slower but technically more accurate.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dist |
String | scpt |
(optional) the name of the inter-curve distance (scpt, haus, cham, end, or cutoff). Pairwise distances can be symmeterized by adding mean, min, or max to the name (except scpt). |
--thresh |
Double | 1.5 |
(optional) the threshold for removal in mm (but the exact meaning of this depends on the distance metric, so be careful) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
Citation: Zhang, S., Correia, S., & Laidlaw, D. H. (2008). Identifying white-matter fiber bundles in DTI data using an automated proximity-based fiber-clustering method. IEEE transactions on visualization and computer graphics, 14(5), 1044-1053.
CurvesDensity
Compute a volumetric density of curves. This works by find the voxels that intersect the curves and accumulating how many curves intersected each voxel.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--reference |
Volume | (optional) input reference volume (exclusive with refmask) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--type |
CurvesDensityType | Count |
(optional) specify the type of normalization (Options: Count, CountNorm, Color, ColorNorm) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
double | 1.0 |
(optional) when no reference sampling is present, create a volume with this voxel size |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output density volume |
CurvesEndpointMask
Extract curve endpoints and create a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--reference |
Volume | (optional) input reference volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--head |
int | 1 |
(optional) curve head label |
--tail |
int | 2 |
(optional) curve tail label |
--num |
int | 1 |
(optional) use the given number of vertices from the endpoints |
--dilate |
int | 0 |
(optional) dilate the endpoint mask |
--mode |
flag | (optional) apply a mode filter |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
CurvesEndpoints
Extract curve endpoints and return them as vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--head |
flag | (optional) curve head vertices | |
--tail |
flag | (optional) curve tail vertices |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
CurvesExtract
Extract only curves that match a given attribute value
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | label |
(optional) the attribute name of the label used to select |
--which |
String | `` | (optional) which labels to extract, e.g. 1,2,3:5 |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesFeatures
Compute features of curves and add them as vertex attributes
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--tangent |
flag | (optional) compute tangents | |
--color |
flag | (optional) compute vertex colors | |
--arclength |
flag | (optional) compute per-vertex arclength | |
--index |
flag | (optional) compute per-vertex index | |
--fraction |
flag | (optional) compute per-vertex fraction along curve | |
--count |
flag | (optional) compute per-curve vertex count | |
--length |
flag | (optional) compute per-curve length | |
--frame |
flag | (optional) compute the per-vertex frenet frame | |
--curvature |
flag | (optional) compute the per-vertex curvatures | |
--density |
flag | (optional) compute the per-vertex density | |
--stats |
flag | (optional) compute the per-curve statistics of vertex curvature and density |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--all |
flag | (optional) compute all possible features | |
--voxel |
double | 1.0 |
(optional) specify a voxel size used for computing density |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
CurvesFilterKernel
Filter curves with kernel regression. This uses a non-parametric statistical approach to smooth the curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--density |
Double | (optional) resample with a given vertex density (mm/vertex), otherwise the original arclength sampling is used | |
--sigma |
Double | 4.0 |
(optional) use the given spatial bandwidth |
--order |
int | 0 |
(optional) specify the order of the local approximating polynomial |
--thresh |
Double | 0.05 |
(optional) the threshold for excluding data from local regression |
--attrs |
String | coord |
(optional) the attributes to smooth (comma separated list) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesFilterLoess
Filter curves with lowess smoothing
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--density |
Double | (optional) resample with a given vertex density (mm/vertex), otherwise the original arclength sampling is used | |
--num |
int | 5 |
(optional) use the given neighborhood size for local estimation |
--order |
Integer | 2 |
(optional) use a given polynomial order for local estimation |
--endpoints |
flag | (optional) smooth endpoints |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesFilterPolynomial
Filter cures with polynomial splines
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--density |
Double | (optional) resample with a given vertex density (mm/vertex), otherwise the original arclength sampling is used | |
--lambda |
Double | (optional) use regularization Tikhonov regularization (specify the negative log, so and input of 2.3 would give a regularization weight of 0.1) | |
--order |
Integer | 10 |
(optional) use a given polynomial order |
--residual |
flag | (optional) save the residuals |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
--outputResiduals |
Vects | (optional) output residual error between the polynomial and the curve |
CurvesFilterPredicate
Filter curves with kernel regression. This uses a non-parametric statistical approach to smooth the curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--min |
int | 2 |
(optional) The minimum number of vertices of the retained segments |
--nodot |
flag | (optional) Replace any dots in the attribute name with an underscore, e.g. pval.age would become pval_age | |
--predicate |
String | pval < 0.05 |
(optional) the predicate for determining if a vertex should be kept |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesFilterTOM
Filter curves based on their agreement with a tract orientation map
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
--reference |
Volume | (optional) input reference volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--iters |
int | 1 |
(optional) the number of iterations |
--beta |
double | 1.0 |
(optional) a gain factor for computing likelihoods |
--thresh |
double | 0.05 |
(optional) a threshold for outlier rejection |
--orient |
flag | (optional) orient the bundle prior to mapping | |
--vector |
flag | (optional) compute a vector orientation (you may want to enable the orient flag) | |
--norm |
VolumeEnhanceContrastType | Histogram |
(optional) specify a method for normalizing orientation magnitudes (Options: Histogram, Ramp, RampGauss, Mean, None) |
--smooth |
flag | (optional) apply fiber smoothing after mapping |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--sigma |
Double | (optional) apply smoothing with the given amount (bandwidth in mm) (default is largest voxel dimension) | |
--support |
int | 3 |
(optional) the smoothing filter radius in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output inlier curves |
--tom |
Volume | (optional) input reference volume |
CurvesFilterTTF
Filter curves to enhance their topographic regularity using the group graph spectral distance
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--K |
Integer | 20 |
(optional) size of neighborhood |
--sigma |
Double | 0.01 |
(optional) parameter for the exponential in the proximity measure |
--density |
double | 5.0 |
(optional) the resolution for downsampling curves |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
Citation: Wang, J., Aydogan, D. B., Varma, R., Toga, A. W., & Shi, Y. (2018). Modeling topographic regularity in structural brain connectivity with application to tractogram filtering. NeuroImage.
CurvesLabelMap
Compute a label map, that is, a mask that represents the most likely label of a given curves label for each voxel.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--refvolume |
Volume | (optional) input reference volume (exclusive with refmask) |
--refmask |
Mask | (optional) input reference mask (exclusive with refvolume) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | label |
(optional) the name of attribute to extract from the curves |
--largest |
flag | (optional) filter out largest components | |
--dilate |
int | 0 |
(optional) dilate the mask a given number of times |
--threads |
int | 1 |
(optional) the number of threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output label map |
--outputProb |
Volume | (optional) output probability map |
CurvesLandmarks
Generate landmarks from curves using simplification and vertex clustering
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--subsamp |
Integer | 1000 |
(optional) the number of curves to subsample |
--eps |
Double | 2.0 |
(optional) the spatial threshold for simplificaion |
--radius |
Double | (optional) the diameter of clusters for vertex grouping | |
--num |
Integer | 2 |
(optional) the number of clusters to start with |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | the output landmarks |
Citation: (in preparation)
CurvesLengths
Compute the lengths of the given curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | the output landmarks |
CurvesMask
Compute a volumetric mask of curves. Any voxel that intersects the curves will be included
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--refvolume |
Volume | (optional) input reference volume (exclusive with refmask) |
--refmask |
Mask | (optional) input reference mask (exclusive with refvolume) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--thresh |
double | 0.5 |
(optional) the threshold |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
CurvesMaskMap
Measure how many curves overlap a given mask parcellation
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--regions |
Mask | input regions |
--lookup |
Table | use a lookup for region names |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--nameField |
String | name |
(optional) specify the lookup table name field |
--indexField |
String | index |
(optional) specify the lookup table index field |
--mode |
CurvesMaskMapMode | Binary |
(optional) specify the way that curves are counted (Options: Count, Binary, Fraction) |
--endpoints |
flag | (optional) select only curves with endpoints in the mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
CurvesMaskSelect
Select curves using volumetric masks
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--deform |
Deformation | (optional) a deformation between curves and the masks |
--include |
Mask | (optional) use an include mask (AND for multiple labels) |
--exclude |
Mask | (optional) use an exclude mask (AND for multiple labels) |
--contain |
Mask | (optional) use a containment mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--binarize |
flag | (optional) binarize the include mask | |
--invert |
flag | (optional) invert the exclude mask | |
--skip |
flag | (optional) skip masks without regions or an insufficient number of regions without error | |
--thresh |
Double | 0.8 |
(optional) specify a containment threshold |
--endpoints |
flag | (optional) select based on only curve endpoints | |
--connect |
flag | (optional) select curves with endpoints that connect different labels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
CurvesMath
Evaluate a mathematical expression at each vertex of curves.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | x > 0.5 |
(optional) the expression to evaluate |
--result |
String | result |
(optional) the attribute name for the result |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesMeasure
Measure statistics of curves and store the results in a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
double | 1.0 |
(optional) the volume resolution |
--thresh |
double | 0.5 |
(optional) the density threshold |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--advanced |
flag | (optional) add advanced measures (outlier measures). warning: these take polynomial time with the number of curves | |
--endcor |
flag | (optional) add the endpoint correlation measure | |
--neighbors |
int | 16 |
(optional) specify a number of neighbors for topographic measures |
--samples |
int | 5000 |
(optional) specify a number of samples for endpoint correlations estimation |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
CurvesMidpointMask
Extract curve endpoints and return them as vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--reference |
Volume | (optional) input reference volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--label |
int | 1 |
(optional) the mask label |
--num |
int | 1 |
(optional) use the given number of vertices from the midpoint |
--dilate |
int | 0 |
(optional) dilate the endpoint mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
CurvesNearest
Extract the nearest curve to a collection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--ref |
Curves | reference curves |
--deform |
Deformation | (optional) a deformation for the input curve |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesOrient
Orient curves to best match endpoints, i.e. flip them to make the starts and ends as close as possible
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--iters |
int | 10 |
(optional) a maxima number of iterations |
--axis |
flag | (optional) orient to the nearest spatial axis |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesOrientationMap
Compute an orientation map. This will find the most likely direction in each voxel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--refvolume |
Volume | (optional) input reference volume (exclusive with refmask) |
--refmask |
Mask | (optional) input reference mask (exclusive with refvolume) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--orient |
flag | (optional) orient the bundle prior to mapping | |
--vector |
flag | (optional) compute a vector orientation (you may want to enable the orient flag) | |
--norm |
VolumeEnhanceContrastType | Histogram |
(optional) specify a method for normalizing orientation magnitudes (Options: Histogram, Ramp, RampGauss, Mean, None) |
--smooth |
flag | (optional) apply fiber smoothing after mapping | |
--fibers |
flag | (optional) return a fibers volume |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--sigma |
Double | -1.0 |
(optional) apply smoothing with the given amount (bandwidth in mm) (a negative value will use the largest voxel dimension) |
--support |
int | 3 |
(optional) the smoothing filter radius in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
CurvesOutlierGaussian
Filter outliers using a mvGaussian probabilistic model with a Chi2 distribution on the Mahalanobis distance
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
--reference |
Curves | input reference curve |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--outlierCount |
Integer | 10 |
(optional) the number of points used for outlier rejection |
--outlierThresh |
Double | 0.95 |
(optional) the probability threshold for outlier rejection |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
CurvesOutlierLength
Detect outliers among curves based on their length. In practice an absolute z-threshold of 2.0 should work well.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--zthresh |
Double | (optional) specify an absolute threshold z-score | |
--zlow |
Double | (optional) specify a low threshold z-score | |
--zhigh |
Double | (optional) specify a high threshold z-score |
Output:
| Flag | Type | Description |
|---|---|---|
--inlier |
Curves | (optional) the output inlier curves |
--outlier |
Curves | (optional) the output outlier curves |
CurvesOutlierSCPT
Detect outliers among curves with a sparse closest point transform.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--type |
String | diagonal |
(optional) covariance matrix type (full, diagonal, spherical) |
--thresh |
Double | 0.99 |
(optional) the threshold probability |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--prior |
Double | 0.001 |
(optional) the prior bundle size (mm) |
--mix |
Double | 0.0 |
(optional) the prior mixing weight (use zero for no prior) |
Output:
| Flag | Type | Description |
|---|---|---|
--inlier |
Curves | (optional) the output inlier curves |
--outlier |
Curves | (optional) the output outlier curves |
--landmarks |
Vects | (optional) the computed landmarks |
CurvesPrintInfo
Print basic information about curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--stats |
flag | (optional) print statistics | |
--length |
flag | (optional) print statistics of curve lengths |
CurvesPrototype
Extract a prototypical curve that has maximum track density
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
double | 1.0 |
(optional) the volume resolution |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesReduce
Reduce the number of curves by random subsampling
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--count |
Integer | (optional) a maxima number of curves | |
--fraction |
Double | (optional) remove a given fraction of the curves | |
--min |
Integer | (optional) retain at least this many curves |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output selected curves |
CurvesRelabel
Relabel curves from biggest to smallest cluster
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threshold |
Double | retain only clusters above a given proportion of the total | |
--largest |
flag | (optional) keep only the largest label |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
CurvesResample
Resample the position of vertices along curves so that they have uniform spacing
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
Integer | (optional) resample with a constant number of vertices per curve (0 specifices that the max should be used) | |
--orient |
flag | (optional) reorient curves | |
--density |
Double | (optional) resample with a given vertex density (mm/vertex) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesSample
Sample a volume at the vertices of curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
--volume |
Volume | the volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--interp |
InterpolationType | Trilinear |
(optional) interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
--attr |
String | sampled |
(optional) attribute name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
CurvesSegmentAlong
Segment a bundle by matching vertices along its length based on a prototype curve
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
--proto |
Curves | (optional) input prototype curve (if not supplied, one will be computed) |
--deform |
Deformation | (optional) a deformation to transform the proto curves to the coordinates of the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
CurvesSegmentAlongType | Hybrid |
(optional) the method for segmenting along the bundle (Options: Arclength, Distance, Hybrid) |
--samples |
Integer | (optional) the number of points used for along tract mapping (if not supplied, the number of points in the proto will be used) | |
--density |
Double | (optional) the density of points used for along tract mapping (if not supplied, the number of points in the proto will be used) | |
--label |
String | label |
(optional) an attribute name for the label used to indicate the position along the bundle |
--outlier |
flag | (optional) remove outliers | |
--outlierCount |
Integer | 10 |
(optional) the number of points used for outlier rejection |
--outlierThresh |
Double | 0.99 |
(optional) the probability threshold for outlier rejection |
--outlierAttrs |
String | FA,MD,frac,diff,S0,base |
(optional) use the following attributes for outlier detection (if they exist) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
Double | 1.0 |
(optional) the volume resolution for distance segmentation |
--power |
Double | 4.0 |
(optional) the power for the mixing function (must be a positive even number, e.g. 2, 4, 6) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output curves |
--outputDist |
Volume | (optional) output distance volume (not provided by arclength segmentation) |
--outputLabel |
Volume | (optional) output label volume (not provided by arclength segmentation |
--outputProto |
Curves | (optional) output proto curve (useful in case it was computed automatically) |
--outputCore |
Curves | (optional) output core curve (the nearest curve to the prototype) |
CurvesSelect
Select a which of curves using a number of possible criteria
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--deform |
Deformation | (optional) a deformation between curves and the masks |
--mask |
Mask | (optional) a mask |
--solids |
Solids | (optional) some solids |
--vects |
Vects | (optional) some vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--radius |
double | 5.0 |
(optional) vects radius |
--or |
flag | (optional) use OR (instead of AND) to combine selections | |
--invert |
flag | (optional) invert the selection after combining | |
--exclude |
flag | (optional) exclude the selected curves | |
--endpoints |
flag | (optional) select based on only curve endpoints | |
--expression |
String | (optional) select based on a boolean-valued expression using any of: length, size, min_attr, max_attr, mean_attr, or sum_attr | |
--minlen |
Double | (optional) a minimum length | |
--maxlen |
Double | (optional) a maximum length | |
--longest |
flag | (optional) select the longest curve |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output selected curves |
CurvesSetAttributeLookupTable
Set vertex attributes of curves based on a table. The curves should have a discrete-valued attribute that is used to match vertices to entries in the table.
Input:
| Flag | Type | Description |
|---|---|---|
--curves |
Curves | input curves |
--table |
Table | input table |
--lookup |
Table | (optional) a lookup table to relate names to indices |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--mergeTable |
String | name |
(optional) a table field name to merge on |
--mergeLookup |
String | along_name |
(optional) a lookup field name to merge on |
--index |
String | along_index |
(optional) the lookup table index field name |
--value |
String | value |
(optional) a table field to get |
--cindex |
String | (optional) the curves index field name (defaults to lookup table index field name) | |
--cvalue |
String | (optional) a curves field to set (defaults to table field name) | |
--background |
double | 0.0 |
(optional) a background value |
--missing |
Double | (optional) an missing value |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--exclude |
flag | (optional) exclude data with no entry in the table |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesSetAttributeVects
Set vertex attributes of curves based on a table. The curves should have a discrete-valued attribute that is used to match vertices to entries in the table.
Input:
| Flag | Type | Description |
|---|---|---|
--curves |
Curves | input curves |
--vects |
Vects | input vectors |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | attr |
(optional) an attribute field name |
--quiet |
flag | (optional) don’t complain if the vects and curves don’t match (and try to add as much data to the curves as possible) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesSimplify
Simplify curves with the Ramer-Douglas-Peucker algorithm
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--epsilon |
double | 2.0 |
(optional) the distance threshold |
--radial |
flag | (optional) use radial distance |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output simplified curves |
Citation: Heckbert, Paul S.; Garland, Michael (1997). Survey of polygonal simplification algorithms
CurvesSmooth
Smooth out irregularities in the input curves using laplacian (or Taubin) smoothing. This works best if curve vertices are equally spaced along each curve.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | coord |
(optional) the attribute to smooth |
--iters |
int | 1 |
(optional) number of iterations |
--lambda |
double | 0.3 |
(optional) lambda smoothing parameter |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--mu |
Double | (optional) mu smoothing parameter (for Taubin smoothing) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesSubdivide
Subdivide the curves by inserting vertices in each edge
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
Integer | 1 |
(optional) subdivide the curves a given number of times |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesSymmetrize
Make a left/right pair of curves symmetric
Input:
| Flag | Type | Description |
|---|---|---|
--inputLeft |
Curves | input left curves |
--inputRight |
Curves | input right curves |
--reference |
Volume | input reference |
Output:
| Flag | Type | Description |
|---|---|---|
--outputLeft |
Curves | output left curves |
--outputRight |
Curves | output right curves |
CurvesThickness
Compute the thickness of a bundle
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--core |
Curves | (optional) input core |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output core with thickness |
CurvesTransform
Apply a spatial transformation to curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
--pose |
Volume | (optional) apply a transform to match the pose of a volume |
--invpose |
Volume | (optional) apply a transform to match the inverse pose of a volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--tx |
Double | (optional) translate the curves in the x dimension | |
--ty |
Double | (optional) translate the curves in the y dimension | |
--tz |
Double | (optional) translate the curves in the z dimension | |
--sx |
Double | (optional) scale the curves in the x dimension | |
--sy |
Double | (optional) scale the curves in the y dimension | |
--sz |
Double | (optional) scale the curves in the z dimension |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
CurvesTrkPrintHeader
Print basic information about TrackVis curves
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | the input curves filename |
CurvesTubes
Create a mesh representing 3D tubes based on the input curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | the input curves |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--color |
flag | (optional) use per-vertex orientation coloring | |
--wash |
Double | 0.2 |
(optional) the color wash |
--dthick |
Double | 0.15 |
(optional) the default tube thickness |
--fthick |
Double | 1.0 |
(optional) the tube thickness factor (scales the thickness attribute, it it is present) |
--thick |
String | thickness |
(optional) use the given thickness attribute |
--resolution |
int | 5 |
(optional) the tube resolution |
--noColor |
flag | (optional) skip color attributes | |
--noThick |
flag | (optional) skip thickness attributes | |
--smooth |
flag | (optional) create smooth tube caps (the default will use a separate disk for tube caps) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output tubes |
CurvesVertices
Extract all curve vertices
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
CurvesVoxelize
Compute a mask by voxelizing curves. This works by find the voxels that intersect the curves and marking them as one.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Curves | input curves |
--refvolume |
Volume | (optional) input reference volume (exclusive with refmask) |
--refmask |
Mask | (optional) input reference mask (exclusive with refvolume) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
GradientsCat
Concatenate two sets of gradients into one
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Gradients | input gradients |
--cat |
Gradients | gradients to concatenate |
--catB |
Gradients | (optional) gradients to concatenate |
--catC |
Gradients | (optional) gradients to concatenate |
--catD |
Gradients | (optional) gradients to concatenate |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Gradients | output concatenated gradients |
GradientsConvert
Convert gradients between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Gradients | the input gradients |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Gradients | the output gradients |
GradientsCreate
Create a gradients file from separate bvecs and bvals
Input:
| Flag | Type | Description |
|---|---|---|
--bvecs |
Vects | the input bvecs |
--bvals |
Vects | the input bvals |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Gradients | the output gradients |
GradientsMatch
Correct for errors in the orientation of diffusion gradients using the fiber coherence index
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Gradients | the input gradients |
--dwi |
Volume | the input diffusion-weighted MR volume |
--mask |
Mask | (optional) the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--nospat |
flag | (optional) skip spatial scaling (note: this is not included in the paper by Schilling et al) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Gradients | the output matched gradients |
Citation: Schilling, Kurt G., et al. “A fiber coherence index for quality control of B-table orientation in diffusion MRI scans.” Magnetic resonance imaging (2019).
GradientsReduce
Reduce a set of gradients to a which based on user specification
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Gradients | the input gradients |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--which |
String | (optional) include only specific gradients (comma separated zero-based indices) | |
--exclude |
String | (optional) exclude specific gradients (comma separated zero-based indices) | |
--shells |
String | (optional) include only specific shells |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Gradients | the output gradients |
GradientsTransform
Transform gradient directions (note: the order of operations is transpose, flip, swap, perm, affine)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Gradients | input gradients |
--affine |
Affine | (optional) apply an affine transform to gradient directions (and normalize afterwards) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--round |
flag | (optional) round the gradients magnitudes | |
--rounder |
int | 100 |
(optional) specify how coarsely to round the gradient magnitudes |
--subset |
String | (optional) select a subset of gradients | |
--flip |
String | (optional) flip a coodinate (x, y, or z) | |
--swap |
String | (optional) swap a pair of coordinates (xy, xz, or yz) | |
--perm |
String | (optional) permute by coordinate index, e.g. 1,0,2 |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Gradients | output transformed gradients |
MapEddy
Summarize the motion parameters from FSL EDDY
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | the input eddy motion file, e.g. ‘eddy_movement_rms’ |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--prefix |
String | `` | (optional) a prefix to add before the metric name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output map |
MapLaterality
Compute the lateralization index of a given map. This assumes you have a two column table (name,value) that contains left and right measurements (see module parameters to specify the left/right identifiers)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table (should use the naming convention like the module parameters) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | name |
(optional) the field holding the name of the measurement |
--value |
String | value |
(optional) the field holding the value of the measurement |
--left |
String | lh_ |
(optional) the identifier for left values |
--right |
String | rh_ |
(optional) the identifier for right values |
--indlat |
String | indlat_ |
(optional) the identifier for the lateralization index |
--abslat |
String | abslat_ |
(optional) the identifier for the absolute lateralization index |
--unilat |
String | unilat_ |
(optional) the identifier for the unilateral averaging |
--minlat |
String | minlat_ |
(optional) the identifier for the left right minimum |
--maxlat |
String | maxlat_ |
(optional) the identifier for the left right maximum |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MaskAdapt
Clean a mask by performing morphological opening followed by closing
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--volume |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--diameter |
int | 1 |
(optional) the distance in voxels for adaptation |
--thresh |
double | 1.0 |
(optional) the statistical threshold |
--robust |
flag | (optional) use robust statistics | |
--robustHuber |
flag | (optional) use a Huber estimator robust statistics |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
--outputProb |
Volume | output prob |
MaskBinarize
Binarize a mask to convert all labels to zero or one.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskBoundary
Close a mask using morphological operations
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--element |
String | cross |
(optional) specify an element |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskBox
Compute the bounding box of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--foreground |
flag | (optional) compute box around foreground | |
--buffer |
Double | (optional) a buffer in mm |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output bounding box |
MaskBoxCreate
Create a mask from a box
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Solids | the input box |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
double | 1.0 |
(optional) voxel spacing |
--round |
flag | (optional) round the starting point |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskCentroids
Extract the centroids for each mask label
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--mask |
Mask | (optional) restrict the centroids to the given mask |
--nearest |
Vects | (optional) extract only the centroid nearest to the given vector |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--components |
flag | (optional) extract centroids of connected components | |
--largest |
flag | (optional) extract only the largest centroid |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
MaskClean
Clean a mask by performing morphological opening followed by closing
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the number of iterations |
--largest |
flag | (optional) select the largest component as an intermediate step | |
--element |
String | cross |
(optional) specify an element: cross, cube, or sphere. you can also specify an optional size, e.g. cross(3) |
--outside |
flag | (optional) treat voxels outside mask as background |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskClose
Close a mask morphologically. This dilates and then erodes the mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the number of times to erode and dilate the mask |
--largest |
flag | (optional) select the largest component as an intermediate step between erosion and dilation | |
--mode |
flag | (optional) apply a mode filter as an intermediate step between erosion and dilation | |
--element |
String | cross |
(optional) specify an element: cross, cube, or sphere. you can also specify an optional size, e.g. cross(3) |
--outside |
flag | (optional) treat voxels outside mask as background |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskComponents
Compute connected components of a mask. The output will be sorted by the number of voxels per component, e.g. the largest component will have label 1, and the second largest will have label 2, etc.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--full |
flag | (optional) use a full 27-voxel neighborhood (default is 6-voxel) | |
--which |
String | (optional) include only specific component labels, e.g. “1,2” would select the two largest components | |
--minvoxels |
Integer | (optional) filter out components with fewer then the given number of voxels | |
--minvolume |
Double | (optional) filter out components that are smaller in volume than the given threshold | |
--keep |
flag | (optional) keep the input labels (only relevant to filtering options) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskConvert
Convert a mask between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output |
MaskCreate
Create a mask based on user specified parameters
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--deltax |
double | 1.0 |
(optional) voxel spacing in x |
--deltay |
double | 1.0 |
(optional) voxel spacing in y |
--deltaz |
double | 1.0 |
(optional) voxel spacing in z |
--numx |
int | 128 |
(optional) number of voxels in x |
--numy |
int | 128 |
(optional) number of voxels in y |
--numz |
int | 1 |
(optional) number of voxels in z |
--startx |
double | 0.0 |
(optional) starting position in x |
--starty |
double | 0.0 |
(optional) starting position in y |
--startz |
double | 0.0 |
(optional) starting position in z |
--label |
int | 0 |
(optional) constant label |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskCreateOverlay
Create a mask from an overlay file
Input:
| Flag | Type | Description |
|---|---|---|
--reference |
Mask | input reference mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--overlay |
String | the overlay filename | |
--label |
int | 1 |
(optional) the label to use |
--preserve |
flag | (optional) preserve the labels from the reference mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskCrop
Crop a mask down to a smaller mask (only one criteria per run)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--mask |
Mask | (optional) a mask |
--solids |
Solids | (optional) some soids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--range |
String | (optional) a range specification, e.g. start:end,start:end,start:end | |
--invert |
flag | (optional) invert the selection | |
--pad |
int | 0 |
(optional) a padding size in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output mask |
MaskDeform
Dilate a mask morphologically.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--effect |
double | 1.0 |
(optional) deformation effect size |
--extent |
double | 1.0 |
(optional) deformation spatial extent |
--iters |
int | 8 |
(optional) number of velocity field integrations |
--interp |
InterpolationType | Nearest |
(optional) the velocity field interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--velocity |
Volume | (optional) output forward deformation |
--forward |
Deformation | (optional) output forward deformation |
--backward |
Deformation | (optional) output backward deformation |
MaskDice
Binarize a mask to convert all labels to zero or one.
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Mask | input left mask |
--right |
Mask | input right mask |
MaskDilate
Dilate a mask morphologically.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the number of times to dilate the mask |
--element |
String | cross |
(optional) specify an element: cross, cube, or sphere. you can also specify an optional size, e.g. cross(3) |
--outside |
flag | (optional) treat voxels outside mask as background |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskDistanceTransform
Compute a distance transform using pff’s fast algorithm
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--signed |
flag | (optional) compute a signed transform |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output distance transform |
Citation: Felzenszwalb, P., & Huttenlocher, D. (2004). DistanceExtrinsic transforms of sampled functions. Cornell University.
MaskEdge
Detect the edges of a input mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--binary |
flag | (optional) binarize the edges | |
--full |
flag | (optional) use a full neighborhood |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output input |
MaskErode
Erode a mask morphologically
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the number of iterations |
--outside |
flag | (optional) treat voxels outside mask as background | |
--verbose |
flag | (optional) print messages |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskExtract
Extract specific labels from a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--lookup |
Table | (optional) input lookup table (must store the index and name of each label) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--label |
String | 1 |
(optional) the label(s) to extract (comma delimited, e.g. 1,2,3 or lh-temporal,rh-temporal if a lookup is used) |
--mode |
MaskExtractMode | Binary |
(optional) the mode for extracting labels (Options: Binary, Preserve, Distinct) |
--name |
String | name |
(optional) the name field in the lookup table |
--index |
String | index |
(optional) the index field in the lookup table |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskFill
Flood fill the interior of the mask regions
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskFilter
Filter a mask in a variety of possible ways
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--mask |
Mask | (optional) a region to limit the filtering |
--ref |
Volume | (optional) input reference volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--mode |
flag | (optional) apply a mode filter | |
--largest |
flag | (optional) extract the largest region | |
--largestn |
Integer | (optional) extract the largest N region | |
--minvox |
Integer | (optional) the minima region voxel count | |
--minvol |
Double | (optional) the minima region volume | |
--highest |
flag | (optional) extract the region with the highest average average reference value | |
--lowest |
flag | (optional) extract the region with the lowest average average reference value | |
--most |
flag | (optional) extract the region with the most total reference signal | |
--binarize |
flag | (optional) binarize the mask at the end |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskFilterMedian
Perform median filtering of a mask.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--window |
int | 1 |
(optional) the window size in voxels |
--slice |
String | (optional) restrict the filtering to a specific slice (i, j, or k) | |
--num |
Integer | 1 |
(optional) the number of times to filter |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output volume |
MaskFilterMode
Perform mode filtering a mask. Each voxel will be replaced by the most frequent label in the surrounding neighborhood, so this is like performing non-linear smoothing a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--mask |
Mask | (optional) input mask to restrict filtering |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--radius |
int | 1 |
(optional) the radius in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskForce
Compute a force field of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--lookup |
Table | (optional) input lookup table (must store the index and name of each label) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--outside |
flag | (optional) only include forces outside | |
--flip |
flag | (optional) flip the orientation of the forces | |
--smooth |
flag | (optional) apply fiber smoothing after projection | |
--which |
String | (optional) only process certain parcellation labels (by default all will be processed) | |
--threads |
int | 1 |
(optional) the number of threads |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--range |
Double | 2.0 |
(optional) the distance for the force field |
--sigma |
Double | (optional) apply smoothing with the given amount (bandwidth in mm) (default is largest voxel dimension) | |
--support |
int | 3 |
(optional) the smoothing filter radius in voxels |
--name |
String | name |
(optional) the name field in the lookup table |
--index |
String | index |
(optional) the index field in the lookup table |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output vectors |
--labels |
Mask | (optional) the output mask of labels |
MaskGreater
Extract the larger components of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--minimum |
double | 25.0 |
(optional) the minima volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskHull
Compute the convex hull of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
Citation: Barber, C. B., Dobkin, D. P., & Huhdanpaa, H. (1996). The quickhull algorithm for convex hulls. ACM Transactions on Mathematical Software (TOMS), 22(4), 469-483.
MaskIntersection
Compute the logical AND of two masks
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Mask | input left mask |
--right |
Mask | input right mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--mode |
MaskIntersectionMode | Left |
(optional) specify what label should be returned (Options: Left, Right, Max, Min, Sum, Product, One) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskInvert
Invert the labels of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--mask |
Mask | (optional) only invert in this region |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskLargest
Extract the largest component of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskLateralize
Compute the logical AND of two masks
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--left |
Mask | a mask marking off the left hemisphere (the remainder is assumed to be the right) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--leftPrefix |
String | Left_ |
(optional) the left prefix |
--leftPostfix |
String | `` | (optional) the left postfix |
--rightPrefix |
String | Right_ |
(optional) the right prefix |
--rightPostfix |
String | `` | (optional) the right postfix |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskLesser
Extract the smaller components of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--maximum |
double | 25.0 |
(optional) the maxima volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskList
Create a list of regions from a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--zero |
flag | (optional) include zero | |
--base |
String | region |
(optional) specify a basename |
--name |
String | name |
(optional) specify the lookup name field |
--index |
String | index |
(optional) specify the output index name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MaskMRFEM
Refine a segmentation using a Expectation Maximization Markov Random Field framework
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input region |
--volume |
Volume | input volume |
--mask |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--distance |
Double | 1.0 |
(optional) the distance in voxels for adaptation |
--mrfCross |
flag | (optional) use a 6-neighborhood (instead of a full 27-neighborhood with diagonals) | |
--mrfGamma |
Double | 1.0 |
(optional) use the following spatial regularization weight |
--mrfCrfGain |
Double | 1.0 |
(optional) use the gain used for the conditional random field (zero will disable it) |
--mrfIcmIters |
Integer | 5 |
(optional) use the following number of MRF optimization iterations |
--mrfEmIters |
Integer | 5 |
(optional) use the following number of expectation maximization iteration |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output input |
MaskMarchingCubes
Extract surfaces from a mask. If there are multiple labels in the volume, distinct meshes will be produced for each label.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--table |
Table | (optional) a table listing a subset of indices |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--std |
Double | (optional) perform Gaussian smoothing before surface extraction | |
--support |
Integer | 3 |
(optional) use a given support in voxels for smoothing |
--level |
Double | 0.5 |
(optional) use a given isolevel for smoothed surface extraction |
--which |
String | (optional) a string specifying a subset of labels, e.g. 1,2,4:6 | |
--meanarea |
Double | (optional) simplify the mesh to have the given mean triangle area |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--tindex |
String | index |
(optional) the index field name to use in the table |
--mindex |
String | label |
(optional) the mesh attribute for the index value (default is “label”) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
Citation: Lorensen, W. E., & Cline, H. E. (1987, August). Marching cubes: A high resolution 3D surface construction algorithm. In ACM siggraph computer graphics (Vol. 21, No. 4, pp. 163-169). ACM.
MaskMarchingSquares
Extract contours from slices of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dim |
String | z |
(optional) volume channel to contour (x, y, or z) |
--start |
int | 0 |
(optional) starting slice index |
--step |
int | 1 |
(optional) number of slices between contours |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output curves |
Citation: Maple, C. (2003, July). Geometric design and space planning using the marching squares and marching cube algorithms. In Geometric Modeling and Graphics, 2003. Proceedings. 2003 International Conference on (pp. 90-95). IEEE.
MaskMatch
Match the dimensions of a mask to a reference image. For example, if you draw a mask on downsampled version of an image, this will upsample the labels to match the high resolution original image.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--reference |
Volume | input reference image |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskMeasure
Measure properties of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--region |
Mask | (optional) restrict the analysis to a given region of interest |
--lookup |
Table | (optional) use a lookup for region names |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--nameField |
String | name |
(optional) specify the output name field |
--valueField |
String | value |
(optional) specify the output value field name |
--lutNameField |
String | name |
(optional) specify the lookup name field |
--lutIndexField |
String | index |
(optional) specify the lut index field name |
--volumes |
flag | (optional) report only the region volumes | |
--fraction |
flag | (optional) compute the fraction of each region | |
--cluster |
flag | (optional) compute cluster statistics of each region | |
--position |
flag | (optional) compute the position of each region | |
--components |
flag | (optional) run connected components labeling before anything else | |
--binarize |
flag | (optional) binarize the mask before anything else (overrides the components flag) | |
--comps |
flag | (optional) include component counts in the report | |
--counts |
flag | (optional) include voxel counts in the report | |
--minvolume |
Double | (optional) the minimum component volume (mm^3) to be included | |
--minvoxels |
Integer | (optional) the minimum component voxel count to be included |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MaskMeasureClusters
Measure individual cluster sizes of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--region |
Mask | (optional) restrict the analysis to a given region of interest |
--lookup |
Table | (optional) use a lookup for region names |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--nameField |
String | name |
(optional) specify the output name field |
--clusterField |
String | cluster |
(optional) specify the output cluster field |
--voxelsField |
String | voxels |
(optional) specify the output voxel count field name |
--lutNameField |
String | name |
(optional) specify the lookup name field |
--lutIndexField |
String | index |
(optional) specify the lut index field name |
--minvolume |
Double | (optional) the minimum component volume (mm^3) to be included | |
--minvoxels |
Integer | (optional) the minimum component voxel count to be included |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MaskMirror
Mirror a mask is the given direction
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--flipi |
flag | (optional) flip in i | |
--flipj |
flag | (optional) flip in j | |
--flipk |
flag | (optional) flip in k |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskNodeLink
Create a node link representation of mask connectivity in a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--lookup |
Table | input table |
--attributes |
Table | input attributes |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--index |
String | index |
(optional) index |
--name |
String | name |
(optional) name |
--group |
String | group |
(optional) group |
--value |
String | value |
(optional) value |
--radius |
double | 10.0 |
(optional) radius |
--subdiv |
int | 2 |
(optional) subdiv |
Output:
| Flag | Type | Description |
|---|---|---|
--links |
Curves | (optional) output links |
--nodes |
Mesh | (optional) output nodes |
MaskOpen
Open a mask using morphological operations. This first erodes the mask and then dilates it.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the number of times to erode and dilate the mask |
--largest |
flag | (optional) select the largest component as an intermediate step between erosion and dilation | |
--mode |
flag | (optional) apply a mode filter as an intermediate step between erosion and dilation | |
--element |
String | cross |
(optional) specify an element: cross, cube, or sphere. you can also specify an optional size, e.g. cross(3) |
--outside |
flag | (optional) treat voxels outside mask as background |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskOrigin
Set the origin of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | the input Mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--x |
double | 0.0 |
(optional) the origin in x |
--y |
double | 0.0 |
(optional) the origin in y |
--z |
double | 0.0 |
(optional) the origin in z |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output Mask |
MaskPad
Pad a mask by a given number of voxels
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pad |
int | 10 |
(optional) the amount of padding in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskPhantomNoisy
Generate a noisy mask
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--width |
int | 100 |
(optional) image width |
--height |
int | 100 |
(optional) image height |
--slices |
int | 1 |
(optional) image slices |
--labels |
int | 1 |
(optional) the number of labels to use |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskPrintInfo
Print basic information about a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--stats |
flag | (optional) print statistics |
MaskProduct
Compute the product of two multi-label masks. Unlike MaskIntersection, this will make sure the product is unique and the names are updated.
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Mask | input left mask |
--right |
Mask | input right mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--sep |
String | _ |
(optional) the string for combining region names |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskPrototype
Create a mask from example data
Input:
| Flag | Type | Description |
|---|---|---|
--mask |
Mask | (optional) an example mask |
--volume |
Volume | (optional) an example volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--label |
int | 0 |
(optional) the default label |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output |
MaskRegionMerge
Merge small regions using an adjacency graph
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input region input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threshold |
double | 10.0 |
(optional) the input threshold |
--full |
flag | (optional) use a full 27-voxel neighborhood (default is 6-voxel) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output input |
MaskRelabel
Relabel a mask by replacing voxel labels with new values
Input:
| Flag | Type | Description |
|---|---|---|
--mask |
Mask | input mask |
--mapping |
Table | input mapping (includes fields named ‘from’ and ‘to’) |
--lookup |
Table | (optional) input lookup |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--preserve |
flag | (optional) preserve the input labels if possible | |
--names |
flag | (optional) use names for remapping (instead of index labels) | |
--from |
String | from |
(optional) specify a from field to us in mapping |
--to |
String | to |
(optional) specify a to field to us in mapping |
--name |
String | name |
(optional) the name field |
--index |
String | index |
(optional) the index field |
Output:
| Flag | Type | Description |
|---|---|---|
--outputMask |
Mask | output mask |
--outputLookup |
Table | (optional) output lookup |
MaskReorder
Change the ordering of voxels in a mask. You can flip and shift the voxels. Which shifting outside the field a view, the data is wrapped around. Shifting is applied before flipping
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--flipi |
flag | (optional) flip in i | |
--flipj |
flag | (optional) flip in j | |
--flipk |
flag | (optional) flip in k | |
--shifti |
int | 0 |
(optional) shift in i |
--shiftj |
int | 0 |
(optional) shift in j |
--shiftk |
int | 0 |
(optional) shift in k |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskResample
Resample a mask with a different voxel size
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dx |
double | 1.0 |
(optional) the voxel size in x |
--dy |
double | 1.0 |
(optional) the voxel size in y |
--dz |
double | 1.0 |
(optional) the voxel size in z |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output volume |
MaskRestoreMRF
Restore a mask using a markov random field with loopy belief propagation
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
--mask |
Mask | (optional) a mask of the area to restore |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--cost |
double | 0.75 |
(optional) the cost for changing a voxel label |
--data |
double | 1.0 |
(optional) the weight for the data term |
--smooth |
double | 1.0 |
(optional) the weight for the smoothness term |
--iters |
int | 50 |
(optional) the number of belief propagation iterations |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
Citation: Felzenszwalb, P. F., & Huttenlocher, D. P. (2006). Efficient belief propagation for early vision. International journal of computer vision, 70(1), 41-54.
MaskRings
Compute equidistant rings around a region
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input region |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--levels |
String | 3,5,7,9 |
(optional) the levels for segmentation (comma-separated in mm) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskSampleVects
Sample vects from a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--count |
int | 1 |
(optional) the number of samples per voxel |
--limit |
int | 10000 |
(optional) the maximum number of points to produce |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
MaskSet
Set the values of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | the input mask |
--solids |
Solids | (optional) some solids |
--vects |
Vects | (optional) some vects |
--mask |
Mask | (optional) the mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--clear |
flag | (optional) clear the input labels before setting anything | |
--range |
String | (optional) a range, e.g. start:end,start:end,start:end | |
--label |
int | 1 |
(optional) the label to set |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output mask |
MaskSetEyes
Binarize a mask to convert all labels to zero or one.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input reference mask |
--eyes |
Vects | input eye positions |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--start |
double | 10.0 |
(optional) the starting level |
--end |
double | 55.0 |
(optional) the end level |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskSetTable
Create a table listing regions of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--reference |
Mask | input reference |
--table |
Table | input table |
--lookup |
Table | (optional) a lookup table to relate names to indices |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--merge |
String | name |
(optional) a field name to merge on |
--index |
String | index |
(optional) the index field name |
--value |
String | value |
(optional) a field to set |
--background |
double | 0.0 |
(optional) a background value |
--missing |
Double | (optional) an missing value |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
MaskShell
Compute the shell of a mask (the voxels at the boundary of the mesh)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) dilate this many times |
--mode |
ShellMode | Inner |
(optional) specify a mode for computing the shell (Options: Inner, Outer, Multi) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskSkeleton
Skeletonize a mask using medial axis thinning. Based on Hanno Homan’s implementation of Lee et al. at http://hdl.handle.net/1926/1292
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
Citation: Lee, Ta-Chih, Rangasami L. Kashyap, and Chong-Nam Chu. Building skeleton models via 3-D medial surface axis thinning algorithms. CVGIP: Graphical Models and Image Processing 56.6 (1994): 462-478.
MaskSort
Sort the labels of a mask by their size
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskSplitMidline
Split mask regions at the midline to produce left and right regions
Input:
| Flag | Type | Description |
|---|---|---|
--mask |
Mask | input mask |
--lookup |
Table | (optional) input lookup |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pattern |
String | %{hemi}_%{name} |
(optional) a pattern for renaming entries |
--midline |
Integer | (optional) specify a midline index (otherwise the middle is used) | |
--start |
Integer | 1 |
(optional) specify an offset value (0 or 1) |
--left |
String | left |
(optional) specify an identifier for the left hemisphere |
--right |
String | right |
(optional) specify an identifier for the right hemisphere |
--name |
String | name |
(optional) the name field in the lookup table |
--index |
String | index |
(optional) the index field in the lookup table |
Output:
| Flag | Type | Description |
|---|---|---|
--outputMask |
Mask | output mask |
--outputLookup |
Table | (optional) output lookup |
MaskStandardize
Standardize the pose of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | (optional) output mask |
--xfm |
Affine | (optional) output affine |
--invxfm |
Affine | (optional) output inverse affine |
MaskSymmetrize
Make a left/right pair masks symmetric
Input:
| Flag | Type | Description |
|---|---|---|
--inputLeft |
Mask | input left mask |
--inputRight |
Mask | input right mask |
Output:
| Flag | Type | Description |
|---|---|---|
--outputLeft |
Mask | output left mask |
--outputRight |
Mask | output right mask |
MaskTable
Create a table listing regions of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--nameField |
String | name |
(optional) the region name field |
--indexField |
String | index |
(optional) the region label field |
--namePattern |
String | region%d |
(optional) a pattern for naming regions |
--xField |
String | x |
(optional) the region centroid x field |
--yField |
String | y |
(optional) the region centroid y field |
--zField |
String | z |
(optional) the region centroid z field |
--name |
flag | (optional) include a name field | |
--centroid |
flag | (optional) include a centroid fields |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MaskThick
Filter the mask to include only subregions with at least the given thickness
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the minimum thickness in voxels |
--element |
String | cross |
(optional) specify an element: cross, cube, or sphere. you can also specify an optional size, e.g. cross(3) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskTransform
Transform a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input volume |
--reference |
Volume | input reference volume |
--mask |
Mask | (optional) input mask (defined in the reference space) |
--inputMask |
Mask | (optional) use an input mask (defined in the input space) |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--background |
Integer | (optional) a label for filling background voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output volume |
MaskUnion
Combine two masks into one. By default, the left mask labels will be preserved and background voxels will be OR-ed with the right mask. You can optionally relabel the result to assign new labels to distinct pairs of left/right labels
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Mask | input left mask |
--right |
Mask | input right mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--relabel |
flag | (optional) combine the masks using distinct values | |
--max |
flag | (optional) use the maximum label when masks overlap (default is to use the left) | |
--distinct |
flag | (optional) use a label of one for the left mask and a label of two for the right |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MaskVects
Extract a vector for each foreground voxel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
MaskZoom
Zoom a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mask | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--factor |
Double | 2.0 |
(optional) an isotropic scaling factor |
--isotropic |
Double | (optional) an isotropic scaling factor | |
--fi |
Double | (optional) a scaling factor in i | |
--fj |
Double | (optional) a scaling factor in j | |
--fk |
Double | (optional) a scaling factor in k | |
--mode |
flag | (optional) filter the mask to smooth it |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
MatrixConvert
Convert a matrix between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Matrix | input matrix |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Matrix | output matrix |
MatrixCreate
Create a matrix
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--identity |
Integer | create an identity matrix with the given channel |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Matrix | output matrix |
MatrixInvert
Invert a matrix
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Matrix | input matrix |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Matrix | output matrix |
MatrixOrthogonalize
Orthogonalize a matrix
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Matrix | input matrix |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Matrix | output matrix |
MatrixPrintInfo
Print basic information about a matrix
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Matrix | the input matrix |
MatrixTranspose
Transpose a matrix
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Matrix | input matrix |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Matrix | output matrix |
MeshAttrBoundary
Extract the boundaries of mesh regions
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input Mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--coord |
String | coord |
(optional) a comma-separated list of coordinate attributes to lift |
--label |
String | coord |
(optional) the label attribute name |
--threshold |
double | 0.5 |
(optional) use a given threshold for picking the boundary |
--lift |
double | 0.0 |
(optional) apply the given amount of lift off the mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output Mesh |
MeshAttrClose
Close a mesh vertex selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--largest |
flag | (optional) select the largest component as an intermediate step | |
--num |
int | 1 |
(optional) the number of iterations |
--attrin |
String | selection |
(optional) the input attribute |
--attrout |
String | (optional) the output attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshAttrComponents
Compute connected components of a mesh selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--largest |
flag | (optional) retain only the largest component | |
--attrin |
String | selection |
(optional) the input attribute |
--attrout |
String | (optional) the output attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshAttrCortexToVolume
Project cortical surface data to a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
--refvolume |
Volume | (optional) input reference volume (exclusive with refmask) |
--refmask |
Mask | (optional) input reference mask (exclusive with refvolume) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pial |
String | pial |
(optional) pial attribute name |
--white |
String | white |
(optional) white attribute name |
--attr |
String | thickness |
(optional) the attribute to project |
--mindist |
double | 1.0 |
(optional) the minimum white-pial to be included |
--samples |
int | 15 |
(optional) the number of points to sample |
--inner |
double | 0.0 |
(optional) the inner buffer size |
--outer |
double | 0.0 |
(optional) the outer buffer size |
--smooth |
flag | (optional) apply fiber smoothing after projection | |
--nofill |
flag | (optional) skip the filling step | |
--threads |
int | 1 |
(optional) the number of threads |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--sigma |
Double | (optional) apply smoothing with the given amount (bandwidth in mm) (default is largest voxel dimension) | |
--support |
int | 3 |
(optional) the smoothing filter radius in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output projection |
MeshAttrCrop
Crop a mesh from a selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--invert |
flag | (optional) invert the selection | |
--attr |
String | selection |
(optional) the selection attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshAttrDilate
Dilate a mesh selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the number of iterations |
--attrin |
String | selection |
(optional) the input attribute |
--attrout |
String | (optional) the output attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshAttrErode
Erode a mesh selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) the number of iterations |
--attrin |
String | selection |
(optional) the input attribute |
--attrout |
String | (optional) the output attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshAttrGetTable
Create a table from mesh vertex attributes
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--vertices |
String | (optional) which vertices retain (comma separated) | |
--which |
String | coord |
(optional) which attributes to retain (comma separated) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MeshAttrGetVects
Extract a mesh vertex attribute as vectors
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | attr |
(optional) the destination attribute name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output mesh |
MeshAttrLaplacian
Filter a mesh with a laplacian
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attrin |
String | coord |
(optional) the input attribute to filter |
--attrout |
String | (optional) the output attribute names (if none, the input is replaced) | |
--num |
int | 5 |
(optional) a number of iterations |
--lambda |
Double | 0.3 |
(optional) the lambda laplacian filtering parameter |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshAttrMask
Apply a mask to an attribute
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--mask |
String | mask |
(optional) the mask attribute |
--attrin |
String | selection |
(optional) the input attribute |
--attrout |
String | (optional) the output attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshAttrMath
Evaluate an expression at each vertex of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | x > 0.5 |
(optional) the expression to evaluate |
--result |
String | result |
(optional) the attribute for the result |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshAttrMeasure
Measure regional attributes properties of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
--labels |
Vects | (optional) add a pacellation attribute |
--lookup |
Table | (optional) use a lookup table for naming regions |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | compute statistics of the following numerical attributes (a comma-delimited list can be used) | |
--output |
String | output directory | |
--label |
String | label |
(optional) the name of the parcellation attribute |
--binary |
flag | (optional) treat the parcellation as binary (zero vs. non-zero) | |
--lutname |
String | name |
(optional) the lookup table name field |
--lutindex |
String | index |
(optional) the lookup table index field |
--outname |
String | name |
(optional) the output table name field |
--outvalue |
String | value |
(optional) the output table value field |
MeshAttrMeasureBinary
Measure regional attributes properties of a mesh with a binary labelling
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
--labels |
Vects | (optional) add a parcellation attribute |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | (optional) compute statistics of the following numerical attributes (a comma-delimited list can be used) | |
--label |
String | label |
(optional) the name of the parcellation attribute |
--whole |
String | whole |
(optional) the name of the whole attribute |
--prefix |
String | `` | (optional) a prefix for naming |
--coord |
String | coord |
(optional) the coordinate field (comma-separate list too) |
--outname |
String | name |
(optional) the output table name field |
--outvalue |
String | value |
(optional) the output table value field |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MeshAttrMedian
Smooth a mesh with a median filter
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attrin |
String | coord |
(optional) the attribute to smooth |
--attrout |
String | (optional) the output attribute names (if none, the input is replaced) | |
--num |
int | 5 |
(optional) a number of iterations |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshAttrMode
Filter a mesh attribute with a mode filter
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attrin |
String | coord |
(optional) the attribute to smooth |
--attrout |
String | (optional) the output attribute names (if none, the input is replaced) | |
--num |
int | 5 |
(optional) a number of iterations |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshAttrOpen
Open a mesh selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--largest |
flag | (optional) select the largest component as an intermediate step | |
--num |
int | 1 |
(optional) the number of iterations |
--attrin |
String | selection |
(optional) the input attribute |
--attrout |
String | (optional) the output attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshAttrParcel
Extract and measure a parcel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input Mesh |
--prior |
Vects | the input prior attribute vectors |
--whole |
Vects | (optional) the input whole surface attribute vectors |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--coord |
String | coord |
(optional) a comma-separated list of coordinate attributes |
--name |
String | parcel |
(optional) the parcel name |
--measure |
String | (optional) the attributes to measure (comma-separated) | |
--segment |
String | segment |
(optional) the attribute for segmentation |
--threshold |
double | 0.5 |
(optional) the value for thresholding |
--invert |
flag | (optional) apply an inverse threshold | |
--normalize |
flag | (optional) normalize the segmentation attribute (scale based on either the mode or mean) | |
--stat |
MeshAttrParcelStat | Mean |
(optional) the statistic to use for normalization (Options: Mode, Mean) |
--otsu |
flag | (optional) use an Otsu threshold (the specific threshold is ignored) | |
--bins |
int | 512 |
(optional) the number of bins for Otsu thresholding |
--smooth |
int | 2 |
(optional) the number of smoothing operations |
--mode |
int | 2 |
(optional) the number of mode filters |
Output:
| Flag | Type | Description |
|---|---|---|
--outputMask |
Vects | the output segmentation mask |
--outputTable |
Table | the output statistics |
MeshAttrSetTable
Create a table listing regions of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--mesh |
Mesh | input mesh |
--table |
Table | input table |
--lookup |
Table | (optional) a lookup table to relate names to indices |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--merge |
String | name |
(optional) a field name to merge on |
--index |
String | index |
(optional) the table index field name |
--value |
String | value |
(optional) a table field to get (can be comma delimited) |
--mindex |
String | (optional) the mesh index field name (defaults to table index field name) | |
--mvalue |
String | (optional) the mesh value field name (defaults to table value field name) | |
--background |
double | 0.0 |
(optional) a background value |
--missing |
Double | (optional) an missing value | |
--remove |
flag | (optional) remove triangles with vertices that are not included in the input table |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshAttrSetVects
Add vects as an attribute on a mesh (number of vects must match the number of vertices)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
--vects |
Vects | input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | attr |
(optional) the destination attribute name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshAttrThreshold
Apply a threshold to a mesh attribute
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attrin |
String | coord |
(optional) the input attribute to threshold |
--attrout |
String | (optional) the output attribute names (if none, the input is replaced) | |
--threshold |
Double | 0.5 |
(optional) threshold value |
--magnitude |
flag | (optional) use the magnitude for multi-variate attribtues | |
--invert |
flag | (optional) invert the threshold |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshAttributes
Manipulate mesh vertex attributes. Operations support comma-delimited lists
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input Mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--copy |
String | (optional) copy attribute (x=y syntax) | |
--rename |
String | (optional) rename attribute (x=y syntax) | |
--remove |
String | (optional) remove attribute (- for all) | |
--retain |
String | (optional) retain the given attributes and remove others) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output Mesh |
MeshBox
Get the bounding box of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output box |
MeshCat
Concatentate two meshes
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Mesh | input left |
--right |
Mesh | input right |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshComponents
Compute connected components of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--largest |
flag | (optional) retain only the largest component | |
--attr |
String | index |
(optional) the name of the component attribute |
--select |
String | (optional) retain components selected with the given attribute | |
--area |
Double | (optional) retain components above a given surface area | |
--invert |
flag | (optional) invert the selection |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshConvert
Convert a mesh between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCreateBox
Create a box
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCreateCylinder
Create a cylinder mesh
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--startx |
double | 0.0 |
(optional) input start x coordinate |
--starty |
double | 0.0 |
(optional) input start y coordinate |
--startz |
double | 0.0 |
(optional) input start z coordinate |
--endx |
double | 1.0 |
(optional) input end x coordinate |
--endy |
double | 10.0 |
(optional) input end y coordinate |
--endz |
double | 10.0 |
(optional) input end z coordinate |
--radius |
double | 5.0 |
(optional) input radius |
--resolution |
int | 5 |
(optional) input resolution |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCreateHemisphere
Create a hemisphere mesh
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--sudiv |
int | 1 |
(optional) the number of subdivisions |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCreateIcosahedron
Create a icosahedron
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCreateOctahedron
Create an octahedron
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCreateSphere
Create a sphere mesh
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--x |
double | 0.0 |
(optional) input x coordinate |
--y |
double | 0.0 |
(optional) input y coordinate |
--z |
double | 0.0 |
(optional) input z coordinate |
--radius |
double | 5.0 |
(optional) input radius |
--subdiv |
int | 2 |
(optional) input subdivisions |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCreateTetrahedron
Create a tetrahedron
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshCrop
Crop a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
--solids |
Solids | (optional) remove vertices inside the given solids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--selection |
String | (optional) remove vertices that are selected with a non-zero attribute | |
--invert |
flag | (optional) invert the selection |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshExtract
Extract a subset of a mesh that matches the given attribute values
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | label |
(optional) the attribute name of the label used to select |
--include |
String | (optional) which labels to include, e.g. 1,2,3:5 | |
--exclude |
String | (optional) which labels to exclude, e.g. 1,2,3:5 |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshFeatures
Compute geometric features of a mesh at each vertex. A locally quadratic approximation at each vertex is used to find curvature features
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | coord |
(optional) the mesh attribute |
--rings |
int | 2 |
(optional) the number of vertex rings to use for estimation |
--smooth |
int | 0 |
(optional) the number of pre-smoothing iterations |
--refine |
flag | (optional) refine the vertex positions to match the quadratic estimate (a loess type filter) | |
--step |
double | 0.001 |
(optional) the gradient step size for refinement |
--thresh |
double | 0.01 |
(optional) the error threshold for refinement |
--iters |
int | 1000 |
(optional) the maximum number of refinement iterations |
--scaling |
double | 2.0 |
(optional) the scaling factor for boundary estimation |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshFeaturesCortex
Compute cortical surface features of a mesh at each vertex
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | coord |
(optional) the mesh attribute |
--outer |
String | pial |
(optional) the outer pial mesh attribute |
--inner |
String | white |
(optional) the inner mesh attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
Citation: Winkler, A. M., Sabuncu, M. R., Yeo, B. T., Fischl, B., Greve, D. N., Kochunov, P., … & Glahn, D. C. (2012). Measuring and comparing brain cortical surface area and other areal quantities. Neuroimage, 61(4), 1428-1443.
MeshFlipNormals
Flip the normals of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshForceCortex
Compute the force field of a cortical mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
--refvolume |
Volume | (optional) input reference volume (exclusive with refmask) |
--refmask |
Mask | (optional) input reference mask (exclusive with refvolume) |
--lookup |
Table | (optional) input lookup table (must store the index and name of each label) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pial |
String | pial |
(optional) pial attribute name |
--white |
String | white |
(optional) white attribute name |
--parc |
String | aparc |
(optional) parcellation attribute name |
--which |
String | (optional) only process certain parcellation labels (by default all will be processed) | |
--mindist |
double | 1.0 |
(optional) the minimum white-pial to be included |
--samples |
int | 15 |
(optional) the number of points to sample |
--inner |
double | 2.0 |
(optional) the inner buffer size |
--outer |
double | 2.0 |
(optional) the outer buffer size |
--nofill |
flag | (optional) skip the filling step | |
--smooth |
flag | (optional) apply fiber smoothing after projection | |
--threads |
int | 1 |
(optional) the number of threads |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | name |
(optional) the name field in the lookup table |
--index |
String | index |
(optional) the index field in the lookup table |
--sigma |
Double | (optional) apply smoothing with the given amount (bandwidth in mm) (default is largest voxel dimension) | |
--support |
int | 3 |
(optional) the smoothing filter radius in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output vectors |
--labels |
Mask | (optional) the output labels |
MeshGetVects
Extract a mesh vertex attribute as vectors
Input:
| Flag | Type | Description |
|---|---|---|
--mesh |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | attr |
(optional) the destination attribute name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output mesh |
MeshGrow
Grow a mesh to fill a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
--reference |
Volume | the reference volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--source |
String | coord |
(optional) the source vertex attribute (default is the vertex position) |
--dest |
String | shell |
(optional) the destination vertex attribute (the result will be saved here) |
--dist |
String | dist |
(optional) the distance to the best match (the result will be saved here) |
--threshold |
double | 0.5 |
(optional) the threshold |
--distance |
double | 20.0 |
(optional) the maximums distance to search |
--step |
double | 0.25 |
(optional) the maximums distance to search |
--invert |
flag | (optional) detect and increase past the threshold (the default is to detect the drop) | |
--outside |
flag | (optional) search inside the mesh (the default is to search outside) | |
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshHoleFill
Fill holes in a mesh. This can be applied to either the entire mesh or a selection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshHull
Compute the convex hull of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output hull mesh |
Citation: Barber, C. B., Dobkin, D. P., & Huhdanpaa, H. (1996). The quickhull algorithm for convex hulls. ACM Transactions on Mathematical Software (TOMS), 22(4), 469-483.
MeshMapSphere
Convert a mesh between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--preiters |
int | 100 |
(optional) the world space Laplacian smoothing iterations |
--iters |
int | 100 |
(optional) the Laplacian smoothing iterations |
--lambmin |
double | 0.1 |
(optional) the minimum Laplacian smoothing rate |
--lambmax |
double | 0.5 |
(optional) the maximum Laplacian smoothing rate |
--gain |
double | 5.0 |
(optional) the curvature gain |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshMath
Evaluate an expression at each vertex of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | x > 0.5 |
(optional) the expression to evaluate |
--result |
String | result |
(optional) the attribute name for the result |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshMeasure
Measure global properties of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MeshMeasureRegion
Measure regional attributes properties of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
--lookup |
Table | (optional) input lookup table |
--labels |
Vects | (optional) add the following per-vertex labeling to use for computing region statistics |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | compute statistics of the following attributes (a comma-delimited list can be used) | |
--output |
String | output directory | |
--label |
String | label |
(optional) use the given vertex attribute to identify regions and compute statistics |
--lutname |
String | name |
(optional) the lookup name field |
--lutindex |
String | index |
(optional) the lookup index field |
--outname |
String | name |
(optional) the output name field |
--outvalue |
String | value |
(optional) the output value field |
MeshNormals
Compute vertex normals of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | coord |
(optional) the mesh attribute |
--smooth |
int | 0 |
(optional) the number of smoothing iterations |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshPrintInfo
Print basic information about a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--stats |
flag | (optional) print statistics | |
--area |
flag | (optional) print statistics of triangle areas |
MeshResampleSphere
Resample a spherically parameterized mesh using a new spherical triangulation
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh to be resampled |
--reference |
Mesh | reference spherical mesh with the new triangulation |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--inputSphereAttr |
String | sphere |
(optional) the input mesh spherical coordinate attribute |
--refSphereAttr |
String | coord |
(optional) the reference mesh spherical coordinate attribute |
--labels |
String | `` | (optional) a comma-separated list of input attributes that are discrete labels (if any) |
--skips |
String | `` | (optional) a comma-separated list of the input attributes that should be skipped (if any) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshSample
Sample a volume at input vertices
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input input |
--volume |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--interp |
InterpolationType | Trilinear |
(optional) interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
--coord |
String | coord |
(optional) coord attribute name (used for sampling volume) |
--attr |
String | sampled |
(optional) output attribute name (where the sampled image data will be stored) |
--window |
Double | (optional) compute a statistical summary of image intensities sampled along points within a certain window of each vertex (units: mm), sampled along the surface normal direction | |
--sample |
MeshSampleDirection | Both |
(optional) compute the statistical summary in a given direction (default is both inside and outside the mesh) (Options: Both, Inside, Outside) |
--stat |
MeshSampleStatistic | Mean |
(optional) use the given statistic for summarizing the vertex window (Options: Mean, Min, Max) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshSelect
Select vertices of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
--solids |
Solids | (optional) some solids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--boundary |
flag | (optional) select the boundary | |
--invert |
flag | (optional) invert the selection | |
--attr |
String | selection |
(optional) the selection attribute |
--value |
double | 1.0 |
(optional) the selection value |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshSetTable
Create a table listing regions of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--mesh |
Mesh | input mesh |
--table |
Table | input table |
--lookup |
Table | (optional) a lookup table to relate names to indices |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--merge |
String | name |
(optional) a field name to merge on |
--index |
String | index |
(optional) the table index field name |
--value |
String | value |
(optional) a table field to get (can be comma delimited) |
--mindex |
String | (optional) the mesh index field name (defaults to table index field name) | |
--mvalue |
String | (optional) the mesh value field name (defaults to table value field name) | |
--background |
double | 0.0 |
(optional) a background value |
--missing |
Double | (optional) an missing value | |
--remove |
flag | (optional) remove triangles with vertices that are not included in the input table |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshSetVects
Add vects as an attribute on a mesh (number of vects must match the number of vertices)
Input:
| Flag | Type | Description |
|---|---|---|
--mesh |
Mesh | input mesh |
--vects |
Vects | input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | attr |
(optional) the destination attribute name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshSimplify
Simplify a input by removing short edges
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--maxiter |
Integer | 10000 |
(optional) maxima number of iterations |
--maxvert |
Integer | (optional) maxima number of vertices | |
--maxedge |
Integer | (optional) maxima number of edges | |
--maxface |
Integer | (optional) maxima number of faces | |
--meanarea |
Double | (optional) maxima average face surface area | |
--nobound |
flag | (optional) do not remove boundary vertices | |
--chatty |
flag | (optional) print messages |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshSmooth
Smooth a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attr |
String | coord |
(optional) the attribute to smooth |
--attrout |
String | (optional) the output attribute names (if none, the input is replaced) | |
--num |
int | 5 |
(optional) a number of iterations |
--lambda |
Double | 0.3 |
(optional) the lambda laplacian smoothing parameter |
--mu |
Double | (optional) the optional mu parameter for Taubin’s method |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
Citation: Taubin, G. (1995, September). A signal processing approach to fair surface design. In Proceedings of the 22nd annual conference on Computer graphics and interactive techniques (pp. 351-358). ACM.
MeshSubdivide
Subdivide a mesh. Each triangle is split into four with new vertices that split each edge in two.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | the input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) a number of subdivisions |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
MeshTable
Create a table from mesh vertex attributes
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--vertices |
String | (optional) which vertices retain (comma separated) | |
--which |
String | coord |
(optional) which attributes to retain (comma separated) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
MeshTransform
Transform a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
--pose |
Volume | (optional) apply a transform to match the pose of a volume |
--invpose |
Volume | (optional) apply a transform to match the inverse pose of a volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--attrs |
String | coord |
(optional) a comma-separated list of attributes to transform |
--tx |
Double | (optional) translate the mesh in by the given about in the x dimension | |
--ty |
Double | (optional) translate the mesh in by the given about in the y dimension | |
--tz |
Double | (optional) translate the mesh in by the given about in the z dimension | |
--sx |
Double | (optional) scale the mesh in by the given about in the x dimension | |
--sy |
Double | (optional) scale the mesh in by the given about in the y dimension | |
--sz |
Double | (optional) scale the mesh in by the given about in the z dimension |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
MeshVertices
Extract the vertices of a mesh
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input mesh |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attribute |
String | coord |
(optional) attribute to extract |
--query |
String | label |
(optional) an attribute to query |
--value |
Integer | (optional) an integer value to query | |
--nonzero |
flag | (optional) select only vertices that have a non-zero query attribute |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
MeshVoxelize
Voxelize a mesh to a mask (should be watertight if the mesh is also)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Mesh | input input |
--reference |
Mask | reference mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--label |
Integer | 1 |
(optional) a label to draw |
--attr |
String | (optional) a attribute to draw (instead of the constant label) | |
--coord |
String | coord |
(optional) the coordinate attribute to use (not applicable when specifying inner and outer shells) |
--innerAttr |
String | (optional) label vertices in a shell between an inner and outer spatial attribute, e.g. like white and pial cortical surfaces | |
--outerAttr |
String | (optional) label vertices in a shell between an inner and outer spatial attribute, e.g. like white and pial cortical surfaces | |
--innerBuffer |
Double | (optional) label vertices in a shell between this attribute and the primary one, e.g. like white and pial cortical surfaces | |
--outerBuffer |
Double | (optional) label vertices in a shell between this attribute and the primary one, e.g. like white and pial cortical surfaces | |
--fill |
flag | (optional) fill the inside of the mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output mask |
NeuronCatPair
Combine two neurons into a single object
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Neuron | the input left neuron |
--right |
Neuron | the input right neuron |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Neuron | output neuron |
NeuronCrossing
Detect the crossing points between two neurons
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Neuron | the input left neuron |
--right |
Neuron | the input right neuron |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--thresh |
Double | (optional) the minimum distance to be considered a crossing (by default it will be the average inter-node distance) | |
--mode |
NeuronCrossingMode | Mean |
(optional) specify a statistic for computing the threshold (not relevant if you provide a specific value) (Options: Min, Max, Mean) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
NeuronExport
Export a neuron file to vects and curves
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the input filename to the SWC neuron file |
Output:
| Flag | Type | Description |
|---|---|---|
--outputRoots |
Vects | (optional) output roots |
--outputForks |
Vects | (optional) output forks |
--outputLeaves |
Vects | (optional) output leaves |
--outputForest |
Curves | (optional) output forest |
NeuronFilter
Filter a neuron
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the input neuron |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--which |
String | (optional) select only the neurons with the given root labels (comma-separated list) | |
--laplacianIters |
Integer | (optional) apply laplacian smoothing the given number of times | |
--laplacianLambda |
Double | 0.25 |
(optional) the smoothing weight for laplacian smoothing (only relevant if smoothing is enabled) |
--lowessNum |
Integer | (optional) apply lowess smoothing with the given neighborhood size, e.g. 5 | |
--lowessOrder |
Integer | 2 |
(optional) apply lowess smoothing with the given local polynomial order |
--simplify |
Double | (optional) simplify the neuron segments with the Douglas-Peucker algorithm | |
--cut |
Double | (optional) cut away the portion of the neuron past the given Euclidean distance away from the root |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--relabel |
flag | (optional) relabel the nodes to be sequential | |
--sort |
flag | (optional) perform a topological sorting of nodes | |
--debase |
flag | (optional) separate the basal dendrite (detected by the soma branch with the farthest reach) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Neuron | output neuron |
NeuronMeasure
Measure statistics of a neuron file
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the input neuron |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--single |
flag | (optional) include statistics for single neurons |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
NeuronMesh
Create a mesh from a neuron file
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the input filename to the SWC neuron file |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--noRootMesh |
flag | (optional) exclude sphere meshes for roots | |
--noForkMesh |
flag | (optional) exclude sphere meshes for forks | |
--noLeafMesh |
flag | (optional) exclude sphere meshes for leaves | |
--noTrunkMesh |
flag | (optional) exclude tube meshes for trunks | |
--noSphereSculpt |
flag | (optional) use constant radius for spheres (the default will modulate the thickness by the neuron radius) | |
--noTrunkSculpt |
flag | (optional) use constant thickness tubes (the default will modulate the thickness by the neuron radius) | |
--trunkColorMode |
TrunkColorMode | Solid |
(optional) the coloring mode for trunks (Options: Solid, DEC, Segment, Tree) |
--rootScale |
double | 1.0 |
(optional) the size of root spheres |
--forkScale |
double | 1.0 |
(optional) the size of fork spheres |
--leafScale |
double | 1.0 |
(optional) the size of leaf spheres |
--trunkScale |
double | 1.0 |
(optional) the size of trunk tubes |
--rootColor |
SolidColor | Orange |
(optional) the color of root spheres (Options: White, Cyan, Yellow, Blue, Magenta, Orange, Green, Pink, GRAY, DarkGray, LightGray) |
--forkColor |
SolidColor | Cyan |
(optional) the color of fork spheres (Options: White, Cyan, Yellow, Blue, Magenta, Orange, Green, Pink, GRAY, DarkGray, LightGray) |
--leafColor |
SolidColor | Yellow |
(optional) the color of leaf spheres (Options: White, Cyan, Yellow, Blue, Magenta, Orange, Green, Pink, GRAY, DarkGray, LightGray) |
--trunkColor |
SolidColor | White |
(optional) the color of trunk tubes (if the coloring mode is solid) (Options: White, Cyan, Yellow, Blue, Magenta, Orange, Green, Pink, GRAY, DarkGray, LightGray) |
--noColor |
flag | (optional) remove all colors (and invalidates any other color options) | |
--sphereResolution |
int | 0 |
(optional) the resolution of the spheres i.e. the number of subdivisions, so be careful with values above 3 |
--tubeResolution |
int | 5 |
(optional) the resolution of the tubes, i.e. the number of radial spokes |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
NeuronPrintInfo
Measure statistics of a neuron file
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the input neuron |
NeuronSplit
Split a SWC file to produce a single file per neuron
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the input neuron |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--output |
String | output filename (if you include %d, it will be substituted with the root label, otherwise it will be renamed automatically) | |
--root |
flag | (optional) use the root neuron label for naming the output file (i.e. the number substituted for %d) |
NeuronStitch
Perform stitching to build neuron segments into a complete neuron. The neuron will be split into pieces and rebuilt.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the input neuron |
--somas |
Solids | (optional) a solids object for manually defining somas for stitching, e.g. each box and sphere will define a region for building somas (only used when the soma mode is Manual) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--mode |
NeuronStitchSomaMode | RadiusMax |
(optional) choose a mode for selecting the soma(s). Manual selection is for user-defined soma (from a solids object passed to the somas option). RadiusMax is for choosing the soma from the node with the largest radius. Cluster is for detecting the soma by clustering endpoints and finding the largest cluster (depends on the cluster option for defining the cluster spatial extent) (Options: Manual, RadiusMax, Cluster) |
--threshold |
Double | (optional) a maximum distance for stitching together segments. If two segments are farther than this distance, they will not be stitched (default is to stitch everything | |
--cluster |
Double | (optional) a specific radius for cluster-based soma selection (only used for the Cluster soma detection mode) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Neuron | output neuron |
NeuronTransform
Apply a spatial transformation to a neuron
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Neuron | the neuron |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--xshift |
double | 0.0 |
(optional) translate the neuron position in x by the given amount |
--yshift |
double | 0.0 |
(optional) translate the neuron position in y by the given amount |
--zshift |
double | 0.0 |
(optional) translate the neuron position in z by the given amount |
--xscale |
double | 1.0 |
(optional) scale the neuron position in x by the given amount |
--yscale |
double | 1.0 |
(optional) scale the neuron position in y by the given amount |
--zscale |
double | 1.0 |
(optional) scale the neuron position in z by the given amount |
--rshift |
double | 0.0 |
(optional) add the given amount to the radius |
--rscale |
double | 1.0 |
(optional) scale the neuron radius by the given amount |
--rset |
Double | (optional) set the radius to a constant value | |
--jitter |
Double | (optional) jitter the position of the nodes by a random amount | |
--jitterEnds |
flag | (optional) jitter only leaves and roots | |
--swap |
String | (optional) swap a pair of coordinates (xy, xz, or yz) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Neuron | output neuron |
SolidsBox
Compute the bounding box of solids
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Solids | input solids |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output bounding box |
SolidsCat
Concatenate solids
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Solids | input solids |
--right |
Solids | input solids |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output solids |
SolidsConvert
Convert solids between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Solids | input solids |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output sphere |
SolidsCreateBox
Create a soilds object containing a box
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--xmin |
double | 0.0 |
(optional) a box minima value in x |
--ymin |
double | 0.0 |
(optional) a box minima in y |
--zmin |
double | 0.0 |
(optional) a box minima in z |
--xmax |
double | 1.0 |
(optional) a box maxima value in x |
--ymax |
double | 1.0 |
(optional) a box maxima in y |
--zmax |
double | 1.0 |
(optional) a box maxima in z |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output solids |
SolidsCreateEmpty
Create an empty soilds object
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output solids |
SolidsCreatePlane
Create a soilds object containing a plane
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--xpoint |
double | 0.0 |
(optional) the x coordinate of a point on the plane |
--ypoint |
double | 0.0 |
(optional) the y coordinate of a point on the plane |
--zpoint |
double | 0.0 |
(optional) the z coordinate of a point on the plane |
--xnormal |
double | 0.0 |
(optional) the x coordinate of the plane normal |
--ynormal |
double | 0.0 |
(optional) the y coordinate of the plane normal |
--znormal |
double | 0.0 |
(optional) the z coordinate of the plane normal |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output solids |
SolidsCreateSphere
Create a soilds object containing a sphere
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--x |
double | 0.0 |
(optional) a sphere x center |
--y |
double | 0.0 |
(optional) a sphere y center |
--z |
double | 0.0 |
(optional) a sphere z center |
--radius |
double | 10.0 |
(optional) a sphere radius |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output solids |
SolidsMask
Create a mask from solids
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Solids | input solids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dx |
double | 1.0 |
(optional) sample spacing in x |
--dy |
double | 1.0 |
(optional) sample spacing in x |
--dz |
double | 1.0 |
(optional) sample spacing in x |
--label |
int | 1 |
(optional) label |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
SolidsMesh
Create a mask from solids
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Solids | input solids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
double | 1.0 |
(optional) the voxel resolution for discretization |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
SolidsPrintInfo
Print basic information about a solids
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Solids | the input solids |
SolidsSample
Sample vects inside solids
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Solids | input solids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 100 |
(optional) the number of points to sample |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output sampled vects |
SolidsToWaypoints
Create a waypoint mask from two solids
Input:
| Flag | Type | Description |
|---|---|---|
--a |
Solids | first input set of solids |
--b |
Solids | second input set of solids |
--ref |
Mask | input reference mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output waypoint mask |
TableCat
Concatenate the rows of two tables. By default, it will only include fields that are common to both input tables.
Input:
| Flag | Type | Description |
|---|---|---|
--x |
Table | (optional) input first table |
--y |
Table | (optional) input second table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--outer |
flag | (optional) include all possible fields |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableConvert
Convert a table between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableDistanceMatrix
Create a distance matrix from pairs of distances
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table (should have field for the left and right identifiers) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--left |
String | left |
(optional) the identifier for left values |
--right |
String | right |
(optional) the identifier for right values |
--value |
String | value |
(optional) the identifier for right values |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableFilter
Filter a table, a few options are available
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
--volumes |
Table | add a field for the mean value based on a table of volumes for each field (this is an unusual need) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--meanField |
String | mean |
(optional) the name of the field for saving the mean value |
--mergeField |
String | subject |
(optional) the name of the field for merging tables |
--missing |
String | NA |
(optional) a token for missing values |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableHemiMean
Compute the left-right average of a lateralized dataset
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table (should use the naming convention like the module parameters) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--left |
String | lh_ |
(optional) the identifier for left values |
--right |
String | rh_ |
(optional) the identifier for right values |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableLaterality
Compute the lateralization index of a given map. This assumes you have a two column table (name,value) that contains left and right measurements (see module parameters to specify the left/right identifiers)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table (should use the naming convention like the module parameters) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--left |
String | lh_ |
(optional) the identifier for left values |
--right |
String | rh_ |
(optional) the identifier for right values |
--indlat |
String | indlat_ |
(optional) the identifier for the lateralization index |
--abslat |
String | abslat_ |
(optional) the identifier for the absolute lateralization index |
--unilat |
String | unilat_ |
(optional) the identifier for the unilateral averaging |
--minlat |
String | minlat_ |
(optional) the identifier for the left right minimum |
--maxlat |
String | maxlat_ |
(optional) the identifier for the left right maximum |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableLateralityIndex
Compute the lateralization index of a given map. This assumes you have a two column table (name,value) that contains left and right measurements (see module parameters to specify the left/right identifiers)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table (should use the naming convention like the module parameters) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | name |
(optional) the field holding the name of the measurement |
--value |
String | value |
(optional) the field holding the value of the measurement |
--left |
String | lh_ |
(optional) the identifier for left values |
--right |
String | rh_ |
(optional) the identifier for right values |
--lat |
String | lat_ |
(optional) the identifier for the lateralization index |
--abslat |
String | abslat_ |
(optional) the identifier for the absolute lateralization index |
--mean |
String | mean_ |
(optional) the identifier for the left-right average |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableMapMath
Evaluate an expression with a map (a table listing name/value pairs)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | the input table map |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | x > 0.5 |
(optional) the expression to evaluate |
--name |
String | name |
(optional) the field name for the name |
--value |
String | value |
(optional) the field name for the value |
--result |
String | result |
(optional) the name of the result |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableMath
Evaluate an expression for each row of a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | the input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | x > 0.5 |
(optional) the expression to evaluate |
--result |
String | result |
(optional) the field name for the result |
--na |
String | NA |
(optional) the string used for invalid values |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableMerge
Merge two tables based the value of a shared field
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Table | input left table |
--right |
Table | input right table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--field |
String | name |
(optional) the common field to merge on |
--leftPrefix |
String | `` | (optional) add a prefix to the fields from the left table |
--rightPrefix |
String | `` | (optional) add a prefix to the fields from the right table |
--leftPostfix |
String | `` | (optional) add a postfix to the fields from the left table |
--rightPostfix |
String | `` | (optional) add a postfix to the fields from the right table |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--leftField |
String | (optional) use the given left field (instead of the shared merge field) | |
--rightField |
String | (optional) use the given right field (instead of the shared merge field) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableNarrow
Narrow a table to reduce the number of fields
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | name |
(optional) the new field for each field name |
--value |
String | value |
(optional) the new field for each field value |
--keep |
String | (optional) fields to keep (comma separated) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableOutliers
Compute z-scores to detect outliers in a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TablePrintData
Print data from a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | the input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--where |
String | (optional) an predicate for selecting records (using existing field names) | |
--name |
String | name |
(optional) the name variable for use in the select predicate |
--sort |
String | (optional) sort by fields (e.g. field2,#field3,^#field1). ‘#’ indicates the value is numeric, and ‘^’ indicates the sorting should be reversed | |
--retain |
String | (optional) retain only specific fields (comma delimited) | |
--remove |
String | (optional) remove specific fields (comma delimited) | |
--tab |
flag | (optional) use tabs | |
--header |
flag | (optional) print the header | |
--na |
String | NA |
(optional) use the given string for missing values |
TablePrintInfo
Print basic information about a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | the input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--na |
String | NA |
(optional) specify the token for identifying missing values |
--field |
String | (optional) only print values from the given field (specify either the field index or name) | |
--pattern |
String | (optional) print a pattern for each line, e.g. ‘${fieldA} and ${fieldB} | |
--indexed |
flag | (optional) print the row index |
TableReliability
Compute reproducibility statistics from repeated measures
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--value |
String | value |
(optional) the field to summarize |
--id |
String | (optional) fields for identifying repeated measures (comma separated) | |
--group |
String | (optional) fields to group records by (comma separated) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableScoreZ
Compute summary statistics of a field of a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--value |
String | value |
(optional) the field to summarize |
--absolute |
flag | (optional) report the absolute value of the z-score | |
--group |
String | (optional) fields to group records by (comma separated) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableSelect
Select columns from a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--where |
String | (optional) an predicate for selecting records (using existing field names) | |
--sort |
String | (optional) sort by fields (e.g. field2,#field3,^#field1). ‘#’ indicates the value is numeric, and ‘^’ indicates the sorting should be reversed | |
--unique |
String | (optional) select a unique set from the given fields (comma delimited) | |
--retain |
String | (optional) include only specific fields (comma delimited regular expressions) | |
--remove |
String | (optional) exclude specific fields (comma delimited regular expressions) | |
--rename |
String | (optional) an renaming of fields (e.g. newfield=oldfield) | |
--dempty |
flag | (optional) delete fields with an empty name | |
--cat |
String | (optional) concatenate existing fields into a new one, e.g. newfield=%{fieldA}_%{fieldB} | |
--constant |
String | (optional) add a constant field (e.g. newfield=value,newfield2=value2) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableSplitAlong
Split the name field from along tract analysis
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | name |
(optional) the field to split |
--bundle |
String | bundle |
(optional) the name of the new bundle field |
--index |
String | index |
(optional) the name of the new index field |
--delimiter |
String | _ |
(optional) the delimiter |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableStats
Compute summary statistics of a field of a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--value |
String | value |
(optional) the field to summarize |
--group |
String | (optional) fields to group records by (comma separated) | |
--pattern |
String | %s |
(optional) a pattern for saving statistics (contains %s) |
--which |
String | mean,std |
(optional) which statistics to include (mean, min, max, sum, var, std, num, cv) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableSubjectMatch
Match subjects into pairs. You should provide a field that stores a binary variable on which to split. The smaller group will be paired with subjects from the bigger group, and optionally, the pairing can be optimized to maximize similarity between paired individuals based on a number of scalar and discrete variables
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--subject |
String | subject |
(optional) the field specifying the subject identifier |
--split |
String | subject |
(optional) the field for splitting the group (should be binary) |
--na |
String | NA |
(optional) a token for specifying missing data |
--distance |
String | distance |
(optional) the field name for distance in the output |
--scalar |
String | `` | (optional) scalar fields to include when computing subject distances (comma separated list) |
--discrete |
String | `` | (optional) discrete fields to include when computing subject distances (comma separated list) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
TableSynth
Synthesize data based on a reference dataset
Input:
| Flag | Type | Description |
|---|---|---|
--reference |
Table | input reference table |
--sample |
Table | input sample table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--group |
String | (optional) an optional list of variables (comma-separated) of variables for grouping | |
--scalar |
String | (optional) specify the scalar-valued fields (floating point) | |
--discrete |
String | (optional) specify the discrete-valued fields (integers) | |
--factor |
String | (optional) specify the categorical-valued fields (factors) | |
--missing |
flag | (optional) synthesize missing data | |
--na |
String | NA |
(optional) specify a missing value token |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output synthesized table |
TableVolume
Map tabular data to a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
--reference |
Mask | a reference mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--vector |
flag | (optional) read vector values | |
--voxel |
String | index |
(optional) index |
--value |
String | value |
(optional) value |
--na |
double | 0.0 |
(optional) a value to substitute for NAs |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
TableWiden
Widen a table to expand a single field to many
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | name |
(optional) the field name to expand |
--value |
String | value |
(optional) the field value to expand |
--pattern |
String | %s_%s |
(optional) pattern for joining names |
--na |
String | NA |
(optional) the value used for missing entries |
--include |
String | (optional) include fields | |
--exclude |
String | (optional) exclude fields |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
VectsAlignAxis
Compute an affine transform to align a set of points to the z-axis
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects (should be roughly linear |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine transform |
VectsBox
Get the bounding box of vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output bounding box |
VectsCat
Concatenate two sets of vectors into one
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
--cat |
Vects | vects to concatenate |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dims |
flag | (optional) concatenate dimensions (instead of vects) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output concatenated vects |
VectsClusterKMeans
Cluster vects using k-means or DP-means clustering
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | the input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--k |
Integer | 3 |
(optional) none |
--lambda |
Double | (optional) none | |
--maxiter |
Integer | 300 |
(optional) none |
Output:
| Flag | Type | Description |
|---|---|---|
--centers |
Vects | (optional) the output cluster centeres |
--output |
Vects | (optional) the output clustered vects (last coordinate stores label) |
VectsConvert
Convert vects between file formats
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
VectsCreate
Create vects
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
VectsCreateSphere
Create vects that lie on a sphere by subdividing an icosahedron
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--subdiv |
int | 3 |
(optional) the number of subdivisions of the sphere |
--smooth |
Integer | (optional) the number of smoothing iterations | |
--points |
Integer | (optional) reduce the point count |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
VectsCreateSphereLookup
Create a set of uniformly distributed spherical points from a lookup table
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
VectsDistances
Compute the pairwise distance matrix of a set of vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Matrix | output distance matrix |
VectsFuseKernel
Fuse a collection of vectors using kernel regression
Input:
| Flag | Type | Description |
|---|---|---|
--table |
Table | (optional) input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | an input pattern (must contain %s for case identifier) | |
--output |
String | output file pattern (must include a %s) | |
--id |
String | id |
(optional) the name of the case identifier (the table should have a column by this name) |
--scalar |
String | (optional) the continuous variable, if none is provided then no sampling is performed | |
--samples |
String | 1,2,3,4,5,6,7,8,9,10 |
(optional) the values for scalar variable sampling |
--sigma |
double | 5.0 |
(optional) the bandwidth for scalar variable sampling |
VectsHistogram
Compute a histogram of a vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | the input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channel |
int | 0 |
(optional) the channel to use |
--bins |
int | 100 |
(optional) the number of bins |
--lower |
Bound | Extrema |
(optional) the method for computing the histogram lower bound (Options: Extrema, Quartile, HalfStd, OneStd, TwoStd, ThreeStd, User) |
--upper |
Bound | Extrema |
(optional) the method for computing the histogram upper bound (Options: Extrema, Quartile, HalfStd, OneStd, TwoStd, ThreeStd, User) |
--mylower |
Double | (optional) specify a specific lower bound for user defined mode | |
--myupper |
Double | (optional) specify a specific upper bound for user defined mode | |
--normalize |
flag | (optional) normalize the counts by the total count | |
--cdf |
flag | (optional) compute the cdf | |
--smooth |
Double | (optional) apply Gaussian smoothing (see hdata) | |
--hdata |
flag | (optional) interpret the smoothing parameter relative to the data intensities (default is bins) | |
--print |
flag | (optional) print a the histogram to standard output |
VectsHull
Compute the convex hull of vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output convex hull |
Citation: Barber, C. B., Dobkin, D. P., & Huhdanpaa, H. (1996). The quickhull algorithm for convex hulls. ACM Transactions on Mathematical Software (TOMS), 22(4), 469-483.
VectsJitter
Jitter vects with isotropic Gaussian random displacements
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--multiplier |
int | 1 |
(optional) the number of multiples to include |
--std |
double | 1.0 |
(optional) the number of samples to take |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output subsampled vects |
VectsMath
Evaluate an expression at each vector
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | the input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | mean(v) |
(optional) the expression to evaluate |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output vects |
VectsMeasureRegion
Measure regional of a set of labeled vectors
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
--lookup |
Table | (optional) input lookup table |
--labels |
Vects | (optional) add the following per-vertex labeling to use for computing region statistics |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--output |
String | output directory | |
--name |
String | name |
(optional) the name of the input data |
--lutname |
String | name |
(optional) the lookup name field |
--lutindex |
String | index |
(optional) the lookup index field |
--outname |
String | name |
(optional) the output name field |
--outvalue |
String | value |
(optional) the output value field |
VectsMeshLaplacian
Filter a vects dataset originating form from a mesh with a laplacian filter
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | the input vector data |
--mesh |
Mesh | the reference mesh (vertices correspond to input) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 5 |
(optional) a number of iterations |
--lambda |
Double | 0.3 |
(optional) the lambda laplacian filtering parameter |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | the output smoothed data |
VectsModeMeanShift
Compute the positions of modes of vectors using the mean shift algorithm
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--bandwidth |
Double | 1.0 |
(optional) the spatial bandwidth |
--minshift |
Double | 1.0E-6 |
(optional) the error threshold for convergence |
--maxiter |
Integer | 10000 |
(optional) the maximum number of iterations |
Output:
| Flag | Type | Description |
|---|---|---|
--masses |
Vects | output masses |
--modes |
Vects | output modes |
Citation: Comaniciu, D., & Meer, P. (2002). Mean shift: A robust approach toward feature space analysis. IEEE Transactions on pattern analysis and machine intelligence, 24(5), 603-619.
VectsPCA
Perform principal component analysis on vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | the input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--top |
Integer | (optional) none |
Output:
| Flag | Type | Description |
|---|---|---|
--mean |
Vects | (optional) the output mean vect |
--comps |
Vects | (optional) the output principal components |
--vals |
Vects | (optional) the output principal values |
--output |
Vects | (optional) the output transformed vects |
VectsPrintInfo
Print basic information about vectors
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | the input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--stats |
flag | (optional) print statistics | |
--norm |
flag | (optional) print statistics of vect norms |
VectsReduce
Reduce the number of vectors in either a random or systematic way
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
Integer | (optional) the maxima number of samples | |
--fraction |
Double | (optional) the fraction of vects to remove (zero to one) | |
--which |
String | (optional) the list of indices to select | |
--exclude |
String | (optional) the list of indices to exclude |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output subsampled vects |
VectsRegisterLinear
Estimate a linear transform to register a given pair of vects. You can choose one of several methods to specify the degrees of freedom of the transform and how the transform parameters are estimated
Input:
| Flag | Type | Description |
|---|---|---|
--source |
Vects | input source vects |
--dest |
Vects | input dest vects (should match source) |
--weights |
Vects | (optional) input weights (only available for some methods) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
VectsRegisterLinearMethod | AffineLeastSquares |
(optional) the registration method (each has different degrees of freedom and estimation techniques) (Options: AffineLeastSquares, RigidDualQuaternion) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine transform mapping source to dest |
--transformed |
Vects | (optional) output transformed source vects (redundant, but useful for validation) |
VectsRegisterRigidDualQuaternion
Estimate a rigid transform using the dual quaterionion method. This assumes point-to-point correspondence between vects.
Input:
| Flag | Type | Description |
|---|---|---|
--source |
Vects | input source vects |
--dest |
Vects | input dest vects (should match source) |
--weights |
Vects | (optional) input weights |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine transform mapping source to dest |
--transformed |
Vects | (optional) output transformed source vects (redundant, but useful for validation) |
Citation: Walker, Michael W., Lejun Shao, and Richard A. Volz. “Estimating 3-D location parameters using dual number quaternions.” CVGIP: image understanding 54.3 (1991): 358-367.
VectsSample
Sample a volume at a set of points
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input 3D coordinates |
--volume |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--interp |
InterpolationType | Trilinear |
(optional) interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | the output samples |
VectsSelect
Select a which of vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
--mask |
Mask | (optional) input mask |
--solids |
Solids | (optional) input solids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--or |
flag | (optional) use OR (instead of AND) to combine selections | |
--invert |
flag | (optional) invert the selection after combining |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output selected vects |
VectsSpheres
Create spheres from vects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--radius |
double | 1.0 |
(optional) the sphere radius |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output solid spheres |
VectsSurfaceWarp
Warp vects that are defined on a surface
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
--mesh |
Mesh | input mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output transformed vects |
VectsTransform
Transform vects. (note: the order of operations is transpose, flip, swap, perm, affine)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Vects | input vects |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--rows |
flag | (optional) force rows > cols | |
--cols |
flag | (optional) force cols > rows | |
--transpose |
flag | (optional) transpose | |
--subset |
String | (optional) which the coordinates | |
--flip |
String | (optional) flip a coodinate (x, y, or z) | |
--swap |
String | (optional) swap a pair of coordinates (xy, xz, or yz) | |
--perm |
String | (optional) permute by coordinate index, e.g. 1,0,2 | |
--negate |
flag | (optional) negative the vectors | |
--normalize |
flag | (optional) normalize |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | output transformed vects |
VolumeBiHistogram
Compute a histogram of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--x |
Volume | the volume for the x-dimension |
--y |
Volume | the volume for the y-dimension |
--mask |
Mask | (optional) an input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--xbins |
int | 100 |
(optional) the number of bins in x |
--ybins |
int | 100 |
(optional) the number of bins in y |
--smooth |
Double | (optional) apply smoothing by the given amount | |
--exclude |
flag | (optional) exclude counts outside the histogram range | |
--xmin |
Double | (optional) the minimum in x | |
--ymin |
Double | (optional) the minimum in y | |
--xmax |
Double | (optional) the maximum in x | |
--ymax |
Double | (optional) the maximum in y |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
--breaks |
Volume | (optional) output breaks |
--mapping |
Mask | (optional) output mapping |
VolumeBiTensorFit
Fit a bi-tensor volume to a diffusion-weighted MRI.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input diffusion-weighted MR volume |
--gradients |
Gradients | the gradients |
--mask |
Mask | (optional) the mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
BiTensorFitType | Isotropic |
(optional) specify an estimation method (Options: DTI, DTIFWE, Isotropic, FixedIsotropic, BothIsotropic, AlignedZeppelin, Zeppelin, Anisotropic) |
--cost |
CostType | SE |
(optional) specify a cost function for non-linear fitting (Options: SE, MSE, RMSE, NRMSE, CHISQ, RLL) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--shells |
String | (optional) specify a subset of gradient shells to include (comma-separated list of b-values) | |
--which |
String | (optional) specify a subset of gradients to include (comma-separated list of indices starting from zero) | |
--exclude |
String | (optional) specify a subset of gradients to exclude (comma-separated list of indices starting from zero) | |
--threads |
int | 1 |
(optional) the number of threads to use |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output bitensor volume (name output like *.bti and an directory of volumes will be created) |
VolumeBiTensorReduce
Reduce a bitensor volume to a single tensor volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input bitensor volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--fluid |
flag | (optional) return the fluid compartment (default is the tissue compartment) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threads |
int | 1 |
(optional) the number of threads to use |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output tensor volume |
VolumeBiTensorTransform
Spatially transform a bi-tensor volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--reference |
Volume | input reference volume |
--mask |
Mask | (optional) input mask |
--inputMask |
Mask | (optional) use an input mask (defined in the input space) |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--reorient |
ReorientationType | Jacobian |
(optional) specify a reorient method (fs or jac) (Options: FiniteStrain, Jacobian) |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--log |
flag | (optional) use log estimation |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output transformed tensor volume |
VolumeBox
Compute the bounding box of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Solids | output bounding box |
VolumeCat
Concatenate two volumes into one
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--cat |
Volume | volume to concatenate |
--mask |
Mask | (optional) input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output concatenated volume |
VolumeCenter
Voxel sizes and position of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input Volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--factor |
Double | input voxel dimension scaling factor |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | (optional) output Volume |
VolumeConform
Process a volume to conform to a given set of constraints
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--maxdi |
double | 1.0 |
(optional) the voxel size in i |
--maxdj |
double | 1.0 |
(optional) the voxel size in j |
--maxdk |
double | 1.0 |
(optional) the voxel size in k |
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeConvert
Convert a volume to a different format (only useful on command line)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--proto |
flag | (optional) only copy the structure, not the intensities |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output |
VolumeCreate
Create a volume based on user specified parameters
Input:
| Flag | Type | Description |
|---|---|---|
--reference |
Volume | (optional) an optional reference volume for setting the voxel grid |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channels |
int | 1 |
(optional) the number of channels |
--deltax |
double | 1.0 |
(optional) voxel spacing in x |
--deltay |
double | 1.0 |
(optional) voxel spacing in y |
--deltaz |
double | 1.0 |
(optional) voxel spacing in z |
--numx |
int | 128 |
(optional) number of voxels in x |
--numy |
int | 128 |
(optional) number of voxels in y |
--numz |
int | 128 |
(optional) number of voxels in z |
--startx |
double | 0.0 |
(optional) starting position in x |
--starty |
double | 0.0 |
(optional) starting position in y |
--startz |
double | 0.0 |
(optional) starting position in z |
--value |
double | 0.0 |
(optional) constant value |
--grid |
flag | (optional) draw a grid | |
--gridSpace |
int | 20 |
(optional) the grid spacing in voxels (number of voxels between grid lines) |
--gridThick |
int | 0 |
(optional) the grid thickness in voxels (diameter will be 2 * n + 1) |
--gridValue |
int | 1 |
(optional) the grid intensity |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeCrop
Crop a volume down to a smaller volume (only one criteria per run)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask |
--solids |
Solids | (optional) some soids |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--range |
String | (optional) a range specification, e.g. start:end,start:end,start:end | |
--thresh |
Double | (optional) crop out the background with a given threshold | |
--invert |
flag | (optional) invert the selection | |
--even |
flag | (optional) ensure the volume has even dimensions | |
--pad |
int | 0 |
(optional) a padding size in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeDeformationCompose
Compose a deformation field with an affine transform
Input:
| Flag | Type | Description |
|---|---|---|
--affine |
Affine | an affine transform |
--deform |
Volume | (optional) an deform deformation field |
--reference |
Volume | (optional) a reference image |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--invert |
flag | (optional) invert the affine transform | |
--reverse |
flag | (optional) reverse the order of the transforms |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output |
VolumeDifferenceMap
Summarize the difference between two image volumes
Input:
| Flag | Type | Description |
|---|---|---|
--left |
Volume | input left volume |
--right |
Volume | input right volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--prefix |
String | `` | (optional) a prefix for the output names |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | the table |
VolumeDownsample
Downsample a volume. Unlike VolumeZoom, this includes a prefiltering step with a triangle filter to reduce alias artifact
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--factor |
double | 2.0 |
(optional) an downsampling scaling factor |
--threads |
Integer | 3 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeDwiAdc
Compute the apparent mri coefficient (ADC) of the mri signal. The default output is the mean ADC, but per-gradient outputs can also be computed
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients |
--mask |
Mask | (optional) the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--component |
flag | (optional) compute the ADC for each gradient, otherwise the average will be computed |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output ADC volume |
VolumeDwiAverage
Average subvolumes from diffusion MRI. This is often used to improve the SNR when the scan includes repeats
Input:
| Flag | Type | Description |
|---|---|---|
--dwi |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients (must match input DWI) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--average |
String | (optional) a file or comma-separated list of integers specifying how the data should be grouped, e.g. 1,1,1,2,2,2,3,3,3,… |
Output:
| Flag | Type | Description |
|---|---|---|
--outputDwi |
Volume | the output dwi volume |
--outputGradients |
Gradients | (optional) the output gradients |
VolumeDwiBaseline
Extract baseline signal statistics from a diffusion-weighted MR volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients |
--mask |
Mask | (optional) the input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--mean |
Volume | (optional) the output mean baseline signal |
--median |
Volume | (optional) the output median baseline signal |
--var |
Volume | (optional) the output variance of baseline signal (only meaningful if there are multiple baselines) |
--std |
Volume | (optional) the output standard deviation of baseline signal (only meaningful if there are multiple baselines) |
--cat |
Volume | (optional) the output complete set of baseline signals |
--drift |
Volume | (optional) the output signal drift estimates (slope, stderr, tstat, pval, sig) measured by percentage change |
Citation: Vos, Sjoerd B., et al. “The importance of correcting for signal drift in diffusion MRI.” Magnetic resonance in medicine 77.1 (2017): 285-299.
VolumeDwiCleanMask
Clean a brain mask to remove background voxels
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients (must match input DWI) |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--depth |
int | 2 |
(optional) cleaning depth from the boundary |
--threshold |
Double | 1.5 |
(optional) the threshold (multiplier for inter-quartile range) |
--nomode |
flag | (optional) skip mode filtering | |
--threads |
Integer | 1 |
(optional) the number of threads to use |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output mask |
VolumeDwiCorrectDrift
Correct for signal drift in a diffusion-weighted MR volume using a polynomial model
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients |
--mask |
Mask | (optional) the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--global |
flag | (optional) use global drift estimation | |
--local |
flag | (optional) use local drift estimation | |
--iso |
flag | (optional) use isotropic drift estimation | |
--blend |
flag | (optional) use blended drift estimation | |
--order |
int | 2 |
(optional) the order of the polynomial model |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output corrected dwi |
Citation: Vos, Sjoerd B., et al. “The importance of correcting for signal drift in diffusion MRI.” Magnetic resonance in medicine 77.1 (2017): 285-299.
VolumeDwiEstimateNoise
Estimate the noise parameter from the baselines of a DWI
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input dwi |
--gradients |
Gradients | input gradients |
--mask |
Mask | (optional) input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output error volume |
VolumeDwiFeature
Compute features of the the diffusion weighted signal. These features are statistical summaries of the signal within and across shells (depending on the method), mostly avoiding any modeling assumptions
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients |
--mask |
Mask | (optional) the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--feature |
VolumeDwiFeatureType | AnisoCoeffVar |
(optional) the method for computing anisotropy (Options: Attenuation, AnisoCoeffVar, AnisoStd, AnisoMu, SphericalMean, SphericalMeanNorm, SphericalMeanADC, SphericalStd, NoiseStd, NoiseCoeffVar) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output anisotropy volume |
VolumeDwiNormalize
normalize a mri weighted image volume by the baseline signal
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients |
--mask |
Mask | (optional) the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--grouping |
String | (optional) a grouping of scans with similar TE/TR (otherwise all scans are assumed to be part of one group) | |
--unit |
flag | (optional) normalize the signal to the unit interval (divide by average baseline by voxel) | |
--mean |
Double | (optional) normalize the signal to have a given mean value across the entire volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output baseline volume |
VolumeDwiReduce
Reduce the number of mri samples in a mri weighted image
Input:
| Flag | Type | Description |
|---|---|---|
--dwi |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients (must match input DWI) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--shells |
String | (optional) include only specific shells | |
--which |
String | (optional) include only specific gradients (comma separated zero-based indices) | |
--exclude |
String | (optional) exclude specific gradients (comma separated zero-based indices) | |
--bscale |
Double | (optional) scale the baseline signal by the given amount (this is very rarely necessary) |
Output:
| Flag | Type | Description |
|---|---|---|
--outputDwi |
Volume | the output dwi volume |
--outputGradients |
Gradients | (optional) the output gradients |
VolumeDwiResampleGP
Resample a diffusion-weighted MR volume to have a different set of gradients (arbitrary b-vectors and b-values)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients (must match input DWI) |
--reference |
Gradients | the gradients used for resampling |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--lambda |
Double | 0.1 |
(optional) the lambda parameter (controls smoothness) |
--alpha |
Double | 1.0 |
(optional) the alpha parameter (controls gradient direction scaling) |
--beta |
Double | 1.0 |
(optional) the beta parameter (controls gradient strength scaling) |
--threads |
Integer | 1 |
(optional) the number of threads to use |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output resampled diffusion-weighted MR volume (will match reference gradients) |
Citation: Andersson, J. L., & Sotiropoulos, S. N. (2015). Non-parametric representation and prediction of single-and multi-shell diffusion-weighted MRI data using Gaussian processes. NeuroImage, 122, 166-176.
VolumeDwiResampleOutlierGP
Detect and replace outliers of a diffusion-weighted MR volume using Gaussian Process regression. This first detects outliers using a very smooth GP model and then replaces only those outliers using a more rigid GP model
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients (must match input DWI) |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--outlier |
Double | 0.35 |
(optional) the threshold for outlier detection. this is the fractional change in single value from the GP prediction to qualify as an outlier |
--include |
Double | 0.75 |
(optional) the minimum fraction of gradient directions to use for outlier replacement. if more than this fraction are considered inliers, then interpolation will be used |
--lambdaDetect |
Double | 1.0 |
(optional) the lambda parameter for detecting outliers (controls smoothness) |
--lambdaPredict |
Double | 1.0 |
(optional) the lambda parameter for replacing outliers (controls smoothness) |
--resample |
flag | (optional) resample all signal values with reduced GP (default will only resample outliers) | |
--alpha |
Double | 1.0 |
(optional) the alpha parameter (controls gradient direction scaling) |
--beta |
Double | 1.0 |
(optional) the beta parameter (controls gradient strength scaling) |
--threads |
Integer | 1 |
(optional) the number of threads to use |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output resampled diffusion-weighted MR volume (will match reference gradients) |
Citation: Andersson, J. L., & Sotiropoulos, S. N. (2015). Non-parametric representation and prediction of single-and multi-shell diffusion-weighted MRI data using Gaussian processes. NeuroImage, 122, 166-176.
VolumeDwiResampleSpherical
Resample a diffusion-weighted MR volume to have a different set of gradients (single shell only)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--source |
Gradients | the (original) source gradients |
--dest |
Vects | the destination gradient directions |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--filter |
String | linear |
(optional) specify a filtering method (linear, local, or global) |
--kappa |
Double | 5.0 |
(optional) the lambda parameter |
--lambda |
Double | 0.1 |
(optional) the lambda parameter |
--sigma |
Double | 20.0 |
(optional) the sigma parameter |
--adaptive |
flag | (optional) use adaptive resampling |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output resampled diffusion-weighted MR volume |
VolumeDwiSphericalMean
Compute the spherical mean for each shell.
Input:
| Flag | Type | Description |
|---|---|---|
--dwi |
Volume | the dwi diffusion-weighted MR volume |
--gradients |
Gradients | the (original) source gradients |
--mask |
Mask | (optional) a mask |
Output:
| Flag | Type | Description |
|---|---|---|
--outputDwi |
Volume | the output resampled diffusion-weighted MR volume |
--outputBvals |
Vects | the output b-values |
VolumeDwiSubsample
Subsample a mri weighted volume by removing channels to maximize the separation of gradient directions. This is currently optimized for single shell data
Input:
| Flag | Type | Description |
|---|---|---|
--indwi |
Volume | the input diffusion-weighted MR volume |
--ingrad |
Gradients | the input gradients |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--nums |
int | 1 |
(optional) the number of baseline channels to keep |
--numd |
int | 12 |
(optional) the number of diffusion-weighted channels to keep |
Output:
| Flag | Type | Description |
|---|---|---|
--outdwi |
Volume | the output diffusion-weighted MR volume |
--outgrad |
Gradients | the output gradients |
VolumeEnhanceContrast
enhance the intensity contrast of a given volume. The output will have a range of zero to one.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--type |
VolumeEnhanceContrastType | Histogram |
(optional) the type of contrast enhancement (Options: Histogram, Ramp, RampGauss, Mean, None) |
--squeeze |
VolumeEnhanceContrastSqueeze | None |
(optional) the type of squeezing (Options: Square, Root, Sine, SquineLow, SquineHigh, None) |
--bins |
int | 1024 |
(optional) the number of histogram bins |
--gauss |
double | 3.0 |
(optional) the Gaussian bandwidth |
--scale |
double | 1.0 |
(optional) the intensity scaling |
--smooth |
Double | (optional) smooth the histogram by adding the given proportion of the total (reduces effect of outliers) | |
--nobg |
flag | (optional) remove background voxels | |
--invert |
flag | (optional) invert the intensities on a unit interval | |
--thresh |
double | 1.0E-6 |
(optional) specify a threshold for background removal |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output enhanced image |
VolumeEstimateLookup
Compute a histogram of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--from |
Volume | the volume for the x-dimension |
--to |
Volume | the volume for the y-dimension |
--mask |
Mask | (optional) an input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--bins |
int | 100 |
(optional) the number of bins in x |
--xmin |
Double | (optional) the minimum in x | |
--xmax |
Double | (optional) the maximum in x | |
--inputField |
String | input |
(optional) the name field name for the input value |
--outputField |
String | output |
(optional) the name field name for the output value |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
--breaks |
Volume | (optional) output breaks |
VolumeExpDecayError
Synthesize a volume from exp decay parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input exp decay sample volume |
--varying |
Vects | the varying parameters |
--model |
Volume | the exponential decay model parameter volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
String | nrmse |
(optional) the type of error metric (me, nme, sse, nsse, mse, nmse, rmse, nrmse) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output error |
VolumeExpDecayFit
Fit an exponential decay model to volumetric data: y = alpha * exp(-beta * x)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input dwi |
--varying |
Vects | (optional) the varying parameters values used for fitting, if not provided the start and step parameters are used instead |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
String | wlls |
(optional) the method for fitting (lls, wlls, nlls) |
--start |
Double | 1.0 |
(optional) the starting echo time (not used if you provide a varying input) |
--step |
Double | 1.0 |
(optional) the spacing between echo times (not used if you provide a varying input) |
--minAlpha |
Double | 0.0 |
(optional) the minimum alpha |
--minBeta |
Double | 0.0 |
(optional) the minimum beta |
--thresh |
Double | (optional) apply a threshold to the input image, e.g. remove zero values | |
--shrinkage |
flag | (optional) apply shrinkage regularization for low SNR regions | |
--shrinkSmooth |
Integer | 5 |
(optional) the amount of smoothing to apply |
--shrinkSnrMax |
Double | 7.0 |
(optional) the maximum shrinkage snr |
--shrinkSnrMin |
Double | 5.0 |
(optional) the minimum shrinkage snr |
--threads |
Integer | 1 |
(optional) the mynumber of threads in the pool |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--which |
String | (optional) specify a subset of data to include (comma-separated list of indices starting from zero) | |
--exclude |
String | (optional) specify a subset of data to exclude (comma-separated list of indices starting from zero) | |
--select |
String | (optional) specify a subset of values to include (as opposed to indices) | |
--skipFirstThresh |
Integer | (optional) skip the first value if there are more than the given number of values (this is for an unusual edge case) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | (optional) the output exp decay model volume |
--outputAlpha |
Volume | (optional) the output exp decay alpha parameter |
--outputBeta |
Volume | (optional) the output exp decay beta parameter |
--outputError |
Volume | (optional) the output exp decay error |
--outputResiduals |
Volume | (optional) the output exp decay residuals |
--outputSnr |
Volume | (optional) the output exp decay SNR map |
VolumeExpDecaySynth
Synthesize a volume from exp decay parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input exp decay volume |
--varying |
Vects | the varying parameters |
--mask |
Mask | (optional) input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | predicted output |
VolumeExpRecoveryError
Synthesize a volume from exp recovery parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input exp recovery sample volume |
--varying |
Vects | the varying parameters |
--model |
Volume | the exponential recovery model parameter volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
String | nrmse |
(optional) the type of error metric (me, nme, sse, nsse, mse, nmse, rmse, nrmse) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output error |
VolumeExpRecoveryFit
Fit an exponential recovery model to volumetric data: y = alpha * exp(-beta * x)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input dwi |
--varying |
Vects | the varying parameters values used for fitting |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output exp recovery model volume |
VolumeExpRecoverySynth
Synthesize a volume from exp recovery parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input exp recovery volume |
--varying |
Vects | the varying parameters |
--mask |
Mask | (optional) input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | predicted output |
VolumeExtrema
Compute the local extrema of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channel |
int | 0 |
(optional) the volume channel |
--minima |
flag | (optional) find the minima | |
--maxima |
flag | (optional) find the maxima | |
--element |
String | cross |
(optional) specify an element |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
VolumeFibersError
Compute error metrics between a ground truth and test fibers volume
Input:
| Flag | Type | Description |
|---|---|---|
--truth |
Volume | the truth fibers volume |
--test |
Volume | the test fibers volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--thresh |
double | 0.05 |
(optional) a threshold for compartment existence |
Output:
| Flag | Type | Description |
|---|---|---|
--missing |
Volume | (optional) output measuring number of missing compartment error |
--extra |
Volume | (optional) output measuring number of extra compartment error |
--linehaus |
Volume | (optional) output measuring the hausdorff angular error |
--linetotal |
Volume | (optional) output measuring the total angular error |
--frachaus |
Volume | (optional) output measuring the hausdorff fraction error |
--fractotal |
Volume | (optional) output measuring the total fraction error |
--fraciso |
Volume | (optional) output measuring the isotropic fraction error |
VolumeFibersFilter
Add orientation and volume fraction noise to a fibers volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input fibers volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--base |
Double | 1.0 |
(optional) the fraction gain |
--frac |
Double | 2.0 |
(optional) the fraction gain |
--angle |
Double | 1.0 |
(optional) the angle gain |
--align |
Double | 2.0 |
(optional) the align gain |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output noisy fibers volume |
VolumeFibersFit
Fit a fibers volume using a multi-stage procedure
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input diffusion-weighted MR volume |
--gradients |
Gradients | the gradients |
--mask |
Mask | (optional) the mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--round |
Integer | (optional) specify rounding factor for the gradients | |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
--columns |
flag | (optional) use fine-grained multi-threading | |
--minfrac |
double | 0.01 |
(optional) the minimum volume fraction |
--comps |
int | 3 |
(optional) the maximum number of fiber compartments to extract |
--points |
Integer | 256 |
(optional) the number of points used for peak extraction |
--cluster |
double | 30.0 |
(optional) the angle for peak clustering |
--peak |
PeakMode | Sum |
(optional) the statistic for aggregating peaks (Options: Sum, Mean, Max) |
--dmax |
double | 0.003 |
(optional) the maximum diffusivity for MCSMT |
--maxiters |
int | 1500 |
(optional) the maximum number of iterations for MCSMT |
--diffinit |
DiffInit | Best |
(optional) specify a method for initializing diffusivity (Options: Tensor, Fixed, Best) |
--method |
Method | RLD |
(optional) specify an orientation estimation method (Options: CSD, RLD) |
--rldIters |
int | 500 |
(optional) the number of iterations for RLD |
--rldAlpha |
double | 0.0017 |
(optional) the alpha parameter for RLD |
--rldBeta |
double | 0.0 |
(optional) the beta parameter for RLD |
--csdOrder |
Integer | 8 |
(optional) specify the maximum spherical harmonic order for CSD |
--csdAxial |
double | 0.0017 |
(optional) the axial fiber response for CSD |
--csdRadial |
double | 1.2E-4 |
(optional) the radial fiber response for CSD |
--csdTau |
double | 0.1 |
(optional) the tau parameter for CSD |
--csdLambda |
double | 0.2 |
(optional) the lambda parameter for CSD |
--csdIters |
int | 50 |
(optional) the number of iterations for CSD |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--shells |
String | (optional) specify a subset of gradient shells to include (comma-separated list of b-values) | |
--which |
String | (optional) specify a subset of gradients to include (comma-separated list of indices starting from zero) | |
--exclude |
String | (optional) specify a subset of gradients to exclude (comma-separated list of indices starting from zero) | |
--dperp |
Double | (optional) use the givel fraction of axial diffusivity when fitting fiber volume fractions | |
--dfix |
Double | 0.00125 |
(optional) use the given fixed axial diffusivity when fitting fiber volume fractions |
--tort |
flag | (optional) use a tortuosity model (otherwise the extra-cellular diffusivity is matched to the intra) | |
--restarts |
Integer | 1 |
(optional) use the given fixed axial diffusivity when fitting fiber volume fractions |
--nosmt |
flag | (optional) skip SMT estimation (for multishell data only) | |
--modeSingle |
Mode | FracSumDiffMultistage |
(optional) specify an parameter estimation mode for single shell analysis (Options: Fracs, FracsFixedSum, FracsDiff, FracSum, FracSumDiff, Diff, FracSumDiffMultistage, FracsDiffMultistage) |
--modeMulti |
Mode | FracsFixedSum |
(optional) specify an parameter estimation mode for single shell analysis (Options: Fracs, FracsFixedSum, FracsDiff, FracSum, FracSumDiff, Diff, FracSumDiffMultistage, FracsDiffMultistage) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output fibers volume |
VolumeFibersNoise
Add orientation and volume fraction noise to a fibers volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input fibers volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--line |
Double | (optional) the sigma of the orientation noise | |
--frac |
Double | (optional) the sigma of the volume fraction noise |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output noisy fibers volume |
VolumeFibersPhantomCrossing
Create a benchmark fibers phantom
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--size |
int | 50 |
(optional) the size of the phantom |
--fracPrimary |
double | 0.4 |
(optional) volume fraction of the primary bundle |
--fracSecondary |
double | 0.4 |
(optional) volume fraction of the secondary bundle |
--radiusPrimary |
double | 0.4 |
(optional) the relative radius of the primary bundle (0 to 1) |
--radiusSecondary |
double | 0.2 |
(optional) the relative radius of the secondary bundle (0 to 1) |
--angle |
double | 45.0 |
(optional) the angle between the primary and secondary bundles |
--noiseAngle |
double | 5.0 |
(optional) the amount of noise added to the compartment fiber orientations |
--noiseFraction |
double | 0.05 |
(optional) the amount of noise added to the compartment volume fraction |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the synthesized output fibers |
--outputBundle |
Mask | (optional) the output bundle mask |
--outputEnd |
Mask | (optional) the output end mask |
VolumeFibersPick
Project fibers onto a reference volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input fibers to pick |
--reference |
Volume | the reference vectors |
--mask |
Mask | (optional) a mask of the input image |
--deform |
Deformation | (optional) a deformation from the input to the reference |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--thresh |
double | 0.05 |
(optional) a threshold for picking |
--threads |
int | 1 |
(optional) the number of threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers |
VolumeFibersProject
Project fibers onto a reference volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input fibers to project |
--reference |
Volume | the reference fibers (may be deformed from another space) |
--mask |
Mask | (optional) a mask of the input image |
--deform |
Deformation | (optional) a deformation from the input to the reference |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--thresh |
double | 0.01 |
(optional) a threshold for compartment existence |
--keep |
flag | (optional) keep the reference fiber orientations | |
--angle |
Double | (optional) the maximum angle for matching | |
--presmooth |
Double | (optional) apply fiber smoothing before projection with the given bandwidth | |
--smooth |
flag | (optional) apply fiber smoothing after projection | |
--threads |
int | 1 |
(optional) the number of threads |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--soft |
flag | (optional) use soft projection with angular smoothing | |
--soften |
Double | 0.1 |
(optional) use the given soft smoothing angular bandwidth (zero to one, where greater is more smoothing) |
--deviation |
flag | (optional) save the angular deviation to the fiber statistic field of the output | |
--hpos |
Double | (optional) apply smoothing with the given amount (bandwidth in mm) (default is largest voxel dimension) | |
--mix |
Double | (optional) smoothly mix reference and the input voxel fiber orientations (0 is all input, 1 is all reference) | |
--support |
int | 3 |
(optional) the smoothing filter radius in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers |
VolumeFibersPrune
Prune outlier fibers
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input fibers |
--mask |
Mask | (optional) a mask of the input image |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--normalize |
flag | (optional) globally normalize the volume fractions to be in a unit range | |
--min |
Double | (optional) a minimum volume fraction | |
--thresh |
Double | (optional) a threshold angle for pruning (in degrees) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers |
VolumeFibersSmooth
Smooth a fibers volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input fibers volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm (negative value will use the voxel size, zero will skip smoothing) |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--comps |
int | 3 |
(optional) a maxima number of fiber compartments |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--hsig |
Double | (optional) the baseline signal adaptive bandwidth | |
--hsigrel |
flag | (optional) treat hsig as a fraction of the mean baseline signal (inside the mask) | |
--hfrac |
Double | (optional) the fraction adaptive bandwidth | |
--hdiff |
Double | (optional) the diffusivity adaptive bandwidth | |
--hdir |
Double | (optional) the fiber adaptive bandwidth | |
--min |
double | 0.01 |
(optional) a minima volume fraction |
--lambda |
double | 0.99 |
(optional) a data adaptive threshold |
--restarts |
int | 2 |
(optional) a number of restarts |
--pass |
flag | (optional) pass through the data without smoothing |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers volume |
Citation: Cabeen, R. P., Bastin, M. E., & Laidlaw, D. H. (2016). Kernel regression estimation of fiber orientation mixtures in mri MRI. NeuroImage, 127, 158-172.
VolumeFibersTransform
Spatially transform a fibers volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input fibers volume |
--reference |
Volume | input reference volume |
--mask |
Mask | (optional) input mask |
--inputMask |
Mask | (optional) use an input mask (defined in the input space) |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--reorientation |
ReorientationType | Jacobian |
(optional) specify a reorient method (Options: FiniteStrain, Jacobian) |
--estimation |
EstimationType | Match |
(optional) the estimation type (Options: Match, Rank) |
--selection |
SelectionType | Adaptive |
(optional) the selection type (Options: Max, Fixed, Linear, Adaptive) |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--comps |
int | 3 |
(optional) a maxima number of fiber compartments |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--min |
double | 0.01 |
(optional) a minima volume fraction |
--lambda |
double | 0.99 |
(optional) a data adaptive threshold |
--threads |
int | 1 |
(optional) the number of threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output transformed volume |
Citation: Cabeen, R. P., Bastin, M. E., & Laidlaw, D. H. (2016). Kernel regression estimation of fiber orientation mixtures in mri MRI. NeuroImage, 127, 158-172.
VolumeFibersZoom
Zoom a fibers volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input fibers volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--factor |
double | 2.0 |
(optional) a zooming factor |
--isotropic |
Double | (optional) zoom to a given isotropic voxel size (not by a factor) | |
--estimation |
EstimationType | Match |
(optional) the estimation type (Options: Match, Rank) |
--selection |
SelectionType | Linear |
(optional) the selection type (Options: Max, Fixed, Linear, Adaptive) |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--comps |
int | 3 |
(optional) a maxima number of fiber compartments |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--min |
double | 0.01 |
(optional) a minima volume fraction |
--lambda |
double | 0.99 |
(optional) a data adaptive threshold |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers volume |
Citation: Cabeen, R. P., Bastin, M. E., & Laidlaw, D. H. (2016). Kernel regression estimation of fiber orientation mixtures in mri MRI. NeuroImage, 127, 158-172.
VolumeFilterBilateral
Filter a volume with a bilateral filter
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channel |
Integer | (optional) volume channel (default applies to all) | |
--hpos |
Double | 1.0 |
(optional) positional bandwidth |
--hval |
Double | (optional) data adaptive bandwidth | |
--support |
int | 3 |
(optional) filter radius in voxels (filter will be 2 * support + 1 in each dimension) |
--iterations |
int | 1 |
(optional) number of repeats |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
Citation: Elad, M. (2002). On the origin of the bilateral filter and ways to improve it. IEEE Transactions on image processing, 11(10), 1141-1151.
VolumeFilterDoG
Filter a volume using a Gaussian kernel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
int | 3 |
(optional) filter support (filter will be 2 * support + 1 voxels in each dimension) |
--low |
double | 1.0 |
(optional) the low smoothing level |
--high |
double | 2.0 |
(optional) the low smoothing level |
--num |
int | 1 |
(optional) number of applications |
--threads |
int | 1 |
(optional) number of threads |
--preserve |
flag | (optional) preserve un-masked values through the filter |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeFilterFrangi
Filter a volume using a Frangi filter. This extracts tubular structures (scale level is the sigma parameter of a Gaussian in mm)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
int | 3 |
(optional) filter support (filter will be 2 * support + 1 voxels in each dimension) |
--low |
double | 1.0 |
(optional) the low scale level |
--high |
double | 5.0 |
(optional) the high scale level |
--scales |
int | 5 |
(optional) the number of scale samples |
--alpha |
double | 0.5 |
(optional) the alpha Frangi parameter |
--beta |
double | 0.5 |
(optional) the beta Frangi parameter |
--gamma |
double | 300.0 |
(optional) the gamma Frangi parameter for 3D structures |
--gammaPlanar |
double | 15.0 |
(optional) the gamma Frangi parameter for 2D structures |
--threads |
int | 1 |
(optional) number of threads |
--dark |
flag | (optional) use detect dark tubes instead of bright tubes | |
--sobel |
flag | (optional) use a sobel operator (default is central finite difference) | |
--full |
flag | (optional) return the full scale space (default is maximum) | |
--pass |
flag | (optional) pass un-masked values through the filter |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 1 |
(optional) number of smoothing iterations |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output filter response |
--outputScale |
Volume | (optional) output scale of the tubular structure |
Citation: Frangi, Alejandro F., et al. “Multiscale vessel enhancement filtering.” International Conference on Medical Image Computing and Computer-Assisted Intervention. Springer, Berlin, Heidelberg, 1998.
VolumeFilterGaussian
Filter a volume using a Gaussian kernel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
int | 3 |
(optional) filter support (filter will be 2 * support + 1 voxels in each dimension) |
--sigma |
Double | 1.0 |
(optional) the smoothing level |
--num |
int | 1 |
(optional) number of applications |
--threads |
int | 1 |
(optional) number of threads |
--full |
flag | (optional) use a full convolution filter (otherwise separate filters are used) | |
--pass |
flag | (optional) pass un-masked values through the filter | |
--channel |
Integer | (optional) the volume channel (default applies to all) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output filtered volume |
VolumeFilterGradient
Filter a volume to compute its Hessian
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threads |
int | 1 |
(optional) number of threads |
--sobel |
flag | (optional) use a sobel operator (default is central finite difference) | |
--mag |
flag | (optional) return the gradient magnitude |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeFilterHessian
Filter a volume to compute its Hessian
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threads |
int | 1 |
(optional) number of threads |
--sobel |
flag | (optional) use a sobel operator (default is central finite difference) | |
--mode |
VolumeFilterHessianMode | Matrix |
(optional) return the given output mode (Options: Matrix, Eigen, Determ, Norm, Westin, Spherical, Linear, Planar, Ridge, Blob, DarkBlob, LightBlob) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeFilterLaplacian
Filter a volume using a Laplacian kernel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
int | 3 |
(optional) filter support (filter will be 2 * support + 1 voxels in each dimension) |
--sigma |
Double | 1.0 |
(optional) the smoothing level |
--amp |
Double | 1.0 |
(optional) the |
--threads |
int | 1 |
(optional) number of threads |
--preserve |
flag | (optional) pass un-masked values through the filter | |
--channel |
Integer | (optional) the volume channel (default applies to all) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output filtered volume |
VolumeFilterMeanShift
Process a volume with mean shift analysis for either anisotropic filtering or segmentation
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--hpos |
double | 8.0 |
(optional) the spatial bandwidth in mm |
--hval |
double | 64.0 |
(optional) the adaptive bandwidth in units of intensity |
--iters |
int | 5000 |
(optional) the maxima number of iterations |
--minshift |
double | 0.001 |
(optional) the threshold for stopping gradient updates |
--minsize |
double | 50.0 |
(optional) the minima cluster size |
Output:
| Flag | Type | Description |
|---|---|---|
--filtered |
Volume | (optional) the output filtered image |
--segmented |
Mask | (optional) the output segmentation |
Citation: Comaniciu, D., & Meer, P. (2002). Mean shift: A robust approach toward feature space analysis. IEEE Transactions on pattern analysis and machine intelligence, 24(5), 603-619.
VolumeFilterMedian
Filter a volume using a median filter
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--window |
int | 1 |
(optional) the window size in voxels |
--channel |
Integer | (optional) the volume channel (default applies to all) | |
--slice |
String | (optional) restrict the filtering to a specific slice (i, j, or k) | |
--num |
Integer | 1 |
(optional) the number of times to filter |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeFilterNLM
Apply a non-local means filter to a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
--hrelMask |
Mask | (optional) a mask for computing the mean image intensity for relative bandwidth (see hrel) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channel |
Integer | (optional) the volume channel (default applies to all) | |
--mode |
FilterMode | Volumetric |
(optional) indicate whether the filtering should be volumetric (default) or restricted to a specified slice (Options: Volumetric, SliceI, SliceJ, SliceK) |
--patch |
int | 1 |
(optional) the patch size |
--search |
int | 2 |
(optional) the search window size |
--stats |
int | 2 |
(optional) the statistics window size (for computing mean and variance in adaptive filtering) |
--h |
Double | (optional) use a fixed noise level (skips adaptive noise esimation) | |
--epsilon |
double | 1.0E-5 |
(optional) the minimum meaningful value for mean and vars |
--meanThresh |
double | 0.95 |
(optional) the mean intensity threshold |
--varThresh |
double | 0.5 |
(optional) the variance intensity threshold |
--factor |
double | 1.0 |
(optional) a factor for scaling adaptive sensitivity (larger values remove more noise) |
--hrel |
flag | (optional) use the h bandwidth as a fraction of the mean image intensity | |
--hrelwhich |
String | 0 |
(optional) specify which channels to use for hrel |
--rician |
flag | (optional) whether a Rician noise model should be used | |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
--outputNoise |
Volume | (optional) output noise map |
Citation: Manjon, Jose V., et al. Adaptive non-local means denoising of MR images with spatially varying noise levels. Journal of Magnetic Resonance Imaging 31.1 (2010): 192-203.
VolumeFilterNeuron
Filter a volume to isolate neuronal structures
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--median |
Integer | 1 |
(optional) the number of median filter passes |
--dilate |
Integer | 1 |
(optional) the number of dilation passes |
--min |
Integer | 300 |
(optional) the minimum number of voxels in a neuron connected component |
--thresh |
Double | 0.01 |
(optional) the threshold for segmenting cell bodies |
--frangi |
flag | (optional) apply the Frangi filter | |
--frangiThresh |
double | 0.01 |
(optional) the threshold for Frangi segmentation |
--frangiScales |
int | 5 |
(optional) the number of scales used in the Frangi filter |
--frangiLow |
int | 1 |
(optional) the lowest scale used in the Frangi filter |
--frangiHigh |
Integer | 10 |
(optional) the highest scale used in the Frangi filter |
--threads |
int | 1 |
(optional) number of threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
--outputFrangi |
Volume | (optional) output frangi |
--outputMask |
Mask | (optional) output mask |
VolumeFilterPCA
Denoise a volume using random matrix theory. Noise is estimated using a universal Marchenko Pastur distribution and removed via principal component analysis
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--type |
VolumeFilterPCAType | MP |
(optional) the type of PCA filtering to use (Options: MP, CenterMP) |
--window |
int | 5 |
(optional) the window size |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output denoised volume |
--noise |
Volume | (optional) output noise map |
--comps |
Volume | (optional) output pca component count |
Citation: Veraart, J., Novikov, D. S., Christiaens, D., Ades-Aron, B., Sijbers, J., & Fieremans, E. (2016). Denoising of diffusion MRI using random matrix theory. NeuroImage, 142, 394-406.
VolumeFilterPDE
Filter a volume using a PDE representing anisotropic mri
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channel |
String | (optional) the volume channel(s) (default applies to all) | |
--lambda |
Double | 0.16666666666666666 |
(optional) smoothing parameter (in mm) |
--k |
Double | 0.01 |
(optional) anisotropic flux parameter (relative to image intensities) |
--steps |
Integer | 5 |
(optional) the number of timesteps to apply |
--anisotropic |
flag | (optional) use anisotropic smoothing | |
--quadratic |
flag | (optional) use a quadratic flux (instead of exponential) | |
--recurse |
flag | (optional) use the output as input |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
Citation: Perona, P., & Malik, J. (1990). Scale-space and edge detection using anisotropic mri. IEEE Transactions on pattern analysis and machine intelligence, 12(7), 629-639.
VolumeFilterSigmoid
Filter a volume with a sigmoid to perform a soft threshold
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--thresh |
double | 0.5 |
(optional) the position of the sigmoid |
--slope |
double | 25.0 |
(optional) the slope of the sigmoid |
--low |
double | 0.0 |
(optional) low output |
--high |
double | 1.0 |
(optional) high output |
--invert |
flag | (optional) invert the sigmoid (lower input values will be high) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeFilterSigmoidRange
Filter a volume with the produce of two sigmoids, which act as a soft range threshold
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--below |
double | 0.5 |
(optional) the below sigmoid threshold |
--above |
double | 0.5 |
(optional) the above sigmoid threshold |
--slope |
double | 25.0 |
(optional) the slope of the sigmoid |
--low |
double | 0.0 |
(optional) low output |
--high |
double | 1.0 |
(optional) high output |
--invert |
flag | (optional) invert the sigmoid |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeFilterTriangle
Filter a volume using a Triangle kernel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
int | 3 |
(optional) filter support (filter will be 2 * support + 1 in each dimension) |
--num |
int | 1 |
(optional) number of applications |
--preserve |
flag | (optional) preserve un-masked values through the filter | |
--channel |
Integer | (optional) the volume channel (default applies to all) | |
--threads |
Integer | 1 |
(optional) the number of threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeFilterZeroCrossing
Filter a volume using a Gaussian kernel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--large |
flag | (optional) use a bigger 27-voxel neighborhood | |
--mode |
Mode | Both |
(optional) the crossing selection mode (Options: Below, Above, Both) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output zero crossings |
VolumeFloodFill
Flip the voxel values of volume along coordinate axes
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume of values for filling |
--source |
Mask | a mask indicating the source, i.e. which voxels of the input are used for filling |
--dest |
Mask | (optional) a mask used for restricting the voxel flooded (must be convex, but this is not checked) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--fix |
int | 0 |
(optional) maximum number of fixing passes |
Output:
| Flag | Type | Description |
|---|---|---|
--outputFlood |
Volume | output volume of flood values |
--outputDist |
Volume | (optional) output distance field |
VolumeGradient
Compute the gradient of an image
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channel |
Integer | 0 |
(optional) the volume channel (default applies to all) |
--type |
String | central |
(optional) type of finite difference approximation (forward, backward, central) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeGradientMagnitude
Compute the gradient magnitude of an image
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--channel |
Integer | 0 |
(optional) the volume channel (default applies to all) |
--type |
String | central |
(optional) type of finite difference approximation (forward, backward, central) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeHarmonize
Harmonize a volume with a reference volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--inputMask |
Mask | (optional) an input mask to restrict both statistics and harmonized voxels |
--inputStatMask |
Mask | (optional) an input mask to only restrict computing statistics |
--reference |
Volume | (optional) a reference volume |
--referenceMask |
Mask | (optional) a reference mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--bins |
int | 256 |
(optional) the number of bins |
--lower |
Bound | ThreeStd |
(optional) the method for computing the histogram lower bound (Options: Extrema, Quartile, HalfStd, OneStd, TwoStd, ThreeStd, User) |
--upper |
Bound | ThreeStd |
(optional) the method for computing the histogram upper bound (Options: Extrema, Quartile, HalfStd, OneStd, TwoStd, ThreeStd, User) |
--mylower |
Double | (optional) specify a specific lower bound for user defined mode | |
--myupper |
Double | (optional) specify a specific upper bound for user defined mode | |
--smooth |
Double | 10.0 |
(optional) the amount of smoothing (relative to bins) |
--lowerThresh |
Double | (optional) a lower threshold for excluding background | |
--upperThresh |
Double | (optional) an upper threshold for excluding background |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeHistogram
Compute a histogram of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--mask |
Mask | (optional) an input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--bins |
int | 256 |
(optional) the number of bins |
--lower |
Bound | Extrema |
(optional) the method for computing the histogram lower bound (Options: Extrema, Quartile, HalfStd, OneStd, TwoStd, ThreeStd, User) |
--upper |
Bound | Extrema |
(optional) the method for computing the histogram upper bound (Options: Extrema, Quartile, HalfStd, OneStd, TwoStd, ThreeStd, User) |
--mylower |
Double | (optional) specify a specific lower bound for user defined mode | |
--myupper |
Double | (optional) specify a specific upper bound for user defined mode | |
--lowerThresh |
Double | (optional) apply a lower threshold before computing the histogram | |
--upperThresh |
Double | (optional) apply an upper threshold before computing the histogram | |
--normalize |
flag | (optional) normalize the counts by the total count | |
--cdf |
flag | (optional) compute the cdf | |
--smooth |
Double | (optional) apply Gaussian smoothing (see hdata) | |
--hdata |
flag | (optional) interpret the smoothing parameter relative to the data intensities (default is bins) | |
--print |
flag | (optional) print a the histogram to standard output | |
--value |
String | value |
(optional) the value column name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | (optional) an output table |
VolumeImpute
Impute voxels by computing a moving average
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input Volume |
--mask |
Mask | (optional) input mask |
--impute |
Mask | (optional) input imputation mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
int | 5 |
(optional) the radius for imputation |
--knn |
int | 6 |
(optional) the k-nearest neighbors for imputation |
--missing |
Double | (optional) a value for missing cases (when imputation region is larger than the support) | |
--outlier |
Double | (optional) remove extreme values (specify a k value for Tukey’s fence, e.g. 1.5 for outliers or 3 for far out) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | (optional) output Volume |
--outputOutlier |
Mask | (optional) output outlier mask |
VolumeIsotropic
Isotropically scaleCamera a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--size |
double | 1.0 |
(optional) the output voxel size |
--interp |
InterpolationType | Tricubic |
(optional) an interpolation type (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeJacobian
Compute the jacobian of a deformation volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask |
--affine |
Affine | (optional) optional affine component to remove |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--deformation |
flag | (optional) treat the input as a deformation (i.e. displacement) | |
--eigenvalues |
flag | (optional) return the eigenvalues (exclusive with determinant flag) | |
--determinant |
flag | (optional) return the determinant (exclusive with eigenvalues flag) | |
--logarithm |
flag | (optional) return the logarithm (works with other options) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output table |
VolumeKurtosisFit
Fit a kurtosis volume. Warning: this does not yet estimate the kurtosis indices, e.g. FA, MK, etc.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input diffusion-weighted MR volume |
--gradients |
Gradients | the gradients |
--mask |
Mask | (optional) the mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
KurtosisFitType | LLS |
(optional) specify an estimation method, (FW enables free water elimination) (Options: LLS, WLLS, FWLLS, FWWLLS) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--shells |
String | (optional) specify a subset of gradient shells to include (comma-separated list of b-values) | |
--which |
String | (optional) specify a subset of gradients to include (comma-separated list of indices starting from zero) | |
--exclude |
String | (optional) specify a subset of gradients to exclude (comma-separated list of indices starting from zero) | |
--threads |
int | 1 |
(optional) the number of threads to use |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output kurtosis volume |
Citation: Veraart, J., Sijbers, J., Sunaert, S., Leemans, A., Jeurissen, B.: Weighted linear least squares estimation of mri mri parameters: strengths, limitations, and pitfalls. NeuroImage 81 (2013) 335-346
VolumeKurtosisODF
Sample an orientation distribution function (ODF) from a kurtosis volume.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input kurtosis volume |
--dirs |
Vects | the sphere directions |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--alpha |
Double | 10.0 |
(optional) the alpha power value |
--detail |
Integer | 4 |
(optional) the level of detail for spherical ODF sampling |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output odf volume |
VolumeKurtosisPeaks
Extract the peaks from a kurtosis volume. This finds the average direction of local maxima clustered by hierarchical clustering. The output fibers will encode the peak ODF value in place of volume fraction.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input kurtosis volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--comps |
Integer | 3 |
(optional) the maximum number of comps |
--alpha |
Double | 10.0 |
(optional) the alpha power value |
--thresh |
Double | 0.0 |
(optional) the minimum peak threshold |
--detail |
Integer | 4 |
(optional) the level of detail for spherical ODF sampling |
--cluster |
Double | 5.0 |
(optional) the minimum angle in degrees for hierarchical clustering of local maxima |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers volume |
VolumeMagnitude
Compute the magnitude of an image
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeMarchingCubes
Extract a mesh from a volume level set. This can be used for extracting boundary surfaces of distance fields, probability maps, parametric maps, etc. The background level should be changed depending on the context though to make sure the mesh orientation is correct.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--level |
double | 0.5 |
(optional) level set to extract |
--background |
double | 0.0 |
(optional) background value for outside sampling range (should be zero if the background is ‘black’ and a large number if the input is similar to a distance field) |
--nobound |
flag | (optional) exclude triangles on the boundary of the volume | |
--largest |
flag | (optional) retain only the largest component | |
--multi |
flag | (optional) extract a mesh for every channel | |
--label |
String | label |
(optional) a label attribute name for multi-channel extraction |
--median |
Integer | (optional) apply a median filter a given number of times before surface extraction | |
--std |
Double | (optional) apply g Gaussian smoothing before surface extraction | |
--support |
Integer | 3 |
(optional) use a given support in voxels for voxel smoothing |
--meanarea |
Double | (optional) simplify the mesh to have the given mean triangle area | |
--noboundmesh |
flag | (optional) do not simplify vertices on the mesh boundary | |
--smooth |
Double | (optional) smooth the mesh |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
Citation: Lorensen, W. E., & Cline, H. E. (1987, August). Marching cubes: A high resolution 3D surface construction algorithm. In ACM SIGGRAPH Computer Graphics (Vol. 21, No. 4, pp. 163-169)
VolumeMarchingSquares
Extract isocontours from slices of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--level |
double | 0.0 |
(optional) level set to extract |
--background |
double | 1.7976931348623157E308 |
(optional) background value for outside sampling range |
--dim |
String | z |
(optional) volume channel to contour (x, y, or z) |
--start |
int | 0 |
(optional) starting slice index |
--step |
int | 1 |
(optional) number of slices between contours |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | output contours |
Citation: Maple, C. (2003, July). Geometric design and space planning using the marching squares and marching cube algorithms. In Geometric Modeling and Graphics, 2003. Proceedings. 2003 International Conference on (pp. 90-95). IEEE.
VolumeMask
Mask a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | a mask |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeMaxProb
Find the maxima probability labels
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask to indicate background |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--bglabel |
int | 0 |
(optional) the background label |
--bgvalue |
double | 1.0 |
(optional) the background value |
Output:
| Flag | Type | Description |
|---|---|---|
--labels |
Mask | (optional) output mask of the extremal index |
--values |
Volume | (optional) output volume of the extremal values |
VolumeMcsmtFit
Estimate multi-compartment microscopic diffusion parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients |
--mask |
Mask | (optional) the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threads |
int | 1 |
(optional) the input number of threads |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--maxiters |
int | 1500 |
(optional) the maximum number of iterations |
--rhobeg |
double | 0.1 |
(optional) the starting simplex size |
--rhoend |
double | 0.001 |
(optional) the ending simplex size |
--dint |
double | 0.0017 |
(optional) the initial guess for parallel diffusivity |
--frac |
double | 0.5 |
(optional) the initial guess for intra-neurite volume fraction |
--fscale |
double | 10.0 |
(optional) the scaling for volume fraction optimization |
--dscale |
double | 1000.0 |
(optional) the scaling for diffusivity optimization |
--dmax |
double | 0.003 |
(optional) the maximum diffusivity |
--dot |
flag | (optional) include a dot compartment |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output parameter map |
Citation: Kaden, E., Kelm, N. D., Carson, R. P., Does, M. D., & Alexander, D. C. (2016). Multi-compartment microscopic diffusion imaging. NeuroImage, 139, 346-359.
VolumeMcsmtTransform
Transform an mcsmt volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input mcsmt volume |
--reference |
Volume | input reference volume |
--mask |
Mask | (optional) input mask |
--inputMask |
Mask | (optional) use an input mask (defined in the input space) |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--reorient |
ReorientationType | Jacobian |
(optional) specify a reorient method (Options: FiniteStrain, Jacobian) |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output transformed mcsmt volume |
VolumeMeasure
Collect statistical sumaries of a volume using a mask. This supports single label masks and more advanced options for multi-channel masks (e.g. loading names associated with each label)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--weight |
Volume | (optional) a weighting |
--mask |
Mask | (optional) a mask |
--lookup |
Table | (optional) use a lookup for region names |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--background |
flag | (optional) use the background | |
--multiple |
flag | (optional) use multiple regions | |
--channel |
int | 0 |
(optional) specify a volume channel |
--base |
String | region |
(optional) specify a region basename |
--index |
String | index |
(optional) specify the lookup index field |
--name |
String | name |
(optional) specify the lookup name field |
--region |
String | region |
(optional) specify the output region field name |
--stat |
String | stat |
(optional) specify the output statistic field name |
--value |
String | value |
(optional) specify the output value field name |
--include |
String | (optional) specify which statistics should be included (e.g. mean) | |
--union |
flag | (optional) combine the region and stat fields into one | |
--join |
String | _ |
(optional) the character for joining region and stat names (depends on union flag) |
--nostat |
flag | (optional) exclude the statistics field | |
--widen |
flag | (optional) widen the table on the statistics field |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
VolumeMeasureMulti
Collect statistical sumaries of a volume using a mask. This supports single label masks and more advanced options for multi-label masks (e.g. loading names associated with each label)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--weight |
Volume | (optional) a weighting |
--mask |
Mask | (optional) a mask |
--lookup |
Table | (optional) use a lookup for region names |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--background |
flag | (optional) use the background | |
--multiple |
flag | (optional) use multiple regions | |
--base |
String | region |
(optional) specify a region basename |
--index |
String | index |
(optional) specify the lookup index field |
--channel |
String | channel |
(optional) specify the channel index field |
--name |
String | name |
(optional) specify the lookup name field |
--region |
String | region |
(optional) specify the output region field name |
--stat |
String | stat |
(optional) specify the output statistic field name |
--value |
String | value |
(optional) specify the output value field name |
--include |
String | (optional) specify which statistics should be included (e.g. mean) | |
--union |
flag | (optional) combine the region and stat fields into one | |
--join |
String | _ |
(optional) the character for joining region and stat names (depends on union flag) |
--nostat |
flag | (optional) exclude the statistics field | |
--widen |
flag | (optional) widen the table on the statistics field |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
VolumeModelError
Compute the root mean square error between a model and dwi volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input model volume |
--dwi |
Volume | input dwi |
--gradients |
Gradients | input gradients |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--model |
String | (optional) a model name (default will try to detect it) | |
--type |
ModelErrorType | RMSE |
(optional) specify an error type (default is root mean square error) (Options: MAD, NMAD, MSE, RMSE, NRMSE, BIC, AIC, AICc) |
--dof |
Integer | (optional) specify an specific degrees of freedom (useful for models that were constrained when fitting) | |
--dparNoddi |
Double | (optional) specify a NODDI parallel diffusivity | |
--disoNoddi |
Double | (optional) specify a NODDI isotropic diffusivity |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output error volume |
Citation: Burnham, K. P., & Anderson, D. R. (2004). Multimodel inference: understanding AIC and BIC in model selection. Sociological methods & research, 33(2), 261-304.
VolumeModelFeature
Extract a feature from a model volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input model volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--model |
String | (optional) a model name (default will try to detect it) | |
--feature |
String | (optional) a feature name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output feature volume |
VolumeModelReorient
Reorient the fiber orientations of a model volume. If both a flip and swap are specified, the flip is performed first. This only works for tensor, noddi, and fibers volumes
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input model volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--model |
String | (optional) a model name (default will try to detect it) | |
--flip |
String | (optional) flip a coodinate (x, y, z, or none) | |
--swap |
String | (optional) swap a pair of coordinates (xy, xz, yz, or none) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output error volume |
VolumeModelSample
Sample model parameters based on a variety of possible data objects
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input model volume |
--vects |
Vects | (optional) vects storing the position where models should be sampled |
--solids |
Solids | (optional) solids storing the position where models should be sampled |
--mask |
Mask | (optional) mask storing the position where models should be sampled |
--curves |
Curves | (optional) curves storing the position where models should be sampled |
--mesh |
Mesh | (optional) mesh storing the position where models should be sampled |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--model |
ModelType | Vect |
(optional) a model type (if you select None, the code will try to detect it) (Options: Vect, Tensor, BiTensor, Fibers, Spharm, Kurtosis, Noddi, ExpDecay, Mcsmt) |
--jitter |
Double | (optional) jitter the samples by a given amount | |
--cull |
Double | (optional) cull the samples at a given threshold ditance | |
--multiplier |
Integer | 1 |
(optional) a multiplier of the number of samples taken (sometimes only makes sense when jittering) |
--limit |
Integer | (optional) a maximum number of samples (the excess is randomly selected) | |
--param |
flag | (optional) samples should store only model parameters (otherwise the position is prepended) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--support |
Integer | 5 |
(optional) the interpolation filter radius in voxels |
--hpos |
Double | 1.5 |
(optional) the positional interpolation bandwidth in mm |
--comps |
int | 3 |
(optional) a maxima number of compartments (xfib only) |
--log |
flag | (optional) use log-euclidean estimation (dti only) | |
--threads |
int | 4 |
(optional) the number of threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Vects | the output sampled vects |
Citation: Cabeen, R. P., Bastin, M. E., & Laidlaw, D. H. (2016). Kernel regression estimation of fiber orientation mixtures in mri MRI. NeuroImage, 127, 158-172.
VolumeModelSynth
Synthesize a dMRI from a fibers volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input model volume |
--gradients |
Gradients | the gradient scheme |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--model |
String | (optional) a model name (default will try to detect it) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output synthesized diffusion-weighted MR volume |
VolumeModelTrackStreamline
Perform deterministic multi-fiber streamline tractography from a model volume. This supports tensor, fibers, spharm, and noddi volumes.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input model volume |
--seedVects |
Vects | (optional) seed from vects |
--seedMask |
Mask | (optional) a seed mask (one seed per voxel is initiated from this) |
--seedSolids |
Solids | (optional) seed from solids (one seed per object is initiated from this) |
--includeMask |
Mask | (optional) an include mask (curves are only included if they touch this, i.e. AND) |
--includeSolids |
Solids | (optional) an include solids (curves are only included if they touch this, i.e. AND) |
--includeAddMask |
Mask | (optional) an additional include mask (curves are only included if they touch this, i.e. AND) |
--includeAddSolids |
Solids | (optional) an additional include solids (curves are only included if they touch this, i.e. AND) |
--excludeMask |
Mask | (optional) an exclude mask (curves are removed if they touch this mask, i.e. NOT) |
--excludeSolids |
Solids | (optional) an exclude solids object (curves are removed if they touch any solid, ie.e NOT) |
--trapMask |
Mask | (optional) a trap mask (tracking terminates when leaving this mask) |
--stopMask |
Mask | (optional) a stop mask (tracking terminates when reaching this mask) |
--stopSolids |
Solids | (optional) a stop solids object (tracking terminates when reaching any solid) |
--endMask |
Mask | (optional) an endpoint mask (curves are only retained if they end inside this) |
--endSolids |
Solids | (optional) an endpoint solids object (curves are only retained if they end inside this) |
--trackMask |
Mask | (optional) a tracking mask (tracking is stopped if a curve exits this mask) |
--trackSolids |
Solids | (optional) a tracking solids (tracking is stopped if a curve exits solids) |
--containMask |
Mask | (optional) a containment mask (a minimum fraction of arclength must be inside this mask) |
--connectMask |
Mask | (optional) a connection mask (tracks will be constrained to connect distinct labels) |
--odfPoints |
Vects | (optional) specify the spherical points for processing the odf (the number of vectors should match the dimensionality of the input volume) |
--force |
Volume | (optional) use a force field |
--hybridPeaks |
Volume | (optional) use the given peaks (otherwise they will be computed from the input) |
--hybridConnectMask |
Mask | (optional) use the given connect mask during the initial tracking phase (but not the secondary one) |
--hybridTrapMask |
Mask | (optional) use the given trap mask during the initial tracking phase (but not the secondary one) |
--hybridExcludeMask |
Mask | (optional) use the given exclude mask during the initial tracking phase (but not the secondary one) |
--hybridStopMask |
Mask | (optional) use the given stop mask during the initial tracking phase (but not the secondary one) |
--hybridTrackMask |
Mask | (optional) use the given track mask during the initial tracking phase (but not the secondary one) |
--hybridCurves |
Curves | (optional) use the given curves (and skip the first stage of hybrid tracking) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--samplesFactor |
Double | 1.0 |
(optional) increase or decrease the total number of samples by a given factor (regardless of whether using vects, mask, or solids) |
--samplesMask |
Integer | 1 |
(optional) the number of samples per voxel when using mask seeding |
--samplesSolids |
Integer | 5000 |
(optional) the number of samples per object when using solid seeding |
--min |
double | 0.075 |
(optional) a minimum cutoff value for tracking (depend on the voxel model, e.g. FA for DTI, frac for Fibers, etc.) |
--angle |
Double | 45.0 |
(optional) the angle stopping criteria (maximum change in orientation per step) |
--disperse |
Double | 0.0 |
(optional) use a fixed amount of orientation dispersion during tracking (e.g. 0.1) |
--step |
Double | 1.0 |
(optional) the step size for tracking |
--minlen |
Double | 0.0 |
(optional) the minimum streamline length |
--maxlen |
Double | 1000000.0 |
(optional) the maximum streamline length |
--maxseeds |
Integer | 2000000 |
(optional) a maximum number of seeds |
--maxtracks |
Integer | 2000000 |
(optional) a maximum number of tracks |
--interp |
KernelInterpolationType | Nearest |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--mono |
flag | (optional) use monodirectional seeding (default is bidirectional), e.g. for seeding from a subcortical structure | |
--prob |
flag | (optional) use probabilistic sampling and selection | |
--probMax |
flag | (optional) follow the maximum probability direction (only used when the prob flag is enabled) | |
--probPower |
Double | 1.0 |
(optional) raise the sample probability to the given power (to disable, leave at one) |
--probAngle |
Double | 5.0 |
(optional) the prior gain for angle changes (beta * change / threshold) (t disable, set to zero) |
--probPoints |
Integer | 300 |
(optional) the number of ODF points to sample for probabilistic sampling (or you can provide specific odfPoints) |
--endConnect |
flag | (optional) find connections in the end mask | |
--quiet |
flag | (optional) print progress messages |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--vector |
flag | (optional) use vector field integration (the default is to use axes, which have not preferred forward/back direction) | |
--hybrid |
flag | (optional) use the hybrid approach | |
--hybridSamplesFactor |
Double | 1.0 |
(optional) specify a seed multiplication factor for the first stage of hybrid tracking |
--hybridMin |
Double | (optional) specify an minimum for the first stage of hybrid tracking | |
--hybridAngle |
Double | (optional) specify an angle for the first stage of hybrid tracking | |
--hybridDisperse |
Double | 0.1 |
(optional) specify an amount of dispersion to in the first stage of hybrid tracking |
--hybridPresmooth |
Double | (optional) specify an pre-smoothing bandwidth (before projection) | |
--hybridProjAngle |
Double | 45.0 |
(optional) specify an angle for hybrid projection |
--hybridProjNorm |
Double | 0.01 |
(optional) specify a minimum norm for hybrid projection |
--hybridProjFrac |
Double | 0.025 |
(optional) specify a minimum compartment fraction for hybrid projection |
--hybridProjFsum |
Double | 0.05 |
(optional) specify a minimum total fraction for hybrid projection |
--hybridPostsmooth |
Double | (optional) specify an post-smoothing bandwidth (after projection) | |
--hybridInterp |
KernelInterpolationType | Nearest |
(optional) the interpolation type for the first stage of hybrid tracking (Options: Nearest, Trilinear, Gaussian) |
--gforce |
Double | 0.0 |
(optional) the prior gain forces (larger values have smoother effects and zero is hard selection) |
--model |
String | (optional) a model name (default will try to detect it) | |
--threads |
int | 3 |
(optional) the number of threads |
--max |
Double | (optional) a maximum value for tracking (FA for dti, frac for xfib/spharm, ficvf for noddi) | |
--mixing |
Double | 1.0 |
(optional) the mixing weight for orientation updates (0 to 1) |
--arclen |
Double | 0.8 |
(optional) an arclength containment threshold |
--reach |
Double | (optional) only allow tracking to travel a given reach distance from the seed | |
--rk |
flag | (optional) use fourth-order Runge-Kutta integration (default is Euler) | |
--binarize |
flag | (optional) binarize masks (ignore multiple labels in include and other masks) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Curves | the output tractography curves |
Citation: Cabeen, R. P., Bastin, M. E., & Laidlaw, D. H. (2016). Kernel regression estimation of fiber orientation mixtures in diffusion MRI. NeuroImage, 127, 158-172.
VolumeMosaic
Create a mosaic from an image volume. This will take a 3D volume and create a single slice that shows the whole dataset. This is mainly useful for quality assessment.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--output |
String | output filename to save mosaic | |
--axis |
VolumeMosaicAxis | i |
(optional) choose an axis for slicing (Options: i, j, k) |
--crop |
String | (optional) a string for cropping the volume, e.g. :,:,10:2:17 would show slices 10, 12, 14, and 16 etc. | |
--rgb |
flag | (optional) treat the input as RGB | |
--enhance |
flag | (optional) enhance the contrast | |
--min |
Double | (optional) use a linear colormap with the given fixed minimum | |
--max |
Double | (optional) use a linear colormap with the given fixed maximum | |
--multichannel |
flag | (optional) save out multichannel slices (the output filename must include ‘%d’ if you use this option) |
VolumeNiftiCopyHeader
Copy the image data of the input image into a reference volume’s nifti header
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | the filename of the input volume (the source of data) | |
--ref |
String | the filename of input reference volume (for providing the header) | |
--output |
String | the filename of the output volume |
VolumeNiftiPrintHeader
Print the header of the given nifti file (this is faster than other modules because it doesn’t read the image data)
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | the filename of the input volume | |
--table |
flag | (optional) write the summary as a table |
VolumeNiftiRead
Load a nifti in a non-standard way, e.g. setting certain header fields before loading the image data
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | the filename of the input nifti volume | |
--scl_slope |
Double | (optional) set the scl_slope field to a certain value | |
--scl_inter |
Double | (optional) set the scl_inter field to a certain value |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the filename of the output volume |
VolumeNiftiVoxelToWorld
Extract the affine transform between voxel and world coordinates (note: this is designed for nifti volumes that have some arbitrary voxel ordering)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input Volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--noscale |
flag | (optional) skip the scaling | |
--notrans |
flag | (optional) skip the translation | |
--norot |
flag | (optional) skip the rotation |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output affine |
VolumeNoddiAbtin
Extract ABTIN (ABsolute TIssue density from NODDI) parameters from a noddi volume. Port from: https://github.com/sepehrband/ABTIN/blob/master/ABTIN.m
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input noddi volume |
--mask |
Mask | (optional) the mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--alpha |
double | 25.0 |
(optional) the alpha parameter (see theory section of paper) |
--gratio |
double | 0.7 |
(optional) the alpha parameter (see theory section of paper) |
Output:
| Flag | Type | Description |
|---|---|---|
--outputMylDen |
Volume | output myelin density volume |
--outputCSFDen |
Volume | output CSF density volume |
--outputFibDen |
Volume | output fiber density volume |
--outputCelDen |
Volume | output cellular density volume |
Citation: Sepehrband, F., Clark, K. A., Ullmann, J. F.P., Kurniawan, N. D., Leanage, G., Reutens, D. C. and Yang, Z. (2015), Brain tissue compartment density estimated using diffusion-weighted MRI yields tissue parameters consistent with histology. Hum. Brain Mapp.. doi: 10.1002/hbm.22872 Link: http://onlinelibrary.wiley.com/doi/10.1002/hbm.22872/abstract
VolumeNoddiCortex
Estimate cortical gray matter noddi parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mesh |
Mesh | input mesh |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--estimation |
String | Component |
(optional) specify an estimation method |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--pial |
String | pial |
(optional) pial attribute name |
--white |
String | white |
(optional) white attribute name |
--samples |
int | 15 |
(optional) the number of points to sample |
--inner |
double | 0.5 |
(optional) the inner search buffer size |
--outer |
double | 0.5 |
(optional) the outer search buffer size |
--maxiso |
Double | 0.5 |
(optional) the maximum isotropic volume fraction |
--zscore |
Double | 3.0 |
(optional) the maximum isotropic volume fraction |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | the output mesh |
--weights |
Volume | (optional) the output weights |
VolumeNoddiFit
Fit a noddi volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input diffusion-weighted MR volume |
--gradients |
Gradients | the gradients |
--mask |
Mask | (optional) the mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
VolumeNoddiFitMethod | FullSMT |
(optional) the method for fitting (Options: SmartStart, FullSMT, SMT, FastSMT, NLLS, Grid) |
--dpar |
Double | 0.0017 |
(optional) the parallel diffusivity (change for ex vivo) |
--diso |
Double | 0.003 |
(optional) the isotropic diffusivity (change for ex vivo) |
--dot |
flag | (optional) include a dot compartment (set for ex vivo) | |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
--columns |
flag | (optional) use fine-grained multi-threading |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--shells |
String | (optional) specify a subset of gradient shells to include (comma-separated list of b-values) | |
--which |
String | (optional) specify a subset of gradients to include (comma-separated list of indices starting from zero) | |
--exclude |
String | (optional) specify a subset of gradients to exclude (comma-separated list of indices starting from zero) | |
--maxiter |
Integer | 100 |
(optional) specify a maximum number of iterations for non-linear optimization |
--rhobeg |
double | 0.1 |
(optional) specify the starting rho parameter for non-linear optimization |
--rhoend |
double | 1.0E-4 |
(optional) specify the ending rho parameter for non-linear optimization |
--prior |
Double | (optional) specify the prior for regularizing voxels with mostly free water, a value between zero and one that indicates substantial free water, e.g. 0.95) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output noddi volume (name output like *.noddi and an directory of volumes will be created) |
VolumeNoddiSmooth
Smooth a noddi volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input Noddi volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--hdir |
Double | (optional) the directionally adaptive bandwidth (only used with adaptive flag) | |
--hsig |
Double | (optional) the baseline signal adaptive bandwidth | |
--estimation |
String | Scatter |
(optional) specify an estimation method |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output noddi volume |
VolumeNoddiTransform
Transform a noddi volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input noddi volume |
--reference |
Volume | input reference volume |
--mask |
Mask | (optional) input mask (defined in the reference space) |
--inputMask |
Mask | (optional) use an input mask (defined in the input space) |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--reorient |
ReorientationType | Jacobian |
(optional) specify a reorient method (Options: FiniteStrain, Jacobian) |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--estimation |
String | Component |
(optional) specify an estimation method |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output transformed noddi volume |
VolumeNoddiZoom
Zoom a noddi volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input noddi volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--factor |
double | 2.0 |
(optional) a zooming factor |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 2.0 |
(optional) the positional kernel bandwidth in mm |
--hval |
Double | (optional) the data kernel bandwidth | |
--hsig |
Double | (optional) the signal kernel bandwidth | |
--estimation |
String | Scatter |
(optional) specify an estimation method |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output noddi volume |
VolumeNoise
Add synthetic noise to a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--sigma |
double | 1.0 |
(optional) noise level |
--rician |
flag | (optional) use rician distributed noise |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeNormalize
Normalize the values of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--type |
VolumeNormalizeType | UnitMax |
(optional) type of normalization (Options: Unit, UnitMax, UnitSum, UnitMean, Mean, UnitMaxFraction, UnitMeanFraction, Gaussian) |
--fraction |
double | 0.5 |
(optional) a fraction for normalization (only applies to some types of normalization) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeOdfFeature
Estimate spherical harmonics representing the ODF. SUpported features include: generalized fractional anisotropy (GFA) and normalized entropy (NE)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input ODF volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | GFA |
(optional) the name of the feature (GFA, NE) |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output spharm volume |
VolumeOdfFit
Fit an orientation distribution function (ODF) using spherical deconvolution
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input dwi |
--gradients |
Gradients | the gradients |
--points |
Vects | (optional) the input odf directions (if you don’t provide this, you they will be generated and returned in outpoints) |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 300 |
(optional) the number of points to use if you need to generate spherical points |
--iters |
int | 500 |
(optional) the number of iterations for deconvolution |
--alpha |
double | 0.0017 |
(optional) the kernel diffusivity for deconvolution |
--beta |
double | 0.0 |
(optional) the kernel radial diffusivity for deconvolution |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--shells |
String | (optional) specify a subset of gradient shells to include (comma-separated list of b-values) | |
--which |
String | (optional) specify a subset of gradients to include (comma-separated list of indices starting from zero) | |
--exclude |
String | (optional) specify a subset of gradients to exclude (comma-separated list of indices starting from zero) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output ODF volume |
--outpoints |
Vects | (optional) the output odf directions (only relevant if you didn’t provide a specific set) |
Citation: Dell’Acqua, F., Scifo, P., Rizzo, G., Catani, M., Simmons, A., Scotti, G., & Fazio, F. (2010). A modified damped Richardson-Lucy algorithm to reduce isotropic background effects in spherical deconvolution. Neuroimage, 49(2), 1446-1458.
VolumeOdfPeaks
Extract the peaks from an odf volume. This finds the average direction of local maxima clustered by hierarchical clustering. The output fibers will encode the peak ODF value in place of volume fraction.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input ODF volume |
--points |
Vects | the odf directions |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--comps |
Integer | 3 |
(optional) the maximum number of comps |
--gfa |
flag | (optional) scaleCamera peak values by generalized fractional anisotropy after extraction | |
--thresh |
Double | 0.01 |
(optional) the minimum peak threshold |
--mode |
PeakMode | Mean |
(optional) the mode for extracting the peak fraction from the lobe (Options: Sum, Mean, Max) |
--cluster |
Double | 25.0 |
(optional) the minimum angle in degrees for hierarchical clustering of local maxima |
--match |
flag | (optional) match the ODF sum | |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers volume |
VolumeOdfResample
Resample an ODF using spherical harmonics. Using a lower maximum order will lead to smoother resamplings
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input ODF volume |
--dirs |
Vects | the input odf directions |
--resample |
Vects | the directions to resample |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--order |
Integer | 8 |
(optional) the maximum spherical harmonic order used for resampling |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output ODF volume |
VolumeOdfSpharm
Estimate spherical harmonics representing the ODF
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input ODF volume |
--dirs |
Vects | the odf directions |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--order |
Integer | 8 |
(optional) the maximum spherical harmonic order |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output spharm volume |
VolumeOrigin
set the origin of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--x |
double | 0.0 |
(optional) the origin in x |
--y |
double | 0.0 |
(optional) the origin in y |
--z |
double | 0.0 |
(optional) the origin in z |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumePad
Pad a volume by a given number of voxels
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pad |
int | 10 |
(optional) the amount of padding in voxels |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output mask |
VolumeParticles
Create particles representing a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--output |
String | output filename (should end in csv) | |
--samples |
int | 4 |
(optional) at most, produce this many samples per voxel |
--adaptive |
flag | (optional) sample particles adaptively, that is, most particles with higher image intensities | |
--thresh |
double | 0.0 |
(optional) specify a threshold for background removal, e.g. 0.01 (based on input image intensities) |
--type |
VolumeEnhanceContrastType | Ramp |
(optional) use the given type of contrast enhancement to normalize the image (Options: Histogram, Ramp, RampGauss, Mean, None) |
--interp |
InterpolationType | Nearest |
(optional) use the given image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
VolumePerturbDeform
Perturb a volume morphometry for data augmentation
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--deform |
Mask | (optional) apply a deform in the given region |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--flip |
Double | (optional) specify the probability of a flip perturbation (zero to one) | |
--angle |
Double | (optional) specify the sampling standard deviation of the angular perturbation (degrees) | |
--scale |
Double | (optional) specify the sampling standard deviation of the total scaling perturbation (added to a scaling factor of one) | |
--aniso |
Double | (optional) specify the sampling standard deviation of the anisotropic scaling perturbation (added to an anisotropic scaling of one) | |
--shear |
Double | (optional) specify the sampling standard deviation of the anisotropic shear perturbation | |
--shift |
Double | (optional) specify the sampling standard deviation of the translational shift perturbation | |
--deformEffect |
Double | 3.0 |
(optional) specify the amount of deform |
--deformExtent |
Double | 10.0 |
(optional) specify the extent of deform |
--deformIters |
Integer | 10 |
(optional) specify the number of deformation integration iterations |
--deformRandomize |
Double | 0.0 |
(optional) randomize the amount of deform with the given sample standard deviation |
Output:
| Flag | Type | Description |
|---|---|---|
--outputVolume |
Volume | (optional) output volume |
--outputDeform |
Deformation | (optional) output deformation field |
--outputAffine |
Affine | (optional) output affine transform |
--outputTable |
Table | (optional) output table |
VolumePerturbSignal
Perturb the volume signal for data augmentation
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--blend |
Volume | (optional) input blending volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--blendMean |
Double | 0.0 |
(optional) specify the blending factor sampling mean value |
--blendStd |
Double | 0.0 |
(optional) specify the averaging factor sampling standard deviation |
--noise |
Double | 0.0 |
(optional) specify the sampling standard deviation of the intensity noise perturbation |
--biasMean |
Double | 0.0 |
(optional) specify the sampling mean of the bias field perturbation |
--biasStd |
Double | 0.0 |
(optional) specify the sampling standard deviation of the bias field perturbation |
--contrastMean |
Double | 0.0 |
(optional) specify the sampling mean of the contrast perturbation (zero is no change) |
--contrastStd |
Double | 0.0 |
(optional) specify the sampling standard deviation of the contrast perturbation (zero is no change) |
Output:
| Flag | Type | Description |
|---|---|---|
--outputVolume |
Volume | (optional) output volume |
--outputTable |
Table | (optional) output table |
VolumePhantomBox
Create a simple box phantom
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--width |
int | 100 |
(optional) image width |
--height |
int | 100 |
(optional) image height |
--slices |
int | 1 |
(optional) image slices |
--size |
double | 0.5 |
(optional) box relative dimensions |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumePoseCopy
Set the pose (orientation and origin) of a volume to match a reference volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--ref |
Volume | the reference volume (the pose will be copied from here) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
flag | (optional) copy the voxel spacing as well |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumePoseGet
Get the pose (orientation and origin) of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | the output affine xfm |
VolumePoseSet
Set the pose (orientation and origin) of a volume. By default, the existing origin and orientation will be removed
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--pose |
Affine | the affine pose (any shear will be removed) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--premult |
flag | (optional) compose the existing pose with the given one by premultiplying | |
--postmult |
flag | (optional) compose the existing pose with the given one by post multiplying |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumePrintInfo
Print basic information about a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--stats |
flag | (optional) print statistics | |
--nifti |
flag | (optional) print complete nifti header (only relevant if the input is nifti) |
VolumeProjection
Compute a projection of an image volume along one axis, for example a minimum intensity projection
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--axis |
VolumeProjectionAxis | k |
(optional) the axis for the projection (Options: i, j, k) |
--type |
VolumeProjectionType | Mean |
(optional) the type of statistic for the projection (Options: Min, Max, Mean, Sum, Var, CV, Median, IQR) |
--thin |
Integer | (optional) use thin projection, whereby groups of the given number of slices are aggregated | |
--index |
int | 0 |
(optional) when collapsing the volume to a single slice, use this image index for the position |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output image slice |
VolumePrototype
Crop a volume down to a smaller volume (only one criteria per run)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dim |
Integer | the output volume dimension |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeReduce
Reduce a multi-channel volume to a volume with fewer channels
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--which |
String | (optional) the list of indices to select (comma separated zero-based indices) | |
--exclude |
String | (optional) exclude specific indices (comma separated zero-based indices) | |
--method |
VolumeReduceType | Mean |
(optional) specify the reduction technique (Subset depends on which or exclude flags) (Options: Subset, Mean, Min, Max, Sum, Var, Std, Gray, RGB) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeRegionMinima
Mask a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--regions |
Mask | a mask encoding regions |
--lookup |
Table | a table encoding region names |
--mask |
Mask | (optional) a mask restricting which voxels are checked |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--minimum |
flag | (optional) retain the minimum value | |
--sample |
flag | (optional) retain the sample voxel indices | |
--index |
String | index |
(optional) specify the lookup index field |
--name |
String | name |
(optional) specify the lookup name field |
--min |
String | min |
(optional) specify the output field name for the minimum value |
--i |
String | i |
(optional) specify the output field name for the sample i index |
--j |
String | j |
(optional) specify the output field name for the sample j index |
--k |
String | k |
(optional) specify the output field name for the sample k index |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
VolumeRegisterLinear
Estimate an affine transform between two volumes
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input moving volume, which is registered to the reference volume |
--ref |
Volume | the reference volume |
--mask |
Mask | (optional) a mask used to exclude a portion of the input volume |
--refmask |
Mask | (optional) a mask used to exclude a portion of the reference volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--init |
VolumeRegisterLinearInit | Center |
(optional) the type of initialization (Options: World, Center, CenterSize) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Affine | output transform |
VolumeRemoveNaN
Remove NaN values
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--replace |
Double | 0.0 |
(optional) the value to replace |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeRender
Render a volume slice based on a colormap
Input:
| Flag | Type | Description |
|---|---|---|
--background |
Volume | (optional) input background |
--foreground |
Volume | (optional) input foreground colored using a scalar colormap |
--labels |
Mask | (optional) input labels colored using a discrete colormap |
--fgmask |
Mask | (optional) input foreground mask |
--bgmask |
Mask | (optional) input background mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--range |
String | all |
(optional) input slice range, e.g. :,:,80 |
--bgmap |
String | grayscale |
(optional) background colormap |
--bglow |
String | 0 |
(optional) background lower bound (supports statistics like min, max, etc) |
--bghigh |
String | 1 |
(optional) background upper bound (supports statistics like min, max, etc) |
--fgmap |
String | grayscale |
(optional) scalar colormap for coloring the volume |
--fglow |
String | 0 |
(optional) scalar lower bound (supports statistics like min, max, etc) |
--fghigh |
String | 1 |
(optional) scalar upper bound (supports statistics like min, max, etc) |
--fgrlow |
String | 0 |
(optional) scalar lower bound for range (0 to 1) |
--fgrhigh |
String | 1 |
(optional) scalar upper bound for range (0 to 1) |
--discrete |
String | White |
(optional) discrete colormap for coloring the label volume |
--invert |
flag | (optional) invert colormap | |
--wash |
double | 0.0 |
(optional) wash out colors |
--alpha |
double | 1.0 |
(optional) blending of background with foreground |
--label |
String | attribute |
(optional) a label for the colormap |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | (optional) output RGB volume rendering |
--colormap |
Volume | (optional) output RGB colormap rendering |
VolumeReorder
Change the ordering of voxels in a volume. You can flip and shift the voxels. Which shifting outside the field a view, the data is wrapped around. Shifting is applied before flipping
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--flipi |
flag | (optional) flip in i | |
--flipj |
flag | (optional) flip in j | |
--flipk |
flag | (optional) flip in k | |
--shifti |
int | 0 |
(optional) shift in i |
--shiftj |
int | 0 |
(optional) shift in j |
--shiftk |
int | 0 |
(optional) shift in k |
--swapij |
flag | (optional) swap ij | |
--swapik |
flag | (optional) swap ik | |
--swapjk |
flag | (optional) swap jk |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeResample
Resample a volume with a different voxel size
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dx |
double | 1.0 |
(optional) the voxel size in x |
--dy |
double | 1.0 |
(optional) the voxel size in y |
--dz |
double | 1.0 |
(optional) the voxel size in z |
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeResliceACPC
Reslice a volume using ACPC alignment (anterior and posterior commissure). You must provide a vects object with three points for the AC, PC, and another midline position (order must match)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--acpcmid |
Vects | a vects containing three points: the anterior commisure, the posterior commissure, and any other midline point that is superior to the AC-PC axis |
--bounds |
Vects | (optional) points that bound the region of interest (by default the whole volume will be used) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
Double | (optional) the voxel spacing (by default it detects it from the input) | |
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeResliceAxis
Reslice a volume along a given axis (specified by a vects)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--vects |
Vects | (optional) input vects (should roughly lie on a straight line) |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
Double | (optional) the voxel spacing (by default it detects it from the input) | |
--mode |
VolumeResliceMode | K |
(optional) specify the target slice (Options: I, J, K) |
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeReslicePlane
Reslice a volume by a given plane (contained in a solids object)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--plane |
Solids | input solids (should contain a plane) |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--delta |
Double | (optional) the voxel spacing (by default it detects it from the input) | |
--mode |
VolumeResliceMode | K |
(optional) specify the target slice (Options: I, J, K) |
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeSampleCortex
Estimate cortical gray matter parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mesh |
Mesh | input mesh |
--mask |
Mask | (optional) a mask |
--gm |
Volume | (optional) input gray matter probability map |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--name |
String | data |
(optional) the name of the volumetric data (only used for naming mesh attributes) |
--pial |
String | pial |
(optional) pial attribute name |
--middle |
String | middle |
(optional) the middle attribute name |
--white |
String | white |
(optional) white attribute name |
--samples |
int | 15 |
(optional) the number of points to sample |
--inner |
double | 0.0 |
(optional) the inner search buffer size |
--outer |
double | 0.0 |
(optional) the outer search buffer size |
--linear |
flag | (optional) use linear weights, e.g. 1 - abs(x) | |
--gain |
double | 12.0 |
(optional) use the given weight gain, e.g. exp(-gain*x^2)) |
--zscore |
Double | 3.0 |
(optional) the z-score for filtering |
--mest |
flag | (optional) use Tukey’s biweight m-estimator for robust statistics |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | (optional) the output mesh |
--weights |
Volume | (optional) the output weights |
--num |
Vects | (optional) the output num vects |
--median |
Vects | (optional) the output mean vects |
--mean |
Vects | (optional) the output mean vects |
--std |
Vects | (optional) the output std vects |
--min |
Vects | (optional) the output min vects |
--max |
Vects | (optional) the output max vects |
VolumeSampleLine
Sample a volume along a polyline. The results are stored in table along with the world coordinates and position along the segment
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--vects |
Vects | input vects (two points in a vects object) |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
int | 5 |
(optional) the number of samples |
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
--value |
String | value |
(optional) the name of the volume value field |
--vector |
flag | (optional) include vector values |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dims |
String | (optional) a which of dimensions to use | |
--vx |
String | x |
(optional) the field for the x coordinate |
--vy |
String | y |
(optional) the field for the y coordinate |
--vz |
String | z |
(optional) the field for the z coordinate |
--pos |
String | posCamera |
(optional) the position along the line segment in mm |
--idx |
String | idx |
(optional) the index along the line segment |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
VolumeSegmentCluster
Segment a volume by clustering intensities (with k-means, dp-means, or Gaussian mixtures)
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--iters |
int | 10 |
(optional) a maximum number of iterations |
--num |
int | 3 |
(optional) the number classes (inital guess in the case of dp-means) |
--restarts |
int | 1 |
(optional) the number of restarts |
--lambda |
Double | (optional) a threshold for detecting the number of clusters in the DP-means algorithm | |
--bayesian |
flag | (optional) use a Bayesian probabilistic approach (MRF Gaussian mixture expectation maximization framework) | |
--emIters |
Integer | 5 |
(optional) use the following number of expectation maximization iteration |
--emCov |
String | spherical |
(optional) specify a covariance type (spherical, diagonal, full) |
--emReg |
Double | 0.0 |
(optional) a regularization parameter added to the covariance |
--mrfIters |
Integer | 5 |
(optional) use the following number of MRF optimization iterations |
--mrfCross |
flag | (optional) use a 6-neighborhood (instead of a full 27-neighborhood with diagonals) | |
--mrfGamma |
Double | 1.0 |
(optional) use the following spatial regularization weight |
--mrfCrfGain |
Double | 1.0 |
(optional) use the gain used for the conditional random field (zero will disable it) |
Output:
| Flag | Type | Description |
|---|---|---|
--labels |
Mask | the output label map |
--membership |
Volume | the output membership map |
VolumeSegmentForeground
Segment the foreground of a volume using a statistical approach
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--median |
Integer | 1 |
(optional) the number of times to median prefilter |
--thresh |
Double | (optional) apply a threshold | |
--fill |
flag | (optional) fill the foreground mask to remove islands | |
--largest |
flag | (optional) extract the largest island | |
--mrf |
flag | (optional) apply markov random field spatial regularization | |
--mrfCross |
flag | (optional) use a 6-neighborhood (instead of a full 27-neighborhood with diagonals) | |
--mrfGamma |
Double | 1.0 |
(optional) use the following spatial regularization weight |
--mrfCrfGain |
Double | 1.0 |
(optional) use the gain used for the conditional random field (zero will disable it) |
--mrfIcmIters |
Integer | 5 |
(optional) use the following number of MRF optimization iterations |
--mrfEmIters |
Integer | 5 |
(optional) use the following number of expectation maximization iteration |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | (optional) the output mask |
--report |
Table | (optional) the output report |
VolumeSegmentForegroundOtsu
Segment the foreground of a volume using the Otsu method
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--median |
int | 3 |
(optional) apply a median filter this many times before segmenting |
--open |
int | 2 |
(optional) open the mask with mask morphology |
--islands |
flag | (optional) keep islands in the segmentation (otherwise only the largest component is kept) | |
--holes |
flag | (optional) keep holes in the segmentation (otherwise they will be filled) | |
--dilate |
int | 0 |
(optional) dilate the segmentation at the very end |
--threads |
int | 1 |
(optional) use this many threads |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output mask |
VolumeSegmentGraph
Segment a volume using graph based segmentation
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--min |
Integer | 10 |
(optional) a minima region size |
--threshold |
Double | 1.0 |
(optional) a threshold for grouping |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output segmentation mask |
Citation: Felzenszwalb, P. F., & Huttenlocher, D. P. (2004). Efficient graph-based image segmentation. International journal of computer vision, 59(2), 167-181. Chicago
VolumeSegmentLocalExtrema
Segment a volume based on local extrema
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--minima |
flag | (optional) find minima instead of maxima | |
--full |
flag | (optional) use a full 27-voxel neighborhood (default is 6-voxel) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output region labels |
VolumeSegmentRegionGrowing
Segment a volume using a statistical region-growing technique
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--seed |
Mask | the input seed mask |
--include |
Mask | (optional) an option mask for including only specific voxels in the segmentation |
--exclude |
Mask | (optional) an option for excluding voxels from the segmentation |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--nbThresh |
int | 0 |
(optional) the neighbor count threshold |
--dataThresh |
Double | 3.0 |
(optional) the intensity stopping threshold |
--gradThresh |
Double | 3.0 |
(optional) the gradient stopping threshold |
--maxiter |
int | 10000 |
(optional) the maxima number of iterations |
--maxsize |
double | 1.7976931348623157E308 |
(optional) the maxima region volume |
--full |
flag | (optional) use a full 27-voxel neighborhood (default is 6-voxel) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output segmentation |
Citation: Adams, R., & Bischof, L. (1994). Seeded region growing. IEEE Transactions on pattern analysis and machine intelligence, 16(6), 641-647.
VolumeSegmentSuperKMeans
Segment supervoxels from a volume using k-means. Voxels are clustered based on position and intensity
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--iters |
int | 10 |
(optional) a maxima number of iterations |
--num |
int | 100 |
(optional) the number regions |
--scale |
double | 1.0 |
(optional) the scaleCamera for combining intensities with voxel positions |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | none |
VolumeSegmentSuperSLIC
Segment a volume to obtain SLIC supervoxels
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--iters |
int | 500 |
(optional) a maximum number of iterations |
--error |
double | 0.001 |
(optional) the convergence criteria |
--size |
double | 20.0 |
(optional) the average size (along each dimension) for the supervoxels |
--scale |
double | 1.0 |
(optional) the scaleCamera for intensities |
--merge |
double | 10.0 |
(optional) a threshold region volume for merging |
--group |
Double | (optional) a threshold gradient magnitude for grouping |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | none |
Citation: Radhakrishna Achanta, Appu Shaji, Kevin Smith, Aurelien Lucchi, Pascal Fua, and Sabine Susstrunk, SLIC Superpixels, EPFL Technical Report 149300, June 2010.
VolumeSetGrid
Standardize the orientation of a volume (no rotation and zero origin). The original pose can be saved to xfm.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input Volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--df |
Double | (optional) scale the delta by the given factor | |
--dx |
Double | (optional) set the x delta | |
--dy |
Double | (optional) set the y delta | |
--dz |
Double | (optional) set the z delta | |
--sf |
Double | (optional) scale the voxel origin by the given factor | |
--sx |
Double | (optional) set the x origin (delta) | |
--sy |
Double | (optional) set the y origin (delta) | |
--sz |
Double | (optional) set the z origin (delta) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | (optional) output Volume |
VolumeSetSampling
Set the origin of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--starti |
Double | (optional) the origin in i | |
--startj |
Double | (optional) the origin in j | |
--startk |
Double | (optional) the origin in k | |
--deltai |
Double | (optional) the voxel spacing in i | |
--deltaj |
Double | (optional) the voxel spacing in j | |
--deltak |
Double | (optional) the voxel spacing in k |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeSetTable
Create a table listing regions of a mask
Input:
| Flag | Type | Description |
|---|---|---|
--reference |
Volume | input volume |
--table |
Table | input table |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dim |
int | 0 |
(optional) the channel |
--index |
String | index |
(optional) the index field name |
--value |
String | value |
(optional) a field to set |
--background |
double | 0.0 |
(optional) a background value |
--missing |
Double | (optional) a missing value |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeSkeletonize
Extract a skeleton from the local maxima and ridges of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threshold |
Double | (optional) exclude voxels with an input intensity below this value |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output skeleton |
VolumeSlice
Threshold a volume to make a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--slice |
int | 0 |
(optional) a slice number |
--dim |
String | z |
(optional) a slice channel (x, y, or z) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeSliceMesh
Create a mesh from image slices
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--attribute |
String | data |
(optional) specify a name for the attribute |
--range |
String | start:25:end |
(optional) specify a range of slices to extract (or a specific slice) |
--axis |
VolumeSliceMeshAxis | k |
(optional) the slice axis (Options: i, j, k) |
--nobg |
flag | (optional) remove background voxels | |
--thresh |
double | 1.0E-6 |
(optional) specify a threshold for background removal |
--color |
flag | (optional) add vertex colors | |
--normalize |
flag | (optional) use min/max normalization |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output mesh |
VolumeSmtFit
Estimate microscopic diffusion parameters
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input diffusion-weighted MR volume |
--gradients |
Gradients | the input gradients |
--mask |
Mask | (optional) the input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threads |
int | 1 |
(optional) the input number of threads |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--maxiter |
int | 5000 |
(optional) the maximum number of iterations |
--rhobeg |
double | 0.1 |
(optional) the starting simplex size |
--rhoend |
double | 1.0E-6 |
(optional) the ending simplex size |
--dperp |
double | 5.0E-4 |
(optional) the initial guess for perpendicular diffusivity |
--dpar |
double | 0.0017 |
(optional) the initial guess for parallel diffusivity |
--dmax |
double | 0.003 |
(optional) the maximum diffusivity |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output parameter map |
Citation: Kaden, E., Kruggel, F., & Alexander, D. C. (2016). Quantitative mapping of the per-axon diffusion coefficients in brain white matter. Magnetic resonance in medicine, 75(4), 1752-1763.
VolumeSort
Sort two volumes based on their mean intensity
Input:
| Flag | Type | Description |
|---|---|---|
--a |
Volume | input volume a |
--b |
Volume | input volume b |
--mask |
Mask | (optional) input mask |
Output:
| Flag | Type | Description |
|---|---|---|
--outputLow |
Volume | output low volume |
--outputHigh |
Volume | output high volume |
VolumeSortChannels
Sort the channels of a multi-channel volumes based on their mean intensity
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) input mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order (output will be decreasing) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output |
VolumeSpharmODF
Sample an orientation distribution function (ODF) from a spharm volume.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input spharm volume |
--points |
Vects | (optional) the sphere points for estimation |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--num |
Integer | 300 |
(optional) the number of points to use if you need to generate spherical points |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output odf volume |
--outpoints |
Vects | (optional) the output odf directions (only relevant if you didn’t provide a specific set) |
VolumeSpharmPeaks
Extract the peaks from a spherical harmonic volume. This finds the average direction of local maxima clustered by hierarchical clustering. The output fibers will encode the peak q-value in place of volume fraction.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input spharm volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--comps |
Integer | 4 |
(optional) the maximum number of comps |
--thresh |
Double | 0.1 |
(optional) the minimum peak threshold |
--detail |
Integer | 7 |
(optional) the level of detail for spherical harmonic sampling |
--mode |
PeakMode | Mean |
(optional) the mode for extracting the peak fraction from the lobe (Options: Sum, Mean, Max) |
--cluster |
Double | 25.0 |
(optional) the minimum angle in degrees for hierarchical clustering of local maxima |
--match |
flag | (optional) match the ODF sum | |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output fibers volume |
VolumeStackParticles
Extract particles from an image stack. This is meant to process datasets that are too big to be fully loaded into memory. This will process one slice at a time and save the results to disk in the process.
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | slice%04d.tif |
(optional) input filename pattern (e.g. %04d will be replaced with 0000, 0001, etc. or e.g. %d will be replaced with 0, 1, etc.) |
--isize |
double | 1.0 |
(optional) the voxel size in the i direction |
--jsize |
double | 1.0 |
(optional) the voxel size in the j direction |
--ksize |
double | 1.0 |
(optional) the voxel size in the k direction |
--istart |
int | 0 |
(optional) start at the given pixel in i when reading the volume |
--jstart |
int | 0 |
(optional) start at the given pixel in j when reading the volume |
--kstart |
int | 0 |
(optional) start at the given pixel in k when reading the volume |
--istep |
int | 1 |
(optional) step the given number of pixels in i when reading the volume |
--jstep |
int | 1 |
(optional) step the given number of pixels in j when reading the volume |
--kstep |
int | 1 |
(optional) step the given number of pixels in k when reading the volume |
--samples |
Double | 8.0 |
(optional) the number of particle samples per unit intensity (e.g. if the image intensity is one, it will produce this many particles) |
--min |
double | 0.25 |
(optional) specify a minimum window intensity (all voxels below this intensity are ignored) |
--max |
double | 0.75 |
(optional) specify a maximum window intensity (all voxels above this intensity are sampled uniformly) |
--empty |
flag | (optional) keep empty particle slices | |
--dstart |
int | 0 |
(optional) start at the given index when loading slices |
--dend |
Integer | (optional) end at the given index when loading slices | |
--dstep |
int | 1 |
(optional) step the given amount when loading slices |
--interp |
InterpolationType | Nearest |
(optional) use the given image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
--output |
String | output.csv |
(optional) output filename of particles (should end in csv) |
VolumeStackProject
Compute the maximum or minimum intensity projection of an image stack
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | input/slice%04d.png |
(optional) input filename pattern (e.g. %04d will be replaced with 0000, 0001, etc. or e.g. %d will be replaced with 0, 1, etc.) |
--min |
flag | (optional) use a minimum intensity projection (default is maximum intensity projection) | |
--mode |
ProjectMode | FullZ |
(optional) project slabs of a given stack fraction (only relevant to SlabFracZ) (Options: FullZ, SlabZ, SlabFracZ, FullX, FullY) |
--statistic |
StatisticMode | Max |
(optional) the statistic to use for projection (Options: Max, Min, Mean, Sum) |
--slabCount |
Integer | 100 |
(optional) project slabs of a given thickness (only relevant to SlabZ) |
--slabStep |
Integer | 100 |
(optional) use a given step amount (only relevant to the SlabZ) |
--slabFraction |
Double | 0.1 |
(optional) project slabs of a given stack fraction (only relevant to SlabFracZ) |
--xstart |
int | 0 |
(optional) start at the given index projecting pixels in x |
--xend |
Integer | (optional) end at the given index projecting pixels in x | |
--ystart |
int | 0 |
(optional) start at the given index projecting pixels in y |
--yend |
Integer | (optional) end at the given index projecting pixels in y | |
--dstart |
int | 0 |
(optional) start at the given index when loading slices |
--dend |
Integer | (optional) end at the given index when loading slices | |
--dstep |
int | 1 |
(optional) step the given amount when loading slices |
--output |
String | output.png |
(optional) the output stack (use %d if you specify a slab) |
VolumeStackRead
Read a volume from an image stack
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | %03d.tif |
(optional) the input filename input for reading each image (must contain %d or some a similar formatting charater for substituting the index) |
--isize |
double | 1.0 |
(optional) the voxel size in the i direction |
--jsize |
double | 1.0 |
(optional) the voxel size in the j direction |
--ksize |
double | 1.0 |
(optional) the voxel size in the k direction |
--istart |
int | 0 |
(optional) start at the given pixel in i when reading the volume |
--jstart |
int | 0 |
(optional) start at the given pixel in j when reading the volume |
--kstart |
int | 0 |
(optional) start at the given pixel in k when reading the volume |
--istep |
int | 1 |
(optional) step the given number of pixels in i when reading the volume |
--jstep |
int | 1 |
(optional) step the given number of pixels in j when reading the volume |
--kstep |
int | 1 |
(optional) step the given number of pixels in k when reading the volume |
--dstart |
int | 0 |
(optional) start at the given index when loading slices |
--dend |
Integer | (optional) end at the given index when loading slices | |
--dstep |
int | 1 |
(optional) step the given amount when loading slices |
--smooth |
Double | (optional) apply Gaussian smoothing to each slice with the given bandwidth in pixels (before downsampling) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeStackReadBlocks
Extract particles from an image stack. This is meant to process datasets that are too big to be fully loaded into memory. This will process one slice at a time and save the results to disk in the process.
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | /your/path/input/block%04d.nii.gz |
(optional) input block filename pattern (e.g. %04d will be replaced with 0000, 0001, etc. or e.g. %d will be replaced with 0, 1, etc.) |
--ref |
String | /your/path/ref/slice%04d.png |
(optional) reference image stack filename pattern (e.g. %04d will be replaced with 0000, 0001, etc. or e.g. %d will be replaced with 0, 1, etc.) |
--isize |
int | 256 |
(optional) the block size in the i direction |
--jsize |
int | 256 |
(optional) the block size in the j direction |
--ksize |
int | 64 |
(optional) the voxel size in the k direction |
--overlap |
int | 8 |
(optional) the amount of overlap in blocks |
--scale |
double | 1.0 |
(optional) the scaling applied to the image intensities |
--dstart |
int | 0 |
(optional) start at the given index when loading slices |
--dend |
Integer | (optional) end at the given index when loading slices | |
--dstep |
int | 1 |
(optional) step the given amount when loading slices |
--output |
String | /your/path/output/slice%04d.png |
(optional) output image stack filename pattern (e.g. %04d will be replaced with 0000, 0001, etc. or e.g. %d will be replaced with 0, 1, etc.) |
VolumeStackWrite
Save the volume to an image stack
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--output |
String | output directory to the stack | |
--axis |
VolumeSaveStackAxis | k |
(optional) choose an axis for slicing (Options: i, j, k) |
--range |
String | (optional) specify a range, e.g. ‘10:50,5:25,start:2:end’ | |
--enhance |
flag | (optional) enhance the contrast | |
--pattern |
String | slice%04d.png |
(optional) the output pattern for saving each image |
VolumeStackWriteBlocks
Extract particles from an image stack. This is meant to process datasets that are too big to be fully loaded into memory. This will process one slice at a time and save the results to disk in the process.
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | /your/path/slice%04d.tif |
(optional) input image stack filename pattern (e.g. %04d will be replaced with 0000, 0001, etc. or e.g. %d will be replaced with 0, 1, etc.) |
--isize |
int | 256 |
(optional) the block size in the i direction |
--jsize |
int | 256 |
(optional) the block size in the j direction |
--ksize |
int | 64 |
(optional) the voxel size in the k direction |
--overlap |
int | 8 |
(optional) the amount of overlap in blocks |
--idelta |
double | 1.0 |
(optional) the voxel size in the i direction |
--jdelta |
double | 1.0 |
(optional) the voxel size in the j direction |
--kdelta |
double | 1.0 |
(optional) the voxel delta in the k direction |
--dstart |
int | 0 |
(optional) start at the given index when loading slices |
--dend |
Integer | (optional) end at the given index when loading slices | |
--dstep |
int | 1 |
(optional) step the given amount when loading slices |
--output |
String | /your/path/output%04d.nii.gz |
(optional) output block filename pattern (e.g. %04d will be replaced with 0000, 0001, etc. or e.g. %d will be replaced with 0, 1, etc.) |
VolumeStandardize
Standardize the orientation of a volume (no rotation and zero origin). The original pose can be saved to xfm.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input Volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | (optional) output Volume |
--xfm |
Affine | (optional) output affine |
--invxfm |
Affine | (optional) output inverse affine |
VolumeStatsPaired
Compute pairwise statistics from volumetric data
Input:
| Flag | Type | Description |
|---|---|---|
--matching |
Table | a table where each row stores a pair of matching subjects |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pattern |
String | input volume filename pattern (should contain %s for the subject identifier) | |
--left |
String | left |
(optional) the left group in the pair |
--right |
String | right |
(optional) the right group in the pair |
Output:
| Flag | Type | Description |
|---|---|---|
--outputLeftMean |
Volume | (optional) output left mean volume |
--outputLeftStd |
Volume | (optional) output left standard deviation volume |
--outputRightMean |
Volume | (optional) output right mean volume |
--outputRightStd |
Volume | (optional) output right standard deviation volume |
--outputDiff |
Volume | (optional) output difference in means |
--outputCohenD |
Volume | (optional) output Cohen’s-d effect size |
VolumeStoreVoxelPosition
Create a volume storing the 3D world coordinates of each voxel
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeSubset
Which the intensities of a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--which |
String | the list of indices to select |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeSurfacePlot
Plot data from a planar image
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--dimension |
int | 0 |
(optional) the channel |
--sx |
double | 1.0 |
(optional) the scaleCamera in x |
--sy |
double | 1.0 |
(optional) the scaleCamera in y |
--sz |
double | 1.0 |
(optional) the scaleCamera in z |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mesh | output |
VolumeTable
Record voxel values in a table
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) a mask |
--lookup |
Table | (optional) a lookup table for matching names to mask labels |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--value |
String | value |
(optional) value |
--multiple |
flag | (optional) use multiple mask labels |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--lookupNameField |
String | name |
(optional) specify the lookup name field |
--lookupIndexField |
String | voxel |
(optional) specify the output voxel field name |
--range |
String | (optional) a mask specification | |
--dims |
String | (optional) a which of dimensions to use | |
--vector |
flag | (optional) include vector values | |
--vi |
String | (optional) the field for the voxel i coordinate | |
--vj |
String | (optional) the field for the voxel j coordinate | |
--vk |
String | (optional) the field for the voxel k coordinate | |
--voxel |
String | voxel |
(optional) the field for the voxel voxel |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Table | output table |
VolumeTensorFilter
Filter a tensor volume in a variety of ways, e.g. changing units, clamping diffusivities, masking out regions
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--scale |
Double | (optional) the scaleCamera to multiply diffusivities (typically needed to changed the physical units) | |
--clamp |
Double | (optional) clamp the diffusivities (values below the threshold will be set to it) | |
--expression |
String | (optional) zero out voxels that do not satisfy the given arithmetic expression, e.g. FA > 0.15 && MD < 0.001 && MD > 0.0001 |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output tensor volume |
VolumeTensorFit
Fit a tensor volume to a diffusion-weighted MRI.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input diffusion-weighted MR volume |
--gradients |
Gradients | the gradients |
--mask |
Mask | (optional) the mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--method |
TensorFitType | LLS |
(optional) specify an estimation method (Options: LLS, WLLS, NLLS, FWLLS, FWWLLS, FWNLLS, RESTORE) |
Advanced Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--cost |
CostType | SE |
(optional) specify a cost function for non-linear fitting (Options: SE, MSE, RMSE, NRMSE, CHISQ, RLL) |
--single |
flag | (optional) use the lowest single shell for tensor estimation (if used, this will skip the shells, which, and exclude flags) | |
--bestb |
flag | (optional) use the best combination of b-values (first try b<=1250, and otherwise use the lowest single shell) | |
--rounder |
Integer | 100 |
(optional) specify the multiple for rounding b-values, e.g. if the rounder in 100, then 1233 is treated as 1200 |
--shells |
String | (optional) specify a subset of gradient shells to include (comma-separated list of b-values) | |
--which |
String | (optional) specify a subset of gradients to include (comma-separated list of indices starting from zero) | |
--exclude |
String | (optional) specify a subset of gradients to exclude (comma-separated list of indices starting from zero) | |
--baseline |
flag | (optional) estimate the baseline value separately from tensor parameter estimation (only for LLS) | |
--threads |
int | 1 |
(optional) the number of threads to use |
--clamp |
Double | 0.0 |
(optional) clamp the diffusivity to be greater or equal to the given value |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output tensor volume (name output like *.dti and an directory of volumes will be created) |
VolumeTensorNoise
Add noise to a tensor volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input tensor volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--sigma |
Double | (optional) the sigma of the noise |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output tensor volume |
VolumeTensorOdf
Sample an orientation distribution function (ODF) from a tensor volume.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--dirs |
Vects | the sphere directions |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--alpha |
Double | 1.0 |
(optional) the alpha power value |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output odf volume |
VolumeTensorSegmentGraph
Tensor volume graph-based segmentation based on principal direction
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--line |
flag | (optional) use a line metric | |
--log |
flag | (optional) use a log Euclidean metric | |
--threshold |
Double | 1.0 |
(optional) a threshold for grouping |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output segmentation mask |
VolumeTensorSegmentSuper
Segment supervoxels from a tensor volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--mask |
Mask | a mask |
--weights |
Volume | (optional) a weight volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--size |
Integer | (optional) a threshold size (any region smaller than this will be removed) | |
--iters |
Integer | 10 |
(optional) the number of iterations |
--restarts |
Integer | (optional) the number of restarts | |
--num |
Integer | 100 |
(optional) the number of clusters (the initial number if dp-means is used) |
--alpha |
Double | 1.0 |
(optional) the alpha parameter for spatial extent |
--beta |
Double | 15.0 |
(optional) the beta parameter for angular extent |
--lambda |
Double | (optional) the lambda parameter for region size (for dp-means clustering) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | the output segmentation mask |
VolumeTensorSegmentTissue
Use a free-water eliminated tensor volume to segment gray and white matter
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--fw |
Double | 0.5 |
(optional) a maximum free water |
--md |
Double | 2.0E-4 |
(optional) a minimum mean diffusivity |
--num |
Integer | 2 |
(optional) a number of iterations for mask opening |
Output:
| Flag | Type | Description |
|---|---|---|
--labels |
Mask | the gray matter segmentation mask |
--gray |
Volume | the gray matter density map |
--white |
Volume | the white matter density map |
VolumeTensorSmooth
Smooth a tensor volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--hdir |
Double | (optional) the tensor adaptive bandwidth | |
--hsig |
Double | (optional) the baseline signal adaptive bandwidth | |
--log |
flag | (optional) use log-euclidean processing | |
--frac |
Double | 0.0 |
(optional) exclude voxels below a give FA |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output tensor volume |
VolumeTensorStandardize
Standardize the pose of a tensor volume. This will remove the rotation and tranlation from the image grid and rotate the tensors accordingly
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output transformed tensor volume |
--xfm |
Affine | (optional) output affine xfm |
--invxfm |
Affine | (optional) output inverse affine xfm |
VolumeTensorThreshold
Create a mask from a tensor volume using a complex expression
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | FA > 0.15 && MD < 0.001 && MD > 0.0001 |
(optional) the expression to evaluate |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
VolumeTensorTransform
Spatially transform a tensor volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--reference |
Volume | input reference volume |
--mask |
Mask | (optional) input mask (defined in the reference space) |
--inputMask |
Mask | (optional) use an input mask (defined in the input space) |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--reorient |
ReorientationType | Jacobian |
(optional) specify a reorient method (fs or jac) (Options: FiniteStrain, Jacobian) |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 1.0 |
(optional) the positional bandwidth in mm |
--log |
flag | (optional) use log estimation |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output transformed tensor volume |
VolumeTensorZoom
Zoom a tensor volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input tensor volume |
--mask |
Mask | (optional) a mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--factor |
double | 2.0 |
(optional) a zooming factor |
--interp |
KernelInterpolationType | Trilinear |
(optional) the interpolation type (Options: Nearest, Trilinear, Gaussian) |
--log |
flag | (optional) use log euclidean estimation | |
--support |
Integer | 3 |
(optional) the filter radius in voxels |
--hpos |
Double | 2.0 |
(optional) the positional bandwidth in mm |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output tensor volume |
VolumeThreshold
Threshold a volume to make a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--threshold |
Double | 0.5 |
(optional) threshold value |
--magnitude |
flag | (optional) use the magnitude for multi-channel volumes | |
--invert |
flag | (optional) invert the threshold | |
--prenorm |
flag | (optional) normalize the intensities to unit mean before thresholding |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
VolumeThresholdHysteresis
Apply a hysteresis threshold
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--low |
Double | 0.5 |
(optional) this low threshold value |
--high |
Double | 0.75 |
(optional) the high threshold value |
--magnitude |
flag | (optional) use the magnitude for multi-channel volumes | |
--invert |
flag | (optional) invert the threshold | |
--prenorm |
flag | (optional) normalize the intensities to unit mean before thresholding |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
VolumeThresholdOtsu
Threshold a volume using Otsu’s method
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--bins |
int | 512 |
(optional) the number of bins |
--invert |
flag | (optional) invert the segmentation |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
Citation: Nobuyuki Otsu (1979). “A threshold selection method from gray-level histograms”. IEEE Trans. Sys., Man., Cyber. 9 (1): 62-66.
VolumeThresholdRamp
Threshold a volume using a ramp defined by low and high thresholds. Values below the low threshold will be zero, values above will be one, and ones in between will increase gradually.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--low |
double | 0.25 |
(optional) low threshold value |
--high |
double | 0.25 |
(optional) low threshold value |
--magnitude |
flag | (optional) use the magnitude for multi-channel volumes | |
--invert |
flag | (optional) invert the threshold |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output threshold map |
VolumeThresholdRange
Threshold a volume to make a mask
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--lower |
Double | 0.25 |
(optional) threshold value |
--upper |
Double | 0.75 |
(optional) threshold value |
--magnitude |
flag | (optional) use the magnitude for multi-channel volumes | |
--invert |
flag | (optional) invert the threshold | |
--prenorm |
flag | (optional) normalize the intensities to unit mean before thresholding |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Mask | output mask |
VolumeTiffPrintInfo
Print info about the organization of a TIFF file
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | the filename of the input volume | |
--which |
String | (optional) print info only about a specific sub-page | |
--table |
flag | (optional) write the summary as a table |
VolumeTiffSplit
Print info about the organization of a TIFF file
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--input |
String | the filename of the input tiff file | |
--output |
String | the filename pattern of the output tiffs (should contain %d) | |
--which |
String | (optional) extract only a specific sub-page (comma-separated list) |
VolumeTile
Tile a collection of volumes in a single volume
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--pattern |
String | volume.${x}.${y}.nii.gz |
(optional) the input pattern (should contain ${x} and ${y}) |
--xids |
String | a,b,c |
(optional) the row identifiers to be substituted |
--yids |
String | 1,2,3,4 |
(optional) the column identifiers to be substituted |
--xbuffer |
int | 0 |
(optional) a buffer size between tiles |
--ybuffer |
int | 0 |
(optional) a buffer size between tiles |
--orientation |
String | z |
(optional) slice orientation for storing a stack (x, y, or z) |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |
VolumeTransfer
Apply a transfer function to a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--transfer |
Table | input transfer function (table with from and to fields) |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--from |
String | from |
(optional) the from field name |
--to |
String | to |
(optional) the to field name |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output |
VolumeTransform
Transform a volume
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | input volume |
--reference |
Volume | input reference volume |
--mask |
Mask | (optional) use a mask (defined in the reference space) |
--inputMask |
Mask | (optional) use an input mask (defined in the input space) |
--affine |
Affine | (optional) apply an affine xfm |
--invaffine |
Affine | (optional) apply an inverse affine xfm |
--deform |
Deformation | (optional) apply a deformation xfm |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--interp |
InterpolationType | Trilinear |
(optional) image interpolation method (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
--reverse |
flag | (optional) reverse the order, i.e. compose the affine(deform(x)), whereas the default is deform(affine(x)) | |
--reorient |
flag | (optional) reorient vector image data | |
--reoriention |
ReorientationType | Jacobian |
(optional) specify a reorient method (fs or jac) (Options: FiniteStrain, Jacobian) |
--threads |
Integer | 1 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeVoxelMathScalar
Evaluate an expression at each voxel of volume data
Input:
| Flag | Type | Description |
|---|---|---|
--a |
Volume | the input volume stored as a variable named ‘a’ |
--b |
Volume | (optional) the input volume stored as a variable named ‘b’ |
--c |
Volume | (optional) the input volume stored as a variable named ‘c’ |
--d |
Volume | (optional) the input volume stored as a variable named ‘d’ |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--expression |
String | a > 0.5 |
(optional) the expression to evaluate |
--undefined |
double | 0.0 |
(optional) use the specificed value for undefined output, e.g. NaN or Infinity |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeVoxelMathVect
Evaluate an expression at each voxel of volume data
Input:
| Flag | Type | Description |
|---|---|---|
--a |
Volume | the input volume stored as a variable named ‘a’ |
--b |
Volume | (optional) the input volume stored as a variable named ‘b’ |
--c |
Volume | (optional) the input volume stored as a variable named ‘c’ |
--d |
Volume | (optional) the input volume stored as a variable named ‘d’ |
--mask |
Mask | (optional) mask |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--world |
flag | (optional) add a variable for world coordinates of the given voxel | |
--expression |
String | mean(a) |
(optional) the expression to evaluate |
--undefined |
double | 0.0 |
(optional) use the specified value for undefined output, e.g. NaN or Infinity |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | output volume |
VolumeZoom
Zoom a volume. Note: be careful using this for downsampling, as it does not apply an anti-aliasing prefilter.
Input:
| Flag | Type | Description |
|---|---|---|
--input |
Volume | the input volume |
Parameters:
| Flag | Type | Default | Description |
|---|---|---|---|
--factor |
Double | (optional) an isotropic scaling factor | |
--fi |
Double | (optional) a scaling factor in i | |
--fj |
Double | (optional) a scaling factor in j | |
--fk |
Double | (optional) a scaling factor in k | |
--interp |
InterpolationType | Trilinear |
(optional) an interpolation type (Options: Nearest, Trilinear, Tricubic, Gaussian, GaussianLocalLinear, GaussianLocalQuadratic) |
--threads |
Integer | 3 |
(optional) the number of threads in the pool |
Output:
| Flag | Type | Description |
|---|---|---|
--output |
Volume | the output volume |