Difference between revisions of "Documentation/Nightly/Modules/LineMarkerRegistration"

From Slicer Wiki
Jump to: navigation, search
(Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887)
Tag: 2017 source edit
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
<noinclude>{{documentation/versioncheck}}</noinclude>
+
<noinclude>{{documentation/versioncheck}}
 +
</noinclude>
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-header}}
 
{{documentation/{{documentation/version}}/module-header}}
Line 28: Line 29:
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
 
Example applications of this modules:
 
Example applications of this modules:
* CT-guided percutaneous intervention (biopsy/RF ablation/cryo etc): Registration of a needle holder to the CT image coordinate system
+
 
* MRI-compatible manipulator for needle placement: Registration of the manipulator to the MRI image coordinate system
+
*CT-guided percutaneous intervention (biopsy/RF ablation/cryo etc): Registration of a needle holder to the CT image coordinate system
 +
*MRI-compatible manipulator for needle placement: Registration of the manipulator to the MRI image coordinate system
  
  
Line 44: Line 46:
  
 
The file is zip-archived. It includes:
 
The file is zip-archived. It includes:
* zframe-config.csv  (Example fiducial marker configuration file)
+
 
* zframe-image.nrrd  (MR image of example fiducial marker)
+
*zframe-config.csv  (Example fiducial marker configuration file)
* zframe-model.vtk  (VTK model of fiducial marker)
+
*zframe-image.nrrd  (MR image of example fiducial marker)
 +
*zframe-model.vtk  (VTK model of fiducial marker)
  
 
==Step by step instruction==
 
==Step by step instruction==
Line 64: Line 67:
 
from IO menu as follows:
 
from IO menu as follows:
  
* Input Volume: "zframe-image"
+
*Input Volume: "zframe-image"
* Marker Config File: Click the button next to the text input, and choose "zframe-config.csv" which is in the Examples folder in the source.  
+
*Marker Config File: Click the button next to the text input, and choose "zframe-config.csv" which is in the Examples folder in the source.
* Output Volume: Choose "Create new Volume" to create a new scalar volume node.
+
*Output Volume: Choose "Create new Volume" to create a new scalar volume node.
* Marker Volume: Choose "Create new LinearTransform" to create a new linear transform node. (The name will be "Marker transform".)
+
*Marker Volume: Choose "Create new LinearTransform" to create a new linear transform node. (The name will be "Marker transform".)
  
 
Leave other parameters as they are (the default values are adjusted for the example data). Now you can click the "Apply" button to run the CLI. It usually takes 2-10 seconds to complete. If it is successful, you could see the segmented line markers on the 2D viewers as below:
 
Leave other parameters as they are (the default values are adjusted for the example data). Now you can click the "Apply" button to run the CLI. It usually takes 2-10 seconds to complete. If it is successful, you could see the segmented line markers on the 2D viewers as below:
Line 85: Line 88:
  
  
<!-- ---------------------------- -->
+
<!-- ---------------------------- -->{{documentation/{{documentation/version}}/module-section|Panels and their use}}
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
 
 
N/A
 
N/A
 
<!--
 
<!--
Line 102: Line 104:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
{{documentation/{{documentation/version}}/module-developerinfo}}
+
 
 +
https://github.com/SNRLab/LineMarkerRegistration
 +
 
 +
 
  
  

Latest revision as of 14:27, 20 December 2019

Home < Documentation < Nightly < Modules < LineMarkerRegistration


For the latest Slicer documentation, visit the read-the-docs.


Introduction and Acknowledgements

This work is part of the National Center for Image Guided Therapy (NCIGT) (P41 EB015898), National Alliance for Medical Image Computing (NA-MIC) (U54 EB005149), and other research grants (R01 CA111288, R01 CA138586) funded by National Institutes of Health and CIMIT.
Author: Junichi Tokuda, BWH
Contact: Junichi Tokuda, <email>tokuda@bwh.harvard.edu</email>

Surgical Planning Laboratory (SPL)  

Module Description

The Line Marker Registration CLI automatically detects a fiducial marker consisting of multiple lines on a 3D image and register the marker to the image coordinate system. The users can configure the CLI to use their own fiducial marker design by creating a marker configuration file formatted in CSV.

Use Cases

Example applications of this modules:

  • CT-guided percutaneous intervention (biopsy/RF ablation/cryo etc): Registration of a needle holder to the CT image coordinate system
  • MRI-compatible manipulator for needle placement: Registration of the manipulator to the MRI image coordinate system


Tutorials

Installation

Currently this CLI is not available in Slicer Extension. Please obtain the source code from Git repository and build it by following the instruction.

Example Data

Example fiducial marker data (MR-visible z-frame) must be downloaded.

File:Documentation Nightly Modules LineMarkerRegistration Example.zip.

The file is zip-archived. It includes:

  • zframe-config.csv (Example fiducial marker configuration file)
  • zframe-image.nrrd (MR image of example fiducial marker)
  • zframe-model.vtk (VTK model of fiducial marker)

Step by step instruction

First, load the MR image and the VTK model to the Scene.

LineMarkerRegistration Screenshot LoadData.png

You will see the model and the image in the 2D/3D viewer.

LineMarkerRegistration Screenshot VisualizeData.png

From the Modules menu, go to "IGT" > "LineMarkerRegistration. The panel of the CLI looks:

LineMarkerRegistration Screenshot GUI.png

Select input volume, marker configuration file, output volume (where the result of marker segmentation is stored) and marker transform from IO menu as follows:

  • Input Volume: "zframe-image"
  • Marker Config File: Click the button next to the text input, and choose "zframe-config.csv" which is in the Examples folder in the source.
  • Output Volume: Choose "Create new Volume" to create a new scalar volume node.
  • Marker Volume: Choose "Create new LinearTransform" to create a new linear transform node. (The name will be "Marker transform".)

Leave other parameters as they are (the default values are adjusted for the example data). Now you can click the "Apply" button to run the CLI. It usually takes 2-10 seconds to complete. If it is successful, you could see the segmented line markers on the 2D viewers as below:

LineMarkerRegistration Screenshot Segmented.png

To confirm that the line marker is registered to the image, you need to apply the marker transform to the Z-frame model. To do this, open the "Data" module and drag the "zframe-model" node to the "Marker transform".

LineMarkerRegistration Screenshot DataModule.png

LineMarkerRegistration Screenshot ApplyTransform.png

By clicking the "eye" icon on the red slice, you could show the axial image and the model in the 3D viewer at the same time. Move the slice with the slider in the 2D viewer and check if the model is well overlapped with the segmented marker.

LineMarkerRegistration Screenshot Confirmation.png


Panels and their use

N/A

Similar Modules

N/A

References

N/A

Information for Developers

https://github.com/SNRLab/LineMarkerRegistration