Difference between revisions of "Documentation/Nightly/Extensions/iGyne"

From Slicer Wiki
Jump to: navigation, search
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
<noinclude>{{documentation/versioncheck}}</noinclude>
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-header}}
 
{{documentation/{{documentation/version}}/module-header}}
Line 5: Line 6:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
 
{{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
Author: Xiaojun Chen<br>
+
Authors: Guillaume Pernelle, Xiaojun Chen, Yi Gao, Jan Egger<br>
Contributors: iGyne Team (url coming)
+
Contributors: iGyne Team<br>
Contact: Xiaojun Chen, <email>xiaojun@bwh.harvard.edu</email>
+
Contact: Guillaume Pernelle, <email>gpernelle@gmail.com</email><br>
Website: https://github.com/xjchen/igyne<br>
+
Website: https://github.com/gpernelle/iGyne<br>
License: [http://www.slicer.org/pages/LicenseText Slicer license]
+
License: [http://www.slicer.org/pages/LicenseText Slicer license]<br>
 
+
Related Master's Thesis: [http://www.ncigt.org/publications/item/view/2316 Labeled Needle Rendering Solution for Image Guided Brachytherapy]
 
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Extension Description}}
 
{{documentation/{{documentation/version}}/extension-section|Extension Description}}
iGyne is an open source software for MR-Guided Interstitial Gynecologic Brachytherapy. It enables on-time processing of the intra-operative MRI data via a DICOM connection to the scanner followed by a multi-stage registration of CAD models of the template and the obturator to the patient images. This allows the virtual placement of interstitial needles during the intervention. Software features include:
+
iGyne is an open source software for MR-Guided Interstitial Gynecologic Brachytherapy. It enables on-time processing of the intra-operative MRI data via a DICOM connection to the scanner followed by a multi-stage registration of CAD models of the template and the obturator to the patient images. This allows the virtual placement of interstitial needles during the intervention, as well as needle detection and needle labeling.  
  
*Loading of Applicator CAD models and MR images
+
iGyne is currently articulated in seven steps:
*Initial registration of CAD model of the Template to MR images
+
1) procedure selection
*Registration Refinement
+
2) applicator selection
*Visualization of Registration
+
3) data importation
*Needle Selection and Display of Virtual Needles relative to Applicator CAD models and Tumor Segmentation
+
4) initial applicator registration
 +
5) refined applicator registration
 +
6) needle position planning
 +
7) needle detection
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 28: Line 31:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Use Cases}}
 
{{documentation/{{documentation/version}}/extension-section|Use Cases}}
[https://github.com/xjchen/igyne/tree/master/Sample%20data Sample data] and
+
[http://slicer.kitware.com/midas3/folder/876 Phantom Study] and
[https://github.com/xjchen/igyne/tree/master/scene%20for%20template%20and%20obturator CAD models] to use with modules.
+
[https://github.com/xjchen/igyne/tree/master/Sample%20data Sample data]
 +
 
 
<gallery widths="200px" perrow="4">
 
<gallery widths="200px" perrow="4">
Image:IGyne 1.0-registration.png|Screenshot of Registration
+
Image:IGyne-beforeFirstRegsitration.png|Data loaded
Image:IGyne 1.0 needle visualization.png|Screenshot of Needle Visualization
+
Image:IGyne-BeforeRefinedRegistration.png|After the initial registration
Image:Igyne 1.0-Tumor and Needle Visualization.png|Screenshot of Tumor and Needle Visualization
+
Image:IGyne-applicatorSegmentation.png|Applicator Segmentation
 +
Image:IGyne-registrationResult.png|Registration results
 +
Image:IGyne-needlePlanning.png|Planning with virtual needles
 +
Image:IGyne-needleSegmentation.png|Real needles segmentation
 +
Image:IGyne-labelingResult.png|Labeling result on the planning sheet
 +
 
 
</gallery>
 
</gallery>
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Tutorials}}
 
[[media:Igyne_Tutorial.ppt | Igyne Tutorial]] (a .PPT file with 18 pages) will guide you step-by-step through the process of loading of applicator CAD models, performing registration, selecting virtual needle and viewing the results within Slicer4. It will take about 10 minutes to finish this tutorial.
 
<!--<gallery widths="200px" perrow="4">
 
</gallery>-->
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 50: Line 53:
 
* http://www.na-mic.org/Wiki/index.php/2012_Summer_Project_Week:iGyne  
 
* http://www.na-mic.org/Wiki/index.php/2012_Summer_Project_Week:iGyne  
 
* Xiaojun Chen, Jan Egger, Akila Viswanathan, Neha Agrawal, William Wells, Ron Kikinis, Clare Tempany, Ferenc Jolesz and Tina Kapur.  "Image Processing for MR-guided Gynecologic Interstitial Brachytherapy in AMIGO", The 9th Interventional MRI Symposium. September 22-23, 2012.
 
* Xiaojun Chen, Jan Egger, Akila Viswanathan, Neha Agrawal, William Wells, Ron Kikinis, Clare Tempany, Ferenc Jolesz and Tina Kapur.  "Image Processing for MR-guided Gynecologic Interstitial Brachytherapy in AMIGO", The 9th Interventional MRI Symposium. September 22-23, 2012.
 
+
* Gao, Farhat, Pernelle et al. "Needle Labeling for Interstitial Gynecological Brachytherapy". Fifth National Image Guided Therapy Workshop, Sept 21, 2012
 +
* Pernelle, Egger, Vale, Chen, Irlinger, Lueth, Wells, Kikinis, Viswanathan and Kapur. Robust Applicator Registration for Interstitial Gynecologic Brachytherapy. ABS 2013 Annual Meeting
 +
* Pernelle. "Needle labeling for Image-Guided Brachytherapy", Masters thesis (in preparation). Technical University Munich and Ecole Centrale Marseille, Dec 14, 2012
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/extension-section|Information for Developers}}
{{documentation/{{documentation/version}}/extension-developerinfo}}
+
iGyne is currently articulated in seven steps:
 +
1) procedure selection
 +
2) applicator selection
 +
3) data importation
 +
4) initial applicator registration
 +
5) refined applicator registration
 +
6) needle position planning
 +
7) needle detection
 +
It offers also a way to go directly from 1) to 7), skipping the registration/planning steps
 +
 
 +
- iGyneSelectProcedureStep.py (1) and iGyneSelectApplicatorStep.py (2) let you choose to use or not an applicator, and to select the most convenient one. There are different configurations for the fiducial markers:
 +
* 4 landmarks, ordered from the top left corner and counting counter-clockwise (new cases)
 +
* 3 landmarks, positioned at the corners of the template, ordered as above
 +
* 3 landmarks, starting from the one in the middle of the template and counting counter-clockwise
 +
This step offers an automatic registration option if the CLI module Hough Transformed has been previously enabled
 +
 
 +
- iGyneLoadModelStep.py (3) let you load the data while the scene is loaded depending on the made in step 2.
 +
 
 +
- iGyneFirstRegistrationStep.py (4) is the initial registration step. Depending on the choice you made on the previous step, you can click on the bright markers in the image or let the automatic registration find them for you (requires the CLI module called Hough Transform).
 +
 
 +
- iGyneSecondRegistrationStep.py (5) is the refined applicator registration step. It offers fully automated computation to complete manual parameterization if needed. Thus, several segmentation methods are available to segment the obturator, and the registration parameters can be tweaked. By default, the most efficient parameters are chosen and all steps of the refined registration are computed successively. Evaluation functions have also been integrated to allow developers to measure time and accuracy of the chosen methods and parameters. Beside the control interface, 2D views display cross sections of the applicator in axial, sagital and coronal planes giving the user a visual characterization of the registration state.
 +
 
 +
- iGyneNeedlePlanningStep.py (6) let you insert "virtual needles" and visualize their trajectory in the 2D/3D viewer. You can tweak the color and the length of the needles.
 +
 
 +
- iGyneNeedleSegmentationStep.py (7) is the "keystone" of iGyne. Start by clicking on "Start Giving Needle Tips" and at each click in the 2D axial viewer, a needle will be segmented. You can display, delete the needles individually or all together. You can also differentiate the different insertion steps and separate each group of needles. A table shows some parameters of the caculated needles. If a registration has been done previously, it will assign to each needle the most probable label. It is also possible to tweak the needle segmentation parameters.
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-footer}}
 
{{documentation/{{documentation/version}}/extension-footer}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 18:32, 28 April 2014

Home < Documentation < Nightly < Extensions < iGyne


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


Introduction and Acknowledgements

Authors: Guillaume Pernelle, Xiaojun Chen, Yi Gao, Jan Egger
Contributors: iGyne Team
Contact: Guillaume Pernelle, <email>gpernelle@gmail.com</email>
Website: https://github.com/gpernelle/iGyne
License: Slicer license
Related Master's Thesis: Labeled Needle Rendering Solution for Image Guided Brachytherapy

Extension Description

iGyne is an open source software for MR-Guided Interstitial Gynecologic Brachytherapy. It enables on-time processing of the intra-operative MRI data via a DICOM connection to the scanner followed by a multi-stage registration of CAD models of the template and the obturator to the patient images. This allows the virtual placement of interstitial needles during the intervention, as well as needle detection and needle labeling.

iGyne is currently articulated in seven steps: 1) procedure selection 2) applicator selection 3) data importation 4) initial applicator registration 5) refined applicator registration 6) needle position planning 7) needle detection

Modules

Use Cases

Phantom Study and Sample data

Similar Extensions

N/A

References

  • http://www.na-mic.org/Wiki/index.php/2012_Summer_Project_Week:iGyne
  • Xiaojun Chen, Jan Egger, Akila Viswanathan, Neha Agrawal, William Wells, Ron Kikinis, Clare Tempany, Ferenc Jolesz and Tina Kapur. "Image Processing for MR-guided Gynecologic Interstitial Brachytherapy in AMIGO", The 9th Interventional MRI Symposium. September 22-23, 2012.
  • Gao, Farhat, Pernelle et al. "Needle Labeling for Interstitial Gynecological Brachytherapy". Fifth National Image Guided Therapy Workshop, Sept 21, 2012
  • Pernelle, Egger, Vale, Chen, Irlinger, Lueth, Wells, Kikinis, Viswanathan and Kapur. Robust Applicator Registration for Interstitial Gynecologic Brachytherapy. ABS 2013 Annual Meeting
  • Pernelle. "Needle labeling for Image-Guided Brachytherapy", Masters thesis (in preparation). Technical University Munich and Ecole Centrale Marseille, Dec 14, 2012

Information for Developers

iGyne is currently articulated in seven steps: 1) procedure selection 2) applicator selection 3) data importation 4) initial applicator registration 5) refined applicator registration 6) needle position planning 7) needle detection It offers also a way to go directly from 1) to 7), skipping the registration/planning steps

- iGyneSelectProcedureStep.py (1) and iGyneSelectApplicatorStep.py (2) let you choose to use or not an applicator, and to select the most convenient one. There are different configurations for the fiducial markers:

  • 4 landmarks, ordered from the top left corner and counting counter-clockwise (new cases)
  • 3 landmarks, positioned at the corners of the template, ordered as above
  • 3 landmarks, starting from the one in the middle of the template and counting counter-clockwise

This step offers an automatic registration option if the CLI module Hough Transformed has been previously enabled

- iGyneLoadModelStep.py (3) let you load the data while the scene is loaded depending on the made in step 2.

- iGyneFirstRegistrationStep.py (4) is the initial registration step. Depending on the choice you made on the previous step, you can click on the bright markers in the image or let the automatic registration find them for you (requires the CLI module called Hough Transform).

- iGyneSecondRegistrationStep.py (5) is the refined applicator registration step. It offers fully automated computation to complete manual parameterization if needed. Thus, several segmentation methods are available to segment the obturator, and the registration parameters can be tweaked. By default, the most efficient parameters are chosen and all steps of the refined registration are computed successively. Evaluation functions have also been integrated to allow developers to measure time and accuracy of the chosen methods and parameters. Beside the control interface, 2D views display cross sections of the applicator in axial, sagital and coronal planes giving the user a visual characterization of the registration state.

- iGyneNeedlePlanningStep.py (6) let you insert "virtual needles" and visualize their trajectory in the 2D/3D viewer. You can tweak the color and the length of the needles.

- iGyneNeedleSegmentationStep.py (7) is the "keystone" of iGyne. Start by clicking on "Start Giving Needle Tips" and at each click in the 2D axial viewer, a needle will be segmented. You can display, delete the needles individually or all together. You can also differentiate the different insertion steps and separate each group of needles. A table shows some parameters of the caculated needles. If a registration has been done previously, it will assign to each needle the most probable label. It is also possible to tweak the needle segmentation parameters.