Classification of a lane. More...

Collaboration diagram for osi3::Lane::Classification:

[legend]

Classes
struct	LanePairing
	The lane ID pairings of antecessor and successor lanes. More...

struct	RoadCondition
	The condition of the road surface. More...

Public Types
enum	Type { TYPE_UNKNOWN = 0 , TYPE_OTHER = 1 , TYPE_DRIVING = 2 , TYPE_NONDRIVING = 3 , TYPE_INTERSECTION = 4 }

enum	Subtype { SUBTYPE_UNKNOWN = 0 , SUBTYPE_OTHER = 1 , SUBTYPE_NORMAL = 2 , SUBTYPE_BIKING = 3 , SUBTYPE_SIDEWALK = 4 , SUBTYPE_PARKING = 5 , SUBTYPE_STOP = 6 , SUBTYPE_RESTRICTED = 7 , SUBTYPE_BORDER = 8 , SUBTYPE_SHOULDER = 9 , SUBTYPE_EXIT = 10 , SUBTYPE_ENTRY = 11 , SUBTYPE_ONRAMP = 12 , SUBTYPE_OFFRAMP = 13 , SUBTYPE_CONNECTINGRAMP = 14 }

Public Attributes
optional Type	type = 1

optional bool	is_host_vehicle_lane = 2

repeated Vector3d	centerline = 3

optional bool	centerline_is_driving_direction = 4

repeated Identifier	left_adjacent_lane_id = 5

repeated Identifier	right_adjacent_lane_id = 6

repeated LanePairing	lane_pairing = 7

repeated Identifier	right_lane_boundary_id = 8

repeated Identifier	left_lane_boundary_id = 9

repeated Identifier	free_lane_boundary_id = 10

optional RoadCondition	road_condition = 11

optional Subtype	subtype = 12

Detailed Description

Classification of a lane.

HighwayExit

Classification for lane l4 in image HighwayExit:

type = TYPE_DRIVING

centerline = (cl4_1, cl4_2, cl4_3, cl4_4, cl4_5)

centerline_is_driving_direction = true

is_host_vehicle_lane = true

left_adjacent_lane_id = l3

right_adjacent_lane_id = (l5,l6)

left_lane_boundary_id = lb5

right_lane_boundary_id = (lb9, lb6)

Intersection

`Classification` for lane l7 in image Intersection:
`type` = `TYPE_INTERSECTION`
`is_host_vehicle_lane` = `false`
`free_lane_boundary_id` = lb11
<border = 0>
`lane_pairing` = (	(l2,l1), (l2,l3), (l2,l5),
	(l4,l1), (l4,l3), (l4,l5),
	(l6,l1), (l6,l3), (l6,l5) )

Note: In the examples, the symbols l1, l2, ... and lb1, lb2, ... stand for the lane ids and lane boundary ids respectively, i.e. for integers (uint64). The symbols cl1, cl2, ... represent the osi3::Lane::Classification::centerline elements of the lanes with the respective ids. The symbols cl1_1, cl1_2, ... stand for osi3::Vector3d elements.

Member Enumeration Documentation

◆ Subtype

enum osi3::Lane::Classification::Subtype

Definition of available lane subtypes, aligned with OpenDRIVE.

Enumerator
SUBTYPE_UNKNOWN	Lane of unknown subtype. Do not use in ground truth.
SUBTYPE_OTHER	Any other subtype of lane.
SUBTYPE_NORMAL	A normal driving lane. Example: Lanes with IDs l1, l2, l3 and l4 in image HighwayExit. Since it is intended to be used for normal automotive driving, it should be used in combination with TYPE_DRIVING.
SUBTYPE_BIKING	A lane that is designated for bicylists. Since it is not intended to be used for normal automotive driving, it should be used in combination with TYPE_NONDRIVING.
SUBTYPE_SIDEWALK	A lane that is designated for pedestrians (sidewalk). Since it is not intended to be used for normal automotive driving, it should be used in combination with TYPE_NONDRIVING.
SUBTYPE_PARKING	A lane with parking spaces. Since it is not intended to be used for normal automotive driving, it should be used in combination with TYPE_NONDRIVING.
SUBTYPE_STOP	A hard shoulder on motorways for emergency stops. Example: Lane l5 in image HighwayExit. Since it is not intended to be used for normal automotive driving, it should be used in combination with TYPE_NONDRIVING.
SUBTYPE_RESTRICTED	A lane on which cars should not drive. Since it is not intended to be used for normal automotive driving, it should be used in combination with TYPE_NONDRIVING.
SUBTYPE_BORDER	A hard border on the edge of a road. Since it is not intended to be used for normal automotive driving, it should be used in combination with TYPE_NONDRIVING.
SUBTYPE_SHOULDER	A soft border on the edge of a road. Since it is not intended to be used for normal automotive driving, it should be used in combination with TYPE_NONDRIVING.
SUBTYPE_EXIT	A deceleration lane in parallel to the main road. Example: Lane l6 in image HighwayExit. Since it is intended to be used for normal automotive driving, it should be used in combination with TYPE_DRIVING.
SUBTYPE_ENTRY	An acceleration lane in parallel to the main road. Since it is intended to be used for normal automotive driving, it should be used in combination with TYPE_DRIVING.
SUBTYPE_ONRAMP	A ramp from rural or urban roads joining a motorway. Since it is intended to be used for normal automotive driving, it should be used in combination with TYPE_DRIVING.
SUBTYPE_OFFRAMP	A ramp leading off a motorway onto rural or urban roads. Since it is intended to be used for normal automotive driving, it should be used in combination with TYPE_DRIVING.
SUBTYPE_CONNECTINGRAMP	A ramp that connect two motorways. Since it is intended to be used for normal automotive driving, it should be used in combination with TYPE_DRIVING.

◆ Type

enum osi3::Lane::Classification::Type

Definition of available lane types.

Enumerator
TYPE_UNKNOWN	Lane of unknown type (must not be used in ground truth).
TYPE_OTHER	Any other type of lane.
TYPE_DRIVING	A normal lane. Example: Lanes with IDs l1, l2, l3, l4 and l6 in image HighwayExit.
TYPE_NONDRIVING	A road where driving is normally not permitted. Example: Lane with ID l5 in image HighwayExit.
TYPE_INTERSECTION	An intersection as a lane. Example: Lane with ID l7 in image Intersection.

Member Data Documentation

◆ centerline

repeated Vector3d osi3::Lane::Classification::centerline = 3

The lane's center line (as a list of segments).

The centerline describes the middle of the lane.

Centerline

Example: In image HighwayExit, the centerline of lane l4 (black line) is given by (cl4_1, cl4_2, cl4_3, cl4_4, cl4_5).

Centerline

Note: cl: center line lb: lane boundary

Attention: The points desribing the center line must be set in the same ordering (ascending or descending) as the points desribing the lane boundaries. Example: If the points are deducted from a map format, the order of points is recommended to be in line with the road coordinate (e.g. s-coordinate in OpenDRIVE).; The points describing the center line might be set at arbitrary distances. When the points are pairwise linearly connected, the lateral distance to the real ideal line (as used by the simulation environment internally) must not exceed 5cm. As shown in the following image:

Approximation error

Approximation error green line.

Note: The center line is the line that a typical vehicle follows more or less (depending on the situation, a little more to the left or right of the center line). The intended direction of travel on the lane is given by the direction defined by the sequence of points forming the centerline w.r.t. centerline_is_driving_direction.; The centerline is defined only for type = TYPE_DRIVING and if exactly one or no lane_pairing pair exists.; Intersections and non-driving lanes do not have a center line. A vehicle must calculate this individually and depending on the situation.

◆ centerline_is_driving_direction

optional bool osi3::Lane::Classification::centerline_is_driving_direction = 4

Definition of the intended driving direction.

Defined and used for driving lanes. true means driving direction is according to ascending storage order of center line points. false means driving direction is according to descending storage order of center line points.

Example: centerline_is_driving_direction = true for lane l4 and centerline_is_driving_direction = false for lane l2 in image HighwayExit .

Note: The centerline_is_driving_direction is defined for type = TYPE_DRIVING .

◆ free_lane_boundary_id

repeated Identifier osi3::Lane::Classification::free_lane_boundary_id = 10

The free boundaries which have no/unknown assignment to left/right.

Example: free_lane_boundary_id = lb11 for lane l7 in image Intersection.

Note: Lane with type = TYPE_INTERSECTION use only free lane boundaries.; OSI uses singular instead of plural for repeated field names.

\rules check_if this.type is_different_to 4 else do_check is_set \endrules

◆ is_host_vehicle_lane

optional bool osi3::Lane::Classification::is_host_vehicle_lane = 2

Indicates that the host vehicle travels on this particular lane. The host vehicle may travel on more than one lane at once. This does also apply for the CanditateLane in the DetectedLane .

◆ lane_pairing

repeated LanePairing osi3::Lane::Classification::lane_pairing = 7

The antecessor/successor lane pairings of this lane. There can be multiple pairings with the same antecessor and different successor lanes and vice versa. The antecessor lanes end in the same point that this lane starts from. The successor lanes start in the same point that this lane ends in.

Example: See image Intersection.

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

◆ left_adjacent_lane_id

repeated Identifier osi3::Lane::Classification::left_adjacent_lane_id = 5

List of IDs of all lane segments that are directly adjacent to the lane on the left side (w.r.t. ascending order of centerline points and lane boundary points). Note that lengths of lane segments are not synchronized and therefore there are multiple adjacent segments if there is a split/merge point in the adjacent lane.

Example: The lane l3 is the only left adjacent lane for lane l4 in image HighwayExit.

Note: The left_adjacent_lane_id is undefined for type = TYPE_INTERSECTION .; OSI uses singular instead of plural for repeated field names.

\rules check_if this.type is_different_to 4 else do_check is_set \endrules

◆ left_lane_boundary_id

repeated Identifier osi3::Lane::Classification::left_lane_boundary_id = 9

The left adjacent lane boundaries left_lane_boundary_id may only be shared with/as the right adjacent lane boundaries right_lane_boundary_id of the nearest left adjacent lane left_adjacent_lane_id.

Example: left_lane_boundary_id = lb5 for lane l4 in image HighwayExit.

Note: Empty for intersections.; The left_lane_boundary_id is undefined for type = TYPE_INTERSECTION .; OSI uses singular instead of plural for repeated field names.

\rules check_if this.type is_different_to 4 else do_check is_set \endrules

◆ right_adjacent_lane_id

repeated Identifier osi3::Lane::Classification::right_adjacent_lane_id = 6

List of IDs of all lane segments that are directly adjacent to the lane on the right side (w.r.t. ascending order of centerline points and lane boundary points). Note that lengths of lane segments are not synchronized and therefore there are multiple adjacent segments if there is a split/merge point in the adjacent lane.

Example: right_adjacent_lane_id = (l5, l6) for lane l4 in image HighwayExit.

Note: The right_adjacent_lane_id is undefined for type = TYPE_INTERSECTION .; OSI uses singular instead of plural for repeated field names.

\rules check_if this.type is_different_to 4 else do_check is_set \endrules

◆ right_lane_boundary_id

repeated Identifier osi3::Lane::Classification::right_lane_boundary_id = 8

The right adjacent lane boundaries right_lane_boundary_id may only be shared with/as the left adjacent lane boundaries left_lane_boundary_id of the nearest right adjacent lane right_adjacent_lane_id.

Example: right_lane_boundary_id = (lb9, lb6) for reference lane l4 in image HighwayExit.

Note: Empty for intersections.; The right_lane_boundary_id is undefined for type = TYPE_INTERSECTION .; OSI uses singular instead of plural for repeated field names.

\rules check_if this.type is_different_to 4 else do_check is_set \endrules

◆ road_condition

optional RoadCondition osi3::Lane::Classification::road_condition = 11

The condition of the lane, e.g. influenced by weather.

◆ subtype

optional Subtype osi3::Lane::Classification::subtype = 12

The subtype of the lane.

This subtype specifies a lane more concretely.

◆ type

optional Type osi3::Lane::Classification::type = 1

The type of the lane.

Example: For l4 in image HighwayExit the type is TYPE_DRIVING.

The documentation for this struct was generated from the following file:

osi_lane.proto

Classes

Public Types

Public Attributes

Detailed Description

Member Enumeration Documentation

◆ Subtype

◆ Type

Member Data Documentation

◆ centerline

◆ centerline_is_driving_direction

◆ free_lane_boundary_id

◆ is_host_vehicle_lane

◆ lane_pairing

◆ left_adjacent_lane_id

◆ left_lane_boundary_id

◆ right_adjacent_lane_id

◆ right_lane_boundary_id

◆ road_condition

◆ subtype

◆ type