Vehicle Info Util

Purpose

This package is to get vehicle info parameters.

Description

In here, you can check the vehicle dimensions with more detail. The current format supports only the Ackermann model. This file defines the model assumed in autoware path planning, control, etc. and does not represent the exact physical model. If a model other than the Ackermann model is used, it is assumed that a vehicle interface will be designed to change the control output for the model.

Versioning Policy

We have implemented a versioning system for the vehicle_info.param.yaml file to ensure clarity and consistency in file format across different versions of Autoware and its external applications. Please see discussion for the details.

How to Operate

• The current file format is set as an unversioned base version (version: field is commented out).
• For the next update involving changes (such as additions, deletions, or modifications):
  • Uncomment and update the version line at the beginning of the file.
  • Initiate versioning by assigning a version number, starting from 0.1.0. Follow the semantic versioning format (MAJOR.MINOR.PATCH).
  • Update this Readme.md too.
• For subsequent updates, continue incrementing the version number in accordance with the changes made.
  • Discuss how to increment version depending on the amount of changes made to the file.

/**:
  ros__parameters:
    # version: 0.1.0 # Uncomment and update this line for future format changes.
    wheel_radius: 0.383
    ...

Why Versioning?

• Consistency Across Updates: Implementing version control will allow accurate tracking of changes over time and changes in vehicle information parameters.
• Clarity for External Applications: External applications that depend on vehicle_info.param.yaml need to reference the correct file version for optimal compatibility and functionality.
• Simplified Management for Customized Branches: Assigning versions directly to the vehicle_info.param.yaml file simplifies management compared to maintaining separate versions for multiple customized Autoware branches. This approach streamlines version tracking and reduces complexity.

Scripts

Minimum turning radius

$ ros2 run autoware_vehicle_info_utils min_turning_radius_calculator.py
yaml path is /home/autoware/pilot-auto/install/autoware_vehicle_info_utils/share/autoware_vehicle_info_utils/config/vehicle_info.param.yaml
Minimum turning radius is 3.253042620027102 [m] for rear, 4.253220695862465 [m] for front.

You can designate yaml file with -y option as follows.

ros2 run autoware_vehicle_info_utils min_turning_radius_calculator.py -y <path-to-yaml>

Assumptions / Known limits

TBD.

Changelog for package autoware_vehicle_info_utils

1.1.0 (2025-05-01)

• refactor(autoware_vehicle_info_utils): rewrite using modern C++ without API breakage (#343)
• Contributors: Yutaka Kondo

1.0.0 (2025-03-31)

• fix(autoware_vehicle_info_utils): test not linking to ament_index_cpp (#317)
• test(autoware_vehicle_info_utils): add tests for missed lines (#271) Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]\@users.noreply.github.com>
• Contributors: NorahXiong, Shane Loretz

0.3.0 (2025-03-21)

• chore: fix versions in package.xml
• feat(autoware_vehicle_info_utils): porting from universe to core (#183) Co-authored-by: Yutaka Kondo <<yutaka.kondo@youtalk.jp>>
• Contributors: NorahXiong, mitsudome-r