genre | Resample |
author | Horst Hahn |
package | MeVisLab/Standard |
dll | MLGeometry1 |
definition | MLGeometry1.def |
keywords | interpolation, scale, zoom, trilinear, triquadratic, tricubic, hermite, polynome, mitchell, lanczos, sinc, gaussian, filter |
The module Resample3D resamples an image in 3D on an arbitrary planar parallel grid.
Use either Image Size, Voxel Size, or Scale Factor to specify the output grid that is used to resample the image data.
Additionally, a Voxel Translation can be given to perform subvoxel translation of the output grid.
Alternatively, voxel size and voxel translation can be automatically derived from a reference image to make sure the resampled image and the reference image are correctly aligned (with respect to the world/patient coordinate system) after resampling.
Choose one of many Resampling Filter to be used for the resampling that differ importantly in both support (i.e. the number of input voxel required for the computation of an output voxel) and in smoothness (resp. their edge-preserving property).
The filtering is performed consecutively and separately for all dimensions (x, y, and z).
Note that Min/Max values are automatically taken over from the input image, even if filtered values would exceed this range. In these cases clamping to the min/max range is performed. This cannot be avoided due to the page-based/demand driven approach this module works with, so the user can only avoid it by changing the properties of the input image accordingly.
Filter always: Bool | Use isotropic voxel size: Bool |
Filtering Tolerance: Double | Voxel Size: Vector3 |
Image Size: Vector3 | Voxel Translation: Vector3 |
Keep Constant: Enum | |
Resample to reference image grid: Bool | |
Resampling Filter: Enum | |
Reset: Trigger | |
Scale Factor: Vector3 |
Defines which property should be held constant if the input image changes.
Values:
Title | Name |
---|---|
Image size | Image size |
Voxel size | Voxel size |
Scale factor | Scale factor |
Defines the filter with which the voxel value of the resampled output image is determined.
The computation time is mainly dependent on the filter's support, i.e. the number of neighboring image elements (to both directions) that are taken into account for the computation of an actual output image element.
Often used filters are Nearest_Neighbor, Triangle/Linear, Mitchell_et_al, and Lanczos_3.
Values:
Title | Name | Description | ||
---|---|---|---|---|
Nearest Neighbor | Nearest_Neighbor |
|
||
Triangle/Linear | Triangle/Linear |
|
||
Hermite | Hermite |
|
||
Blackman | Blackman |
|
||
Hamming | Hamming |
|
||
Hanning | Hanning |
|
||
Gaussian | Gaussian |
|
||
Bell/Quadratic | Bell/Quadratic |
|
||
Cubic B-Spline | Cubic_B-Spline |
|
||
Catrom | Catrom |
|
||
Mitchell et al | Mitchell_et_al |
|
||
Trunc Sinc 4 | Trunc_Sinc_4 |
|
||
Lanczos 2 | Lanczos_2 |
|
||
Lanczos 3 | Lanczos_3 |
|
||
Lanczos 4 | Lanczos_4 |
|
||
Box NNB | Box_NNB |
|
If checked, an isotropic voxel size is obtained at the output (i.e. vx = vy = vz).
If checked, a filtering is always performed, independent of the Scale Factor factor. The input data is just passed to the output for the respective dimension.
Otherwise, a filtering is only performed if Scale Factor does not equal 1.0 for a dimension.
Sets the value threshold difference for shifting where a resampling should be performed.
If this value is set to 0, the filtering is disabled, if set to 1e-6, rounding errors are ignored.
Sets the scale factor for the output image in comparison to the input image.
A value of 1.0 means identity.
Depends on Image Size and Voxel Size.
Sets the output image extent in voxel.
Depends on Scale Factor and Voxel Size.
Sets the output voxel size in mm.
Depends on Scale Factor and Image Size.
Sets a translation vector for the output image.
For instance, a voxel translation of (-0.5) in x-direction moves the output grid half an input voxel to the left.
Hint: Usually this parameter is used to align the output to a reference grid. Enable Resample to reference image grid to let the module determine the shift from the input images automatically.
If checked, Voxel Size and Voxel Translation will be copied from the reference image, making sure the grids of the resampled and of the reference image are correctly aligned (with respect to the world/patient coordinate system) after resampling.
Note: This option aligns the grids, but not the full images, i.e. there still might be a shift between resampled and reference image by an integer number of voxels.
If an image should be resample to exactly the grid and extent of a reference image, try to use the module Reformat.