View source for Documentation/4.5/Modules/Q3DC

<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/LongitudinalQuantification|LongitudinalQuantification]]<br>
Acknowledgments:
This work was supported by the National Institues of Dental and Craniofacial Research and Biomedical Imaging and Bioengineering of the National Institutes of Health under Award Number R01DE024450<br>
Author: Lucie Macron (University of Michigan)<br>
Contributor1: Francois Budin (UNC)<br>
Contributor2: Beatriz Paniagua (UNC)<br>
Contributor3: Lucia Cevidanes (University of Michigan)<br>
Contributor4: Steve Pieper (Isomics, Inc.)<br>
Contributor5: Jean-Baptiste Vimort (University of Michigan)<br>
Contact: Jean-Baptiste Vimort, <email>jb.vimort@gmail.com</email><br>
License: [http://www.apache.org/licenses/LICENSE-2.0.html Apache License, Version 2.0]
{{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 extension contains one module of the same name: Q3DC means Quantitative 3D Cephalometrics, meaning head measurements used in craniofacial surgery. Using placed fiducials, it allows users to compute 2D angles: Yaw, Pitch and Roll; and decompose the 3D distance into the three different components: R-L , A-P and S-I. 
It is possible to compute the middle point between two fiducials and export the values. 

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Use Cases}}
{|
|[[Image:Q3DC_Logo.png‎|thumb|340px|Logo for Q3DC]]
|[[Image:Q3DC_Interface.png|thumb|300px|Interface of Q3DC]]
|[[Image:FullView_Q3DC.png|thumb|700px|Q3DC in Slicer]]
|}

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/extension-section|Tutorials}}
===Visibility of models and Landmarks===
{|
|[[Image:CMFVisibilityOfModelsAndLandmarksTab.png|500px]]
|This tab allows the user to display and hide all the models and landmarks contained in Slicer's scene. <br>
|}
===Add and move landmarks===
{|
|[[Image:CMFAddAndMoveLandmarksTab.png|500px]]
|To add points, the user will need to select a model (on which each landmark will be projected) and a list of landmarks. <br>
This list of Landmarks can already contain landmarks, if that is the case the "on surface" option will project all the landmarks that are not defined as a middle point. <br>
Only one landmark can be moved at the time, the one that is selected in the "landmark modification" part. This landmark can be kept on the surface or not.
|}
===Define a middle point===
{|
|[[Image:CMFDefineMiddlePointsTab.png|500px]]
|In this tab, the user will have to define a middle point defined with two landmarks. <br>
Q3DC won't allow the modification of any middle point, therefore all the middle points will be updated when one of the landmarks that define its is moved.
|}
===Calculate distance between two landmarks===
{|
|[[Image:CMFCalculateDistanceBetweenLandmarksTab.png|500px]]
|To calculate distances between two points the user will need two specify two landmarks that can be from different landmark list. <br>
The result of each measurement will be add as a line in a tab, each measurement will contain the distance between the two points in the 3D space and the 3 components (x,y,z) of the distance. <br>
The result tab can then be exported as a .csv file.
|}
===Calculate angles between two lines===
{|
|[[Image:CMFCalculateAngleBetweenLinesTab.png|500px]]
|To calculate angles between two lines the user will need two specify two lines each composed of two points,  each landmarks can be from different landmark list. <br>
The user will then have the possibility to choose if he want to compute the Roll, Pitch and/or Yaw. <br>
The result of each measurement will be add as a line in a tab, each measurement will contain what the user had decide to compute.<br>
The result tab can then be exported as a .csv file.
|}
===Calculate distance between a landmark and a line===
{|
|[[Image:CMFCalculateDistanceBetweenLineLandmrksTab.png|500px]]
|To calculate distances between a point and a line, the user will need two specify two landmarks that will define the line and an other landmark for the point, each landmark can be from different landmark list. <br>
The point will then be projected on the line, and the distance between the selected point and the projected point will be computed. <br>
The result of each measurement will be add as a line in a tab, each measurement will contain the distance between the two points in the 3D space and the 3 components (x,y,z) of the distance. <br>
The result tab can then be exported as a .csv file.
|}

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

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
The source code is available on

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-footer}}
<!-- ---------------------------- -->