Getting Started
Key Concepts
- Smart-Data: A modern approach to robotic data capture that enables scenario-driven data collection through deployed software agents. Characterized by remote management, Over-the-Air (OTA) updates, selective signal recording, automated event tagging with metadata for searchability, and robotic data democratization.
- RDA (Resource and Data Automation for ROS 2): A tool that simplifies integration of ROS-based robotic systems with Heex. RDA automatically configures data sources and signals from provided ROS bags, enabling real-time monitoring and recording of data without any coding required. This solution eliminates manual setup and accelerates deployment for robotics teams working with ROS ecosystems.
- Heex Installer: Your gateway to deploying Heex on any target system. Once connected to your robot via SSH or other secure methods, it connects your robot to our SaaS back-end, declares your device and configures its OTA data capture agents and scenarios to ensure you’re quickly ready to capture data with minimal effort. Simply declare your data capture scenarios in a user friendly interface, and the installer handles agent download, installation, and up-to-date trigger deployment.
Physical Entities
- System: Physical devices (robot, drone, vehicle, computer for historical data parsing and simulation, etc.) where Agents are installed to collect Smart-Data.
- Agent: An executable program deployed on Systems that monitors data streams and initiates custom data recording based on predefined scenarios. Agents can receive Over-The-Air (OTA) updates.
Data Sources
- Datasource: Device or file (e.g., ROSbag) that exposes one or many data streams.
- Signal: A single data stream from a Datasource which can be monitored and/or recorded.
Monitoring & Recording
- Trigger: A set of Signals to monitor, conditions, and recording strategies that define data capture scenarios for generating Smart-Data.
- Monitor: Custom component within an Agent that tracks specific data points or system metrics.
- Conditions: Logical rules that determine when data recording should occur (i.e. robot is stopped)
- Recorder: Custom component within an Agent responsible for capturing, tagging and transferring specified data streams.
- Implementation: An executable binary developed from the Heex SDK, which implements monitors and/or recorders and deployed in Agents to monitor or record given Signal.
Events & Recordings
- Event: Generated when all conditions of a given trigger are met, and which results in a notification and tagged data capture from Recorders.
- Recording: A custom format digital document/file captured by the Recorder Implementations in response to a specific Event, containing relevant data and tags for searchability.
Organization & Classification
- Label: Key-value pairs that add searchable metadata to your resources, enabling custom classification and efficient filtering across the Heex Smart-Data platform.
- Group: A special Label used to group similar or different Systems together for bulk monitoring and management.
- Status: Automatically updated to reflect the current state of Systems, Triggers, Implementations, and other components (e.g., requested, to be deployed, ready).