Technical Information

Technical information of 4D Ultrasound

<= Back to project page

Build Instructions

It is highly recommended to have a compiled version of Slicer and to have good knowledge about cmake.

1. Check out 4D Ultrasound from http://svn.na-mic.org/NAMICSandBox/trunk/4DUltrasound
   
   
2. Configure via ccmake (version > 2.6) in your build directory
   
   You need a compiled version of VTK
   
   
   1. Make a new directory in with the name "Build" in the 4DUltrasound dir:
      
      .../4DUltrasound$ mkdir Build
      
      
   2. Change into the Build directory
      
      .../4DUltrasound$ cd Build
      
      
   3. Execute ccmake in this directory with the parent directory as parameter
      
      .../4DUltrasound/Build$ ccmake ../
      
      If ccmake (version > 2.6) is not installed in your system the executable can as well be found in: .../Slicer3-lib/CMAKE-build/bin/ccmake
      
      
   4. Type "c" to start the configuration -> You will receive an error message that VTK was not found -> Type "e" to exit help
      
      
   5. Change the cursor to the variable with the name "VTK_DIR" and hit ENTER
      
      
   6. Fill in your VTK-Build directory and hit ENTER (if you have a compiled version of Slicer you can use: .../Slicer3-lib/VTK-build )
      
      
   7. Hit "c" to start the configuration
      
      
   8. You will receive an error message -> ignore it and hit "e"
3. Compile 4D Ultrasound: Type $ make in your build directory
   
   .../4DUltrasound/Build$ make

Running 4D Ultrasound

You need a working version of Slicer with OpenIGTLink

1. Copy "CalibrationFile.txt" from YOUR_SOURCE_DIR to YOUR_BUILD_DIR/bin
2. Run Slicer
3. Add an "activer Server Connector" in the OpenIGTLink module which is waiting for data at port 18944
4. Run Synchrograb on the same machine you run Slicer

 $YOUR_BUILD_DIR/bin/4DUltrasound -c CalibrationFile.txt

Commandline Options

Command	Alternative	Description
--calibration-file xxx	-c xxx	Specify the calibration file (mandatory)
--reconstruct-volume	-rv	Enable volume reconstruction
--dynamic-volumesize	-dvs	Enable dynamic size of reconstruction volume
--track-ultrasound	-tu	Enable ultrasound tracking
--track-instrument	-ti	Enable instrument tracking
--simulate-instrument	-si	Simulate instrument
--oigtl-server xxx	-os xxx	Specify OpenIGTLink server (default: 'localhost')
--oigtl-port xxx	-op xxx	Specify OpenIGTLink port of server (default: 18944)
--frames-per-second xxx	-fps xxx	Number of frames per second for the ultrasound data collection (default: 30)
--video-source xxx	-vs xxx	Set video source (default: '/dev/video0')
--video-source-channel xxx	-vsc xxx	Set video source channel (default: 3)
--video-mode xxx	-vm xxx	Set video mode; Options: NTSC, PAL (default: NTSC)
--scan-depth xxx	-sd xxx	Set depth of ultrasound scan in Millimeter (default: 70mm)
--verbose	-v	Print more information TO DO Priority MUST Priority SHOULD Clean up Code and Make files (Remove unnecessary Koeniginen parts) Outsource OpenIGTLink library Automatically copy Calibration file into binary directory Fix compiler checking in cmake Enable differnet video modes and channels in vtkVideo4Linux2 Priority COULD DONE Replace SonixGrabber with Ultrasound in source code OpenIGTLink test feature Tracker test feature Ultrasound test feature Ultrasound device The ultrasound images are received via a video capture card. Linux uses V4L2 to support the card. Capture Card - Hauppauge WIN-TV PCI Board ImpactVCB Model 558 Hauppauge Homepage Incoming images are digitized using high quality 4:2:2 (Y:U:V) video sampling Linux (Ubuntu 8.10 , Fedora 5) The card is automatically correct detected. No further configuration needed. Linux Driver: Video4Linux2 bt878 "bt" stands for Brooktree the original Manufacturer. Now bought by Conexant The Linux driver (bttv) for the WinTV card is now part of the Linux kernel (version 2.6.xxx and newer). Hauppage Linux Information Linux installation hints [1] Modprobe option # for specific drivers: http://tldp.org/HOWTO/BTTV/cards.html The Impact VCB has # 10 enable kernel module via: "$ modprobe bttv card=10" or add to /etc/modprobe.conf the following line "options bttv card=10 " to switch to another card first remove the module via: "$ modprobe -r bttv" The card uses NTSC video interlacing per default Hardware Information Channel 3 delivers the s-video signal To set the channel add the following at the end of void vtkV4L2VideoSource::InitDevice(void): int channel = 3; if (-1 == xioctl (fd,VIDIOC_S_INPUT , &channel)) errno_exit ("VIDIOC_S_INPUT"); Specific Hardware information: [2] !!be carefull huge page, takes a long time to load!! Video4Linux2 Video4Linux is part of the Linux kernel since version 2.6.xx V4L2 wiki [3] API Specificattion: [4] xawtv software for video preview from the guy who wrote the bt8xx driver Old links may soon be dead V4L Old wiki Driver for our Video Card Link collection for V4L: [5] Homepage of the original developer of the bttv driver: [6] Is not up to date anymore Old Informaton they might not be be up to date anymore Contacts Christoph Ruetz His Project Page Tracking device We are using a NDI Aurora tracker. Synchrograb includes an NDI tracker class which works out of the box with the Aurora NDI tracker. Contacts Haiying Liu Calibration Description: To get the correct information from the ultrasound device it has to be calibrated Contacts Raul San Jose Information: I have serval links and information from Raul on which I have to go through Slicer I am using the trunk version of Slicer (3.3) since this has the OpenIGTLink module and the CUDA module. Python Synchrograb Module I implemented a Pyhton module for Slicer to start Synchrograb. The module can be found in this svn repository. Basically it starts a new shell and calls the Synchrograb binary within this shell. All Synchrograb commandline options are available in the module. So fare it is not part of the Slicer repository. 3D CUDA I might not use Cuda acceleration since there is no real performance advantage at this point TO DO Nothing Contacts Ben Grauer: Volume Rendering with CUDA Nicholas Harlambang: CUDA Guru Documentation: VolumeRenderingCuda Module Adjust the threshold (scroll bar below 'Component Weights Scrollbars') to correct values. Especially the lower value. Normally > 0 Scalar Opacity Mapping: Shows a histogram of the used values an their transparence. Low transparent, high solid Scalar Color Mapping: You can click into and than in the color circle above and select certain colors for a specific value Composite: Here you can select different rendering modes Volume: You can also select just to display a slice instead of the whole volume. You can transform the slice in the Transforms Module and than select the transformation matrix in Slice Matrix Plus/Minus: Select if you want to see everything or just the volume on one side of the slice and on the other Links Sandbox page [7] SPL Intraweb web for incoming staff Wink - Software for Video Documentation BWH Editorial Service Infos on loadable Modules HowTo Loadable Module HowToLoadable Module GUI Infos about Executable Modules inSlicer Subscribe to different meetings Journal Club 1st Monday Seminar Office OPRC Radiology Grand Rounds Cimit Forum How to "Enable CUDA 2.0 in Fedora 8 for use with Slicer 3.3 Alpha" Date: Sept. 26th 2008 Fedora 8 is the newest Fedora version for which CUDA is available. The available CUDA Version is 2.0. To enable CUDA 2.0 in Fedora 8 for Slicer 3.3 Alpha follow the steps below: Installation of Drivers Download the CUDA installation files (Driver, Toolkit, SDK) here [8] and remember the directory in which you downloaded them. I used for the driver installation binary ~/Download/CUDA/Driver/ for the tool kit installation binary ~/Download/CUDA/Toolkit/ and for the SDK installation binary ~/Download/CUDA/SDK/ For the installation there must not run a X-Server. Therefore we have to restart the computer. When you see the GRUB Bootscreen after the reboot press any key to enter the GRUB menu. Highlight the Fedora Version you want to boot and press a Then type Type 3 and hit the 'Enter' key. Fedora will boot up without X Server and drop you at Command Line Login prompt. Login and change into root mode via: su Then switch to the directory where you downloaded the driver. For me this means: cd ~/Download/CUDA/Driver/ Now we have to change the permissions for the driver-binary and make it executable. This works with chmod +x BINARY-NAME (Replace 'BINARY-NAME' with the name of the driver binary) Now start the installation with: ./BINARU-NAME I changed none of the default values during the installation For the sdk compilation follow this reference guide: [9] If you get the error message: "ld: cannot find -lglut", like I did, have a look at the reference under 'IV. Known Issues' In the next step we do the same for the toolkit and for the sdk, e.g chance to the according directory, change the permissions and run the installation with the default values Enable CUDA in Slicer 3.3 Alpha Start with the installation manual of Ben Grauer. You find it here [10] Below you find corrections to certains points that did not work for me the way it was explained in the manual In 1.1.2 Check out the following slicer branch instead and build it: svn co http://svn.slicer.org/Slicer3/trunk Slicer3 ./Slicer3/Scripts/getbuildtest.tcl Before you can go on with step 1.2.2 you have to Uncomment: CudaSupport in Slicer3/Libs/CMakeLists.txt VolumeRenderingCuda in Slicer3/Modules/CMakeLists.txt In step 1.2.2 you have to use your build directory (Slicer-build) as parameter for ccmake for CUDA_INSTALL_PREFIX use /usr/local/cuda for FOUND_CUT use $HOME/NVIDIA_CUDA_SDK/common/lib/linux/libcudpp.a for FOUND_CUT_INCLUDE use $HOME/NVIDIA_CUDA_SDK/common/inc Step 1.2.3 was not necessary for me Just do a rebuild (run Slicer3/Scripts/getbuildtest.tcl) and the VolumeRenderingCUDA module is available This installation worked for me on a DELL machine with XEON Dual Core and a Nvidia G8800. For fast rendering make sure not enable compiz(Desktop Effects).