Difference between revisions of "Documentation/Nightly/Modules/PortPlacement"

From Slicer Wiki
Jump to: navigation, search
Line 46: Line 46:
  
 
Once you've added your ports, the module will automatically visualize surgical tools at each port at some default (and likely useless) orientation.
 
Once you've added your ports, the module will automatically visualize surgical tools at each port at some default (and likely useless) orientation.
 +
 +
You can remove a port by selecting the fiducial used to specify it in the ports table and then clicking the "Remove Port" button.
  
 
== Tools ==
 
== Tools ==
Line 58: Line 60:
  
 
You can also vary the length and radius of individual tools by selecting them in the table and adjusting the "Tool radius" and "Tool length" spinboxes.
 
You can also vary the length and radius of individual tools by selecting them in the table and adjusting the "Tool radius" and "Tool length" spinboxes.
 +
 +
== Notes ==
 +
Each port added to the scene is tied directly to the fiducial marker used to specify it; this means the user can move the fiducial marker around and the port/tool will follow automatically. This also means that if the user deletes a fiducial marker associated with the port, the port will also be removed from the scene.
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
+
<!-- {{documentation/{{documentation/version}}/module-section|Panels and their use}}  
N/A
+
N/A -->
 
<!--
 
<!--
 
{{documentation/{{documentation/version}}/module-parametersdescription}}
 
{{documentation/{{documentation/version}}/module-parametersdescription}}
Line 67: Line 72:
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
+
<!-- {{documentation/{{documentation/version}}/module-section|Similar Modules}}  
N/A
+
N/A -->
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|References}}
+
<!-- {{documentation/{{documentation/version}}/module-section|References}}  
N/A
+
N/A -->
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
+
<!-- {{documentation/{{documentation/version}}/module-section|Information for Developers}}  
{{documentation/{{documentation/version}}/module-developerinfo}}
+
{{documentation/{{documentation/version}}/module-developerinfo}} -->
  
  

Revision as of 17:41, 20 June 2013

Home < Documentation < Nightly < Modules < PortPlacement


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


Introduction and Acknowledgements

Extension: PortPlacement
This work is part of the National Alliance for Medical Image Computing (NA-MIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149. Information on NA-MIC can be obtained from the NA-MIC website.
Author: Luis G. Torres, UNC-Chapel Hill
Contact: Luis G. Torres, <email>lgtorres42@gmail.com</email>

Kitware, Inc.  
National Alliance for Medical Image Computing (NA-MIC)  

Module Description

The PortPlacement module assists in the planning of surgical port placement in a laparoscopic procedure. Users can specify ports using fiducial markers and the module will automatically visualize simulated surgical tools at the port locations. Users can freely pivot the simulated surgical tools about the ports, as well as automatically orient all surgical tools toward a specified surgical target. Simulated tools are represented by cylinders whose lengths and radii can be varied from tool to tool.

Use Cases

Portplacement.png

Tutorials

Ports

There are two ways to add surgical ports to be visualized:

  • Individually
  1. Place a fiducial marker at a desired surgical port location.
  2. Select that fiducial in the box labeled "Surgical Port".
  3. Click the "Add Port" button.
  • From a List
  1. Select the Annotations module.
  2. Click the "Create a new hierarchy" button.
  3. (Optional) Rename the new hierarchy to something meaningful like "My Surgical Ports".
  4. Add fiducial markers to the scene where surgical ports are desired.
  5. Select the Port Placement module.
  6. Select your annotation hierarchy in the box labeled "List of Surgical Ports".
  7. Click the "Add Ports from List" button.

Once you've added your ports, the module will automatically visualize surgical tools at each port at some default (and likely useless) orientation.

You can remove a port by selecting the fiducial used to specify it in the ports table and then clicking the "Remove Port" button.

Tools

Once you've added some ports, you can re-orient the surgical tools in two ways:

  • Target-oriented
  1. Place a fiducial marker in the scene that you want your surgical tools to point at. Think of this as your surgical target.
  2. Select that fiducial marker in the box labeled "Surgical Target Fiducial".
  3. Click the "Aim Tools at Target" button to automatically orient all surgical tools toward your selected target.
  • Manual Orientation
  1. In order to manually orient an individual tool, look in the port table for the fiducial corresponding to that tool's port and select it by clicking on it.
  2. Use the Tool Orientation sliders to re-orient the tool about the port location.

You can also vary the length and radius of individual tools by selecting them in the table and adjusting the "Tool radius" and "Tool length" spinboxes.

Notes

Each port added to the scene is tied directly to the fiducial marker used to specify it; this means the user can move the fiducial marker around and the port/tool will follow automatically. This also means that if the user deletes a fiducial marker associated with the port, the port will also be removed from the scene.