From f290a0f2e756691dee8e5f80256a0cae594988a1 Mon Sep 17 00:00:00 2001
From: Shunsuke Miura <shunsuke.miura@tier4.jp>
Date: Mon, 8 Jul 2024 15:21:34 +0900
Subject: [PATCH] chore: refactored launch options

Signed-off-by: Shunsuke Miura <shunsuke.miura@tier4.jp>
---
 .../tier4_perception_component.launch.xml     | 48 ++++++++++++++-----
 1 file changed, 37 insertions(+), 11 deletions(-)

diff --git a/autoware_launch/launch/components/tier4_perception_component.launch.xml b/autoware_launch/launch/components/tier4_perception_component.launch.xml
index e13b987607..f862cc88e7 100644
--- a/autoware_launch/launch/components/tier4_perception_component.launch.xml
+++ b/autoware_launch/launch/components/tier4_perception_component.launch.xml
@@ -1,5 +1,11 @@
 <?xml version="1.0"?>
 <launch>
+  <arg
+    name="use_empty_dynamic_object_publisher"
+    default="false"
+    description="if use_empty_dynamic_object_publisher:=true, /perception/object_recognition/objects topic has an empty DynamicObjectArray"
+  />
+  <arg name="use_traffic_light_recognition" default="true" description="use traffic light recognition module, if false, traffic light recognition module will not be launched"/>
   <arg
     name="occupancy_grid_map_method"
     default="pointcloud_based_occupancy_grid_map"
@@ -15,17 +21,42 @@
   <arg name="data_path" default="$(env HOME)/autoware_data" description="packages data and artifacts directory path"/>
 
   <include file="$(find-pkg-share tier4_perception_launch)/launch/perception.launch.xml">
+    <!-- Options to Switch Launch Function -->
     <arg name="mode" value="$(var perception_mode)"/>
     <arg name="vehicle_param_file" value="$(find-pkg-share $(var vehicle_model)_description)/config/vehicle_info.param.yaml"/>
+    <arg name="data_path" value="$(var data_path)"/>
+
     <arg name="pointcloud_container_name" value="$(var pointcloud_container_name)"/>
     <arg name="occupancy_grid_map_method" value="$(var occupancy_grid_map_method)"/>
     <arg name="occupancy_grid_map_updater" value="$(var occupancy_grid_map_updater)"/>
+
+    <arg
+      name="use_empty_dynamic_object_publisher"
+      value="$(var use_empty_dynamic_object_publisher)"
+      description="if use_empty_dynamic_object_publisher:=true, /perception/object_recognition/objects topic will contain an empty DynamicObjectArray, and the object recognition modules will not be launched."
+    />
+    <arg name="use_low_height_cropbox" default="true" description="use low height crop filter in clustering"/>
+    <arg name="use_vector_map" default="true" description="use vector map in prediction"/>
+    <arg name="use_pointcloud_map" default="true" description="use pointcloud map in detection"/>
+    <arg name="use_roi_based_cluster" default="true" description="launch roi_based_cluster in clustering"/>
+    <arg name="use_low_intensity_cluster_filter" default="true" description="launch low_intensity_cluster_filter in clustering"/>
+    <arg name="use_perception_online_evaluator" default="false" description="launch perception online evaluator"/>
+    <arg name="use_detection_by_tracker" default="true" description="launch detection_by_tracker function"/>
+    <arg
+      name="use_radar_tracking_fusion"
+      default="true"
+      description="if use_radar_tracking_fusion:=true, radar information is merged in tracking module. Otherwise, radar information is merged in detection module."
+    />
+    <arg name="use_object_filter" default="true" description="launch object filter to filter-out detected object"/>
     <arg name="objects_filter_method" value="$(var detected_objects_filter_method)"/>
     <arg name="objects_validation_method" value="$(var detected_objects_validation_method)"/>
-    <arg name="data_path" value="$(var data_path)"/>
-    <arg name="use_low_height_cropbox" value="false"/>
 
-    <!-- object recognition -->
+    <arg name="use_traffic_light_recognition" value="$(var use_traffic_light_recognition)" description="launch traffic light recognition module"/>
+    <arg name="traffic_light_recognition/enable_fine_detection" value="$(var traffic_light_recognition/enable_fine_detection)"/>
+    <arg name="traffic_light_recognition/fusion_only" value="false"/>
+    <arg name="traffic_light_image_number" value="2"/>
+
+    <!-- object recognition parameters -->
     <arg
       name="object_recognition_detection_euclidean_cluster_param_path"
       value="$(find-pkg-share autoware_launch)/config/perception/object_recognition/detection/clustering/euclidean_cluster.param.yaml"
@@ -145,7 +176,7 @@
       value="$(find-pkg-share autoware_launch)/config/perception/object_recognition/tracking/tracking_object_merger/decorative_tracker_merger.param.yaml"
     />
 
-    <!-- obstacle segmentation -->
+    <!-- obstacle segmentation parameters -->
     <arg
       name="obstacle_segmentation_ground_segmentation_param_path"
       value="$(find-pkg-share autoware_launch)/config/perception/obstacle_segmentation/ground_segmentation/ground_segmentation.param.yaml"
@@ -155,16 +186,11 @@
       value="$(find-pkg-share autoware_launch)/config/perception/obstacle_segmentation/ground_segmentation/elevation_map_parameters.yaml"
     />
 
-    <!-- occupancy grid map -->
+    <!-- occupancy grid map parameters -->
     <arg name="occupancy_grid_map_param_path" value="$(find-pkg-share autoware_launch)/config/perception/occupancy_grid_map/$(var occupancy_grid_map_method).param.yaml"/>
     <arg name="occupancy_grid_map_updater_param_path" value="$(find-pkg-share autoware_launch)/config/perception/occupancy_grid_map/$(var occupancy_grid_map_updater)_updater.param.yaml"/>
 
-    <!-- traffic light recognition -->
-    <arg name="use_traffic_light_recognition" value="true"/>
-    <arg name="traffic_light_recognition/enable_fine_detection" value="$(var traffic_light_recognition/enable_fine_detection)"/>
-    <arg name="traffic_light_recognition/fusion_only" value="false"/>
-    <arg name="traffic_light_image_number" value="1"/>
-
+    <!-- traffic light recognition parameters -->
     <arg name="traffic_light_arbiter_param_path" value="$(find-pkg-share autoware_launch)/config/perception/traffic_light_arbiter/traffic_light_arbiter.param.yaml"/>
     <arg name="traffic_light_fine_detector_model_path" value="$(var data_path)/traffic_light_fine_detector"/>
     <arg name="traffic_light_fine_detector_model_name" value="tlr_car_ped_yolox_s_batch_6"/>