View source for Documentation/4.8/Modules/SurfaceRegistration

<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/CMFreg|CMFreg]]<br>
Acknowledgments: This work was supported by the National Institute of Dental & Craniofacial Research and the National Institute of Biomedical Imaging and Bioengineering under Award Number R01DE024450. The content is solely the responsibility of the authors and does not necessarily represent the official views of the National Institutes of Health.<br>
Author: Jean-Baptiste Vimort (University of Michigan)<br>
Contributors: Francois Budin (UNC), Juan Carlos Prieto (UNC), Beatriz Paniagua (UNC), Lucia Cevidanes (University of Michigan)<br>
Contact: Jean-Baptiste Vimort, <email>jb.vimort@gmail.com</email><br>
{{documentation/{{documentation/version}}/module-introduction-row}}
<gallery>
Image:UofM-logo.png|University of Michigan
Image:Logo-namic.jpg‎|NAMIC
Image:UNC-logo.png|UNC
</gallery>

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

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Module Description}}
This module allows the user to compute and apply transformations (registration) between two 3D models (VTK file). The registration can be computed using the entire mesh of both models (Surface Registration), just a region of interest (ROI Registration) on each model, or two fiducial lists which can be projected on the meshes (Fiducial Registration).

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Use Cases}}
==Fiducials Registration==
===Pictures===
{|
|[[Image:SurfaceRegistrationFR.png|thumb|400px|Before fiducial registration]]
|[[Image:SurfaceRegistrationFRInterface.png|thumb|400px|Fiducial Registration Interface]]
|[[Image:SurfaceRegistrationFRResult.png|thumb|400px|Result after fiducial registration]]
|}

===Inputs/Outputs===
* <span style="color:blue">'''Inputs'''</span>: 
** <span style="color:green">'''Fixed Model'''</span>: 3D model (vtk file) that won't move. 
** <span style="color:green">'''Moving Model'''</span>: 3D model (vtk file) that will move.
** <span style="color:green">'''Fixed Landmarks'''</span>: ordered landmark list (fiducial list) associated with the Fixed Model. 
** <span style="color:green">'''Moving Landmarks'''</span>: ordered landmark list (fiducial list) associated with the Fixed Model. 
* <span style="color:blue">'''Outputs'''</span>: 
** <span style="color:green">'''Output model'''</span>: 3D model node that in which the transformed moving model will be saved. 
** <span style="color:green">'''output transform'''</span>: linear transform node in which the transformation computed by the algorithm will be saved.

===Description===
The fiducial registration computes a rigid, similarity, or affine transform from a matched list of fiducials using the SurfaceRegistration module. The algorithm needs the same number of fiducial in each list, and at least 3 fiducials per list. <br>
The 'add landmarks' section allows the user to add and move landmarks. Landmarks can be projected on the surfaces or not.

==Surface Registration==
===Pictures===
{|
|[[Image:SurfaceRegistrationSR.png|thumb|400px|Before Surface Registration]]
|[[Image:SurfaceRegistrationSRInterface.png|thumb|400px|Surface Registration Interface]]
|[[Image:SurfaceRegistrationSRResult.png|thumb|400px|Result after Surface Registration]]
|}

===Inputs/Outputs===
* <span style="color:blue">'''Inputs'''</span>: 
** <span style="color:green">'''Fixed Model'''</span>: 3D model (vtk file) that won't move. 
** <span style="color:green">'''Moving Model'''</span>: 3D model (vtk file) that will move.
* <span style="color:blue">'''Outputs'''</span>: 
** <span style="color:green">'''Output model'''</span>: 3D model node in which the transformed moving model will be saved. 
** <span style="color:green">'''output transform'''</span>: linear transform node in which the computed transformation is saved.

===Description===
The fiducial registration computes a rigid, similarity, or affine transform to register two models using the Iterative Closest Point algorithm. This algorithm doesn't require the two models to have the same number of points.

==ROI Registration==
===Pictures===
{|
|[[Image:SurfaceRegistrationROIR.png|thumb|400px|Before ROI (Region Of Interest) Registration]]
|[[Image:SurfaceRegistrationROIRInterface.png|thumb|400px|Interface of ROI (Region Of Interest) Registration]]
|[[Image:SurfaceRegistrationROIRResult.png|thumb|400px|Result after ROI (Region Of Interest) Registration]]
|}

===Inputs/Outputs===
* <span style="color:blue">'''Inputs'''</span>: 
** <span style="color:green">'''Fixed Model'''</span>: 3D model (vtk file) that won't move. 
** <span style="color:green">'''Moving Model'''</span>: 3D model (vtk file) that will move.
** <span style="color:green">'''Fixed Landmarks'''</span>: list of landmarks associated to the Fixed Model. 
** <span style="color:green">'''Moving Landmarks'''</span>: list of landmarks associated to the Fixed Model. 
* <span style="color:blue">'''Outputs'''</span>: 
** <span style="color:green">'''Output model'''</span>: 3D model that will save the result of the moving model after the transformation. 
** <span style="color:green">'''output transform'''</span>: linear transform that will save the transform compute by the algorithm.
===Description===
The fiducial registration computes a rigid, similarity, or affine transform from a matched part of models based on the Iterative Closest Point algorithm. This algorithm doesn't require the regions of each model to have the same number of points.
The 'add landmarks' section allows user to define the regions of interest (ROIs) by positioning a landmark on a 3D model and defining a radius for the region (the radius is defined in term of neighbors and not in millimeters).

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
N/A

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
The source code is available on [https://github.com/DCBIA-OrthoLab/CMFreg github]

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-footer}}
[[Category:Documentation/{{documentation/version}}/Modules/ShapeAnalysis]]
<!-- ---------------------------- -->