osi3::MovingObject::VehicleAttributes Struct Reference

The vehicle attributes for MovingObject (host or other). More...

Collaboration diagram for osi3::MovingObject::VehicleAttributes:

Classes

struct  WheelData
 Detailed wheel data. More...
 

Public Attributes

optional Identifier driver_id = 1
 The ID of the driver of the (host) vehicle. More...
 
optional double radius_wheel = 2
 Deprecated: Will be removed in next major release. More...
 
optional uint32 number_wheels = 3
 Number of independent wheels. More...
 
optional Vector3d bbcenter_to_rear = 4
 The vector pointing from the bounding box center point (MovingObject::base . More...
 
optional Vector3d bbcenter_to_front = 5
 The vector pointing from the bounding box center point (MovingObject::base . More...
 
optional double ground_clearance = 6
 Static minimal distance or space from the lowest point of the vehicle's body to the surface plane below it under neutral load conditions. More...
 
repeated WheelData wheel_data = 7
 Description of each wheel. More...
 
optional double steering_wheel_angle = 8
 Angle of the steering wheel. More...
 

Detailed Description

The vehicle attributes for MovingObject (host or other).

This is an extension to the MovingObject with additional attributes, such as type and lights. The origin of the rear (front) axis coordinate system in global coordinates is calculated as: MovingObject::base . BaseMoving::position + R * MovingObject::VehicleAttributes::bbcenter_to_rear (front) for the host vehicle (R rotates from vehicle to world frame, i.e. inverse orientation of MovingObject::base . BaseMoving::orientation).

For all vehicles, including host vehicles, the position given in MovingObject::base . BaseMoving::position points to the center of the vehicle's bounding box.

The vehicle object coordinates are defined as x-axis is the direction from rear to front of the vehicle, y-axis corresponds to rear axle and z-axis points to vehicle ceiling [1]. The coordinate system is right-handed. Therefore the positive y-axis points to the left of the vehicle.

Reference:
[1] DIN Deutsches Institut fuer Normung e. V. (2013). DIN ISO 8855 Strassenfahrzeuge - Fahrzeugdynamik und Fahrverhalten - Begriffe. (DIN ISO 8855:2013-11). Berlin, Germany.

Member Data Documentation

◆ driver_id

optional Identifier osi3::MovingObject::VehicleAttributes::driver_id = 1

The ID of the driver of the (host) vehicle.

Note
Field need not be set if host_vehicle is set to false or use value for non valid id.

◆ radius_wheel

optional double osi3::MovingObject::VehicleAttributes::radius_wheel = 2

Deprecated: Will be removed in next major release.

Moved to WheelData. Median radius of the wheels measured from a center of the wheel including tire.

Unit: m

Rules
is_greater_than_or_equal_to: 0

◆ number_wheels

optional uint32 osi3::MovingObject::VehicleAttributes::number_wheels = 3

Number of independent wheels.

Rules
is_greater_than_or_equal_to: 1

◆ bbcenter_to_rear

optional Vector3d osi3::MovingObject::VehicleAttributes::bbcenter_to_rear = 4

The vector pointing from the bounding box center point (MovingObject::base .

BaseMoving::position) to the middle (in x, y and z) of the rear axle under neutral load conditions. In object coordinates.

◆ bbcenter_to_front

optional Vector3d osi3::MovingObject::VehicleAttributes::bbcenter_to_front = 5

The vector pointing from the bounding box center point (MovingObject::base .

BaseMoving::position) to the middle (in x, y and z) of the front axle under neutral load conditions. In object coordinates.

◆ ground_clearance

optional double osi3::MovingObject::VehicleAttributes::ground_clearance = 6

Static minimal distance or space from the lowest point of the vehicle's body to the surface plane below it under neutral load conditions.

This distance disregards, for example, driving-dynamic effects or road-surface effects. Can be useful to approximate the clearance area under a vehicle that a sensor can see through.

Note
ground_clearance is included in the bounding box height.

◆ wheel_data

repeated WheelData osi3::MovingObject::VehicleAttributes::wheel_data = 7

Description of each wheel.

Note
OSI uses singular instead of plural for repeated field names.

◆ steering_wheel_angle

optional double osi3::MovingObject::VehicleAttributes::steering_wheel_angle = 8

Angle of the steering wheel.

Zero means the steering wheel is in its center position, a positive value means the steering wheel is turned to the left and a negative value means the steering wheel is turned to the right of the center position.

Unit: rad


  • osi_object.proto