Difference between revisions of "IGT:ToolKit/Navigation-tutorial"

From NAMIC Wiki
Jump to: navigation, search
Line 6: Line 6:
 
* IGSTK: An interfacing tool for common commercial tracking devices
 
* IGSTK: An interfacing tool for common commercial tracking devices
 
* Tracking device: e.g. NDI Aurora tracking system
 
* Tracking device: e.g. NDI Aurora tracking system
<br>
+
 
 
This tutorial explains how to set up a general navigation system with a tracker simulator.
 
This tutorial explains how to set up a general navigation system with a tracker simulator.
<br><br>
+
 
 +
 
 
=== '''Step 1: Install Slicer3''' ===
 
=== '''Step 1: Install Slicer3''' ===
 
Go to the [http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Install-Slicer3 Slicer3 Install] site.
 
Go to the [http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Install-Slicer3 Slicer3 Install] site.
  
=== '''Step 2: Install OpenIGTLink module''' ===
+
=== '''Step 2: Install the OpenIGTLink module''' ===
OpenIGTLink is currently distributed as a loadable module for 3D Slicer.
+
OpenIGTLink is a communication protocol used to interface Slicer3 with external devices, such as trackers, imaging devices and robots.  OpenIGTLink is currently distributed as a loadable module for Slicer3.
 
* '''Step 2a:'''  You have the choice of either downloading a precompiled version '''OR''' building it yourself from the source code:
 
* '''Step 2a:'''  You have the choice of either downloading a precompiled version '''OR''' building it yourself from the source code:
** Precompiled OpenIGTLink module (for use with Slicer 3.2):
+
** Precompiled OpenIGTLink module (for use with Slicer 3.2): Download and unzip.
 +
*** [[Media:OpenIGTLink_3.2_Win_x86_32.zip| For Windows (32-bit)]].
 +
*** [[Media:OpenIGTLink_Darwin_3.2_x86.tgz| For Mac OS X(x86)]].
 
*** [[Media:OpenIGTLink_3.2_Linux_x86_32.tgz| For Linux (x86, 32-bit)]].
 
*** [[Media:OpenIGTLink_3.2_Linux_x86_32.tgz| For Linux (x86, 32-bit)]].
 
*** [[Media:OpenIGTLink_3.2_Linux_x86_64.tgz| For Linux (x86, 64-bit)]].
 
*** [[Media:OpenIGTLink_3.2_Linux_x86_64.tgz| For Linux (x86, 64-bit)]].
*** [[Media:OpenIGTLink_3.2_Win_x86_32.zip| For Windows (32-bit)]].
+
** Building the OpenIGTLink module from source code:  [http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Build-OpenIGTLink Find the instructions here]
*** [[Media:OpenIGTLink_Darwin_3.2_x86.tgz| For Mac OS X(x86)]].
 
** Building the OpenIGTLink from source code:  [http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Build-OpenIGTLink Find the instructions here]
 
 
* ''' Step 2b:''' Copy the binary into '''your-slicer3-build(install)-directory'''/lib/Slicer3/Modules.  You should see the OpenIGTLink module in the Slicer3 module list once Slicer3 is started.
 
* ''' Step 2b:''' Copy the binary into '''your-slicer3-build(install)-directory'''/lib/Slicer3/Modules.  You should see the OpenIGTLink module in the Slicer3 module list once Slicer3 is started.
  
==='''Step 3: Install tracker simulator'''===
+
==='''Step 3: Install the tracker simulator'''===
* This tracker simulator will generate and send fake tracking data to Slicer3. Download one of the following binaries:
+
The tracking simulator will be used to generate and send fake tracking data to Slicer3.
** For Linux (x86, 32-bit), click [[Media:TrackerSimulator_Linux_x86_32.tgz|'''here''']].
+
* You have the choice of either downloading a precompiled version '''OR''' building it yourself from the source code:
** For Linux (x86, 64-bit), click [[Media:TrackerSimulator_Linux_x86_64.tgz|'''here''']].
+
** Precompiled tracking simulator:  Download and unzip.
** For Windows (32-bit), click [[Media:TrackerSimulator_Win_x86_32.zip|'''here''']].
+
*** [[Media:TrackerSimulator_Win_x86_32.zip|For Windows (32-bit)]].
** For Mac OS X (x86), click [[Media:TrackerSimulator_Darwin_x86.tgz |'''here''']].
+
*** [[Media:TrackerSimulator_Darwin_x86.tgz |For Mac OS X(x86)]].
* Unzip the binary to some place on your computer.
+
*** [[Media:TrackerSimulator_Linux_x86_32.tgz|For Linux (x86, 32-bit)]].
 
+
*** [[Media:TrackerSimulator_Linux_x86_64.tgz|For Linux (x86, 64-bit)]].
==='''Step 4: Perform navigation'''===
+
** Building the tracker simulator from source code[http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Build-Tracker-Simulator Find the instructions here]
* Run Slicer3. In the top directory of your Slicer3 installation, run this command to start up Slicer3:
 
./Slicer3
 
* Set up OpenIGTLink module
 
** Choose OpenIGTLink from Slicer Module list:[[Image:Slicer3_Select_OpenIGTLinkModule.png]]
 
** Set up OpenIGTLink module to receive tracking data: [[Image:Slicer3_Enable_OpenIGT_Server.png]]
 
* Run tracker simulator to send tracking data to Slicer3:
 
cd to the install directory of TrackerSimulator
 
  ./TrackerSim  10  c  local 18944
 

Revision as of 02:08, 4 June 2008

Home < IGT:ToolKit < Navigation-tutorial

Back to IGT:ToolKit

The general navigation system consists of the following components:

  • Slicer3: the base platform for navigation
  • IGT loadable modules: Software modules, pluginned into Slicer3, for supporting IGT specific functionality
  • IGSTK: An interfacing tool for common commercial tracking devices
  • Tracking device: e.g. NDI Aurora tracking system

This tutorial explains how to set up a general navigation system with a tracker simulator.


Step 1: Install Slicer3

Go to the Slicer3 Install site.

Step 2: Install the OpenIGTLink module

OpenIGTLink is a communication protocol used to interface Slicer3 with external devices, such as trackers, imaging devices and robots. OpenIGTLink is currently distributed as a loadable module for Slicer3.

Step 3: Install the tracker simulator

The tracking simulator will be used to generate and send fake tracking data to Slicer3.