@@ -45,7 +45,7 @@ message Lane
4545 // Example: \c #type = \c #TYPE_DRIVING (see reference picture)
4646 //
4747 optional Type type = 1 ;
48-
48+
4949 // Indicates that the host vehicle travels on this particular lane.
5050 // The host vehicle may travel on more than one lane at once. This does
5151 // also apply for the \c CanditateLane in the \c DetectedLane .
@@ -54,56 +54,58 @@ message Lane
5454
5555 // The lane's center line (as a list of segments).
5656 //
57- // The center line describes the middle of the lane.
57+ // The center line describes the middle of the lane.
5858 //
5959 // \image html highway_exit.png "Center lines as yellow dotted lines."
6060 //
6161 // \attention The points describing the center line might be set at
62- // arbitrary distances. When the points are pairwise linearly connected, the
63- // lateral distance to the real ideal line (as used by the simulation
64- // environment internally) must not exceed 5cm. As shown in the following
65- // image:
66- //
67- // \image html line_approximation_error.png "Approximation error as green line."
68- //
69- // \note The center line is the line that a typical vehicle follows more or
70- // less (depending on the situation, a little more to the left or right of the
71- // center line). Thus, if the road narrows (e.g. at a construction site) this
72- // line is supposed to describe the trajectory that the vehicle should follow.
73- // Depending on the size of the vehicle, the vehicle may not be able to
74- // orient itself directly on the center line due to its dimensions, but
75- // may have to deviate from it in order to avoid e.g. a collision.
76- // The intended direction of travel on the lane is given by the
77- // direction defined by the sequence of points forming the center line.
62+ // arbitrary distances. When the points are pairwise linearly connected,
63+ // the lateral distance to the real ideal line (as used by the
64+ // simulation environment internally) must not exceed 5cm. As shown in
65+ // the following image:
66+ //
67+ // \image html line_approximation_error.png "Approximation error as
68+ // green line."
69+ //
70+ // \note The center line is the line that a typical vehicle follows more
71+ // or less (depending on the situation, a little more to the left or
72+ // right of the center line). Thus, if the road narrows (e.g. at a
73+ // construction site) this line is supposed to describe the trajectory
74+ // that the vehicle should follow. Depending on the size of the vehicle,
75+ // the vehicle may not be able to orient itself directly on the center
76+ // line due to its dimensions, but may have to deviate from it in order
77+ // to avoid e.g. a collision. The intended direction of travel on the
78+ // lane is given by the direction defined by the sequence of points
79+ // forming the center line.
7880 //
7981 // \note The \c #centerline is defined only for \c #type =
8082 // \c #TYPE_DRIVING and one \c #lane_pairing pair.
81- // \note Intersections and non-driving lanes do not have a center line.
82- // A vehicle must calculate this individually and depending on the
83+ // \note Intersections and non-driving lanes do not have a center line.
84+ // A vehicle must calculate this individually and depending on the
8385 // situation.
8486 //
8587 repeated Vector3d centerline = 3 ;
8688
8789 // Definition of the intended driving direction.
8890 //
8991 // Defined and used for driving lanes.
90- // true means driving direction is according to ascending storage order of
91- // center line points.
92- // false means driving direction is according to descending storage order of
93- // center line points.
92+ // true means driving direction is according to ascending storage order
93+ // of center line points. false means driving direction is according to
94+ // descending storage order of center line points.
9495 //
95- // \note The \c #centerline_is_driving_direction is defined for \c #type =
96- // \c #TYPE_DRIVING .
96+ // \note The \c #centerline_is_driving_direction is defined for \c #type
97+ // = \c #TYPE_DRIVING .
9798 //
9899 optional bool centerline_is_driving_direction = 4 ;
99100
100- // List of IDs of all lane segments that are directly adjacent to the lane
101- // on the left side (w.r.t. intended driving direction). Note that lengths
102- // of lane segments are not synchronized and therefore there are multiple
103- // adjacent segments if there is a split/merge point in the adjacent lane.
101+ // List of IDs of all lane segments that are directly adjacent to the
102+ // lane on the left side (w.r.t. intended driving direction). Note that
103+ // lengths of lane segments are not synchronized and therefore there are
104+ // multiple adjacent segments if there is a split/merge point in the
105+ // adjacent lane.
104106 //
105- // Example: The lane ID 2 is the only left adjacent lane for lane ID 3 in
106- // the reference picture.
107+ // Example: The lane ID 2 is the only left adjacent lane for lane ID 3
108+ // in the reference picture.
107109 //
108110 // \note The \c #left_adjacent_lane_id is undefined for \c #type =
109111 // \c #TYPE_INTERSECTION .
@@ -112,14 +114,14 @@ message Lane
112114 //
113115 repeated Identifier left_adjacent_lane_id = 5 ;
114116
115- // List of IDs of all lane segments that are directly adjacent to the lane
116- // on the right side (w.r.t. intended driving direction). Note that lengths
117- // of lane segments are not synchronized and therefore there are multiple
118- // adjacent segments if there is a split/merge point in the adjacent lane.
119- // Example: The lane IDs 4 and 7 are the right adjacent lane segments for
120- // lane ID 3 in the reference picture due to the lane split. Lane ID 6 is
121- // not a right adjacent lane to lane ID 3 as they are separated by lane ID
122- // 7.
117+ // List of IDs of all lane segments that are directly adjacent to the
118+ // lane on the right side (w.r.t. intended driving direction). Note that
119+ // lengths of lane segments are not synchronized and therefore there are
120+ // multiple adjacent segments if there is a split/merge point in the
121+ // adjacent lane. Example: The lane IDs 4 and 7 are the right adjacent
122+ // lane segments for lane ID 3 in the reference picture due to the lane
123+ // split. Lane ID 6 is not a right adjacent lane to lane ID 3 as they
124+ // are separated by lane ID 7.
123125 //
124126 // \note The \c #right_adjacent_lane_id is undefined for \c #type =
125127 // \c #TYPE_INTERSECTION .
@@ -129,20 +131,19 @@ message Lane
129131 repeated Identifier right_adjacent_lane_id = 6 ;
130132
131133 // The antecessor/successor lane pairings of this lane. There can be
132- // multiple pairings with the same antecessor and different successor lanes
133- // and vice versa.
134- // The antecessor lanes end in the same point that this lane starts from.
135- // The successor lanes start in the same point that this lane ends in.
136- // Example:
134+ // multiple pairings with the same antecessor and different successor
135+ // lanes and vice versa. The antecessor lanes end in the same point that
136+ // this lane starts from. The successor lanes start in the same point
137+ // that this lane ends in. Example:
137138 //
138139 // \note OSI uses singular instead of plural for repeated field names.
139140 //
140141 repeated LanePairing lane_pairing = 7 ;
141142
142- // The right adjacent lane boundaries \c #right_lane_boundary_id may only be
143- // shared with/as the left adjacent lane boundaries
144- // \c #left_lane_boundary_id of the nearest right adjacent lane
145- // \c #right_adjacent_lane_id.
143+ // The right adjacent lane boundaries \c #right_lane_boundary_id may
144+ // only be shared with/as the left adjacent lane boundaries \c
145+ // #left_lane_boundary_id of the nearest right adjacent lane \c
146+ // #right_adjacent_lane_id.
146147 //
147148 // \note Empty for intersections.
148149 //
@@ -153,10 +154,10 @@ message Lane
153154 //
154155 repeated Identifier right_lane_boundary_id = 8 ;
155156
156- // The left adjacent lane boundaries \c #left_lane_boundary_id may only be
157- // shared with/as the right adjacent lane boundaries
158- // \c #right_lane_boundary_id of the nearest left adjacent lane
159- // \c #left_adjacent_lane_id.
157+ // The left adjacent lane boundaries \c #left_lane_boundary_id may only
158+ // be shared with/as the right adjacent lane boundaries \c
159+ // #right_lane_boundary_id of the nearest left adjacent lane \c
160+ // #left_adjacent_lane_id.
160161 //
161162 // \note Empty for intersections.
162163 //
@@ -193,7 +194,8 @@ message Lane
193194 TYPE_OTHER = 1 ;
194195
195196 // A normal lane.
196- // Example: lanes with IDs 1, 2, 3, 4 and 7 of the highway_exit image.
197+ // Example: lanes with IDs 1, 2, 3, 4 and 7 of the highway_exit
198+ // image.
197199 //
198200 TYPE_DRIVING = 2 ;
199201
@@ -236,10 +238,10 @@ message Lane
236238 //
237239 optional double surface_ice = 4 ;
238240
239- // The coefficient representing the roughness or unevenness of the road.
240- // International Roughness Index (IRI) [1] values range from 0 = smooth
241- // ground (equivalent to driving on a plate of glass) up to > 20 mm/m
242- // (a very rough road).
241+ // The coefficient representing the roughness or unevenness of the
242+ // road. International Roughness Index (IRI) [1] values range from 0
243+ // = smooth ground (equivalent to driving on a plate of glass) up to
244+ // > 20 mm/m (a very rough road).
243245 //
244246 // Estimated value ranges (IRI):
245247 // 0.0 [mm/m] absolutely perfect evenness
@@ -274,9 +276,10 @@ message Lane
274276 // The surface texture or fine roughness
275277 //
276278 // Whereas the IRI-based roughness or unevenness measure only takes
277- // into account road wavelengths around 0.5m - 100m, the surface texture
278- // or fine roughness [2] measures only wavelengths below 0.5m.
279- // It is given as the standard height deviation of fine roughness
279+ // into account road wavelengths around 0.5m - 100m, the surface
280+ // texture or fine roughness [2] measures only wavelengths below
281+ // 0.5m. It is given as the standard height deviation of fine
282+ // roughness
280283 //
281284 // Unit: [m]
282285 //
@@ -324,13 +327,13 @@ message LaneBoundary
324327 // Since a \c BoundaryPoint is part of a sequence, only the position
325328 // attribute has to be set for each instance. All other values will be
326329 // reused from the previous \c BoundaryPoint in the sequence or set to
327- // default values if there is none or it was never set.
330+ // default values if there is none or it was never set.
328331 //
329332 // \note For dashed lines, one \c BoundaryPoint has to be at the start and
330- // another at the end of each dashed line segment. The first
333+ // another at the end of each dashed line segment. The first
331334 // \c BoundaryPoint defines the beginning of the first dashed lane marking.
332- // The last \c BoundaryPoint defines the end of the last dashed lane
333- // marking. For example, the area between the second and third
335+ // The last \c BoundaryPoint defines the end of the last dashed lane
336+ // marking. For example, the area between the second and third
334337 // \c BoundaryPoint has no lane marking, and so on.
335338 // \note For Botts' dots lines, one \c BoundaryPoint position has to define
336339 // each Botts' dot.
@@ -392,9 +395,9 @@ message LaneBoundary
392395 repeated Identifier limiting_structure_id = 3 ;
393396
394397 // The lane boundary type.
395- // There is no special representation for double lines, e.g. solid / solid
396- // or dashed / solid. In such cases, each lane will define its own side of
397- // the lane boundary.
398+ // There is no special representation for double lines, e.g. solid /
399+ // solid or dashed / solid. In such cases, each lane will define its own
400+ // side of the lane boundary.
398401 //
399402 enum Type
400403 {
@@ -460,21 +463,22 @@ message LaneBoundary
460463 }
461464
462465 // The color of the lane boundary in case of a lane markings.
463- // Lane markings that alternate in color must be represented by individual
464- // \c LaneBoundary segments.
466+ // Lane markings that alternate in color must be represented by
467+ // individual \c LaneBoundary segments.
465468 //
466469 enum Color
467470 {
468- // Color of marking is unknown. Value must not be used in ground truth.
471+ // Color of marking is unknown. Value must not be used in ground
472+ // truth.
469473 //
470474 COLOR_UNKNOWN = 0 ;
471475
472476 // Other (unspecified but known) color.
473477 //
474478 COLOR_OTHER = 1 ;
475479
476- // Marking without color. Used to represent logical boundaries without
477- // actual physical markings at the respective position.
480+ // Marking without color. Used to represent logical boundaries
481+ // without actual physical markings at the respective position.
478482 // Value may be used in ground truth only.
479483 //
480484 COLOR_NONE = 2 ;
0 commit comments