Slicer - Convert centerlines to a graph {V,E}

som1197 · July 9, 2021, 3:55pm

Hello,

I want to convert the centerline network generated from the segmentations of the Circle of Willis into a graph data structure. Currently the only way to do it in vmtk is to use the ‘vmtknetworkextraction’ class to do so - VMTK network extraction. However, it required the input to be a surface file.

In my case, I have a centerline tree hierarchical structure already generated in slicer as shown.

I can use the .json files containing the centerline curve information to create a graph using the NetworkX library in Python. But is there a way to directly convert the Centerline model_1.vtk file into a graph using the connectivity information stored as an ordered dictionary?

I am using the following code to get numpy arrays from the vtk file.

# Using vmtk
filename = 'Centerline model_1.vtk'
centerlineReader = vmtkscripts.vmtkSurfaceReader()
centerlineReader.InputFileName = filename
centerlineReader.Execute()
clNumpyAdaptor = vmtkscripts.vmtkCenterlinesToNumpy()
clNumpyAdaptor.Centerlines = centerlineReader.Surface
clNumpyAdaptor.Execute()
numpyCenterlines = clNumpyAdaptor.ArrayDict

I get the following as an output:
Points:

PointData:

What does ‘EdgeArray’ and ‘EdgePCoordarray’ mean here? How do they represent the edge connectivity of the 1D centerline tree?

CellData:

Thank you!

lassoan · July 11, 2021, 3:54pm

You could easily add an option to the Extract Centerline module in Slicer to create the graph representation you need. See source code here that generates a hierarchy of curves, with a little change you can put the point lists into a Python dictionary instead. If you send a pull request with the proposed changes then we’ll be happy to merge it.

som1197 · July 16, 2021, 4:42am

Thank you @lassoan for the piece of code. Yes I will send out a pull request with the proposed changes soon.

Moreover, I also wanted to know if scalar values of ‘GroupIDsarray’, ‘TortuosityArray’ , ‘BlankingArray’ etc. can be incorporated in the centerline model. I generated the following plots by using the conventional vmtkscripts, but it does not always work correctly.

Currently there are only 3 ways to postprocess the centerline data as shown here.

However, can we make any changes here in the base code to store values of other arrays as well?
Also would it be possible to run this function independently in a separate python code given the vtkpolymesh surface data and the endpoint co ordinates?

github.com

vmtk/SlicerExtension-VMTK/blob/995027f17f195d802134f799aab095ea31f3e6c5/ExtractCenterline/ExtractCenterline.py#L635-L723


      
          def extractCenterline(self, surfacePolyData, endPointsMarkupsNode, curveSamplingDistance=1.0):

              """Compute centerline.

              This is more robust and accurate but takes longer than the network extraction.

              :param surfacePolyData:

              :param endPointsMarkupsNode:

              :return:

              """

          

              import vtkvmtkComputationalGeometryPython as vtkvmtkComputationalGeometry

              import vtkvmtkMiscPython as vtkvmtkMisc

          

              # Cap all the holes that are in the mesh that are not marked as endpoints

              # Maybe this is not needed.

              capDisplacement = 0.0

              surfaceCapper = vtkvmtkComputationalGeometry.vtkvmtkCapPolyData()

              surfaceCapper.SetInputData(surfacePolyData)

              surfaceCapper.SetDisplacement(capDisplacement)

              surfaceCapper.SetInPlaneDisplacement(capDisplacement)

              surfaceCapper.Update()

This file has been truncated. show original

This has been done for the network curves but the centerline curves hold the real information.

github.com

vmtk/SlicerExtension-VMTK/blob/995027f17f195d802134f799aab095ea31f3e6c5/ExtractCenterline/ExtractCenterline.py#L616-L633


      
          if computeGeometry:

              centerlineGeometry = vtkvmtkComputationalGeometry.vtkvmtkCenterlineGeometry()

              centerlineGeometry.SetInputData(networkExtraction.GetOutput())

              centerlineGeometry.SetLengthArrayName(self.lengthArrayName)

              centerlineGeometry.SetCurvatureArrayName(self.curvatureArrayName)

              centerlineGeometry.SetTorsionArrayName(self.torsionArrayName)

              centerlineGeometry.SetTortuosityArrayName(self.tortuosityArrayName)

              centerlineGeometry.SetFrenetTangentArrayName(self.frenetTangentArrayName)

              centerlineGeometry.SetFrenetNormalArrayName(self.frenetNormalArrayName)

              centerlineGeometry.SetFrenetBinormalArrayName(self.frenetBinormalArrayName)

              # centerlineGeometry.SetLineSmoothing(0)

              # centerlineGeometry.SetOutputSmoothedLines(0)

              # centerlineGeometry.SetNumberOfSmoothingIterations(100)

              # centerlineGeometry.SetSmoothingFactor(0.1)

              centerlineGeometry.Update()

              return centerlineGeometry.GetOutput()

          else:

              return networkExtraction.GetOutput()

lassoan · July 17, 2021, 5:54am

Yes, sure. These are cell data (one value for each branch) and the values are saved in the table where you can easily look them up (by cell ID) but feel free to add it to the centerline tree model as well. Send a pull request with the proposed changes.

Yes, just send a pull request if you have any suggestion.

You can use the module from anywhere (from a Python script, without a GUI; from Jupyter notebooks, etc.). See complete example here:

github.com

vmtk/SlicerExtension-VMTK/blob/master/ExtractCenterline/ExtractCenterline.py#L1157-L1186


      
          your test should break so they know that the feature is needed.

          """

          

          self.delayDisplay("Starting the test")

          

          # Get/create input data

          

          import SampleData

          inputVolume = SampleData.downloadFromURL(

            nodeNames='MRHead',

            fileNames='MR-Head.nrrd',

            uris='https://github.com/Slicer/SlicerTestingData/releases/download/MD5/39b01631b7b38232a220007230624c8e',

            checksums='MD5:39b01631b7b38232a220007230624c8e')[0]

          self.delayDisplay('Finished with download and loading')

          

          inputScalarRange = inputVolume.GetImageData().GetScalarRange()

          self.assertEqual(inputScalarRange[0], 0)

          self.assertEqual(inputScalarRange[1], 279)

          

          outputVolume = slicer.mrmlScene.AddNewNodeByClass("vtkMRMLScalarVolumeNode")

This file has been truncated. show original

RomanStriker · November 8, 2022, 6:56pm

Hi, can you share your code for generating centerline curves colored by centerlineIDs. I am trying to separate the centerlines into different segments (branches).

lassoan · November 12, 2022, 3:41am

The code for splitting the tree to branches is here:

github.com

vmtk/SlicerExtension-VMTK/blob/437526ad4a097483d25b9591ab74548ab9ae0176/ExtractCenterline/ExtractCenterline.py#L832-L1013


      
          def createCurveTreeFromCenterline(self, centerlinePolyData, centerlineCurveNode=None, centerlinePropertiesTableNode=None, curveSamplingDistance=1.0):

          

              import vtkvmtkComputationalGeometryPython as vtkvmtkComputationalGeometry

          

              branchExtractor = vtkvmtkComputationalGeometry.vtkvmtkCenterlineBranchExtractor()

              branchExtractor.SetInputData(centerlinePolyData)

              branchExtractor.SetBlankingArrayName(self.blankingArrayName)

              branchExtractor.SetRadiusArrayName(self.radiusArrayName)

              branchExtractor.SetGroupIdsArrayName(self.groupIdsArrayName)

              branchExtractor.SetCenterlineIdsArrayName(self.centerlineIdsArrayName)

              branchExtractor.SetTractIdsArrayName(self.tractIdsArrayName)

              branchExtractor.Update()

              centerlines = branchExtractor.GetOutput()

          

              mergeCenterlines = vtkvmtkComputationalGeometry.vtkvmtkMergeCenterlines()

              mergeCenterlines.SetInputData(centerlines)

              mergeCenterlines.SetRadiusArrayName(self.radiusArrayName)

              mergeCenterlines.SetGroupIdsArrayName(self.groupIdsArrayName)

              mergeCenterlines.SetCenterlineIdsArrayName(self.centerlineIdsArrayName)

              mergeCenterlines.SetTractIdsArrayName(self.tractIdsArrayName)

This file has been truncated. show original

RomanStriker · November 14, 2022, 12:35pm

Thanks. I used the function to get the curve tree but I see that it is not very consistent with the centerline model near bifurcations. I was hoping I could just classify nodes and edges in the centerline model directly.

Topic		Replies	Views
SlicerVMTK Extract Centerlines Not Creating a Model Support vmtk , vmtk-centerline	3	401	June 8, 2023
VMTK vessel centerline network extraction in Slicer Support feature	24	3177	July 11, 2020
Extracting Data from VMTK Centerline Support	3	1541	June 18, 2019
How to export centerline generated by the VMTK? Support file-export	5	1096	March 6, 2024
VMTK Centerline Display by CenterlineId Support	7	989	July 8, 2020

Slicer - Convert centerlines to a graph {V,E}

Related topics