/
brainsfit.py
395 lines (379 loc) · 21.1 KB
/
brainsfit.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
# -*- coding: utf-8 -*-
# -*- coding: utf8 -*-
"""Autogenerated file - DO NOT EDIT
If you spot a bug, please report it on the mailing list and/or change the generator."""
from nipype.interfaces.base import (
CommandLine,
CommandLineInputSpec,
SEMLikeCommandLine,
TraitedSpec,
File,
Directory,
traits,
isdefined,
InputMultiPath,
OutputMultiPath,
)
import os
class BRAINSFitInputSpec(CommandLineInputSpec):
fixedVolume = File(
desc="The fixed image for registration by mutual information optimization.",
exists=True,
argstr="--fixedVolume %s",
)
movingVolume = File(
desc="The moving image for registration by mutual information optimization.",
exists=True,
argstr="--movingVolume %s",
)
bsplineTransform = traits.Either(
traits.Bool,
File(),
hash_files=False,
desc="(optional) Filename to which save the estimated transform. NOTE: You must set at least one output object (either a deformed image or a transform. NOTE: USE THIS ONLY IF THE FINAL TRANSFORM IS BSpline",
argstr="--bsplineTransform %s",
)
linearTransform = traits.Either(
traits.Bool,
File(),
hash_files=False,
desc="(optional) Filename to which save the estimated transform. NOTE: You must set at least one output object (either a deformed image or a transform. NOTE: USE THIS ONLY IF THE FINAL TRANSFORM IS ---NOT--- BSpline",
argstr="--linearTransform %s",
)
outputVolume = traits.Either(
traits.Bool,
File(),
hash_files=False,
desc="(optional) Output image for registration. NOTE: You must select either the outputTransform or the outputVolume option.",
argstr="--outputVolume %s",
)
initialTransform = File(
desc="Filename of transform used to initialize the registration. This CAN NOT be used with either CenterOfHeadLAlign, MomentsAlign, GeometryAlign, or initialTransform file.",
exists=True,
argstr="--initialTransform %s",
)
initializeTransformMode = traits.Enum(
"Off",
"useMomentsAlign",
"useCenterOfHeadAlign",
"useGeometryAlign",
"useCenterOfROIAlign",
desc="Determine how to initialize the transform center. GeometryAlign on assumes that the center of the voxel lattice of the images represent similar structures. MomentsAlign assumes that the center of mass of the images represent similar structures. useCenterOfHeadAlign attempts to use the top of head and shape of neck to drive a center of mass estimate. Off assumes that the physical space of the images are close, and that centering in terms of the image Origins is a good starting point. This flag is mutually exclusive with the initialTransform flag.",
argstr="--initializeTransformMode %s",
)
useRigid = traits.Bool(
desc="Perform a rigid registration as part of the sequential registration steps. This family of options superceeds the use of transformType if any of them are set.",
argstr="--useRigid ",
)
useScaleVersor3D = traits.Bool(
desc="Perform a ScaleVersor3D registration as part of the sequential registration steps. This family of options superceeds the use of transformType if any of them are set.",
argstr="--useScaleVersor3D ",
)
useScaleSkewVersor3D = traits.Bool(
desc="Perform a ScaleSkewVersor3D registration as part of the sequential registration steps. This family of options superceeds the use of transformType if any of them are set.",
argstr="--useScaleSkewVersor3D ",
)
useAffine = traits.Bool(
desc="Perform an Affine registration as part of the sequential registration steps. This family of options superceeds the use of transformType if any of them are set.",
argstr="--useAffine ",
)
useBSpline = traits.Bool(
desc="Perform a BSpline registration as part of the sequential registration steps. This family of options superceeds the use of transformType if any of them are set.",
argstr="--useBSpline ",
)
numberOfSamples = traits.Int(
desc="The number of voxels sampled for mutual information computation. Increase this for a slower, more careful fit. You can also limit the sampling focus with ROI masks and ROIAUTO mask generation.",
argstr="--numberOfSamples %d",
)
splineGridSize = InputMultiPath(
traits.Int,
desc="The number of subdivisions of the BSpline Grid to be centered on the image space. Each dimension must have at least 3 subdivisions for the BSpline to be correctly computed. ",
sep=",",
argstr="--splineGridSize %s",
)
numberOfIterations = InputMultiPath(
traits.Int,
desc="The maximum number of iterations to try before failing to converge. Use an explicit limit like 500 or 1000 to manage risk of divergence",
sep=",",
argstr="--numberOfIterations %s",
)
maskProcessingMode = traits.Enum(
"NOMASK",
"ROIAUTO",
"ROI",
desc="What mode to use for using the masks. If ROIAUTO is choosen, then the mask is implicitly defined using a otsu forground and hole filling algorithm. The Region Of Interest mode (choose ROI) uses the masks to define what parts of the image should be used for computing the transform.",
argstr="--maskProcessingMode %s",
)
fixedBinaryVolume = File(
desc="Fixed Image binary mask volume, ONLY FOR MANUAL ROI mode.",
exists=True,
argstr="--fixedBinaryVolume %s",
)
movingBinaryVolume = File(
desc="Moving Image binary mask volume, ONLY FOR MANUAL ROI mode.",
exists=True,
argstr="--movingBinaryVolume %s",
)
outputFixedVolumeROI = traits.Either(
traits.Bool,
File(),
hash_files=False,
desc="The ROI automatically found in fixed image, ONLY FOR ROIAUTO mode.",
argstr="--outputFixedVolumeROI %s",
)
outputMovingVolumeROI = traits.Either(
traits.Bool,
File(),
hash_files=False,
desc="The ROI automatically found in moving image, ONLY FOR ROIAUTO mode.",
argstr="--outputMovingVolumeROI %s",
)
outputVolumePixelType = traits.Enum(
"float",
"short",
"ushort",
"int",
"uint",
"uchar",
desc="The output image Pixel Type is the scalar datatype for representation of the Output Volume.",
argstr="--outputVolumePixelType %s",
)
backgroundFillValue = traits.Float(
desc="Background fill value for output image.",
argstr="--backgroundFillValue %f",
)
maskInferiorCutOffFromCenter = traits.Float(
desc="For use with --useCenterOfHeadAlign (and --maskProcessingMode ROIAUTO): the cut-off below the image centers, in millimeters, ",
argstr="--maskInferiorCutOffFromCenter %f",
)
scaleOutputValues = traits.Bool(
desc="If true, and the voxel values do not fit within the minimum and maximum values of the desired outputVolumePixelType, then linearly scale the min/max output image voxel values to fit within the min/max range of the outputVolumePixelType.",
argstr="--scaleOutputValues ",
)
interpolationMode = traits.Enum(
"NearestNeighbor",
"Linear",
"ResampleInPlace",
"BSpline",
"WindowedSinc",
"Hamming",
"Cosine",
"Welch",
"Lanczos",
"Blackman",
desc="Type of interpolation to be used when applying transform to moving volume. Options are Linear, NearestNeighbor, BSpline, WindowedSinc, or ResampleInPlace. The ResampleInPlace option will create an image with the same discrete voxel values and will adjust the origin and direction of the physical space interpretation.",
argstr="--interpolationMode %s",
)
minimumStepLength = InputMultiPath(
traits.Float,
desc="Each step in the optimization takes steps at least this big. When none are possible, registration is complete.",
sep=",",
argstr="--minimumStepLength %s",
)
translationScale = traits.Float(
desc="How much to scale up changes in position compared to unit rotational changes in radians -- decrease this to put more rotation in the search pattern.",
argstr="--translationScale %f",
)
reproportionScale = traits.Float(
desc="ScaleVersor3D 'Scale' compensation factor. Increase this to put more rescaling in a ScaleVersor3D or ScaleSkewVersor3D search pattern. 1.0 works well with a translationScale of 1000.0",
argstr="--reproportionScale %f",
)
skewScale = traits.Float(
desc="ScaleSkewVersor3D Skew compensation factor. Increase this to put more skew in a ScaleSkewVersor3D search pattern. 1.0 works well with a translationScale of 1000.0",
argstr="--skewScale %f",
)
maxBSplineDisplacement = traits.Float(
desc=" Sets the maximum allowed displacements in image physical coordinates for BSpline control grid along each axis. A value of 0.0 indicates that the problem should be unbounded. NOTE: This only constrains the BSpline portion, and does not limit the displacement from the associated bulk transform. This can lead to a substantial reduction in computation time in the BSpline optimizer., ",
argstr="--maxBSplineDisplacement %f",
)
histogramMatch = traits.Bool(
desc="Histogram Match the input images. This is suitable for images of the same modality that may have different absolute scales, but the same overall intensity profile. Do NOT use if registering images from different modailties.",
argstr="--histogramMatch ",
)
numberOfHistogramBins = traits.Int(
desc="The number of histogram levels", argstr="--numberOfHistogramBins %d"
)
numberOfMatchPoints = traits.Int(
desc="the number of match points", argstr="--numberOfMatchPoints %d"
)
strippedOutputTransform = traits.Either(
traits.Bool,
File(),
hash_files=False,
desc="File name for the rigid component of the estimated affine transform. Can be used to rigidly register the moving image to the fixed image. NOTE: This value is overwritten if either bsplineTransform or linearTransform is set.",
argstr="--strippedOutputTransform %s",
)
transformType = InputMultiPath(
traits.Str,
desc="Specifies a list of registration types to be used. The valid types are, Rigid, ScaleVersor3D, ScaleSkewVersor3D, Affine, and BSpline. Specifiying more than one in a comma separated list will initialize the next stage with the previous results. If registrationClass flag is used, it overrides this parameter setting.",
sep=",",
argstr="--transformType %s",
)
outputTransform = traits.Either(
traits.Bool,
File(),
hash_files=False,
desc="(optional) Filename to which save the (optional) estimated transform. NOTE: You must select either the outputTransform or the outputVolume option.",
argstr="--outputTransform %s",
)
fixedVolumeTimeIndex = traits.Int(
desc="The index in the time series for the 3D fixed image to fit, if 4-dimensional.",
argstr="--fixedVolumeTimeIndex %d",
)
movingVolumeTimeIndex = traits.Int(
desc="The index in the time series for the 3D moving image to fit, if 4-dimensional.",
argstr="--movingVolumeTimeIndex %d",
)
medianFilterSize = InputMultiPath(
traits.Int,
desc="The radius for the optional MedianImageFilter preprocessing in all 3 directions.",
sep=",",
argstr="--medianFilterSize %s",
)
removeIntensityOutliers = traits.Float(
desc="The half percentage to decide outliers of image intensities. The default value is zero, which means no outlier removal. If the value of 0.005 is given, the moduel will throw away 0.005 % of both tails, so 0.01% of intensities in total would be ignored in its statistic calculation. ",
argstr="--removeIntensityOutliers %f",
)
useCachingOfBSplineWeightsMode = traits.Enum(
"ON",
"OFF",
desc="This is a 5x speed advantage at the expense of requiring much more memory. Only relevant when transformType is BSpline.",
argstr="--useCachingOfBSplineWeightsMode %s",
)
useExplicitPDFDerivativesMode = traits.Enum(
"AUTO",
"ON",
"OFF",
desc="Using mode AUTO means OFF for BSplineDeformableTransforms and ON for the linear transforms. The ON alternative uses more memory to sometimes do a better job.",
argstr="--useExplicitPDFDerivativesMode %s",
)
ROIAutoDilateSize = traits.Float(
desc="This flag is only relavent when using ROIAUTO mode for initializing masks. It defines the final dilation size to capture a bit of background outside the tissue region. At setting of 10mm has been shown to help regularize a BSpline registration type so that there is some background constraints to match the edges of the head better.",
argstr="--ROIAutoDilateSize %f",
)
ROIAutoClosingSize = traits.Float(
desc="This flag is only relavent when using ROIAUTO mode for initializing masks. It defines the hole closing size in mm. It is rounded up to the nearest whole pixel size in each direction. The default is to use a closing size of 9mm. For mouse data this value may need to be reset to 0.9 or smaller.",
argstr="--ROIAutoClosingSize %f",
)
relaxationFactor = traits.Float(
desc="Internal debugging parameter, and should probably never be used from the command line. This will be removed in the future.",
argstr="--relaxationFactor %f",
)
maximumStepLength = traits.Float(
desc="Internal debugging parameter, and should probably never be used from the command line. This will be removed in the future.",
argstr="--maximumStepLength %f",
)
failureExitCode = traits.Int(
desc="If the fit fails, exit with this status code. (It can be used to force a successfult exit status of (0) if the registration fails due to reaching the maximum number of iterations.",
argstr="--failureExitCode %d",
)
writeTransformOnFailure = traits.Bool(
desc="Flag to save the final transform even if the numberOfIterations are reached without convergence. (Intended for use when --failureExitCode 0 )",
argstr="--writeTransformOnFailure ",
)
numberOfThreads = traits.Int(
desc="Explicitly specify the maximum number of threads to use. (default is auto-detected)",
argstr="--numberOfThreads %d",
)
forceMINumberOfThreads = traits.Int(
desc="Force the the maximum number of threads to use for non thread safe MI metric. CAUTION: Inconsistent results my arise!",
argstr="--forceMINumberOfThreads %d",
)
debugLevel = traits.Int(
desc="Display debug messages, and produce debug intermediate results. 0=OFF, 1=Minimal, 10=Maximum debugging.",
argstr="--debugLevel %d",
)
costFunctionConvergenceFactor = traits.Float(
desc=" From itkLBFGSBOptimizer.h: Set/Get the CostFunctionConvergenceFactor. Algorithm terminates when the reduction in cost function is less than (factor * epsmcj) where epsmch is the machine precision. Typical values for factor: 1e+12 for low accuracy; 1e+7 for moderate accuracy and 1e+1 for extremely high accuracy. 1e+9 seems to work well., ",
argstr="--costFunctionConvergenceFactor %f",
)
projectedGradientTolerance = traits.Float(
desc=" From itkLBFGSBOptimizer.h: Set/Get the ProjectedGradientTolerance. Algorithm terminates when the project gradient is below the tolerance. Default lbfgsb value is 1e-5, but 1e-4 seems to work well., ",
argstr="--projectedGradientTolerance %f",
)
gui = traits.Bool(
desc="Display intermediate image volumes for debugging. NOTE: This is not part of the standard build sytem, and probably does nothing on your installation.",
argstr="--gui ",
)
promptUser = traits.Bool(
desc="Prompt the user to hit enter each time an image is sent to the DebugImageViewer",
argstr="--promptUser ",
)
NEVER_USE_THIS_FLAG_IT_IS_OUTDATED_00 = traits.Bool(
desc="DO NOT USE THIS FLAG", argstr="--NEVER_USE_THIS_FLAG_IT_IS_OUTDATED_00 "
)
NEVER_USE_THIS_FLAG_IT_IS_OUTDATED_01 = traits.Bool(
desc="DO NOT USE THIS FLAG", argstr="--NEVER_USE_THIS_FLAG_IT_IS_OUTDATED_01 "
)
NEVER_USE_THIS_FLAG_IT_IS_OUTDATED_02 = traits.Bool(
desc="DO NOT USE THIS FLAG", argstr="--NEVER_USE_THIS_FLAG_IT_IS_OUTDATED_02 "
)
permitParameterVariation = InputMultiPath(
traits.Int,
desc="A bit vector to permit linear transform parameters to vary under optimization. The vector order corresponds with transform parameters, and beyond the end ones fill in as a default. For instance, you can choose to rotate only in x (pitch) with 1,0,0; this is mostly for expert use in turning on and off individual degrees of freedom in rotation, translation or scaling without multiplying the number of transform representations; this trick is probably meaningless when tried with the general affine transform.",
sep=",",
argstr="--permitParameterVariation %s",
)
costMetric = traits.Enum(
"MMI",
"MSE",
"NC",
"MC",
desc="The cost metric to be used during fitting. Defaults to MMI. Options are MMI (Mattes Mutual Information), MSE (Mean Square Error), NC (Normalized Correlation), MC (Match Cardinality for binary images)",
argstr="--costMetric %s",
)
writeOutputTransformInFloat = traits.Bool(
desc="By default, the output registration transforms (either the output composite transform or each transform component) are written to the disk in double precision. If this flag is ON, the output transforms will be written in single (float) precision. It is especially important if the output transform is a displacement field transform, or it is a composite transform that includes several displacement fields.",
argstr="--writeOutputTransformInFloat ",
)
class BRAINSFitOutputSpec(TraitedSpec):
bsplineTransform = File(
desc="(optional) Filename to which save the estimated transform. NOTE: You must set at least one output object (either a deformed image or a transform. NOTE: USE THIS ONLY IF THE FINAL TRANSFORM IS BSpline",
exists=True,
)
linearTransform = File(
desc="(optional) Filename to which save the estimated transform. NOTE: You must set at least one output object (either a deformed image or a transform. NOTE: USE THIS ONLY IF THE FINAL TRANSFORM IS ---NOT--- BSpline",
exists=True,
)
outputVolume = File(
desc="(optional) Output image for registration. NOTE: You must select either the outputTransform or the outputVolume option.",
exists=True,
)
outputFixedVolumeROI = File(
desc="The ROI automatically found in fixed image, ONLY FOR ROIAUTO mode.",
exists=True,
)
outputMovingVolumeROI = File(
desc="The ROI automatically found in moving image, ONLY FOR ROIAUTO mode.",
exists=True,
)
strippedOutputTransform = File(
desc="File name for the rigid component of the estimated affine transform. Can be used to rigidly register the moving image to the fixed image. NOTE: This value is overwritten if either bsplineTransform or linearTransform is set.",
exists=True,
)
outputTransform = File(
desc="(optional) Filename to which save the (optional) estimated transform. NOTE: You must select either the outputTransform or the outputVolume option.",
exists=True,
)
class BRAINSFit(SEMLikeCommandLine):
"""title: General Registration (BRAINS)
category: Registration
description: Register a three-dimensional volume to a reference volume (Mattes Mutual Information by default). Described in BRAINSFit: Mutual Information Registrations of Whole-Brain 3D Images, Using the Insight Toolkit, Johnson H.J., Harris G., Williams K., The Insight Journal, 2007. http://hdl.handle.net/1926/1291
version: 3.0.0
documentation-url: http://wiki.slicer.org/slicerWiki/index.php/Modules:BRAINSFit
license: https://www.nitrc.org/svn/brains/BuildScripts/trunk/License.txt
contributor: Hans J. Johnson, hans-johnson -at- uiowa.edu, http://wwww.psychiatry.uiowa.edu
acknowledgements: Hans Johnson(1,3,4); Kent Williams(1); Gregory Harris(1), Vincent Magnotta(1,2,3); Andriy Fedorov(5) 1=University of Iowa Department of Psychiatry, 2=University of Iowa Department of Radiology, 3=University of Iowa Department of Biomedical Engineering, 4=University of Iowa Department of Electrical and Computer Engineering, 5=Surgical Planning Lab, Harvard
"""
input_spec = BRAINSFitInputSpec
output_spec = BRAINSFitOutputSpec
_cmd = "BRAINSFit "
_outputs_filenames = {
"outputVolume": "outputVolume.nii",
"bsplineTransform": "bsplineTransform.mat",
"outputTransform": "outputTransform.mat",
"outputFixedVolumeROI": "outputFixedVolumeROI.nii",
"strippedOutputTransform": "strippedOutputTransform.mat",
"outputMovingVolumeROI": "outputMovingVolumeROI.nii",
"linearTransform": "linearTransform.mat",
}