TubeTK/Documentation/InteractivePDFSegmenter: Difference between revisions
From KitwarePublic
< TubeTK | Documentation
Jump to navigationJump to search
(Undo revision 36308 by 97.65.130.163 (talk)) |
m (Aylward moved page TubeTK/InteractivePDFSegmenter to TubeTK/Documentation/InteractivePDFSegmenter) |
||
| (13 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
= | = Overview = | ||
The interactive PDF segmenter performs image segmentation based on a rough initial segmentation provided by the user. This initial segmentation can be "painted" by the user within 3D Slicer, and can be refined iteratively after visualizing the segmentation results. | |||
The segmentation steps proceed as follows: | |||
# Using the intensity statistics within the rough initial segmentation, calculate the class probabilities for each pixel in the image to be segmented | |||
# Smooth the probability map | |||
# Classify each pixel to the class with the highest probability: now every pixel has a label | |||
# Analyze connected components relative to the rough initial segmentation: retain only those classified pixels that are connected to a pixel of the same class in the rough initial segmentation | |||
# Perform hole-filling on the label map | |||
# Perform erosion on the label map | |||
# Perform connected components analysis again: should now have well connected regions | |||
# Perform dilation on the label map | |||
=== Tutorial Data == | = Running the Interactive PDF Segmenter = | ||
The interactive PDF segmenter is to be used with 3D Slicer (see the [[TubeTK/Slicer | TubeTK with Slicer]] page for setup instructions). | |||
Its implementation can be found in TubeTK/Applications/SlicerModules/InteractivePDFSegmenter.py. | |||
== Parameters == | |||
* '''Input Volume 1''': The image to be segmented | |||
* '''Input Volumes 2 and 3 (optional)''': Optional images visualizing the same structures as the image to be segmented. Input volumes 1,2 and 3 must be co-registered. If input volumes 2 and 3 are provided, intensity statistics are calculated in a multi-dimensional space by considering the intensities in all of the input volumes. | |||
* '''Output Volume''': The segmentation results (label map) | |||
* '''Label Map''': The rough initial segmentation provided as input to the algorithm | |||
* '''Void Id''': Value that specifies nothing in the label map (typically 0) | |||
* '''Erosion Radius''': Dictates the strength of the erosion performed in step 5 above | |||
* '''Hole Fill Iterations''': Dictates the number of hole-filling iterations performed in step 4 above | |||
* '''Probability Smoothing Standard Deviations''': Dictates the strength of the probability map smoothing in step 2 above | |||
* '''Draft Mode''': TODO | |||
* '''Reclassify Object Mask''': If true, the pixel classifications provided by the rough initial segmentation can be changed during the segmentation process. If false, the pixel classifications within the rough initial segmentation are fixed and will be retained in the final segmentation. | |||
* '''Reclassify Not Object Mask''': If true, the pixel classifications within the rough initial segmentation for the "Void Id" can be updated as part of step 3 above, based on the intensity statistics of the rough initial segmentation. If false, the "Void Id" classifications within the rough initial segmentations dictate a "no-go" zone and will be retained in the final segmentation. | |||
= Tutorial = | |||
== Tutorial Data == | |||
* In this example, we will attempt to segment gray matter, white matter and cerebrospinal fluid (CSF) | |||
* The 2D brain image used in this example is distributed as part of Slicer4, and is located in '''Slicer4/Testing/Data/Input/brainSliceDOUBLE.mha''' | * The 2D brain image used in this example is distributed as part of Slicer4, and is located in '''Slicer4/Testing/Data/Input/brainSliceDOUBLE.mha''' | ||
== Tutorial Steps == | |||
# '''Load brainSliceDOUBLE.mha:''' | # '''Load brainSliceDOUBLE.mha:''' | ||
#* File -> Add Volume | #* File -> Add Volume | ||
# '''Open the Interactive PDF Segmenter module''' | # '''Open the Interactive PDF Segmenter module''' | ||
#* [[File:InteractivePDFSegmenterTutorial_step2.png|800px]] | |||
# '''Set the input and output volumes''' | # '''Set the input and output volumes''' | ||
#* Input Volume 1: brainSliceDOUBLE | #* Input Volume 1: brainSliceDOUBLE | ||
| Line 19: | Line 50: | ||
#** Creates a new volume called "Volume": this will hold the final segmentation | #** Creates a new volume called "Volume": this will hold the final segmentation | ||
# '''Set the view layout to "Red slice only"''' | # '''Set the view layout to "Red slice only"''' | ||
#* [[File:InteractivePDFSegmenterTutorial_step4a.png|800px]] | |||
#* [[File:InteractivePDFSegmenterTutorial_step4b.png|800px]] | |||
# '''Create the label map roughly outlining the structures to be segmented and the background''' | # '''Create the label map roughly outlining the structures to be segmented and the background''' | ||
#* Label Map: Create new volume | #* Label Map: Create new volume | ||
| Line 26: | Line 59: | ||
#** Click on the "Paint" button to begin editing | #** Click on the "Paint" button to begin editing | ||
#** Use a different label color for each structure of interest: choose the label by clicking the colored push button | #** Use a different label color for each structure of interest: choose the label by clicking the colored push button | ||
#* [[File:InteractivePDFSegmenterTutorial_step5a.png|800px]] | |||
#** Create a label for the background as well | #** Create a label for the background as well | ||
#* In the following example, green represents gray matter, yellow represents white matter, and brown represents the cerebrospinal fluid (CSF) | #* In the following example, green represents gray matter, yellow represents white matter, and brown represents the cerebrospinal fluid (CSF): | ||
#* [[File:InteractivePDFSegmenterTutorial_step5b.png|800px]] | |||
#* Void Id: 0 | #* Void Id: 0 | ||
# '''Specify the segmentation parameters''' | # '''Specify the segmentation parameters''' | ||
#* The goal segmentation buttons provide example parameters depending on whether the shapes of the expected segmentations are jagged, smooth or intermediate | #* The goal segmentation buttons provide example parameters depending on whether the shapes of the expected segmentations are jagged, smooth or intermediate | ||
| Line 43: | Line 77: | ||
#* Click the "Segment" button | #* Click the "Segment" button | ||
#* Select "Volume" as the label map to view the results | #* Select "Volume" as the label map to view the results | ||
#* Pixels that do not have a label value remain un-classified | |||
#* [[File:InteractivePDFSegmenterTutorial_step7a.png|800px]] | |||
#* [[File:InteractivePDFSegmenterTutorial_step7b.png|800px]] | |||
#* To view the label outlines, select "Show label volume outlines" | #* To view the label outlines, select "Show label volume outlines" | ||
#* [[File:InteractivePDFSegmenterTutorial_step7c.png|800px]] | |||
#* [[File:InteractivePDFSegmenterTutorial_step7d.png|800px]] | |||
[[Category:TubeTK Applications|InteractivePDFSegmenter]] | |||
Latest revision as of 13:09, 6 January 2015
Overview
The interactive PDF segmenter performs image segmentation based on a rough initial segmentation provided by the user. This initial segmentation can be "painted" by the user within 3D Slicer, and can be refined iteratively after visualizing the segmentation results.
The segmentation steps proceed as follows:
- Using the intensity statistics within the rough initial segmentation, calculate the class probabilities for each pixel in the image to be segmented
- Smooth the probability map
- Classify each pixel to the class with the highest probability: now every pixel has a label
- Analyze connected components relative to the rough initial segmentation: retain only those classified pixels that are connected to a pixel of the same class in the rough initial segmentation
- Perform hole-filling on the label map
- Perform erosion on the label map
- Perform connected components analysis again: should now have well connected regions
- Perform dilation on the label map
Running the Interactive PDF Segmenter
The interactive PDF segmenter is to be used with 3D Slicer (see the TubeTK with Slicer page for setup instructions).
Its implementation can be found in TubeTK/Applications/SlicerModules/InteractivePDFSegmenter.py.
Parameters
- Input Volume 1: The image to be segmented
- Input Volumes 2 and 3 (optional): Optional images visualizing the same structures as the image to be segmented. Input volumes 1,2 and 3 must be co-registered. If input volumes 2 and 3 are provided, intensity statistics are calculated in a multi-dimensional space by considering the intensities in all of the input volumes.
- Output Volume: The segmentation results (label map)
- Label Map: The rough initial segmentation provided as input to the algorithm
- Void Id: Value that specifies nothing in the label map (typically 0)
- Erosion Radius: Dictates the strength of the erosion performed in step 5 above
- Hole Fill Iterations: Dictates the number of hole-filling iterations performed in step 4 above
- Probability Smoothing Standard Deviations: Dictates the strength of the probability map smoothing in step 2 above
- Draft Mode: TODO
- Reclassify Object Mask: If true, the pixel classifications provided by the rough initial segmentation can be changed during the segmentation process. If false, the pixel classifications within the rough initial segmentation are fixed and will be retained in the final segmentation.
- Reclassify Not Object Mask: If true, the pixel classifications within the rough initial segmentation for the "Void Id" can be updated as part of step 3 above, based on the intensity statistics of the rough initial segmentation. If false, the "Void Id" classifications within the rough initial segmentations dictate a "no-go" zone and will be retained in the final segmentation.
Tutorial
Tutorial Data
- In this example, we will attempt to segment gray matter, white matter and cerebrospinal fluid (CSF)
- The 2D brain image used in this example is distributed as part of Slicer4, and is located in Slicer4/Testing/Data/Input/brainSliceDOUBLE.mha
Tutorial Steps
- Load brainSliceDOUBLE.mha:
- File -> Add Volume
- Open the Interactive PDF Segmenter module
- Set the input and output volumes
- Input Volume 1: brainSliceDOUBLE
- Input Volume 2 (optional): None
- Input Volume 3 (optional): None
- Output Volume: Create new volume
- Creates a new volume called "Volume": this will hold the final segmentation
- Set the view layout to "Red slice only"
- Create the label map roughly outlining the structures to be segmented and the background
- Label Map: Create new volume
- Creates a new volume called "Volume1": this will hold the input label map
- A small version of Slicer's Editor module is embedded into the Interactive PDF Segmenter
- Create a label map roughly outlining the structures of interest and the background by using the paint, erase and threshold functions
- Click on the "Paint" button to begin editing
- Use a different label color for each structure of interest: choose the label by clicking the colored push button
- Create a label for the background as well
- In the following example, green represents gray matter, yellow represents white matter, and brown represents the cerebrospinal fluid (CSF):
- Void Id: 0
- Label Map: Create new volume
- Specify the segmentation parameters
- The goal segmentation buttons provide example parameters depending on whether the shapes of the expected segmentations are jagged, smooth or intermediate
- In this example, we will use custom parameters
- Erosion Radius: 0
- Hole Fill Iterations: 2
- False Positive Ratio: 1.00
- Probability Smoothing Standard Deviation: 1.00
- Draft Mode: Off
- Reclassify Object Mask: On
- Reclassify Not Object Mask: On
- Run the segmentation
- Click the "Segment" button
- Select "Volume" as the label map to view the results
- Pixels that do not have a label value remain un-classified
- To view the label outlines, select "Show label volume outlines"
