DTI Task Card
    
    
      Version 1.71 build 2006.12.11 for VA25/VB11/VB12/VB13
    
    
      
    Updated: February 06, 2007 01:15:49 PM (EST)    Download upgrade  
Please read the update log for information about all the changes.
    
   Note: For users who were unable to install the DTI Task Card version 1.70 on VB13 workstations, 
   please contact us for version 1.71 fresh installer.
   Note: New Siemens gradient tables have been added as of December 19, 2006. 
   For those who downloaded the v1.71 upgrade before that date (and therefore have problem with new Siemens 12 dir data), 
   please download it again and re-update. Sorry for the inconvenience.
   Note: For VB13, you will need 'DTI Evaluation package' (MR_3D_DIFFUSION_BASE)
   license from Siemens to run DTI Task Card.
    
      This document describes how to use the task card for
      Diffusion Tensor Imaging (DTI Task
      Card) on a SIEMENS
      NUMARIS 4 satellite console. This task
      card allows visualization of diffusion tensor imaging data
      and white matter fiber tracking (tractography). A general knowledge of
      MRease usage is assumed.
    
    
      Contents![[top]](images/top.png) 
    
    
      ![[down]](images/down.png) Installation
Installation
       ![[down]](images/down.png) Detailed Instructions
Detailed Instructions
    
    
      ![[down]](images/down.png) Loading Image Data
Loading Image Data
      ![[down]](images/down.png) Tensor Viewing
Tensor Viewing
      ![[down]](images/down.png) Tractography
Tractography
      ![[down]](images/down.png) Miscellanies
Miscellanies
    
![[down]](images/down.png) Known Issues
Known Issues
     ![[down]](images/down.png) References
References
     ![[down]](images/down.png) Acknowledgment
Acknowledgment
     ![[down]](images/down.png) Further Information
Further Information
    
     
    
    Note: Starting from v1.71, VA21 & VB23 are no longer supported.
    
      Before installation please check if the following
      software/hardware requirements are met:
    
    
      - 
        Make sure the PC that is about to be installed on is a
        Satellite Console (DO NOT INSTALL
        THIS SOFTWARE ON MAIN CONSOLE), and the
            MRease and Syngo versions match one of the following
            versions: 
        
    N4_VB13A_LATEST_XXXXXXXX
 syngo VE31E
 
 N4_VB11A_LATEST_XXXXXXXX
 syngo VD20L
 
 N4_VA25A_LATEST_2004XXXX
 syngo VD20L
 
 
          To find out the version select Help ->
          Info and General tab.
         
- 
        Due to extensive computation and memory usage of this
        software, a fast PC (e.g., dual Intel P4 with 1~2GB RAM) is preferred.
        Also, a mid/high end 3D graphics card by ATI or nVidia is STRONGLY
        recommended for better performance. Matrox
        G400/G450/G550 which was the default graphics card
        for old Syngo system is NOT
        recommended! 
        
          Be sure to set the color depth of the Windows display to
          32-bit or True color for best performance.
         
      Also, please read the  
      license and be aware of the following issues before
      installing the DTI Task Card software:
    
    
      - 
        Do not install this software on a scanner console.
      
- 
        Do not install this software on a satellite console without
        approval by SIEMENS.
      
- 
        Installation of this software may void any warranty.
      
- 
        There is no SIEMENS support or
        warranty or liability for this software.
      
- 
        There is no other support or warranty or liability for this
        software.
      
      To install/upgrade/uninstall the DTI Task
      Card, run the setup file "DTI_TaskCard_vXXXX.exe" and follow appropriate steps. DO NOT install unmatched version on your system.
    
    NOTE: If, for any reason, the Syngo system could not start after the installation but you need it up urgently, you may run the installer again and choose remove. That should remove the DTI Task Card and restore your Syngo system.
    Attention for VA25/VB11/VB13 version (Windows XP based): After installation the DTI task card will not show up until the data loading starts. It can also be brought up from "Applications" menu.
    
    
    
      Loading Image Data
    
    
      
        | Open the Patient Browser. Select
          the series of the original diffusion data to be used for
          diffusion tensor map calculation and visualization. Then
          click on the DTI button on the
          toolbar of the Patient Browser and
          select the appropriate type of sequence to load the data
          into the DTI Task Card. NOTE: To add your own DTI gradient directions, modify the configuration file C:\MedCom\Config\DTI\gradient_directions.ini. DO NOT MESS WITH THAT FILE UNLESS YOU KNOW WHAT YOU ARE DOING. New! Starting from version 1.63, the DTI Task Card can take mosaic data. No need to split the mosaic images anymore. 
            After data is loaded and calculated, the diffusion
            tensors can now be visualized in different patterns and
            white matter fiber tracking (tractography) can also be
            performed.
           Note: According to D. Jones' paper (see references), more diffusion gradient directions and less averages appears preferable for tractography to less diffusion directions and more averages. We would recommend using more number of diffusion directions (e.g., 12 or 24 or even more) for tractography study. | 
             
 
   | 
    
    
      Tensor Viewing![[top]](images/top.png) 
    
    
      Viewing Mode Buttons
    
    
      Select between Tensor or Tractography viewing mode.
    
    
      
        |   | Tensor viewing mode. |   | 
      
        |   | Tractography viewing mode. |   | 
    
    
      Tool Buttons for Tensor Viewing![[top]](images/top.png) 
    
    
    
    
      
        | 
            
              | View |   |  | 
      
        | 
            
              |   | 1:1. Set the current
                viewpage the same size of the viewport. |  
              |   | 4:1. Split viewport to
                2x2 viewpages. |  
              |   | 9:1. Similar to above. |  
              |   | 16:1. Similar to above. |  
              |   | Zoom In. Zoom in the current
                selected image by a factor of 2. |  
              |   | Zoom Out. Zoom out the
                current selected image by a factor of 2. |  
              |   | Zoom... Zoom the current
                selected image by an arbitrary factor chosen by
                user. |  
              |   | Restore. Restore the current
                image's size and position. |  
              |   | Restore All. Restore all the
                images' size and position. |  | 
    
    
     
    
      
        | 
            
              | Image |   |  | 
      
        | 
            
              |  |  
              |   
    | Boxoid, Ellipsoid, Plain
                Color or Plain
                Grayscale. Set the rendering object to
                Boxoid or Ellipsoid for the visualization of
                diffusion tensor, or just plain color or grayscale
                map. The small dark arrow on the right bottom of
                the button indicates that a drop-down menu will be
                shown if clicked, allowing to select the object. Note: Ellipsoid rendering can only be allowed when the view page layout is set to 1:1.
 |  
              |   | Color Sphere. Show the color
                sphere indicating the direction-color coding for
                visualization. |  
              |  |  
              |   | Unnormalized Scaling . Set
                unnormalized scaling for rendering of the diffusion
                tensor object. That is, use the three eigenvalues
                as the scaling factors for Boxoid or Ellipsoid object. This button is only enabled when Boxoid or Ellipsoid is chosen.
 |  
              |   | Parallel Viewing. Set the
                projection mode to Parallel
                or Prospective. |  
              |   | Interpolate. Turn on/off the
                interpolation for Plain
                Color or Plain
                Grayscale map. |  
              |   | Noise Threshold. Manually
                set the noise threshold for rendering. Noise threshold is used to determine background in Low b image. |  
              |   | Autoset Noise Threshold.
                Automatically set the noise threshold as the mean
                value plus 6 times standard deviation of low b
                background. |  | 
    
    
     
    
      
        | 
            
              | Map |   |  | 
      
        | 
            
              |   | FA. Set Fractional
                Anisotropy as the weighting factor for current
                visualization/maps. |  
              |   
    | E1, E2, E3 or E1-E2. Show E1, E2, E3 or E1-E2 map respectively. Only generic grayscale map is valid at E1, E2 or E3 mode. |  
              |   | LOWB. Show LOWB maps. Only generic grayscale map is valid at this mode. |  
              |   | ADC.  Show ADC maps. Only generic grayscale map is valid at this mode. |  
              |   | DWI. Show DWI maps. Only generic grayscale map is valid at this mode. |  
              |   | EXP. Show Exponential maps. Only generic grayscale map is valid at this mode. |  | 
    
    
     
    
      
        | 
            
              | Plane |   |  | 
      
        | 
            
              |   | Sagittal. View Sagittal slices. |  
              |   | Coronal. View Coronal slices. |  
              |   | Axial. View Axial slices. |  | 
    
    
     
    
      
        | 
            
              | Patient |   |  | 
      
        | 
            
              |   | Write New Series. Write new
                series into database. There will be a pop-up dialog
                allowing to selection what maps (FA, E2-E3, etc.)
                to write. The new images can be loaded into the
                Viewing Task Card. The scale factor is 1000 for FA map and 1000,000 for E1, E2, E3, E2E3 and ADC maps.
 |  
              |   | Save Map As Analyze File. Save maps (FA, ADC, LOWB, etc. and even tensor and vectors) to local files in analyze format. (NEW!) |  
              |   | Close Patient. Close the
                current patient. |  | 
    
    
      
        | 
            Note:
           
            
              
                All of the above commands except the ones in
                "Patient" category can be found in the main menu on
                top of the task card.
              
              
                Move the mouse cursor over each button to show its
                tooltip. Tooltip can only be shown when the button
                is not grayed.
              
              
                Loading a new series (new patient data) will close
                the current loaded patient and clear all the
                previously rendered images.
               | 
    
    
      Mouse![[top]](images/top.png) 
    
    
    
      
        | 
            
              |   | At this cursor, hold left button and drag to move
                the image. |  
              |   | At this cursor, hold left button and drag to zoom
                the image. |  
              |   | Hold right button and drag to rotate the image. |  
              |  | Hold middle button and drag to change windowing
                level of the image. (Note: Color and grayscale
                windowing are independent). |  | 
      
        | 
            
              |  | Right-click to bring up popup menu for more
                commands. |   |  | 
    
    
      Tractography![[top]](images/top.png) 
    
    
      Fiber Tracking Steps
    
    
    
      
        |  | 
      
        | 
            
              | Tips: |  
              | Shift Key + Left Mouse
                Button to "test-track" in the real time. |  |  
              | Left Control Key + 1/2/3 to save the current viewing position. Click camera buttons at top-right corner of the image at any time to set the viewing position to the pre-saved ones. Right Control Key + 1/2/3 to remove the pre-saved viewing positions.
 |  |   |  
              | Shift Key + Right Mouse Button to view the current voxel info. |  |   |  
              | Click right mouse button to bring up popup menu for
                the COMPLETE set of commands, such as: 
		  Some of the commands
                are not available from the menu bar or the tool
                buttons.Enable/disable fast interactive viewing.
                    Hide/Show/Delete/Save fibers/ROIs. NOTE: Saved track points are for reference only and can not be loaded back into the task card. However, ROIs can be saved and loaded.
                  
		  Save fiber as Analyze format volume.(NEW!)
		  
		  Make finished ROI editable.(NEW!)
		  
	          View mean FA, ADC and DWI values of ROI. (NEW!)
		  
                    Changing fiber name and tracking and rendering parameters.
                  
                    Save image to file or database. There are 5 different image formats supported: Jpeg, TIFF, Bitmap, PNG and PostScript.
                  Switch on/off stereo rendering. (Needs red/blue 3D glasses to view).
                    Hide/Show annotations and axes.
                   
 |  |  
 
  
 
   |  
              | Parameter setting: |  
              | Tracking parameters 
 
		Angle Threshold. If the turning angle is larger than this value, fiber tracking will stop.FA Threshold. If the FA is smaller than this value, fiber tracking will stop.Step Length. The step length for the streamline marching algorithm. Recommended setting: about 1/5 ~ 1/4 of the voxel size. Too small will cause much longer tracking time with little improvement on quality and accuracy.Number Of Samples Per Voxel Length. The sample rate for the seed region. Recommended value: 1, 2 or 3. WARNING: Setting this value larger will tremendously increase the work load of the fiber tracking and rendering and may cause unexpected error (due to VTK's limitation) if a large seed region is used.Smoothing and Interpolation setting. Apply Gaussian smoothing and interpolation on raw data or tensor data. |  |   |  
              | Rendering parameters 
 
		Tube Radius. The radius of the fiber tracks visualized as the many tubes.Decimation Factor. Decimation can reduce the number of polygons of the fiber objects without reducing the rendering quality visually. Thus the rendering needs less resources and will be faster. Decimation factor here determines how much decimation to be done. Recommended value: 50%~70%. That means the number of polygons to be rendered is reduced to 50%~30% of the original.Color Coding. Color codings for the fiber, includes direction-coded color, solid color and FA-coded color. NOTE: From version 1.62, the DTI Task Card uses a new scheme for direction-color mapping. It may not look as vivid as the old one but it represents the directions more accurately.  |  |   |  | 
    
    
      Tool Buttons for Tractography![[top]](images/top.png) 
    
    
    
    
      
        | 
            
              | View |   |  | 
      
        | 
            
              |   | FA Color. View FA color map. |  
              |   | FA. View FA grayscale map. |  
              |   | Low b. View Low b map. |  
              |   | Sagittal. Show Sagittal slice. |  
              |   | Coronal. Show Coronal slice. |  
              |   | Axial. Show Axial slice. |  
              |   | Restore To Sagittal. Restore viewing position to Sagittal. |  
              |   | Restore To Coronal. Restore viewing position to Coronal. |  
              |   | Restore To Axial. Restore viewing position to Axial. |  | 
    
    
    
    
      
        | 
            
              | ROI |   |  | 
      
        | 
            
              |   | Define ROI. Define the previously selected voxels as an ROI. The next selected voxel will start a new ROI. If fiber tracking has been performed with previously selected voxels, they are already automatically defined as an ROI. |  
              |   | Undo Last ROI Editing. Undo the last ROI editing. |  
              |   | Load ROI. Load ROI from a saved ROI file. |  |  | Starting from v1.68, ROI file uses analyze format. Old format is still readable but not writable any more. |  | 
    
    
    
    
      Sample Images![[top]](images/top.png) 
    
    
    
      
        | 
            
              | Fiber tracking visualization in the
                    DTI Task Card. |   |  | Fiber tracking images saved to the database by
                DTI Task Card and loaded in
                the Viewing task card afterwards. |   |  | 
    
    
      Miscellanies![[top]](images/top.png) 
    
    
      
        | Click the copyright texts on the lower right corner of
          the screen to bring up About window with version info and
          link to this online documentation. Also click the "Live Update" button to check the latest update of the DTI Task Card. | 
              | 
    
    
      Known Issues![[top]](images/top.png) 
    
    
      This software is not an official release and it is not as
      tightly integrated into MRease as an
      official SIEMENS task card. Due
      to this reason, the following known issues may or may not be
      solved in the near future.
    
    
      - 
        Current version of DTI Task Card can only deal with
        single b-value series.
      
- 
        The software can work with GE data collected in
        Massachusetts General Hospital but is not guaranteed to
        work with all kinds of GE data.
      
- 
        Computation and pre-rendering are extremely CPU intensive
        and memory-consuming and might be slow, especially in
        Ellipsoid rendering mode and/or with high resolution images (e.g., 256x256).
      
- 
        Due to the limitation of the VTK engine, the tractography tool can not handle too large amount of fibers together at the same rendering. Reducing the "Number of Samples Per Voxel Length" parameter and increasing the "Decimation Factor" parameter in Tracking Options... may help reduce the load of rendering and increase the limitation of the number of fibers that can be rendered together.
      
      The algorithms used for fiber tracking are based on the
      following literature:
    
    
      - 
        Mori S, Crain BJ, Chacko VP, van Zijl PC.
 Three-dimensional tracking of axonal projections in the
        brain by magnetic resonance imaging.
 Ann Neurol 1999; 45: 265-269.(PubMed abstract)
- 
        Basser PJ, Pajevic S, Pierpaoli C, Duda J, Aldroubi A.
 In vivo fiber tractography using DT-MRI data.
 Magn Reson Med 2000;44:625-632.(PubMed abstract)
- 
        B. Stieltjes, W.E. Kaufmann, P.C. van Zijl, K.
        Fredericksen, G.D. Pearlson, M. Solaiyappan and S.Mori.
 Diffusion tensor imaging and axonal tracking in the human
        brainstem.
 Neuroimage 14 (2001), pp.723-735.(PubMed abstract)
- 
        Mori S, Van Zijl PC.
 Fiber tracking: principles and strategies - a technical
        review.
 NMR Biomed. 2002 Nov-Dec;15(7-8):468-80.(PubMed abstract)
- Jones DK, Horsfield MA, Simmons A.
 Optimal strategies for measuring diffusion in anisotropic systems by magnetic resonance imaging.
 Magn Reson Med. 1999 Sep;42(3):515-25.(PubMed abstract)
      Thanks to David Tuch for the initial idea of tensor visualization.
    
    
    
      If you have questions or problems about the DTI Task Card, please contact Ruopeng Wang
      <rpwang@nmr.mgh.harvard.edu>.