Skip to content

Implementation and Tutorials for robust Reeb graph model of white matter fibers.

Notifications You must be signed in to change notification settings

UCSB-VRL/ReeBundle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reeb Graph for modeling neuronal fiber pathways

Given the trajectories of neuronal fiber pathways, we model the evolution of trajectories that capture geometrically significant events (akin to a fingerprint) and calculate their point correspondence in the 3D brain space. We show that our model can handle the presence of improbable streamlines, as commonly produced by tractography algorithms. Three key parameters in our method capture the geometry and topology of the streamlines: (i) $\epsilon$ -- the distance between a pair of streamlines in a bundle that defines its sparsity; (ii) $\alpha$ -- the spatial length of the bundle that introduces persistence; and (iii) $\delta$ -- the bundle thickness. Together, these parameters control the granularity of the model to provide a compact signature of the tracts and their underlying anatomical structure.

For more details about our algorithm, please refer to our paper. overview

Citation

The system was employed for our research presented in [1], where we propose a novel and efficient algorithm to model high-level topological structures of neuronal fibers. Tractography constructs complex neuronal fibers in three dimensions that exhibit the geometry of white matter pathways in the brain. However, most tractography analysis methods are time consuming and intractable. We develop a computational geometry-based tractography representation that aims to simplify the connectivity of white matter fibers. If the use of the software or the idea of the paper positively influences your endeavours, please cite [1] and [2].

[1] Shailja, S., Angela Zhang, and B. S. Manjunath. "A computational geometry approach for modeling neuronal fiber pathways." International Conference on Medical Image Computing and Computer-Assisted Intervention. Springer, Cham, 2021.

[2] Shailja, S., Bhagavatula, V., Cieslak, M., Vettel, J., Grafton, S. T., and B. S. Manjunath. "ReeBundle: a method for topological modeling of white matter pathways. " Submitted to the Journal, 2022.

Requirements

To download all prerequisites, in the terminal type pip install -r requirements.txt

The code has been tested only on python version 3.7.

Example usage

Visualize an example Reeb graph in 3D.

  1. For ISMRM Dataset, sample .trk files are included in teh SampleISMRMData folder. Run the jupyter notebook "ReebGraphForISMRMBundles" to load the .trk files and construct the Reeb graphs for CA and CP bundle tracts. For ISMRM, ReeBundle detects and handles the morphology of the white matter tract configurations due to branching and local ambiguities in complicated bundle tracts like anterior and posterior commissures. ISMRM dataset helps in the qualitative validation of the ReeBundle method.

  2. For the CRASH Dataset, sample .gpickle files for Reeb graphs can be found in SampleISMRMData. Run the jupyter notebook "TopologicalDistanceForCRASH" to load .gpickle files and compute topological distances. Finally, creates the heatmap for CC bundle as presented in the paper [2]. In the analysis of the bundle tracts of white matter fibers in the CRASH dataset, the Reeb graphs of a given subject are similar across eight scan repetitions acquired weeks apart, whereas they differ from other subjects. CRASH dataset helps in the quantitative validation of the Reeb graph as a fingerprint for the bundle tract.

  3. For Tractometry methods, values of the features computed for CC ROIs can be found in the 'CCtractometry.csv'. Run the jupyter notebook "" to load the tractometry file and compute the inter- and intra- distances. The statistical significance of the difference between \emph{inter-} and \emph{intra-} distances based on these tractometry metrics is negligible $(p \sim .99)$ whereas ReeBundle provides a graph representation that visualizes, quantifies, and localizes the topological differences.

Dataset

The code was tested on the publicly available ISMRM dataset and the proposed Reeb graph-based distance was tested on CRASH dataset.

About

Implementation and Tutorials for robust Reeb graph model of white matter fibers.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published