Difference between revisions of "Documentation/4.3/Extensions/ModelToModelDistance"

From Slicer Wiki
Jump to: navigation, search
(Created page with '<noinclude>{{documentation/versioncheck}}</noinclude> <!-- ---------------------------- --> {{documentation/{{documentation/version}}/module-header}} <!-- -----------------------…')
 
 
Line 43: Line 43:
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
  
 +
===Quick Tour of Features and Use===
 +
 +
A list panels in the interface, their features, what they mean, and how to use them.
 
{|
 
{|
 
|
 
|
 +
* <span style="color:blue">'''''Input/Ouput'''''</span>:
 +
** <span style="color:green">'''VTK File 1'''</span> [<span style="color:orange">----vtkfile1</span>] : VTK File 1 (required)
 +
 +
** <span style="color:green">'''VTK File 2'''</span> [<span style="color:orange">----vtkfile2</span>] : VTK File 2 (required)
 +
 +
** <span style="color:green">'''VTK Output File'''</span> [<span style="color:orange">----output</span>] : VTK Output File (required)
 +
 +
** <span style="color:green">'''distanceType'''</span> [<span style="color:orange">----distanceType</span>] : Algorithm used to compute the distance between the 2 models (signed_closest_point/absolute_closest_point/corresponding_point_to_point).
 +
*** signed_closest_point and absolute_closest_point are respectively the signed and absolute Hausdorff distance between the points of the 2 models.
 +
*** corresponding_point_to_point requires the 2 models to have the same number of points. It assumes that in each model, point at a certain index correspond to each other. The distance is then computed between each corresponding point. The distances are computed the following way: Point2 - Point1. The output information is saved in a copy of VTKFile1. This methods adds 6 data fields to the vtk file: PointToPointVector, SignedPointToPointDistance, AbsolutePointToPointDistance, MagNormVector, SignedMagNormDirDistance, AbsoluteMagNormDirDistance. PointToPoint distances are the different distances between the models (vector, signed distance and absolute distance). MagNorm distances are computed on the projection of the distance version on the normal at that location. MagNormVector is the normal version multiplied by the dot product of the normal vector and the distance vector. SignedMagNormDirDistance is the dot product between the 2 vectors and AbsoluteMagNormDirDistance its absolute value.
 
|[[Image:SlicerExtension-ModelToModelDistanceMenu.png|thumb|280px|Module UI]]
 
|[[Image:SlicerExtension-ModelToModelDistanceMenu.png|thumb|280px|Module UI]]
 
|}
 
|}
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/module-section|References}}
 +
* Cory Quammen, Chris Weigle C., Russ Taylor, "Boolean Operations on Surfaces in VTK Without External Libraries", http://hdl.handle.net/10380/3262
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 +
The source code is available on [https://github.com/NIRALUser/3DMetricTools github]
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/module-footer}}
 +
[[Category:Documentation/{{documentation/version}}/Modules/ShapeAnalysis]]
 +
<!-- ---------------------------- -->
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 21:45, 19 September 2014

Home < Documentation < 4.3 < Extensions < ModelToModelDistance


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



Introduction and Acknowledgements

Extension: ModelToModelDistance
Acknowledgments: This work was funded by National Institute of Dental and Craniofacial Research (NIDCR) and the National Institute of Biomedical Imaging and Bioengineering (NIBIB) through the Grant R01 DE024450
Author: Francois Budin (UNC)
Contributor1: Julietta Pera (UNC)
Contributor2: Beatriz Paniagua (UNC)
Contact: Francois Budin, <email>fbudin@unc.edu</email>

  • NIRAL

  • UNC

  • NAMIC

Module Description

This extension contains one CLI module of the same name. It computes a point by point distance between two models loaded in Slicer or VTK volumes. It is based on vtkDistancePolyDataFilter. The distance can be signed or unsigned. Even though vtkDistancePolyDataFilter computes both the distance between points and the distance between cells, this module only saves the distance between points. The output volume has the same number of points as the first input volume. The distances are saved as in the model as a point data array under the name "Distance" which is added to the input point and cell arrays already in the first input file.

Use Cases

Input shapes overlaid
Distance computed

Tutorials

More information can be found on http://www.nitrc.org/projects/meshmetric3d

Panels and their use

Quick Tour of Features and Use

A list panels in the interface, their features, what they mean, and how to use them.

  • Input/Ouput:
    • VTK File 1 [----vtkfile1] : VTK File 1 (required)
    • VTK File 2 [----vtkfile2] : VTK File 2 (required)
    • VTK Output File [----output] : VTK Output File (required)
    • distanceType [----distanceType] : Algorithm used to compute the distance between the 2 models (signed_closest_point/absolute_closest_point/corresponding_point_to_point).
      • signed_closest_point and absolute_closest_point are respectively the signed and absolute Hausdorff distance between the points of the 2 models.
      • corresponding_point_to_point requires the 2 models to have the same number of points. It assumes that in each model, point at a certain index correspond to each other. The distance is then computed between each corresponding point. The distances are computed the following way: Point2 - Point1. The output information is saved in a copy of VTKFile1. This methods adds 6 data fields to the vtk file: PointToPointVector, SignedPointToPointDistance, AbsolutePointToPointDistance, MagNormVector, SignedMagNormDirDistance, AbsoluteMagNormDirDistance. PointToPoint distances are the different distances between the models (vector, signed distance and absolute distance). MagNorm distances are computed on the projection of the distance version on the normal at that location. MagNormVector is the normal version multiplied by the dot product of the normal vector and the distance vector. SignedMagNormDirDistance is the dot product between the 2 vectors and AbsoluteMagNormDirDistance its absolute value.
Module UI

Similar Modules

References

Information for Developers

The source code is available on github

Similar Modules

References

Information for Developers

The source code is available on github

Retrieved from "https://www.slicer.org/w/index.php?title=Documentation/4.3/Extensions/ModelToModelDistance&oldid=39167"