Skip to content

Commit 8cdb924

Browse files
Update Format (Clang)
1 parent 1802967 commit 8cdb924

File tree

1 file changed

+77
-73
lines changed

1 file changed

+77
-73
lines changed

osi_lane.proto

Lines changed: 77 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)