Modules:IGTToolSelector-Documentation-3.6
Return to Slicer 3.6 Documentation
Module Name
IGTToolSelector
General Information
Module Type & Category
Type: Interactive
Category: IGT
Authors, Collaborators & Contact
- Andrew D. Wiles, Ph.D.: NDI (Northern Digital Inc., http://www.ndigital.com)
- Contact: awiles [at] ndigital.com
Module Description
This module allows you to change the model of a tracked tool for image-guided therapy. Used with the OpenIGTLink IF Module, a vtkPolyData model can be assigned to a transformation from the tracking system. This module has PolyData models for a needle and a probe. The user can also choose to toggle on/off (i) the target (tip) location and (ii) the tool projection. It is assumed that the projection of the tool is in the negative z-direction.
Usage
Use Cases, Examples
This module is especially appropriate for these use cases:
- Use Case 1: This is intended for IGT applications where virtual representation of the surgical tool is needed for interaction with an image. Currently, this module is limited to a single tool but plans are in place to expand it to multiple tools.
Examples of the module in use:
- Example 1 -- To be completed at a later date.
Tutorials
Links to tutorials explaining how to use this module:
- Tutorial 1 -- to be completed at a later date.
Quick Tour of Features and Use
- Tool Properties Panel:
- Probe Transform: Select the MRML node that contains the probe transform being served up from the tracking system via the OpenIGTLink IF Module.
- Tool Type List: Select the tool type being tracked. Currently only three types are available: the OpenIGTLink Default, Needle and a Pointer Probe. It is easy to added other models by adding functions to the Logic code.
- Enable Tool PolyDdata Checkbox: Toggle the tool on and off.
- Show Axes Checkbox: Toggle the tool axes on and off.
- Show Tool Projection: Toggle the projection line on and off.
- Set Projection Length Slider: Control the length of the projection line. 250mm is the maximum (Is this reasonable?).
- Set Projection Diamater Slider: Control the size of the radius of the projection line. 10mm is the maximum.
- Show Tool Tip Location Checkbox: Toggle the tool tip sphere on and off.
- Set Tool Tip Diameter Slider: Control the size of the sphere at the tool tip location. 10mm is the maximum.
Development
Notes from the Developer(s)
Dependencies
None are needed, but you will need a transform either from OpenIGTLink or somewhere else. If you just want to test the module. Create a new transform using the Transforms Module and leave as the identity and assign that transform as the Probe Transform in this module.
Tests
Known bugs
Links to known bugs in the Slicer3 bug tracker
Usability issues
Follow this link to the Slicer3 bug tracker. Please select the usability issue category when browsing or contributing.
Source code & documentation
Source code:
- vtkIGTToolSelectorGUI.cxx
- vtkIGTToolSelectorGUI.h
- vtkIGTToolSelectorLogic.cxx
- vtkIGTToolSelectorLogic.h
Doxygen documentation:
More Information
Acknowledgment
Developed at Northern Digital Inc. (NDI). Thanks to Chris Wedlake and John Moore at the Robarts Research Institute and the University of Western Ontario for providing their code from the Atamai Viewer for the needle and pointer probe tools.
References
Publications related to this module go here. Links to pdfs would be useful.