Training:RobartsResearchInstitute2008 Workshop Prerequisite
Contents
To Do Before the Workshop
- Install Slicer from the source code (downloading a binary is not enough)
- Install the additional software
- Download the datasets
Preparation for the Workshop
The following components of the NA-MIC kit will be used during the workshop.
- 1. Slicer3: software application and open-source programming environment
- 2. CMake: cross-platform open-source build system
- 3. Insight Segmentation and Registration Toolkit (ITK) environment
- 4. Visualization Toolkit (VTK) environment
- 5. Development packages
- 6. Datasets
Slicer3 Software
Please do the following two commands to download the source code and build Slicer3 on the computer that you will be bringing to the workshop:
svn co http://svn.slicer.org/Slicer3/branches/Stanford2008 Slicer3 ./Slicer3/Scripts/getbuildtest.tcl
Note: Building Slicer can take up to 2 hours.
Note: the VTK, ITK, and KWWidgets cvs servers have been heavily loaded. If your build fails, you should re-run the getbuildtest script to be sure all the libraries have properly built.
Also note that some of the tests may fail due to warnings - don't worry about this. As long as the slicer user interface built on your machine comes up on you will be ready for the workshop.
Recommended configuration: Windows XP, Linux (x86 or x86_64), Mac OS (ppc or Intel), 2 GB of RAM and a dedicated graphic accelerator with 128 MB of on board graphic memory.
This will install the following packages:
- CMake 2.6
- ITK 3.8
- VTK 5.2
Development packages
Linux
- gcc
- gcc-c++
- libX11
- libX11-devel (libX11-dev on Ubuntu)
- libXt-devel (libXt-dev on Ubuntu)
- opengl/mesa (libgl1-mesa-dev on Ubuntu)
- libncurses5-dev
Below is a Ubuntu one line install:
sudo apt-get install subversion cvs tcl8.4 gcc g++ libX11-dev libXt-dev libxext-dev libgl1-mesa-dev libncurses5-dev tcsh
Note: The packages names below correspond to Ubuntu 7.04. Please ensure that you use the appropriate package names for your distribution. Also, be sure you have OpenGL and the GLX extension to X working. To check the installation, it is usually enough to confirm that the command 'glxgears' runs with no errors.
Windows
- Developer Studio 8 2005 ( if installed in the default locations in "c:/Program Files" it will be detected by the build script automatically (you need to edit slicer_variables.tcl to point to the installation)).
- Cygwin with the following 5 packages
- tcltk (Libs -> tcltk: TCL/Tk libraries)
- svn (Devel -> subversion: A version control system)
- cvs (Devel -> cvs: Concurrent Version System)
- unzip (Archive -> unzip: A utility for uinpacking zip files)
- curl (Web -> curl: Command line tool for transferring files with HTTP, HTTPS, FTP, etc.)
Note: CMake and VTK will not work on a FAT formatted disk (use NTFS).
- If you do not have Developer Studio 8 2005, follow the instructions on this page. However, run:
svn co http://svn.slicer.org/Slicer3/branches/Stanford2008 Slicer3
instead of
svn co http://svn.slicer.org/Slicer3/trunk Slicer3
You will need to manually install a newer version of cmake as part of the process described in the link.
Apple Mac OS X
For Mac OS 10.4.10 install the following from the OS disks (not installed by default on new machines):
- Xcode Tools (OS Disk 1, default window)
- X11: also on OS Disk 1, but you need to scroll down and find the Optional Installs installer and select X11 under Applications. See step-by-step instructions.
- X11SDK - from OS Disk 1, Xcode Tools/Packages/X11SDK.pkg
- Subversion. Installation options here. Get the latest svn version for compatibility with the server and be sure your client includes SSL (so it can access https repositories).
Additional software
- Follow the instructions to install the OpenIGTLink loadable module.
- If you downloaded the precompiled version (binary):
- Check to make sure that OpenIGTLink appears as a module in Slicer's list of modules (run Slicer, open the modules list by clicking on "Data", and ensure that OpenIGTLink is in the list).
- If OpenIGTLink does not appear, then you must build the OpenIGTLink module from source.
- Follow the instructions to install the tracker simulator.
Datasets
Please download the following datasets for the hands-on sessions:
- Tool.vtk
- If Windows saves the file as Tool.htm instead of Tool.vtk:
- Select Start->Run
- type "cmd"
- type "cd <directory where Tool.htm is>"
- type "move Tool.htm Tool.vtk"
