Difference between revisions of "Modules:PlastimatchDICOMRT"

From Slicer Wiki
Jump to: navigation, search
Line 44: Line 44:
 
** '''Cost Function:''' Here you can choose either Mean-squared error (MSE) for unimodal registration, or Mutual Information (MI) for multimodal registration.
 
** '''Cost Function:''' Here you can choose either Mean-squared error (MSE) for unimodal registration, or Mutual Information (MI) for multimodal registration.
 
** '''Hardware:''' Here you can choose either GPU for CUDA-accelerated registration, or CPU for multicore-accelerated registration.
 
** '''Hardware:''' Here you can choose either GPU for CUDA-accelerated registration, or CPU for multicore-accelerated registration.
* '''Stage 0 panel:''' Stage 0 is the a pre-alignment stage, which uses either a translation, rigid transform, or affine transform to make a rough alignment of the moving image to the fixed image.  The default is not to do pre-alignment.  If your images are reasonably well aligned you can keep this option off, which makes plastimatch run faster.  But generally it doesn't hurt to enable Stage 0.
+
|[[Image:plastimatch_dicomrt_gui.png|thumb|280px|User Interface]]
** '''Enable Stage 0:'''  Click on this checkbox to enable the pre-alignment stage.
 
** '''Image Subsampling Rate:'''  This option is specified as three integers, separated by commas.  It tells plastimatch to subsample the images in the (x,y,z) dimensions by this amount for this stage.  This is one of the methods that plastimatch implements multi-resolution registration. by cascading stages of different subsampling rates.
 
** '''Max Iterations:''' This option controls how many iterations of B-spline registration will be run in this stage.  Usually there is no benefit beyond 200 iterations.  Also, there is usually no harm in running extra iterations, except that it takes longer.
 
** '''Transformation:''' This option controls whether the pre-alignment uses a translation (3 DOF), a rigid transform (6 DOF), or an affine transform (12 DOF).  Generally speaking, translation is recommended unless the images are extremely different.
 
* '''Stage 1 panel:''' Stage 1 is the first stage of non-rigid registration.  The plastimatch plugin will always do at least one non-rigid stage.
 
** '''Image Subsampling Rate:'''  This option is specified as three integers, separated by commas.  It tells plastimatch to subsample the images in the (x,y,z) dimensions by this amount for this stage.  This is one of the methods that plastimatch implements multi-resolution registration. by cascading stages of different subsampling rates.
 
** '''Max Iterations:''' This option controls how many iterations of B-spline registration will be run in this stage.  Usually there is no benefit beyond 200 iterations.  Also, there is usually no harm in running extra iterations, except that it takes longer.
 
** '''Grid Spacing:''' The grid spacing parameter is a floating point number which controls the size of the B-spline control grid, in mm.  Larger spacing means a smoother registration, while smaller spacing means a finer registration.
 
* '''Stage 2 panel:'''  Stage 2 is an optional second round of non-rigid registration.  If you get good results after stage 1, you might try stage 2 to further improve the results.  However, enabling stage 2 increases the time required to perform the registration.
 
** '''Enable Stage 2:'''  Click on this checkbox to enable stage 2.
 
** '''Image Subsampling Rate:'''  This option is specified as three integers, separated by commas.  It tells plastimatch to subsample the images in the (x,y,z) dimensions by this amount for this stage.  This is one of the methods that plastimatch implements multi-resolution registration. by cascading stages of different subsampling rates.
 
** '''Max Iterations:''' This option controls how many iterations of B-spline registration will be run in this stage.  Usually there is no benefit beyond 200 iterations.  Also, there is usually no harm in running extra iterations, except that it takes longer.
 
** '''Grid Spacing:''' The grid spacing parameter is a floating point number which controls the size of the B-spline control grid, in mm.  Larger spacing means a smoother registration, while smaller spacing means a finer registration.
 
|[[Image:plastimatch_dicomrt_gui.png|thumb|380px|User Interface]]
 
 
|}
 
|}
  

Revision as of 20:24, 23 May 2010

Home < Modules:PlastimatchDICOMRT

Return to Slicer 3.6 Documentation


Plastimatch > DICOM-RT Import

General Information

Module Type & Category

Type: CLI

Category: Plastimatch

Authors, Collaborators & Contact

  • Authors: See AUTHORS.TXT contained within the package
  • Contact: Greg Sharp, Department of Radiation Oncology, Massachusetts General Hospital (gcsharp@partners.org)
  • Web page: http://plastimatch.org

Module Description

This is the DICOM-RT structure set import module. It allows you to select a file containing DICOM-RT structure sets, and it creates a 3D Slicer labelmap.

Usage

Tutorials

Quick Tour of Features and Use

  • Input/Output panel:
    • Fixed Volume: Here you choose the "fixed image", which is the reference image.
    • Moving Volume: Here you choose the "moving image", which will be warped to match the fixed image.
    • Output Volume: Here you choose where to put the warped image. You can replace an existing image in the scene, or create a new image.
    • Cost Function: Here you can choose either Mean-squared error (MSE) for unimodal registration, or Mutual Information (MI) for multimodal registration.
    • Hardware: Here you can choose either GPU for CUDA-accelerated registration, or CPU for multicore-accelerated registration.
User Interface

Development

Notes from the Developer(s)

Developer-oriented documentation is found on the plastimatch web site: http://plastimatch.org

Dependencies

This module has no dependencies.

Tests

Plastimatch features approximately 100 test cases.

Known bugs

Usability issues

Please report usability issues to the bug tracker.

Source code & documentation

We recommended to download the latest source code from subversion:

Documentation:

More Information

Acknowledgment

National Institutes of Health
NIH / NCI 6-PO1 CA 21239
Federal share of program income earned by MGH on C06CA059267

Progetto Rocca Foundation
A collaboration between MIT and Politecnico di Milano

References

  • G Sharp et al. "Plastimatch - An open source software suite for radiotherapy image processing," Proceedings of the XVIth International Conference on the use of Computers in Radiotherapy, May, 2010.