Projects:RegistrationLibrary:RegLib A01

From NAMIC Wiki
Jump to: navigation, search
Home < Projects:RegistrationLibrary:RegLib A01
 Back to Registration main page
 Back to Registration Use-case Inventory 
 Back to Auxiliary Data collection

Registration Library : Using Grid Images

1.Match physical dimensions & position

    1. Load grid image with the desired number of grid points (e.g. ~50% higher than the DOF of the BSpline applied)
    2. Place your target image in background and grid image in foreground
    3. Go to Volumes module / Info tab
    4. select first target and then grid image from Active Volume menu; for both click on Center Volume button to match image centers
    5. set fading slider to halfway, so you can see both target and grid image
    6. select grid image from Active Volume menu
    7. change Image Spacing parameters (voxel size) to something close to those of your target image. You will see the grid change shape as you adjust. Make numbers smaller or larger to change the box sizes. Click the Center Volume button after each size adjustment. Continue until grid largely covers area of interest
ColorGrid overlay.png


    1. go to ResampleScalarVectorDWIVolume module (Filtering menu)
    2. select grid image as input, your target as reference
    3. select "create new volume" from output volume and rename to "grid_deformed" or similar
    4. under Transform Node select the nonrigid (BSpline) transformation
    5. as interpolation method, select "nearest neighbor". If continuity of the deformed grid lines is important, select "linear"
    6. leave rest at defaults; click Apply.
BWGrid overlay deformed.png
ColorGrid overlay deformed.png


  • the grid images have different values for the axial, sagittal and coronal planes to help you distinguish. An orthogonal plane being bent down into an adjacent slice shows up as rings or blobs. You can adjust the window & level values to match the particular plane and thus fade out the distracting other ones. Or you can threshold the grid image to generate labelmaps that contain only 1 set of planes for easier viewing.
  • the alternative 4D grid image contain each plane as a separate channel and are loaded as vector images that will show up in color (see figure above) that help distinguish the different directions.

Registration Library : Using Deformation Field Images


  • There is commandline functionality in Slicer to convert a BSpline ITK transform file (.tfm) into a deformation field volume. To execute, type (exchange /Applications/Slicer3.6.3 with the path of your Slicer installation):
 /Applications/Slicer3.6.3/Slicer3 --launch /Applications/Slicer3.6.3/lib/Slicer3/Plugins/BSplineToDeformationField --tfm InputBSpline.tfm 
  --refImage ReferenceImage.nrrd   --defImage Output_DeformationField.nrrd  
  • for more details try:
 /Applications/Slicer3.6.3/Slicer3 --launch /Applications/Slicer3.6.3/lib/Slicer3/Plugins/BSplineToDeformationField --help
  • this creates a 4-dimensional (4D) image that contains the displacements of each image point in the x-, y- and z-direction as 3 separate volumes. You can load this image into Slicer and visualize the distribution and values of the deformation field. If loaded as a NRRD "list" image (as of v.3.6.3 there was a problem with loading 4D "vector" NRRD images, so if you have trouble loading, try changing the following line in the NRRD header, e.g. with a text editor:
 sizes: 3 256 256 124
 space directions: none (0.9375,0,0) (0,0,-0.9375) (0,-1.5,0)
 kinds: vector domain domain domain

change the word "vector" to the word "list" and then save and retry loading:

 kinds: list domain domain domain

2. Visualize Example of 4D displacement field rendered in Slicer. displacements in the x-, y- and z-direction in red, green and blue color, respectively.

  • if loaded properly, the 4D volume is rendered in RGB color, with displacements in the x-, y- and z-direction in red, green and blue color, respectively. RGB mixtures of yellow, cyan and magenta then indicate displacements of similar magnitude in both xy, yz and xz directions, respectively etc.
  • Note that negative displacements (as of v.3.6) are clipped and will all show as black.