Raw Messages panel
Inspect values from your data source using FoxQL.
As new messages are received for a given path, the collapsible tree will show just the latest message. You will be able to expand and collapse keys, and have those changes persist across playback.
In Comparison mode, use the Data source picker in the panel toolbar to choose which slot to display.
Raw Messages also supports FoxQL functions. Functions can be chained.
Scalar (.@abs, .@acos, .@asin, and more)
| Function | Description |
|---|---|
.@abs | Absolute value |
.@acos | Arc cosine (radians) |
.@asin | Arc sine (radians) |
.@atan | Arc tangent (radians) |
.@ceil | Round up to nearest integer |
.@cos | Cosine (input in radians) |
.@degrees | Convert radians to degrees |
.@log | Natural logarithm |
.@log1p | Natural log of 1 + value |
.@log2 | Base-2 logarithm |
.@log10 | Base-10 logarithm |
.@negative | Negate the value |
.@radians | Convert degrees to radians |
.@round | Round to nearest integer |
.@sign | Sign of value (-1, 0, or 1) |
.@sin | Sine (input in radians) |
.@sqrt | Square root |
.@tan | Tangent (input in radians) |
.@trunc | Truncate to integer |
Operand (.@add(number), .@sub(number), .@mul(number), and more)
| Function | Description |
|---|---|
.@add(number) | Add a number |
.@sub(number) | Subtract a number |
.@mul(number) | Multiply by a number |
.@div(number) | Divide by a number |
Vector (.@norm)
| Function | Description |
|---|---|
.@norm | Euclidean norm (magnitude) of a vector object or numeric array |
Struct (.@rpy, .@quat, .@ypr, and more)
| Function | Description |
|---|---|
.@rpy | Convert quaternion to roll/pitch/yaw (radians) |
.@quat | Convert roll/pitch/yaw to quaternion |
.@ypr | Convert quaternion to yaw/pitch/roll (radians, ZYX order) |
.@yrp | Convert quaternion to yaw/roll/pitch (radians, ZXY order) |
Not supported in this panel: Time-series functions (.@delta, .@derivative, .@timedelta). See the Plot panel for time-series modifiers (timestamp x-axis).
These example paths show struct conversion with field access, chaining, and vector magnitude:
/odom.orientation.@rpy
/[email protected].@degrees
/pose.euler.@quat
/imu.linear_acceleration.@norm
A link to the topic's schema is at the top of display for easy reference.
Drilling down to a primitive value (number, string, or boolean) will display that value in large text.
Settings
General
| field | description |
|---|---|
| Font size | Font size for text display |
Controls and shortcuts
Message stepping
The 'previous' and 'next' buttons next to the timestamp seek the playback time to the timestamp of the previous or next message on the path. When several messages share a timestamp, a counter (for example 1 / 3) indicates which one is displayed and the buttons move through the group of simultaneous messages before advancing.
When the panel is selected, Alt + [/] (Option + [/] on macOS) steps to the previous or next message.
Message stepping is available for recordings; it is not available for live data sources.
View in Search
Hover over a value in the message tree and click the search icon ("View in Search") to open the Search page with a query for that field and value, scoped to the recording's time range. The same icon in the message header searches on the panel's path: if the path resolves to a single field, the query matches that field's value; otherwise it matches messages where the path has any value.
The hover icon appears only for values Search can query.
Diff mode
Compare messages by showing additions (green), deletions (red), and changes (yellow) to their fields across 3 categories:
"previous message"– Compare consecutive messages for a given expression"custom"– Compare different topic messages for a given timestamp
Click "Copy msg" to copy the current topic message to your clipboard.
Click the icon next to the expression to expand or collapse all nested fields in the displayed message.
Message conversion
Apply installed schema converters directly to a topic and visualize their output.
If you have a message converter that matches the fromSchemaName of the current topic, the schema name will become a dropdown with the toSchemaName option available. Selecting the target schema will let you see the messages on that topic that have been transformed using the message converter.
