This quick start guide lets you test Heex with a fully automated workflow. You’ll transform your computer into a simulated robot with Heex running on it, no actual robot required!You’ll install the Heex Agent on your Ubuntu system (or VM), connect to a pre-configured “AMR - Sample Mobile Robot” in your workspace, and generate events by controlling a simulated speed signal. When the speed exceeds the threshold set in the “High Speed” trigger, Heex captures the relevant data. This hands-on experience demonstrates how Heex captures Smart-Data when specific conditions are met, just as it would on a real robotic system in production.By adjusting the simulated robot’s speed, you’ll trigger events when crossing predefined thresholds. Heex will automatically capture the relevant data, allowing you to explore the full Smart-Data workflow from event generation to data visualization.
If you don’t have Ubuntu, you can use Multipass to create a virtual Ubuntu environment with ROS2 Jazzy pre-installed (ROS2 is not needed for this quick start but can be useful for other Heex features):
Copy
# Launch an Ubuntu VM with ROS2 Jazzy pre-installedmultipass launch ros2-jazzy --name heex-demo# Connect to the VMmultipass shell heex-demo
If you’re running Ubuntu with a GUI, a window will appear showing:
A graph plotting the speed value
A red threshold line
A slider to control the speed
Increase the speed above the red line to generate an event. To create additional events, lower the speed below the line, then raise it above the line again.
Click on any of your newly generated events to open the event details column
Examine the event information:
Timestamp when the event occurred
System that generated it (AMR — Sample Mobile Robot)
Trigger that activated the event
Labels providing additional context
And more
At the bottom of the event column, find the Recordings table
Click the Play button on the MCAP recording to open Heex Studio
Customize your view by:
Creating a plot panel
Selecting the speed signal to visualize
Optionally, you may plot the Acceleration and the Wheel Turn signals
Exploring how the speed change triggered the event
Congratulations! You’ve successfully generated and visualized your first event using Heex. You’ve experienced the full Smart-Data workflow from simulating a robot’s speed to capturing and analyzing the resulting event data.