View source for Documentation/4.8/Extensions/ModelToModelDistance

<noinclude>{{documentation/versioncheck}}</noinclude>
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-header}}
<!-- ---------------------------- -->

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
{{documentation/{{documentation/version}}/module-introduction-row}}
Extension: [[Documentation/{{documentation/version}}/Extensions/ModelToModelDistance|ModelToModelDistance]]<br>
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 grants R01 DE024450 and R01 DE005215<br>
Author: Francois Budin (UNC)<br>
Contributor1: Julietta Pera (UNC)<br>
Contributor2: Beatriz Paniagua (UNC)<br>
Contact: Francois Budin, <email>fbudin@unc.edu</email><br>
Website: https://www.nitrc.org/projects/meshmetric3d<br>
License: [http://www.apache.org/licenses/LICENSE-2.0.html Apache License, Version 2.0]
{{documentation/{{documentation/version}}/module-introduction-row}}
<gallery>
Image:UNC-NIRAL.png‎|NIRAL
Image:UNC-logo.png|UNC
Image:Logo-namic.jpg‎|NAMIC
</gallery>

{{documentation/{{documentation/version}}/module-introduction-end}}

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|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 [http://www.vtk.org/doc/nightly/html/classvtkDistancePolyDataFilter.html 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.

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Use Cases}}
{|
|[[Image:Slicer4Extensions-ModelToModelDistanceOriginalShapes.png|thumb|340px|Input shapes overlaid]]
|[[Image:Slicer4Extensions-ModelToModelDistanceResults.png|thumb|340px|Distance computed]]
|}

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Tutorials}}
More information can be found on http://www.nitrc.org/projects/meshmetric3d

<!-- ---------------------------- -->
{{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]]
|}

<!-- ---------------------------- -->
{{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]]
<!-- ---------------------------- -->