Difference between revisions of "Projects:RegistrationLibrary:RegLib C46"

From NAMIC Wiki
Jump to: navigation, search
Line 51: Line 51:
 
##click: Apply; (runtime < 10 sec. on MacPro)
 
##click: Apply; (runtime < 10 sec. on MacPro)
 
##adjust grid size until registration is acceptable
 
##adjust grid size until registration is acceptable
##you can see the commandline text of the registration performed by opening the 'Window/'Error Log'' window and clicking on "BRAINSfit commandline input''
+
##you can see the commandline text of the registration performed by opening the ''Window/Error Log'' window and clicking on "BRAINSfit commandline input''
 
*'''Phase II:  Batch Run'''
 
*'''Phase II:  Batch Run'''
 
#open a terminal window
 
#open a terminal window

Revision as of 22:54, 28 June 2011

Home < Projects:RegistrationLibrary:RegLib C46

Back to ARRA main page
Back to Registration main page
Back to Registration Use-case Inventory

v3.6.3 Slicer3-6Announcement-v1.png Slicer Registration Library Case #46: 2D Cine MRI of Breathing Cycle

Input

this is the fixed reference image. All images are aligned into this space lleft this is the time series of 2D images to be registered with the reference
fixed image/target moving image

Modules

Objective / Background

We seek to study the motion of the lung during a breathing cycle by co-registering all of the images in a sequence with a reference, and then extract the motion from the registration displacement field.

Keywords

MRI, lung, 2D, time-series, deformation

Input Data

  • reference/fixed : 2D coronal MRI 256x256 , FIESTA sequence ,1.5 x 1.5 x 15mm voxel size
  • moving: 2D coronal time series, 200 images total, each as fixed above

Notes / Overall Strategy

  • because the torso is already well registered and does not move across the sequence, a global affine/rigid registration is of no use. Instead we seek to assess the internal displacements caused across the breathing cycle. We therefore choose a low-DOF BSpline model.
  • Because the implementation of the BRAINSfit module used here expects a 3D volume, we choose a slightly larger grid and make it isotropic, although the 3rd dimension of the grid is not used. We expect the optimizer in the registration to not move outside the slice plane and simply return 0 deformations there.
  • Overall strategy:
  1. select one frame within the breathing cycle as reference frame
  2. compute non-rigid BSpline registration of all images to the reference frame
  3. extract the displacements of indiv. grid nodes and plot over time

Procedures

  • Phase I: Pilot to determine optimal registration parameters
  1. load reference image and one moving image from the series
  2. open Registration : BrainsFit module
    1. Registration Phases:
    2. set "reference" fixed and "moving_??" as moving image
      1. select/check Include BSpline registration phase
    3. Output Settings:
      1. select a new transform "Slicer BSpline Transform", rename to "Xf1_moving_??"
      2. select a new volume "Output Image Volume, rename to "moving_??_Xf1"
    4. Registration Parameters: increase Number Of Samples to 200,000
    5. Registration Parameters: set Number Of Grid Subdivisions to 5,5,5
    6. Leave all other settings at default
    7. click: Apply; (runtime < 10 sec. on MacPro)
    8. adjust grid size until registration is acceptable
    9. you can see the commandline text of the registration performed by opening the Window/Error Log window and clicking on "BRAINSfit commandline input
  • Phase II: Batch Run
  1. open a terminal window
    1. via a TextEditor or prototyping/scripting software (e.g. Matlab), copy and modify the prototype line below, by changing only the moving input image:
 /Applications/Slicer36/Slicer3 --launch  /Applications/Slicer36/lib/Slicer3/Plugins/BRAINSFit --useBSpline --splineGridSize 5,5,5 --outputVolumePixelType short /
 --numberOfSamples 200000 --costMetric MMI --fixedVolume Reference/refLung_001.dcm --movingVolume Moving/Moving_001/Moving_001.dcm /
 --bsplineTransform Xforms/Moving_001_XfBSpl5.tfm --outputVolume MovingResampled/Moving_001_r.nrrd >> Logs/Moving_001_RegLog.txt 2>&1
    1. replace "/Applications/Slicer36" with your path of 3DSlicer
    2. create result directories MovingResampled, Logs, Xforms
    3. note that because input image is DICOM, and images are 2D only, each image of the time series must be in its own directory, otherwise Slicer will read them as a volume.
    4. paste all commands into a terminal window, or copy into a shell script and execute.
  • Phase III: Evaluate Transform files
    1. upon completion, read the transform files with an editor and extract the displacements of interest
    2. The ITK transform files describe displacements at the grid nodes, many of which are outside the region of interest. Because BRAINSfit pads the grid with 1 voxel, the grid returned is actually 8x8x8. We use only the plane (*,*,4) for analysis and discard the y-direction displacements, which as expected are all zero.
    3. for details on the ITK transform format see the FAQ here
    4. To obtain displacements at arbitrary coordinates, interpolate the transform into a deformation field, e.g. using this module (details FAQ here):
/Applications/Slicer3.6.3/lib/Slicer3/Plugins/BSplineToDeformationField

Registration Results

moving input moving input after registration (only frames 1-27 shown) displacements displacements (PDF)

Download


Acknowledgments

Thanks to Amir Owrangi and the Robarts Institute for sharing the registration problem and data.