From 9dfca093ef6407fa3f785e8e37f031e1ce6c66dc Mon Sep 17 00:00:00 2001 From: Zulfaqar Azmi <93502286+zulfaqar-azmi-t4@users.noreply.github.com> Date: Tue, 28 May 2024 19:09:09 +0900 Subject: [PATCH] docs(planning_test_utils): update purpose of the package and add lanelet map images (#7077) * docs(planning_test_utils): Add explanation Signed-off-by: Muhammad Zulfaqar Azmi * remove autoware prefix from autoware planning test manager Signed-off-by: Muhammad Zulfaqar Azmi * fix document Signed-off-by: Muhammad Zulfaqar Azmi * remove implemented test part Signed-off-by: Muhammad Zulfaqar Azmi --------- Signed-off-by: Muhammad Zulfaqar Azmi --- planning/.pages | 1 + .../autoware_planning_test_manager/README.md | 2 +- planning/planning_test_utils/README.md | 92 +--- .../planning_test_utils/images/2km-test.png | Bin 0 -> 5585 bytes .../planning_test_utils/images/2km-test.svg | 505 ++++++++++++++++++ .../planning_test_utils/images/common.png | Bin 0 -> 54710 bytes 6 files changed, 527 insertions(+), 73 deletions(-) create mode 100644 planning/planning_test_utils/images/2km-test.png create mode 100644 planning/planning_test_utils/images/2km-test.svg create mode 100644 planning/planning_test_utils/images/common.png diff --git a/planning/.pages b/planning/.pages index e355639eb8da5..28a791801b805 100644 --- a/planning/.pages +++ b/planning/.pages @@ -80,5 +80,6 @@ nav: - 'About Planning Debug Tools': https://github.com/autowarefoundation/autoware_tools/tree/main/planning/planning_debug_tools - 'Stop Reason Visualizer': https://github.com/autowarefoundation/autoware_tools/blob/main/planning/planning_debug_tools/doc-stop-reason-visualizer.md - 'Planning Test Utils': planning/planning_test_utils + - 'Planning Test Manager': planning/autoware_planning_test_manager - 'Planning Topic Converter': planning/planning_topic_converter - 'Planning Validator': planning/planning_validator diff --git a/planning/autoware_planning_test_manager/README.md b/planning/autoware_planning_test_manager/README.md index 63f1bf53a4954..b72625be999dd 100644 --- a/planning/autoware_planning_test_manager/README.md +++ b/planning/autoware_planning_test_manager/README.md @@ -1,4 +1,4 @@ -# Planning Interface Test Manager +# Autoware Planning Test Manager ## Background diff --git a/planning/planning_test_utils/README.md b/planning/planning_test_utils/README.md index b72625be999dd..c064e5791a487 100644 --- a/planning/planning_test_utils/README.md +++ b/planning/planning_test_utils/README.md @@ -1,92 +1,40 @@ -# Autoware Planning Test Manager +# Test Utils ## Background -In each node of the planning module, when exceptional input, such as unusual routes or significantly deviated ego-position, is given, the node may not be prepared for such input and could crash. As a result, debugging node crashes can be time-consuming. For example, if an empty trajectory is given as input and it was not anticipated during implementation, the node might crash due to the unaddressed exceptional input when changes are merged, during scenario testing or while the system is running on an actual vehicle. +Several Autoware's components and modules have already adopted unit testing, so a common library to ease the process of writing unit tests is necessary. ## Purpose -The purpose is to provide a utility for implementing tests to ensure that node operates correctly when receiving exceptional input. By utilizing this utility and implementing tests for exceptional input, the purpose is to reduce bugs that are only discovered when actually running the system, by requiring measures for exceptional input before merging PRs. +The objective of the `test_utils` is to develop a unit testing library for the Autoware components. This library will include -## Features +- commonly used functions +- input/mock data parser +- maps for testing +- common routes and mock data for testing. -### Confirmation of normal operation +## Available Maps -For the test target node, confirm that the node operates correctly and publishes the required messages for subsequent nodes. To do this, test_node publish the necessary messages and confirm that the node's output is being published. +The following maps are available [here](https://github.com/autowarefoundation/autoware.universe/tree/main/planning/planning_test_utils/test_map) -### Robustness confirmation for special inputs +### Common -After confirming normal operation, ensure that the test target node does not crash when given exceptional input. To do this, provide exceptional input from the test_node and confirm that the node does not crash. +The common map contains multiple types of usable inputs, including shoulder lanes, intersections, and some regulatory elements. The common map is named `lanelet2_map.osm` in the folder. -(WIP) +![common](./images/common.png) -## Usage +### 2 km Straight -```cpp +The 2 km straight lanelet map consists of two lanes that run in the same direction. The map is named `2km_test.osm`. -TEST(PlanningModuleInterfaceTest, NodeTestWithExceptionTrajectory) -{ - rclcpp::init(0, nullptr); +![two_km](./images/2km-test.png) - // instantiate test_manager with PlanningInterfaceTestManager type - auto test_manager = std::make_shared(); +The following illustrates the design of the map. - // get package directories for necessary configuration files - const auto planning_test_utils_dir = - ament_index_cpp::get_package_share_directory("planning_test_utils"); - const auto target_node_dir = - ament_index_cpp::get_package_share_directory("target_node"); +![straight_diagram](./images/2km-test.svg) - // set arguments to get the config file - node_options.arguments( - {"--ros-args", "--params-file", - planning_test_utils_dir + "/config/test_vehicle_info.param.yaml", "--params-file", - planning_validator_dir + "/config/planning_validator.param.yaml"}); +## Example use cases - // instantiate the TargetNode with node_options - auto test_target_node = std::make_shared(node_options); +### Autoware Planning Test Manager - // publish the necessary topics from test_manager second argument is topic name - test_manager->publishOdometry(test_target_node, "/localization/kinematic_state"); - test_manager->publishMaxVelocity( - test_target_node, "motion_velocity_smoother/input/external_velocity_limit_mps"); - - // set scenario_selector's input topic name(this topic is changed to test node) - test_manager->setTrajectoryInputTopicName("input/parking/trajectory"); - - // test with normal trajectory - ASSERT_NO_THROW(test_manager->testWithNominalTrajectory(test_target_node)); - - // make sure target_node is running - EXPECT_GE(test_manager->getReceivedTopicNum(), 1); - - // test with trajectory input with empty/one point/overlapping point - ASSERT_NO_THROW(test_manager->testWithAbnormalTrajectory(test_target_node)); - - // shutdown ROS context - rclcpp::shutdown(); -} -``` - -## Implemented tests - -| Node | Test name | exceptional input | output | Exceptional input pattern | -| -------------------------- | ----------------------------------------------------------------------------------------- | ----------------- | -------------- | ------------------------------------------------------------------------------------- | -| planning_validator | NodeTestWithExceptionTrajectory | trajectory | trajectory | Empty, single point, path with duplicate points | -| motion_velocity_smoother | NodeTestWithExceptionTrajectory | trajectory | trajectory | Empty, single point, path with duplicate points | -| obstacle_cruise_planner | NodeTestWithExceptionTrajectory | trajectory | trajectory | Empty, single point, path with duplicate points | -| obstacle_stop_planner | NodeTestWithExceptionTrajectory | trajectory | trajectory | Empty, single point, path with duplicate points | -| obstacle_velocity_limiter | NodeTestWithExceptionTrajectory | trajectory | trajectory | Empty, single point, path with duplicate points | -| obstacle_avoidance_planner | NodeTestWithExceptionTrajectory | trajectory | trajectory | Empty, single point, path with duplicate points | -| scenario_selector | NodeTestWithExceptionTrajectoryLaneDrivingMode NodeTestWithExceptionTrajectoryParkingMode | trajectory | scenario | Empty, single point, path with duplicate points for scenarios:LANEDRIVING and PARKING | -| freespace_planner | NodeTestWithExceptionRoute | route | trajectory | Empty route | -| behavior_path_planner | NodeTestWithExceptionRoute NodeTestWithOffTrackEgoPose | route | route odometry | Empty route Off-lane ego-position | -| behavior_velocity_planner | NodeTestWithExceptionPathWithLaneID | path_with_lane_id | path | Empty path | - -## Important Notes - -During test execution, when launching a node, parameters are loaded from the parameter file within each package. Therefore, when adding parameters, it is necessary to add the required parameters to the parameter file in the target node package. This is to prevent the node from being unable to launch if there are missing parameters when retrieving them from the parameter file during node launch. - -## Future extensions / Unimplemented parts - -(WIP) +The goal of the [Autoware Planning Test Manager](https://autowarefoundation.github.io/autoware.universe/main/planning/autoware_planning_test_manager/) is to test planning module nodes. The `PlanningInterfaceTestManager` class ([source code](https://github.com/autowarefoundation/autoware.universe/blob/main/planning/autoware_planning_test_manager/src/autoware_planning_test_manager.cpp)) creates wrapper functions based on the `test_utils` functions. diff --git a/planning/planning_test_utils/images/2km-test.png b/planning/planning_test_utils/images/2km-test.png new file mode 100644 index 0000000000000000000000000000000000000000..297dc5a43865ea0d71a04be8bd19bed6ef102cfe GIT binary patch literal 5585 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 + + + + + + + + + + + + + + + + + +
+
+
+ 25.0 meter +
+
+
+
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ 3.5 meter +
+
+
+
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ 2000.0 meter +
+
+
+
+ +
+
+
+ + + + + + + + + +
+
+
+ 1.75 meter +
+
+
+
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + +
+
+
+ pose +
+ (0.0, 0.0) +
+
+
+
+
+
+ +
+
+
+ + + + + + + + + +
+
+
+ 1000.0 meter +
+
+
+
+ +
+
+
+ + + + + + + + + + + + +
+
+
+ 7.0 meter +
+
+
+
+ +
+
+
+ + + + + + + + + +
+
+
+ 25.0 meter +
+
+
+
+ +
+
+
+ + + + + + + + + +
+
+
+ 25.0 meter +
+
+
+
+ +
+
+
+ + + + + + + +
+
+
+ pose +
+ (1000.0, -3.5) +
+
+
+
+
+
+ +
+
+
+ + + + + + + + + + + + + + + +
+
+
+ pose +
+ (1000.0, 3.5) +
+
+
+
+
+
+ +
+
+
+ + + + + + + + + + + + + + + +
+
+
+ pose +
+ (-1000.0, 3.5) +
+
+
+
+
+
+ +
+
+
+
+
diff --git a/planning/planning_test_utils/images/common.png b/planning/planning_test_utils/images/common.png new file mode 100644 index 0000000000000000000000000000000000000000..340437b53c0f59ac418f47e4819b6b2a451db0fa GIT binary patch literal 54710 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 EFEHc!>;M1& literal 0 HcmV?d00001