13.10 Object reference

It is possible to link an object with one or more roads, signals, or other objects. These links represent a logical connection between the two elements.

An object reference is used, for example, if a pedestrian crossing crosses several roads. In this case, the pedestrian crossing is defined for one road only, and then referenced by the other roads that it crosses. Objects that apply to multiple roads within a junction can alternatively be attached to the junction reference line.

The lane validity element may be used to indicate for which lane the object reference is valid.

Elements in UML model

<objectReference> element

In ASAM OpenDRIVE, the object reference is represented by the <objectReference> element within the <objects> element.

UML class: t_road_objects_objectReference
XML tag:   <objectReference> (Multiplicity: 0..*)

An object reference refers to one identical object from multiple roads. The referenced objects require a unique ID. The <objectReference> element consists of a main element and an optional lane validity element.

Table 100. Attributes of the <objectReference> element
Name	Type	Use	Unit	Description
`id`	string	required		Unique ID of the referred object within the database
`orientation`	e_orientation	required		"+" = valid in positive s-direction "-" = valid in negative s-direction "none" = valid in both directions
`s`	t_grEqZero	required	m	s-coordinate
`t`	double	required	m	t-coordinate
`validLength`	t_grEqZero	optional	m	Validity of the object along s-axis (0.0 for point object)
`zOffset`	double	optional	m	z offset relative to the elevation of the road reference line

<validity> element

In ASAM OpenDRIVE, lane validity is represented by the <validity> element within the <object> element or the <objectReference> element.

UML class: t_road_objects_object_laneValidity
XML tag:   <validity> (Multiplicity: 0..*)

Lane validities restrict signals and objects to specific lanes.

Table 101. Attributes of the <validity> element
Name	Type	Use	Description
`fromLane`	integer	required	Minimum ID of the lanes for which the object is valid
`toLane`	integer	required	Maximum ID of the lanes for which the object is valid

Rules

The following rules apply for the purpose of reusing object information:

The value of the @fromLane attribute shall be lower than or equal to the value of the @toLane attribute.

Related topics