Difference between revisions of "Documentation/4.4/Extensions/Wasp"

From Slicer Wiki
Jump to: navigation, search
Line 38: Line 38:
  
  
IMPORTANT: The current version of WASP has been tested with the nightly build in july 2015. See below link for the nightly build installer. To get the plugin working with  
+
IMPORTANT: The current version of WASP has been tested with the nightly build in july 2015. See below link for the nightly build installer. To get WASP working with  
the stable build read the instructions in the readme of https://github.com/Tomnl/Slicer-Wasp
+
the stable 4.4.0 build read the instructions in the readme of https://github.com/Tomnl/Slicer-Wasp
  
 
For most recent nighlty version of 3D Slicer tested see: https://www.dropbox.com/sh/xu6e9wwydnv341m/AADiXr-uQka4xhPBg5ccCDpMa?dl=0
 
For most recent nighlty version of 3D Slicer tested see: https://www.dropbox.com/sh/xu6e9wwydnv341m/AADiXr-uQka4xhPBg5ccCDpMa?dl=0

Revision as of 09:30, 15 October 2015

Home < Documentation < 4.4 < Extensions < Wasp


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



Introduction and Acknowledgements

Extension: Wasp

Watershed Annotation and Segmentation Plugin for 3D Slicer.

Acknowledgments: This work was done at the Medical Research Council (MRC) Harwell, Oxfordshire. Funded by Mouse Phenotyping Informatics Infrastructure (MPI2)

Author: Thomas Lawson
Contact: Thomas Lawson, <email> tnl495@bham.ac.uk </email>

WASP (MRC Harwell)



Module Description

The plugin consists of two main components

  • Watershed stage: Perform a series of watershed filters on the original image
  • Annotation stage: Creating a new label map out of selected components from the watershed stage

The primary use cas of the tool is to perform multiple watershed segmentations (watershed stage) of an image and then use fiducials to pick out the good segmentations (annotation stage).

For code of the plugin see: https://github.com/Tomnl/Slicer-Wasp


IMPORTANT: The current version of WASP has been tested with the nightly build in july 2015. See below link for the nightly build installer. To get WASP working with the stable 4.4.0 build read the instructions in the readme of https://github.com/Tomnl/Slicer-Wasp

For most recent nighlty version of 3D Slicer tested see: https://www.dropbox.com/sh/xu6e9wwydnv341m/AADiXr-uQka4xhPBg5ccCDpMa?dl=0


Watershed stage

It allows the user to perform a series of Watershed segmentations on a 3D image using the SimpleITK “Morphological Watershed” without seeds.

They can edit various parameters but importantly they can choose a range of values to use for the “watershed level”.

  • When the watershed value is lower the image will be segmented into more components.
  • When the watershed level is higher the image will be segmented into less components

A user can then use a range for this parameter (e.g. 1 to 2 with steps of 0.1 resulting in 20 label map results)

Annotation stage

The user can then select individual segmentations out of any of the watershed produced label map using fiducials.

This will create a new label map with only the components the user has chosen. The user can also choose the order of the labels as well.

A model of the label map is generated as well.

Use Cases

I was primarily working with a micro-CT dataset of a mouse embryo and that is what I get the best results with. However, the extension can be used with other data including the Slicer examples:

RegLib_c01_1 Using Watershed level 2 to 2.5 with default settings. The idea is that you use fiducials to pick out the the good segmentations (say the tumour and eyes) and then they will be created into a new label map and isosurface.

CT-Head Watershed level 7 to 10 with with 0.5 iterations. Can use fiducials to get out the lungs.

A few notes: To gauge what watershed level to use I typically run WASP with watershed levels 0.1 to 10 with iteration steps of 1. I can then run more watershed iterations where it is needed e.g. 3 to 4 with iterations of 0.1.

The limits for the parameters were just what fit with the embryo dataset I used. The actual limits are just the same as the SimpleITK methods so I can modify if requested.


Tutorials

Tutorial on how to use the WASP extension. Please be aware that a few changes have been made since the tutorial was created. Video link does not work in presentation. See youtube link below for video.

https://www.youtube.com/watch?v=o9DA4gqWNjg&feature=youtu.be


File:Wasp tutorial.pptx

Panels and their use

Similar Modules

References

Information for Developers