Skip to content

Latest commit

 

History

History
84 lines (65 loc) · 2.63 KB

README.md

File metadata and controls

84 lines (65 loc) · 2.63 KB

TenVis (Tensor Visualization tool)

TenVis can help you analyze tensors or 3x3 matrices using ellipsoids. Different color mappings are given. This project was created as part of my Computer Science thesis work and is mostly aimed on Diffusion Tensor Imaging visualization.

Version

0.1

Tech

TenVis uses javascript, HTML5, WebGL and the amazing Three.js library.

Installation

No installation needed, it's all javascript! Just click the TenVis.html file and it works automagically. Things should work on any WebGL enabled browser, which means no IE support for the time being.

How to use

Drag and drop a file containing:

  • Tensors coordinates in space
  • Tensors eigenvectors ( for orientation )
  • Tensors eigenvalues

Example:

57,94,23
1,0,0
0,1,0
0,0,1
10,3,3
77,94,23
0,1,0
0,0,1
1,0,0
10,3,3
97,94,23
0,1,0
1,0,0
0,0,1
10,3,3

A .txt file containing the above data (15 text lines + 1 white line in this case) should display 3 ellipsoids aligned with the x, y and z axis.
For each tensor, the first line contains the coordinates. The next three lines contain the rotation matrix
XX, XY, XZ
YX, YY, YZ
ZX, ZY, ZZ
while the last line contains the eigenvalues of the matrix.

Snapshots

  • Image showing tensors for an entire brain image. Tissue direct is represented by different colors. alt text
  • Same as before, but using a filter to show only highly anisotropic voxels. alt text
  • Result of gradualy interpolating the three tensors on the corner of the triangle. Colors are related to tensor orientation. alt text
  • MRI brain slice. Different color intensity represents different diffusion in the tissue. alt text
  • Image using an experimental filter for color coding. Highlighting diffusion, anisotropy and tissue direction at the same time. alt text

Acknowledgements

I would like to thank Professor Bruno Iannazzo from UNIPG who helped testing and debugging TenVis, and Gabriele di Bari whose WebGL expertise saved me from some weird situations.

License

MIT