autoware_simple_object_merger#
This package can merge multiple topics of autoware_perception_msgs/msg/DetectedObject with low calculation cost.
Design#
Background#
Object_merger is mainly used for merge process with DetectedObjects. There are 2 characteristics in Object_merger. First, object_merger solve data association algorithm like Hungarian algorithm for matching problem, but it needs computational cost. Second, object_merger can handle only 2 DetectedObjects topics and cannot handle more than 2 topics in one node. To merge 6 DetectedObjects topics, 6 object_merger nodes need to stand for now.
Therefore, autoware_simple_object_merger aim to merge multiple DetectedObjects with low calculation cost.
The package do not use data association algorithm to reduce the computational cost, and it can handle more than 2 topics in one node to prevent launching a large number of nodes.
Use case#
- Multiple radar detection
autoware_simple_object_merger can be used for multiple radar detection. By combining them into one topic from multiple radar topics, the pipeline for faraway detection with radar can be simpler.
Limitation#
- Sensor data drops and delay
Merged objects will not be published until all topic data is received when initializing. In addition, to care sensor data drops and delayed, this package has a parameter to judge timeout. When the latest time of the data of a topic is older than the timeout parameter, it is not merged for output objects. For now specification of this package, if all topic data is received at first and after that the data drops, and the merged objects are published without objects which is judged as timeout.The timeout parameter should be determined by sensor cycle time.
- Post-processing
Because this package does not have matching processing, there are overlapping objects depending on the input objects. So output objects can be used only when post-processing is used. For now, clustering processing can be used as post-processing.
Interface#
Input#
Input topics is defined by the parameter of input_topics (List[string]). The type of input topics is std::vector<autoware_perception_msgs/msg/DetectedObjects.msg>.
Output#
~/output/objects(autoware_perception_msgs/msg/DetectedObjects.msg)- Merged objects combined from input topics.
Parameters#
| Name | Type | Description | Default | Range |
|---|---|---|---|---|
| update_rate_hz | float | This parameter defines the update rate for the onTimer function. This value should match the frame rate of the input topics. |
20.0 | N/A |
| new_frame_id | string | This parameter specifies the header frame_id for the output topic. If the output topics are used for a perception module, this should be set to base_link. |
base_link | N/A |
| timeout_threshold | float | This parameter sets the threshold for timeout judgment. If the time difference between the first topic in input_topics and another input topic exceeds this value, the objects in that topic are not merged into the output objects. |
1.0 | N/A |
| input_topics | array | This parameter lists the names of input topics. For example, when this package is used for radar objects, input topics can be specified here. | [''] | N/A |