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

From NAMIC Wiki
Jump to: navigation, search
 
(6 intermediate revisions by 2 users not shown)
Line 9: Line 9:
 
This tutorial uses a tracking simulator to explain how navigation works in Slicer3.
 
This tutorial uses a tracking simulator to explain how navigation works in Slicer3.
  
The general IGT navigation system consists of the following components:
+
A general IGT navigation system consists of the following components:
 
* Slicer3 - the base platform
 
* Slicer3 - the base platform
* OpenIGTLink module - a loadable software module plugged into Slicer3
 
 
* IGSTK - an interfacing tool for common commercial tracking devices
 
* IGSTK - an interfacing tool for common commercial tracking devices
 
* A tracking device - such as the NDI Aurora magnetic tracking system
 
* A tracking device - such as the NDI Aurora magnetic tracking system
Line 26: Line 25:
  
 
==Software Installation Instructions==
 
==Software Installation Instructions==
<font color="red">!![Oct 15 2008, 9:00am] The instruction has been updated to fix the module compatibility problem.!!</font>
+
 
 
=== '''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.
 
+
* Download a Slicer binary for your platform.
<s>To use precomplied Open IGT Link module below, one has to download Slicer3.2-rc1-2008-06-02 .</s>
+
* Install Slicer.
 
 
To use precomplied Open IGT Link module below, one has to download Slicer3.2-rc2-2008-06-23 .
 
 
 
* [http://www.slicer.org/DownloadSlicer.php/Snapshots/win32/Slicer3-3.2-rc2-2008-06-23-win32.exe For Windows (32-bit)]
 
* [http://www.slicer.org/DownloadSlicer.php/Snapshots/linux-x86/Slicer3-3.2-rc2-2008-06-23-linux-x86.tar.gz For Linux (x86, 32-bit)]
 
* [http://www.slicer.org/DownloadSlicer.php/Snapshots/linux-x86_64/Slicer3-3.2-rc2-2008-06-23-linux-x86_64.tar.gz For Linux (x86, 64-bit)]
 
* [http://www.slicer.org/DownloadSlicer.php/Snapshots/darwin-x86/Slicer3-3.2-rc2-2008-06-23-darwin-x86.tar.gz For Mac OS X (x86)]
 
* [http://www.slicer.org/DownloadSlicer.php/Snapshots/darwin-ppc/Slicer3-3.2-rc2-2008-06-23-darwin-ppc.tar.gz For Mac OS X (PPC)]
 
 
 
 
 
=== '''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 2a:'''  You have the choice of either downloading a precompiled version (binary) '''OR''' building it yourself from the source code:
 
** Precompiled OpenIGTLink module (for use with Slicer 3.2):  Download and unzip.
 
*** [[Media:OpenIGTLink_3.2rc2_Linux_x86_32.tgz| For Linux (x86, 32-bit)]].
 
*** [[Media:OpenIGTLink_3.2rc2_Linux_x86_64.tgz| For Linux (x86, 64-bit)]].
 
*** [[Media:OpenIGTLink_3.2rc2_Win_x86_32.zip| For Windows (32-bit)]].
 
*** [[Media:OpenIGTLink_3.2rc2_Darwin_x86.tgz| For Mac OS X(x86)]].
 
*** [[Media:OpenIGTLink_3.2rc2_Darwin_ppc.tgz| For Mac OS X(PPC)]].
 
 
 
<!--
 
*** [[Media:OpenIGTLink_3.2_Win_x86_32.zip| For Windows (32-bit)]].
 
*** [[Media:OpenIGTLink-vs8-Munich2008.zip| For Windows (32-bit Visual Studio 2008, debug, Munich2008)]]
 
*** [[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_64.tgz| For Linux (x86, 64-bit)]].
 
-->
 
 
 
** Building the OpenIGTLink module from source code:  [http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Build-OpenIGTLink Find the instructions here]
 
* ''' Step 2b:'''
 
** Windows:  Copy the binary into '''your-slicer3-build(install)-directory'''/lib/Slicer3/Modules/Debug
 
** Linux/Mac OS X:  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 the tracker simulator'''===
+
==='''Step 2: Install the tracker simulator'''===
 
The tracking simulator will be used to generate and send fake tracking data to Slicer3.
 
The tracking simulator will be used to generate and send fake tracking data to Slicer3.
 
* You have the choice of either downloading a precompiled version (binary) '''OR''' building it yourself from the source code:
 
* You have the choice of either downloading a precompiled version (binary) '''OR''' building it yourself from the source code:
 
** Precompiled tracking simulator:  Download and unzip.
 
** Precompiled tracking simulator:  Download and unzip.
*** [[Media:TrackerSimulator_Win_x86_32.zip|For Windows (32-bit)]].
+
*** [[Media:TrackerClient_Win_x86_32.zip|For Windows (32-bit)]].
 
*** [[Media:TrackerSimulator_Darwin_x86.tgz |For Mac OS X(x86)]].
 
*** [[Media:TrackerSimulator_Darwin_x86.tgz |For Mac OS X(x86)]].
*** [[Media:TrackerSimulator_Linux_x86_32.tgz|For Linux (x86, 32-bit)]].
+
*** [[Media:TrackerClient_Linux_x86_32.tgz|For Linux (x86, 32-bit)]].
*** [[Media:TrackerSimulator_Linux_x86_64.tgz|For Linux (x86, 64-bit)]].
+
*** [[Media:TrackerClient_Linux_x86_64.tgz|For Linux (x86, 64-bit)]].
 
** Building the tracker simulator from source code:  [http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Build-Tracker-Simulator Find the instructions here]
 
** Building the tracker simulator from source code:  [http://wiki.na-mic.org/Wiki/index.php/IGT:ToolKit/Build-Tracker-Simulator Find the instructions here]
  

Latest revision as of 16:06, 10 April 2009

Home < IGT:ToolKit < Navigation-tutorial
IGTBasicNavigationSummary.png

Back to IGT:ToolKit

Basic Slicer3 Navigation Tutorial

Overview:

This tutorial uses a tracking simulator to explain how navigation works in Slicer3.

A general IGT navigation system consists of the following components:

  • Slicer3 - the base platform
  • IGSTK - an interfacing tool for common commercial tracking devices
  • A tracking device - such as the NDI Aurora magnetic tracking system

The tracking simulator simulates the tracking device and the IGSTK interfacing software.

Those wishing to connect a real tracking system to Slicer3 should see the Advanced Navigation Tutorial.

Tutorial Materials

  • Tutorial slides for the Basic Navigation Tutorial
  • Atlas: download the .zip file from either the SPL-PNL Brain Atlas or the SPL Abdominal Atlas
  • Tool model (right-click to download)
    • If Windows saves the file as Tool.htm intstead of Tool.vtk: Select Start->Run, type "cmd", type "cd <directory where Tool.htm is>", type "move Tool.htm Tool.vtk"

Software Installation Instructions

Step 1: Install Slicer3

  • Go to the Slicer3 Install site.
  • Download a Slicer binary for your platform.
  • Install Slicer.

Step 2: Install the tracker simulator

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

People