Modules:CollectFiducials-Documentation-3.6
Return to Slicer 3.6 Documentation
Module Name
Collect Fiducials
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 is intended for use with OpenIGTLink Module. The main purpose of this module is to collect patient fiducial locations from an external tracking device. Once a tracking system, such as the NDI Aurora, is configured and transforms are being passed to Slicer, then this module will let a user collect the position of patient fiducials, which can then be registered using Fiducial-Based Registration (TransformFrom Fidcucials).
Usage
Use Cases, Examples
This module is especially appropriate for these use cases:
- Given a patient with patient fiducials attached prior to imaging or appropriate anatomical landmarks, use this module to collect the locations in the tracking (or reference tool) space for registration with the fiducials or landmarks in the associated image.
Examples of the module in use:
- 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.
- Data Set 1: To be completed at a later date.
Quick Tour of Features and Use
- Tracker Information: Provide the Transform MRML node that contains the transform for the tool being tracked.
- Fiducial List Node Selection Panel:
- Create a new fiducial list MRML node or select an existing list.
- Select the number of fiducials to set up the table below to have the correct number of rows. The number of fiducials should correspond to the number of fiducials that are identified in the image.
- Initialize or reset the fiducial list. An easy way to know which fiducials have been collected, it is easier to set all of them to zero and then work through the table.
- Get New Measure Button: Collect the current location of the tracked tool tip.
- Save Fiducials Button: Save the fiducial locations to the fiducial list MRML node.
Development
Notes from the Developer(s)
Dependencies
- OpenIGTLink Module is needed to serve up the tracking data either via IGSTK or a custom program that serves up OpenIGT stream data.
- Fiducial Registration Algorithm such as Fiducial-Based Registration (TransformFromFiducials)module in the Registration category is needed after the fiducial markers are collected.
Tests
Known bugs
Links to known bugs in the Slicer3 bug tracker
- None.
Usability issues
Follow this link to the Slicer3 bug tracker. Please select the usability issue category when browsing or contributing.
Source code & documentation
Links to the module's source code:
Source code:
- vtkCollectFiducialsGUI.cxx
- vtkCollectFiducialsGUI.h
- vtkCollectFiducialsLogic.cxx
- vtkCollectFiducialsLogic.h
Doxygen documentation:
More Information
Acknowledgment
Developed at Northern Digital Inc. (NDI)
