View source for Documentation/4.8/Modules/AnglePlanes

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

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
Extension: [[Documentation/{{documentation/version}}/Extensions/ShapeQuantifier|ShapeQuantifier]]<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: Julia Lopinto, University of Michigan<br>
Contributors: <br>
- Francois Budin (NIRAL, University of North Carolina), <br>
- Beatriz Paniagua (NIRAL, University of North Carolina), <br>
- Lucia Cevidanes (University of Michigan - School of Dentistry)<br>
- Jean-Baptiste Vimort (University of Michigan - School of Dentistry)<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]
<gallery>
Image:UofM-logo.png|University of Michigan
Image:UNC-logo.png|UNC
Image:Logo-namic.jpg‎|NAMIC
</gallery>
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/extension-section|Extension Description}}

This Module is used to calculate the angle between two plans by using the normals. The user gets the choice to use two plans which are already implemented on Slicer or they can define a plan by using landmarks (at least 3 landmarks).  Plans can also be saved to be reused for other models.

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/extension-section|Interface}}

{|
|[[Image:AnglePlanes_Logo.png‎|thumb|340px|Logo for AnglePlanes]]
|[[Image:Interface_AnglePlanes.png|thumb|240px|User Interface of AnglePlanes]]
|[[Image:FullView_AnglePlanes.png|thumb|700px|AnglePlanes in Slicer]]
|}

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/extension-section|Tutorials}}
===Scene===
{|
|[[Image:CMFSceneTab.png|500px]]
|This tab allows the user to display and hide all the models contained in Slicer's scene. <br>
There is an option to automatically set the view in Slicer to 3D only each time that the user is using this module. <br>
The "compute around bounding box" button will adjust the bounding box around all the displayed models in Slicer.
|}
===Manage plans===
*Create a plan:
{|
|[[Image:CMFMangePlaneTab1.png|500px]]
|To create a plan, 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.
|}
*Modify a plan:
{|
|[[Image:CMFMangePlaneTab2.png|500px]]
|Once the plan created, there is a possibility to add landmarks to the list. <br>
Each plan will be defined by three different landmarks. <br>
There is also some options to select the opacity of each plan, hide it, or adapt it to the bounding box. <br>
The remove plan option will erase the plan from Angle Plans, but the landmarks list will remain intact.
|}
===Define a middle point===
{|
|[[Image:CMFDefineMiddlePointTab.png|500px]]
|In this tab, the user will have to define a middle point defined with two landmarks from the same list. <br>
Angle plan 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.
|}
===Choose plans===
{|
|[[Image:CMFChoosePlanesTab.png|500px]]
|This tab is fore the selection of the two plans that will be used for the measurement, the user can also choose two use one of the three fundamental plans.
|}
===Results===
{|
|[[Image:CMFResultsTab.png|500px]]
|The result tab will display the Pitch, Yaw and Roll between the to plans selected in the previous tab.
|}
===Save===
{|
|[[Image:CMFSaveTab.png|500px]]
|The positions of the red, green and yellow plans can be saved and reloaded thanks to this tab.
|}

<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/extension-section|Similar Extensions}}
N/A

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

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