Skip to content
Phil Strawser edited this page Jan 11, 2016 · 9 revisions

Overview

smtscope is a GUI for plotting live data available through the Shared Memory Transport

Starting smtscope

smtscope
-- or ---
rosrun shared_memory_transport_qt smtscope

NOTE: There are no command line arguments, and no 'help'.

--back to top--

Detailed Description

Topic Selector

The topic selector provides a view of all the current plottable topics available on SMT.  The tree-view is the broken down hierarchically.  Shared Memory Topics use '/' to act as a name spacing of sorts of topic names.  While this "namespacing" doesn't actually mean anything to the actual transport, this tool uses this convention to help organize the data for the user.  When any level of the hierarchy is checked/unchecked, all sub-items of the tree will also be checked/unchecked.  

NOTE: If the highest-level of a hierarchy is selected of a fairly large tree, the system can take a very long time to refresh the screen. Use this feature with caution.

At the top of the topic selector, there is a text box where a user can input a filter.  This filter must be formatted as a regular expression.  For those who aren't savvy with regex (which is MOST people), there are several online tools to help you cheat, line this one.  The button next to the text box toggles case sensitivity in the filter.

Plot Area

The graph area provides two different views of the data.  The large window on top is meant to be the primary view used by the user.  The view on the bottom is meant to be a "wide" or "zoomed-out" view of the data.

Basic controls

  • Panning - press and hold left mouse button
  • Zoom - Scrolling the center wheel will zoom all about the cursor.  Right-click hold and drag left/right or up/down to zoom in/out vertically and horizontally
  • View all - Right click once to pop-open a context menu.  Select "View All" to fit the screen to view all the data.

Plot Options

The check boxes below the plots modify how the views will update.  

  • Autoscroll - the plot will continually scroll from right-to-left, where the right-hand side of the plot will show the current time
  • Show Crosshairs - this will show a horizontal and vertical line intersecting with the cursor on the main plot.  The x, y value of the cursor will be displayed near the intersection point, where x is the time and y is the value.  While selected, the values in the table will reflect the value of the topic at the cursor's point in time
  • Show Legend - When selected, the legend for the different signals will be displayed in the upper left-hand corner of the main window

Value Table

The value table provides the value of all the topics that are being plotted.  When Show Crosshairs is selected, the value will be at the point in time of the crosshairs, otherwise the most current value is displayed.

--back to top--