Documentation/Nightly/Modules/SurfaceToolbox - Revision history

Lantiga at 23:46, 7 November 2013

2013-11-07T23:46:31Z

Pieper at 10:40, 22 August 2013

2013-08-22T10:40:38Z

Pieper at 10:39, 22 August 2013

2013-08-22T10:39:13Z

Pieper at 00:21, 22 August 2013

2013-08-22T00:21:18Z

Pieper: Created page with '{{documentation/versioncheck}} {{documentation/{{documentation/version}}/module-header}}

@@ Line 7: / Line 7: @@
 {{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
-* Luca Antiga: Orobix Srl & Mario Negri Institute
+* Luca Antiga: Orobix Srl
 * Daniel Blezek: Mayo Clinic
 * Ron Kikinis, BWH
@@ Line 23: / Line 23: @@
 {{documentation/{{documentation/version}}/module-section|Module Description}}
 {{documentation/{{documentation/version}}/module-description}}
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Use Cases}}
-{|
+The module is appropriate when a surface has been extracted (e.g. with the Model Maker module) but its appearance has to be improved.
-|[[Image:SurfaceToolbox.png|thumb|380px|SurfaceToolbox User Interface]]
-|}
+This module supports various cleanup and optimization processes on surface models.  For example, a noisy image data set can lead to models that have bumpy surfaces which do not accurately depict the actual anatomy of interest.  In this case, the model can be smoothed to better approximate the actual surface.
-The module is appropriate when a surface has been extracted (e.g. with the Modelmaker module) but its appearance has to be improved.
+Connectivity can be employed after the extraction of an isosurface using Grayscale Model Maker, in order to get rid of tiny pieces of surface associated to noise with intensity greater than the isosurface level.
-This module supports various cleanup and optimization processes on surface models.  For example, a noisy image data set can lead to models that have bumpy surfaces which do not accurately depict the actual anatomy of interest.  In this case, the model can be smoothed to better approximate the actual surface.  Another application is to reduce the geometric complexity of surface models to reduce the file size or rendering time of the models.
+{|
 <!-- ---------------------------- -->
@@ Line 42: / Line 60: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Panels}}
 Select the input and output models, and then enable the stages of the pipeline by selecting the buttons. Stages that include parameters will open up when they are enabled. Click apply to activate the pipeline and then click the Toggle button to compare the model before and after the operation.
-* '''Surface Decimation:'''
+* '''Decimation:'''
 ** ''Enabled'': enable topology-preserving surface decimation.
 ** ''Target reduction'': target percentage reduction in number of triangles (this target reduction may not be achieved depending on the constraints on the topology).
 ** ''Boundary vertex deletion'': allow deletion of points located on the boundary of the surface.
-* '''Surface Smoothing:'''
+* '''Smoothing:'''
 ** ''Enabled'': enable surface smoothing.
-** ''Smoothing method'': choose between Laplace or Taubin surface smoothing algorithms (while Taubin is a non-shrinking filter, Laplace will tend to shrink the surface under the effect of curvature).
+** ''Smoothing method'': choose between Laplace or Taubin [1] surface smoothing algorithms (while Taubin is a non-shrinking filter, Laplace will tend to shrink the surface under the effect of curvature).
 ** ''Boundary smoothing'': allow smoothing of points located on the boundary of the surface.
 ** ''Laplace number of iterations'': number of iterations set when the Laplace algorithm is selected.
@@ Line 58: / Line 82: @@
 ** ''Taubin number of iterations'': number of iterations set when the Taubin algorithm is selected.
 ** ''Taubin passband'': spatial frequency cutoff for the Taubin algorithm.
-* '''Surface Normals:'''
+* '''Normals:'''
 ** ''Enabled'': enable computation of consistently-oriented surface normals (advised after smoothing - smoothing algorithms only move points and do not update normals accordingly, so the surface might still look non-smooth after smoothing when Gouraud shading is used).
 ** ''Flip normals'': toggle direction of normals - the algorithm will do its best to orient the normals consistently "outwards" a surface, if the surface is orientable. This switch will make normals point "inwards"
 ** ''Splitting'': toggle splitting of surface when angle between the normals of two neighboring triangles is above the Feature angle. This improves the shading appearance of sharp edges but produces topological holes in the surface.
 ** ''Feature angle'': angle (in degrees) between two neighboring triangles beyond which the edge between the triangles is split.
-* '''Surface Cleaner:'''
+* '''Cleaner:'''
 ** ''Enabled'': enable cleaning (merging of coincident points, elimination of unused points, treatment of degenerate cells) of the surface.
-* '''IO:'''
+* '''Connectivity:'''
-** ''Input Surface'': the input surface
+** ''Enabled'': enable extracting the largest connected portion of the surface and getting rid of the rest.
-** ''Output Surface'': the output surface, i.e. the input surface filtered through all the "Enabled" filters.
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|References}}
-N/A
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Information for Developers}}
 {{documentation/{{documentation/version}}/module-developerinfo}}
 The module internally uses the following VTK filters:

@@ Line 6: / Line 6: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
 {{documentation/{{documentation/version}}/module-introduction-logo-gallery

@@ Line 24: / Line 24: @@
 |[[Image:SurfaceToolbox.png|thumb|380px|SurfaceToolbox User Interface]]
 |}
 This module supports various cleanup and optimization processes on surface models.  For example, a noisy image data set can lead to models that have bumpy surfaces which do not accurately depict the actual anatomy of interest.  In this case, the model can be smoothed to better approximate the actual surface.  Another application is to reduce the geometric complexity of surface models to reduce the file size or rendering time of the models.
@@ Line 35: / Line 38: @@
 Select the input and output models, and then enable the stages of the pipeline by selecting the buttons. Stages that include parameters will open up when they are enabled. Click apply to activate the pipeline and then click the Toggle button to compare the model before and after the operation.
 <!-- ---------------------------- -->
@@ Line 44: / Line 71: @@
 {{documentation/{{documentation/version}}/module-developerinfo}}
 This is a scripted module.
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-footer}}
 <!-- ---------------------------- -->

@@ Line 6: / Line 6: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
-{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
 {{documentation/{{documentation/version}}/module-introduction-logo-gallery
 |Image:Logo-namicnew2.jpg|NA-MIC
@@ Line 15: / Line 12: @@
 |Image:Orobix_logo.jpg|Orobix
 }}
-{{documentation/{{documentation/version}}/module-introduction-end}}
 <!-- ---------------------------- -->
@@ Line 36: / Line 33: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Panels}}
 Select the input and output models, and then enable the stages of the pipeline by selecting the buttons. Stages that include parameters will open up when they are enabled. Click apply to activate the pipeline and then click the Toggle button to compare the model before and after the operation.
@@ Line 47: / Line 43: @@
 {{documentation/{{documentation/version}}/module-section|Information for Developers}}
 {{documentation/{{documentation/version}}/module-developerinfo}}
+This is a scripted module.
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-footer}}
 <!-- ---------------------------- -->