Difference between revisions of "Documentation/Nightly/Extensions/IASEM"

From Slicer Wiki
Jump to: navigation, search
 
(26 intermediate revisions by 3 users not shown)
Line 38: Line 38:
  
 
IASEM stands for ion-abrasion scanning electron microscopy, some times also call dual-beam or focused ion-beam scanning electron microscopy (FIBSEM).  
 
IASEM stands for ion-abrasion scanning electron microscopy, some times also call dual-beam or focused ion-beam scanning electron microscopy (FIBSEM).  
 +
 +
Sample data can be downloaded from http://placid.nlm.nih.gov/community/22, in particular the dateset below is the [http://placid.nlm.nih.gov/community/22 GoldBeads].
  
 
<gallery widths="200px" perrow="4">
 
<gallery widths="200px" perrow="4">
Line 46: Line 48:
 
{{documentation/{{documentation/version}}/extension-section|Modules}}
 
{{documentation/{{documentation/version}}/extension-section|Modules}}
  
−
* BinShrink ImageFilter
+
* BinShrink Image Filter
 
* SpacingAwareCurvatureDiffusion Image Filter
 
* SpacingAwareCurvatureDiffusion Image Filter
 +
* IASEM Import
 +
* IASEM Series Import
 +
* Label Object Statistics
 
* DoubleThreshold Editor Effect
 
* DoubleThreshold Editor Effect
 
* BinaryWatershed Editor Effect
 
* BinaryWatershed Editor Effect
 +
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Use Cases}}
 
{{documentation/{{documentation/version}}/extension-section|Use Cases}}
 
===BinShrink Image Filter===
 
===BinShrink Image Filter===
 +
Bin Shrink is one of the modules used to help ease the process of segmentation. By stipulating a neighborhood size, 5x5x5 for example, it will average the neighboring pixels within that 5x5x5 region and turn them into one pixel. Applying the Bin Shrink will result in reduced resolution and a less noisy image. Based on the features you want to segment, you can apply a more aggressive bin or a less aggressive bin based on the complexity of your features of interest. Binning the image does not significantly affect the quality of the image, it also reduces the amount of memory the computer needs to process the data, so the more an image is binned the faster slicer will work and the more free memory you will have.
 +
 +
 +
{|
 +
|[[Image:GoldGrayscale.png|thumb|Original gray scale image.]]
 +
|[[Image:GoldGrayscaleBin5.png|thumb|After running the BinShrink by a factor of 5x5x5.]]
 +
|}
 +
 
===SpacingAwareCurvatureDiffusion Image Filter===
 
===SpacingAwareCurvatureDiffusion Image Filter===
 +
===IASEM Import===
 +
IASEM Import performs streaming image file reading while reducing the resolution and extracting a region of interest.
 +
 +
When dealing with large microscopy image files, the whole volume can be loaded at low resolutions by specifying "Shrink Factors" of "10,10,10". This will still read the entire volume but perform averaging to reduce the resolution. However if "Disable Z-Averaging" is selected not averaging will be performed in the Z-direction, and the amount of data read will be reduced.
 +
 +
After an area of interest is visually  determine the ROI tool can be used to define a region of interest, which can be specified as the "Image ROI" and a sub-volume can be loaded at a higher resolution.
 +
 +
===IASEM Series Import===
 +
This module imports a series of TIFF images and optionally applies a slice by slice transform. It support the same multi-resolution and region of interest features as the IASEM Import module.
 +
===Label Object Statistics===
 
===DoubleThreshold Editor Effect===
 
===DoubleThreshold Editor Effect===
 
===BinaryWatershed Editor Effect===
 
===BinaryWatershed Editor Effect===
  
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/extension-section|Walk Through}}
 +
===Multi-Resolution Label Map Segmentation===
 +
When a data set is too large we can use a combination of tools and modules to help speed things up. We can BinShrink the gray scale to reduce resolution and size, and we can crop the region of interest. Cropping, however distorts the dimensions of the volume and we must resample it to match the original gray scale when putting them back together.
 +
{|
 +
|[[Image:OriginalGoldGrayscale.png|thumb|Step 1: Original gray scale image.]]
 +
|[[Image:BinShrinkSettings.png|thumb|Step 2: BinShrink settings.]]
 +
|[[Image:BinShrinkGoldGrayscale.png|thumb|Step 3: After running the BinShrink by a factor of 5x5x5.]]
 +
|[[Image:ROIToolbar.png|thumb|Step 4: ROI Toolbar.]]
 +
|[[Image:CropGoldGrayscale.png|thumb|Step 5: Cropped gray scale image.]]
 +
|[[Image:ThresholdGoldLabelMap.png|thumb|Step 6: Threshold of the cropped gray scale image.]]
 +
|}
 +
#[[Documentation/{{documentation/version}}/Modules/SlicerWelcome#LoadPanel|Load]] gray scale data.
 +
#Go to the Modules search bar, search and select "BinShrink". Go to the BinShrink settings, change the input to the original gray scale image and change the output to "create a new volume".
 +
#Apply the BinShrink Image Filter.
 +
#Create a Region of Interest (ROI) using the Fiducial Module in the Slicer Toolbar.
 +
#Use the [[Documentation/{{documentation/version}}/Modules/CropVolume|Crop Volume]] module to crop the region of interest. '''Make sure to check the box for Voxel based cropping, since this is a gray scale and not a label map.'''
 +
#Apply  [[Documentation/{{documentation/version}}/Modules/Editor#Threshold|Threshold Effect]], or any other editing technique, to your gray scale image to create a label map.
 +
#[[Documentation/{{documentation/version}}/Modules/BRAINSResample|Resample]] the label map so its dimensions match those of the gray scale image.
 +
##Using the [[Documentation/{{documentation/version}}/Modules/Transforms|Transforms]] module, create a new transform and rename it "Identity".
 +
##Search and select "Resample Image (BRAINS)" in the modules search bar. Go to the [[Documentation/{{documentation/version}}/Modules/BRAINSResample|Resample]] settings to resample the label map.
 +
##The Image to Warp should be the label map.
 +
##The Reference Image should be the BinShrink gray scale image.
 +
##Create a new Output Image.
 +
##Change the pixel type to "short".
 +
##Change the Transform file to "Identity".
 +
##Change the Interpolation Mode to "NearestNeighbor".
 +
##Apply the Resampling.
 +
*'''NearestNeighbor must be used when resampling label maps.'''
 +
{|
 +
|[[Image:TransformModule.png|thumb|Transform Settings: Creating Active Transform "identity"]]
 +
|[[Image:ResampleSettings.png|thumb|Resample settings.]]
 +
|}
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Tutorials}}
 
{{documentation/{{documentation/version}}/extension-section|Tutorials}}
−
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Similar Extensions}}
 
{{documentation/{{documentation/version}}/extension-section|Similar Extensions}}
−
N/A
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 16:55, 6 November 2014

Home < Documentation < Nightly < Extensions < IASEM


For the latest Slicer documentation, visit the read-the-docs.


Work in progress
 WARNING: This module is Work in Progress, which means:
  • the functionality provided by this module may change drastically in the future releases of 3D Slicer
  • the scenes containing data types specific to this module may not be readable by the future versions of Slicer
  • the functionality and user interface may change at any time
  • some functionality may not work as intended
  • testing and documentation is limited

Introduction and Acknowledgements

Acknowledgments: This work is supported by NLM, and the Slicer Community.
Author: Bradley Lowekamp
Contact: Bradley Lowekamp <email>blowekamp@mail.nih.gov</email>
License: Apache License 2.0

The National Library of Medicine  
National Alliance for Medical Image Computing (NA-MIC)  


Extension Description

This extension is a compilation of modules which are useful for segmentation and processing of IASEM Electron Microscopy images. It adds modules which help in general with segmenting large data sets, and has components to deal with images in multi-resolutions.

IASEM stands for ion-abrasion scanning electron microscopy, some times also call dual-beam or focused ion-beam scanning electron microscopy (FIBSEM).

Sample data can be downloaded from http://placid.nlm.nih.gov/community/22, in particular the dateset below is the GoldBeads.

  • Segmentation of Gold particles.

Modules

  • BinShrink Image Filter
  • SpacingAwareCurvatureDiffusion Image Filter
  • IASEM Import
  • IASEM Series Import
  • Label Object Statistics
  • DoubleThreshold Editor Effect
  • BinaryWatershed Editor Effect


Use Cases

BinShrink Image Filter

Bin Shrink is one of the modules used to help ease the process of segmentation. By stipulating a neighborhood size, 5x5x5 for example, it will average the neighboring pixels within that 5x5x5 region and turn them into one pixel. Applying the Bin Shrink will result in reduced resolution and a less noisy image. Based on the features you want to segment, you can apply a more aggressive bin or a less aggressive bin based on the complexity of your features of interest. Binning the image does not significantly affect the quality of the image, it also reduces the amount of memory the computer needs to process the data, so the more an image is binned the faster slicer will work and the more free memory you will have.


Original gray scale image.
After running the BinShrink by a factor of 5x5x5.

SpacingAwareCurvatureDiffusion Image Filter

IASEM Import

IASEM Import performs streaming image file reading while reducing the resolution and extracting a region of interest.

When dealing with large microscopy image files, the whole volume can be loaded at low resolutions by specifying "Shrink Factors" of "10,10,10". This will still read the entire volume but perform averaging to reduce the resolution. However if "Disable Z-Averaging" is selected not averaging will be performed in the Z-direction, and the amount of data read will be reduced.

After an area of interest is visually determine the ROI tool can be used to define a region of interest, which can be specified as the "Image ROI" and a sub-volume can be loaded at a higher resolution.

IASEM Series Import

This module imports a series of TIFF images and optionally applies a slice by slice transform. It support the same multi-resolution and region of interest features as the IASEM Import module.

Label Object Statistics

DoubleThreshold Editor Effect

BinaryWatershed Editor Effect

Walk Through

Multi-Resolution Label Map Segmentation

When a data set is too large we can use a combination of tools and modules to help speed things up. We can BinShrink the gray scale to reduce resolution and size, and we can crop the region of interest. Cropping, however distorts the dimensions of the volume and we must resample it to match the original gray scale when putting them back together.

Step 1: Original gray scale image.
Step 2: BinShrink settings.
Step 3: After running the BinShrink by a factor of 5x5x5.
Step 4: ROI Toolbar.
Step 5: Cropped gray scale image.
Step 6: Threshold of the cropped gray scale image.
  1. Load gray scale data.
  2. Go to the Modules search bar, search and select "BinShrink". Go to the BinShrink settings, change the input to the original gray scale image and change the output to "create a new volume".
  3. Apply the BinShrink Image Filter.
  4. Create a Region of Interest (ROI) using the Fiducial Module in the Slicer Toolbar.
  5. Use the Crop Volume module to crop the region of interest. Make sure to check the box for Voxel based cropping, since this is a gray scale and not a label map.
  6. Apply Threshold Effect, or any other editing technique, to your gray scale image to create a label map.
  7. Resample the label map so its dimensions match those of the gray scale image.
    1. Using the Transforms module, create a new transform and rename it "Identity".
    2. Search and select "Resample Image (BRAINS)" in the modules search bar. Go to the Resample settings to resample the label map.
    3. The Image to Warp should be the label map.
    4. The Reference Image should be the BinShrink gray scale image.
    5. Create a new Output Image.
    6. Change the pixel type to "short".
    7. Change the Transform file to "Identity".
    8. Change the Interpolation Mode to "NearestNeighbor".
    9. Apply the Resampling.
  • NearestNeighbor must be used when resampling label maps.
Transform Settings: Creating Active Transform "identity"
Resample settings.

Tutorials

Similar Extensions

References

Information for Developers

Work in progress
 Section under construction.
Retrieved from "https://www.slicer.org/w/index.php?title=Documentation/Nightly/Extensions/IASEM&oldid=39384"