Difference between revisions of "Documentation/4.5/Extensions/AnglePlanes"

From Slicer Wiki
Jump to: navigation, search
Line 14: Line 14:
 
- Lucia Cevidanes (University of Michigan - School of Dentistry)<br>
 
- Lucia Cevidanes (University of Michigan - School of Dentistry)<br>
 
- Jean-Baptiste Vimort (University of Michigan - School of Dentistry)<br>
 
- Jean-Baptiste Vimort (University of Michigan - School of Dentistry)<br>
Contact: Julia Lopinto, <email>lopinto.julia@gmail.com</email><br>
+
Contact: Julia Lopinto, <email>jb.vimort@gmail.com</email><br>
 
License: [http://www.apache.org/licenses/LICENSE-2.0.html Apache License, Version 2.0]
 
License: [http://www.apache.org/licenses/LICENSE-2.0.html Apache License, Version 2.0]
 
<gallery>
 
<gallery>
Line 24: Line 24:
 
{{documentation/{{documentation/version}}/extension-section|Extension Description}}
 
{{documentation/{{documentation/version}}/extension-section|Extension Description}}
  
This Module is used to calculate the angle between two planes by using the normals. The user gets the choice to use two planes which are already implemented on Slicer or they can define a plane by using landmarks (at least 3 landmarks).  Plane can also be saved to be reused for other models.
+
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.
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 44: Line 44:
 
The "compute around bounding box" button will adjust the bounding box around all the displayed models in Slicer.
 
The "compute around bounding box" button will adjust the bounding box around all the displayed models in Slicer.
 
|}
 
|}
===Manage planes===
+
===Manage plans===
 
*Create a plan:
 
*Create a plan:
 
{|
 
{|
Line 57: Line 57:
 
|Once the plan created, there is a possibility to add landmarks to the list. <br>
 
|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>
 
Each plan will be defined by three different landmarks. <br>
There is also some options to select the opacity of each plane, hide it, or adapt it to the bounding box. <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 Planes, but the landmarks list will remain intact.
+
The remove plan option will erase the plan from Angle Plans, but the landmarks list will remain intact.
 
|}
 
|}
 
===Define a middle point===
 
===Define a middle point===
Line 64: Line 64:
 
|[[Image:CMFDefineMiddlePointTab.png|500px]]
 
|[[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>
 
|In this tab, the user will have to define a middle point defined with two landmarks from the same list. <br>
Angle plane 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.
+
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 planes===
+
===Choose plans===
 
{|
 
{|
 
|[[Image:CMFChoosePlanesTab.png|500px]]
 
|[[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 planes.
+
|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===
 
===Results===
Line 89: Line 89:
 
{{documentation/{{documentation/version}}/extension-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/extension-section|Information for Developers}}
 
The source code is available on [https://github.com/DCBIA-OrthoLab/AnglePlanes-Extension github]
 
The source code is available on [https://github.com/DCBIA-OrthoLab/AnglePlanes-Extension github]
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-footer}}
 
{{documentation/{{documentation/version}}/extension-footer}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Revision as of 20:57, 29 February 2016

Home < Documentation < 4.5 < Extensions < AnglePlanes


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



Introduction and Acknowledgements

Extension: AnglePlanes
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
Author: Julia Lopinto, University of Michigan
Contributors:
- Francois Budin (NIRAL, University of North Carolina),
- Beatriz Paniagua (NIRAL, University of North Carolina),
- Lucia Cevidanes (University of Michigan - School of Dentistry)
- Jean-Baptiste Vimort (University of Michigan - School of Dentistry)
Contact: Julia Lopinto, <email>jb.vimort@gmail.com</email>
License: Apache License, Version 2.0

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.

Interface

Logo for AnglePlanes
User Interface of AnglePlanes
AnglePlanes in Slicer

Tutorials

Scene

CMFSceneTab.png This tab allows the user to display and hide all the models contained in Slicer's scene.

There is an option to automatically set the view in Slicer to 3D only each time that the user is using this module.
The "compute around bounding box" button will adjust the bounding box around all the displayed models in Slicer.

Manage plans

  • Create a plan:
CMFMangePlaneTab1.png To create a plan, the user will need to select a model (on which each landmark will be projected) and a list of landmarks.

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.
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:
CMFMangePlaneTab2.png Once the plan created, there is a possibility to add landmarks to the list.

Each plan will be defined by three different landmarks.
There is also some options to select the opacity of each plan, hide it, or adapt it to the bounding box.
The remove plan option will erase the plan from Angle Plans, but the landmarks list will remain intact.

Define a middle point

CMFDefineMiddlePointTab.png In this tab, the user will have to define a middle point defined with two landmarks from the same list.

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

CMFChoosePlanesTab.png 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

CMFResultsTab.png The result tab will display the Pitch, Yaw and Roll between the to plans selected in the previous tab.

Save

CMFSaveTab.png The positions of the red, green and yellow plans can be saved and reloaded thanks to this tab.

Similar Extensions

N/A

Information for Developers

The source code is available on github