From Slicer Wiki
Revision as of 14:51, 11 November 2013 by Luist (talk | contribs) (→‎Ports: Updating ports documentation for new Markups-enabled module)
Jump to: navigation, search
Home < Documentation < Nightly < Modules < PortPlacement

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

Introduction and Acknowledgements

Extension: PortPlacement
This work is supported by NA-MIC and the 3DSlicer community. This work was partially supported by NSF GRFP Grant No. DGE-1144081 and NIH/NIBIB Grant No. 1R43EB014074-01.
Author: Andinet Enquobahrie (Kitware), Luis G. Torres (UNC-Chapel Hill)
Contact: Andinet Enquobahrie, <email></email> and Luis G. Torres, <email></email>

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

Module Description

NOTE: This module currently does not work in Slicer 4.3; this module supports up through Slicer 4.2. Fixes are in progress to enable this module in Slicer 4.3. 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




You can use Markups fiducials to add surgical ports for visualization:

  1. Select the Markups module.
  2. Click the combo box labeled "Select a MarkupsFiducial".
  3. Select "Create and rename new MarkupsFiducial" and give your MarkupsFiducial list a meaningful name like "surgical ports".
  4. Begin placing fiducial markers in the scene where surgical ports are desired.
  5. Select the Port Placement Module (under the IGT category).
  6. Select your MarkupsFiducial list using the combo box labeled "Markups node of surgical ports"
  7. Click "Set Port Markups Node" to associate the selected MarkupsFiducial list with the Port Placement module.

The module will automatically visualize surgical tools centered at each fiducial marker at some default (and likely useless) orientation.

You can always remove a port by either deleting its associated fiducial marker or by highlighting the port in the module's ports table and clicking "Remove Selected Port".

You can also continue to add fiducial markers to the associated MarkupsFiducial list and the module will automatically add the new markers as ports.


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.


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.