feat: New OSI message osi_route

The new message allows sending route information to a traffic
agent in the simulation. The route information can then be used by the
agent to traverse the road network.

Signed-off-by: Fabian Pfeuffer <[email protected]>

Author: Fabian Pfeuffer

CMakeLists.txt

@@ -83,6 +83,7 @@ set(OSI_PROTO_FILES
     osi_trafficcommand.proto
     osi_referenceline.proto
     osi_roadmarking.proto
+    osi_route.proto
     osi_lane.proto
     osi_logicallane.proto
     osi_featuredata.proto

doc/images/OSI_Planned_Route.png

@@ -4,6 +4,7 @@ option optimize_for = SPEED;
 
 import "osi_version.proto";
 import "osi_common.proto";
+import "osi_route.proto";
 
 package osi3;
 
@@ -87,6 +88,10 @@ message HostVehicleData
     //
     repeated VehicleAutomatedDrivingFunction vehicle_automated_driving_function = 12;
 
+    // Route that should be used by the host vehicle
+    //
+    optional Route route = 13;
+
     //
     // \brief Base parameters and overall states of the vehicle.
     //

doc/images/OSI_Road_Segment.png

@@ -0,0 +1,106 @@
+syntax = "proto3";
+
+option optimize_for = SPEED;
+
+import "osi_common.proto";
+
+package osi3;
+
+//
+// \brief A route in the road network
+//
+// A route is a planned or suggested path for an agent to travel from one location
+// to another within the road network. It is composed of a list of road segments,
+// which form a continuous path through the road network and should be traversed
+// in the order they are listed.
+//
+// ## Example
+//
+// The example below shows the \link Route route\endlink of a vehicle.
+//
+// \image html OSI_Planned_Route.png "Route" width=850px
+//
+// The route is composed of three \link RoadSegment road segments\endlink RS1-3,
+// each indicated by a yellow outline. Two of the road segments
+// (RS2 and RS3) only contain a single \link LogicalLaneSegment logical lane segment\endlink
+// (highlighted in blue), while RS1 is composed of three
+// logical lane segments (green, blue and red).
+//
+message Route
+{
+
+    // Road segments that form the planned route of an agent.
+    //
+    // Consecutive segments should be connected without gaps, meaning that the
+    // two of them should form a continuous area.
+    //
+    repeated RoadSegment planned_route = 1;
+
+    //
+    // \brief A segment of a logical lane.
+    //
+    message LogicalLaneSegment
+    {
+        // The ID of the logical lane this segment belongs to.
+        //
+        // \rules
+        // refers_to: LogicalLane
+        // \endrules
+        //
+        optional Identifier logical_lane_id = 1;
+
+        // S position on the logical lane where the segment starts.
+        //
+        optional double start_s = 2;
+
+        // S position on the logical lane where the segment ends.
+        //
+        optional double end_s = 3;
+    }
+
+    //
+    // \brief A segment of a road.
+    //
+    // A road segment describes a segment of a road by listing the lanes that are
+    // in there. In general, only lanes should be listed that are parallel to each
+    // other, though some may have different lenghts (e.g. if a lane widening
+    // occurs, the newly appearing lane will have a shorter length).
+    //
+    // Typically a road segment will be either
+    // - a set of lanes between two junctions, or
+    // - parallel lanes on an intersection with the same driving direction
+    //
+    // ## Example
+    //
+    // Consider the \link RoadSegment road segment\endlink between two intersections,
+    // shown in the image below.
+    //
+    // \image html OSI_Road_Segment.png "RoadSegment" width=850px
+    //
+    // In the example, a single road segment RS with three
+    // \link LogicalLaneSegment logical lane segments\endlink LL1, LL2 and LL3 is
+    // shown. The segments are indicated by the green, blue and red highlighted areas,
+    // one for each underlying logical lane The starting
+    // s-position of each segment is indicated by the yellow dotted line and the s- prefix
+    // (note that the start of LL2 lies further to the left, outside of the image),
+    // while the ending s-position of all segments is shown by the yellow dotted line e-RS.
+    //
+    // As it can be seen in the example, all logical lane segments are parallel,
+    // but two of them are opening at a later position, so their starting
+    // s-positions will be different.
+    //
+    message RoadSegment
+    {
+
+        // Logical lane segments that form a road segment.
+        //
+        // The logical lane segments of a road segment should be connected without
+        // gaps, meaning that, together, the lane segments should form a
+        // continous area.
+        //
+        repeated LogicalLaneSegment lane_segment = 1;
+
+    }
+
+
+}

osi_hostvehicledata.proto

@@ -64,6 +64,7 @@ def find_protoc():
         'osi_occupant.proto',
         'osi_referenceline.proto',
         'osi_roadmarking.proto',
+        'osi_route.proto',
         'osi_sensordata.proto',
         'osi_sensorspecific.proto',
         'osi_sensorview.proto',