Markups

Overview

This module is used to create and edit markups (fiducial list, line, angle, curve, plane, etc.) and adjust their display properties.

How to

Place new markups

  1. Click “Create and place” button on the toolbar to activate place mode.

Click the down-arrow icon on the button to choose markups type.

Click “Place multiple control points” checkbox to keep placing control points continuously, without the need to click the place button after each point.

  1. Left-click in the slice or 3D views to place points.

  2. Double-left-click or right-click to finish point placement.

Edit point positions in existing markups

  • Make sure that the correct markups node is selected in Markups module.

  • Left-click-and drag a control point to move it

  • Left-click a control point to show it in all slice viewers. This helps in adjusting its position along all axes.

  • Right-click to delete or rename a control point or change node properties.

  • Ctrl + Left-click to place a new control point on a curve.

  • Enable Display / Interaction / Visible to show a widget that allows translation/rotation of the entire widget.

Edit properties of a markups node that is picked in a view

To pick a markups node in a viewer so that its properties can be edited in Markups module, right-click on it in a slice or 3D view and choose “Edit properties”.

Edit ROI markups

  • ROI size can be changed using handles on the corners and faces of the ROI.

  • If the handles are not visible, right-click on the ROI outline, or on a control point, and check “Interaction handles visible”.

  • Left-click-and-drag on interaction handles to change the ROI size.

  • Alt + Left-click-and-drag to symmetrically adjust the ROI size without changing the position of the center.

Panels and their use

  • Create: click on any of the buttons to create a new markup. Click in any of the viewers to place control points.

  • Markups list: Select a markups node to populate the GUI and allow modifications. When control point placement is activated on the toolbar, then points are added to this selected markups node.

Display section:

  • Visibility: Toggle the markup visibility, which will override the individual control point visibility settings. If the eye icon is open, the list is visible, and pressing it will make it invisible. If the eye icon is closed, the list is invisible and pressing the button will make it visible.

  • Opacity: overall opacity of the selected markup.

  • Glyph Size: Set control point glyph size relative to the screen size (if absolute button is not pressed) or as an absolute size (if absolute button is depressed).

  • Text Scale: Label size relative to screen size.

  • Interaction: check Visible to enable translation of the entire markups in slice and 3D views with an interactive widget.

  • Advanced:

    • View: Select which views the markup is displayed in

    • Selected Color: Select the color that will be used to display the glyph and text when the markup is marked as selected.

    • Unselected Color: Select the color that will be used to display the glyph and text when the markup is not marked as selected.

    • Glyph Type: Select the symbol that will be used to mark each location. Default is the Sphere3D.

    • Control Point Labels: check to display a label for each control point.

    • Control Point Projection: Controls the projection of the control points in the 2D viewers onto slices around the one on which the control points have been placed.

      • 2D Projection: Toggle the eye icon open or closed to enable or disable visualization of the projected control points on 2D viewers.

      • Use Markup Color: If checked, color the projections the same color as the markup.

      • Projection Color: If not using markup color for the projection, use this color.

      • Outlined Behind Slice Plane: Control point projection is displayed filled (opacity = Projection Opacity) when on top of slice plane, outlined when behind, and with full opacity when in the plane. Outline isn’t used for some glyphs (Dash2D, Cross2D, Starburst).

      • Projection Opacity: A value between 0 (invisible) and 1 (fully visible) for displaying the control point projection.

      • Reset to Defaults: Reset the display properties of this markups node to the system defaults.

      • Save to Defaults: Save the display properties of this markups node to be the new system defaults. Control point labels visibility and properties label visibility settings are not saved to defaults, as typically it is better to initialize these based on the node type (control point labels are more useful for markups fiducial nodes, while properties label is more useful for other markups nodes).

  • Scalars: Color markup according to a scalar, e.g. a per-control-point measurement (see Measurements section below)

    • Visible: Whether scalar coloring should be shown or the original color of the markup

    • Active Scalar: Which scalar array to use for coloring

    • Color Table: Palette used for coloring

    • Scalar Range Mode: Method for determining the range of the scalars (automatic range calculation based on the data is the default)

Control points section:

  • Interaction in views: toggle the markups lock state (if it can be moved by mouse interactions in the viewers), which will override the individual control points lock settings.

  • Click to Jump Slices: If checked, click in name column to jump slices to that point. The radio buttons control if the slice is centered on the control point or not after the jump. Right click in the table allows jumping 2D slices to a highlighted control point (uses the center/offset radio button settings). Once checked, arrow keys moving the highlighted row will also jump slice viewers to that control point position.

  • Buttons: These buttons apply changes to control points in the selected list.

    • Toggle visibility flag: Toggle visibility flag on all control points in the list. Use the drop down menu to set all to visible or invisible.

    • Toggle selected flag: Toggle selected flag on all control points in the list. Use the drop down menu to set all to selected or deselected. Only selected markups will be passed to command line modules.

    • Toggle lock flag: Toggle lock flag on all control points in the list. Use the drop down menu to set all to locked or unlocked.

    • Delete the highlighted control points from the active list: After highlighting rows in the table to select control points, press this button to delete them from the list.

    • Remove all control points from the active list: Pressing this button will delete all of the control points in the active list, leaving it with a list length of 0.

    • Transformed: Check to show the transformed coordinates in the table. This will apply any transform nodes to the points in the list and show that result. Keep unchecked to show the raw RAS values that are stored in MRML. If you harden the transform the transformed coordinates will be the same as the non transformed coordinates.

    • Hide RAS: Check to hide the coordinate columns in the table and uncheck to show them. Right click in rows to see coordinates.

  • Control points table: Right click on rows in the table to bring up a context menu to show the full precision coordinates, distance between multiple highlighted control points, delete the highlighted control point, jump slice viewers to that location, refocus 3D viewers to that location, or if there are other lists, to copy or move the control point to another list.

    • Selected: A check box is shown in this column, it’s check state depends on if the control point is selected or not. Click to toggle the selected state. Only selected control points will be passed to command line modules.

    • Locked: An open or closed padlock is shown in this column, depending on if the control point is unlocked or locked. Click it to toggle the locked state.

    • Visibility: An open or closed eye icon is shown in this column, depending on if the control point is visible or not. Click it to toggle the visibility state.

    • Name: A short name for this control point, displayed in the viewers as text next to the glyphs.

    • Description: A longer description for this control point, not displayed in the viewers.

    • X, Y, Z: The RAS coordinates of this control point, 3 places of precision are shown.

  • Advanced section:

    • Move Up: Move a highlighted control point up one spot in the list.

    • Move Down: Move a highlighted control point down one spot in the list.

    • Add Control Point: Add a new control point to the selected list, placing it at the origin

    • Naming:

      • Name Format: Format for creating names of new control points, using sprintf format style. %N is replaced by the list name, %d by an integer.

      • Apply: Rename all control points in this list according to the current name format, trying to preserve numbers. A quick way to re-number all the control points according to their index is to use a name format with no number in it, rename, then add the number format specifier %d to the format and rename one more time.

      • Reset: Reset the name format field to the default value, %N-%d.

Measurements section:

  • This section lists the available measurements of the selected markup

    • length for line and curve

    • angle for angle markups

    • curvature mean and curvature max for curve markups

  • In the table below the measurement descriptions, the measurements can be enabled/disabled

    • Basic measurements (e.g. length, angle) are enabled by default

    • Curve markups support curvature calculation, which is off by default

      • When turned on, the curvature data can be displayed as scalar coloring (see Display/Scalars above)

Curve settings section:

  • Curve type:

    • linear: control points are connected with straight line

    • spline, Kochanek spline: smooth interpolating curve

    • polynomial: smooth approximating curve

    • shortest distance on surface: curve points are forced to be on the selected model’s surface, connected with a minimal-cost path

  • Surface: surface used for shortest distance on surface curve type and cost function that is minimized to find path connecting two control points

Resample section: Replace control points by curve points sampled at equal distances. If a model node is selected for Constrain points to surface then the resampled points will be projected to the chosen model surface.

Information for developers

See examples and other developer information in Developer guide and Script repository.

Contributors

Authors:

  • Andras Lasso (PerkLab, Queen’s University)

  • Davide Punzo (Kapteyn Astronomical Institute, University of Groningen)

  • Kyle Sunderland (PerkLab, Queen’s University)

  • Nicole Aucoin (SPL, BWH)

  • Csaba Pinter (Pixel Medical / Ebatinca)

Acknowledgements

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.