Difference between revisions of "Projects/Slicer3/2007 Project Week Slicer Matlab Pipeline for scalars and tensors"

From NAMIC Wiki
Jump to: navigation, search
m
Line 8: Line 8:
 
* Isomics: Steve Pieper
 
* Isomics: Steve Pieper
 
* BWH: Sylvain Bouix
 
* BWH: Sylvain Bouix
 +
* BWH: Marc Niethammer
  
  
Line 14: Line 15:
 
<div style="width: 27%; float: left; padding-right: 3%;">
 
<div style="width: 27%; float: left; padding-right: 3%;">
 
<h1>Objective</h1>
 
<h1>Objective</h1>
To extend and test Matlab client for reading and writing tensor data from/to Slicer.
+
* Provide tools to pipe volume data from Slicer3 memory to Matlab and back.
 
 
  
 
</div>
 
</div>
Line 23: Line 23:
 
<h1>Approach, Plan</h1>
 
<h1>Approach, Plan</h1>
  
* Provide tools to pipe tensor data from Slicer3 memory to Matlab and back
+
* Finalize utilities that transform tensor data from Slicer's IJK space to the original gradient space and transform the data from gradient space back to Slicer's IJK space respectively.
 
+
* Quantify numerical error for these transformations. 
* Provide matlab tools for tensor transformation from IJK space to gradient space and the other way around
+
* Application testing: Get user feedback.
** Test if these transformations in matlab are consistent with vtkNRRDReader
 
** Quantify numerical error when transformation from ijk space to gradient space and back to ijk space is done.  
 
 
 
* Application testing: who has a nice matlab script that needs tensor data as input?
 
 
</div>
 
</div>
  

Revision as of 15:03, 22 June 2007

Home < Projects < Slicer3 < 2007 Project Week Slicer Matlab Pipeline for scalars and tensors


Key Investigators

  • BWH: Katharina Quintus
  • Isomics: Steve Pieper
  • BWH: Sylvain Bouix
  • BWH: Marc Niethammer


Objective

  • Provide tools to pipe volume data from Slicer3 memory to Matlab and back.

Approach, Plan

  • Finalize utilities that transform tensor data from Slicer's IJK space to the original gradient space and transform the data from gradient space back to Slicer's IJK space respectively.
  • Quantify numerical error for these transformations.
  • Application testing: Get user feedback.

Progress

  • Pipeline tools for scalar data are ready to use


References

Slicer Deamon Wiki page

Additional Information

When Slicer is started with the "--daemon" flag, a server socket is created that is listening and waiting for new connections. This network service can be used to access the MRML scene or other objects in Slicer memory. Several clients have been written or are beeing worked on at the moment:

  • Tcl scripts that read out volumes to stdout or write to stdin
  • Python based clients
  • Matlab clients

The Slicer Deamon Wiki page provides more details.

The Matlab client

  • Matlab scripts: getSlicerVolume.m and putSlicerVolume.m use Matlab extention popen to connect to stdout(stdin) of the tcl client slicerget.tcl (slicerput.tcl respectively). The tcl client establishes a channel to the SlicerDaemon socket and requests(sends) data.
  • flag in these scripts can be set to do/undo gradientSpace->IJKspace transformation.

Motivation

Matlab pipeline client can be used to send data from a running slicer to Matlab, where the data can be used as input for whatever great algorithms you have implemented in matlab. The data can then be sent back to slicer for visualisations or further processing. No file I/O is necessary. Can be very useful since a lot of methods or algorithms are first prototyped in Matlab. Ideas what can be done easily in matlab while Slicer does not have the functionality yet:

  • Tensors:
    • Thresholding
    • Do tensor statistics after masking tensor with labelmap
    • Average two tensors
    • smoothing of tensor field (Marco's algorithm?)
  • Scalars:
    • plot histogram (that allows to quantify, at the moment slicer-histograms are not associated with numbers )

Tensor transformation issues

When tensors are loaded into Slicer, vtkNRRDReader performs transformation from diffusion gradient space into image space (IJK space). This is done to improve performance since most itk-filters require data in ijk coordinates. Tensors piped to Matlab will live in IJK-space, since this is where they are in Slicer memory. Assuming the dataset will be sent back to Slicer after processing in Matlab, no such transformations need to be done. To apply this transformation and afterwards the inverse transformation will introduce numberical errors due to matrix inversion.

However, the Matlab user might wish to transform the data back to gradient space. Matlab tools are provided to perform transformations needed.



Back to Project week