Data Sources
Data Sources Overview
Data Sources are a fundamental part of Heex’s Smart-Data approach, which enables scenario-driven data collection through deployed software agents. Data Sources are logical groupings of one or many data streams available in one or multiple Systems. The workflow is as follows:
- Data Sources contain Signals and are linked to Systems
- Signals are monitored through Triggers
- When trigger conditions are met, some Signals are recorded and Events are generated.
This architecture ensures that you’re only recording the data that matters, based on specific scenarios and conditions you define, rather than capturing everything continuously.
Data Sources Management
On the Data Sources page, you’ll find a comprehensive list of all your workspace data sources, complete with details such as their names, unique identifiers, and signal counts.
Creating New Data Sources
To start generating Smart-Data, you need data sources linked to your systems. To create a new data source, you have several options:
- Through manual configuration in the web app from the System’s view.
- Through RDA (Resource and Data Automation) from an existing ROS bag.
- Through the CLI.
Editing existing Data Sources
To edit an existing data source, click on the three dots menu (action menu) on the right side of the data source row, then select “edit”.
Alternatively, you can click directly on the data source name to open the detailed view, then use the edit button (pencil icon) in the top-right corner of the details panel.
Data Source Details
When you click on a data source, a detailed view appears showing comprehensive information about that data source. This view includes:
General Information
- Name: The user-friendly name of the data source (e.g., “Bumper sensor”)
- UUID: A unique identifier for the data source you can copy/paste for use in the CLI for instance.
- Action buttons: Edit (pencil icon) and Delete (trash icon) options in the top-right corner
Key Metrics
- Signals: The number of signals provided by this data source (e.g., 2)
- Used by systems: The number of systems using this data source (e.g., 8)
- Date: When the data source was created or last modified (e.g., “7 months ago”)
- Description: Additional textual information about the data source (if available)
Signals
The Signals section lists all signals provided by this data source, with details including:
- Name: The signal’s identifier (e.g., “camera”, “obstacle detection1”)
- Type: The data type of the signal (e.g., “STRING”)
- Unit: The measurement unit of the signal (if applicable)
You can expand or collapse the Signals section using the arrow icon on the right.
Navigation
The top of the details panel includes navigation arrows to move between data sources without returning to the main list view.