Meta
UML Version: 1.2
Date: 2022-03-24
XSD 1.2 Documentation
Changes from Version 1.2 compared to version 1.1
Changes from Version 1.1 compared to version 1.0

All Classes
  AbsoluteSpeed
  AbsoluteTargetLane
  AbsoluteTargetLaneOffset
  AbsoluteTargetSpeed
  AccelerationCondition
  AcquirePositionAction
  Act
  Action
  ActivateControllerAction
  Actors
  AddEntityAction
  AnimationAction
  AnimationFile
  AnimationState
  AnimationType
  AppearanceAction
  AssignControllerAction
  AssignRouteAction
  AutomaticGear
  Axle
  Axles
  BoundingBox
  Brake
  BrakeInput
  ByEntityCondition
  ByObjectType
  ByType
  ByValueCondition
  Catalog
  CatalogDefinition
  CatalogLocations
  CatalogReference
  Center
  CentralSwarmObject
  Clothoid
  CollisionCondition
  Color
  ColorCmyk
  ColorRgb
  ComponentAnimation
  Condition
  ConditionGroup
  ControlPoint
  Controller
  ControllerAction
  ControllerCatalogLocation
  ControllerDistribution
  ControllerDistributionEntry
  CustomCommandAction
  CustomContent
  DeleteEntityAction
  Deterministic
  DeterministicMultiParameterDistribution
  DeterministicMultiParameterDistributionType
  DeterministicParameterDistribution
  DeterministicSingleParameterDistribution
  DeterministicSingleParameterDistributionType
  Dimensions
  DirectionOfTravelDistribution
  Directory
  DistanceCondition
  DistributionDefinition
  DistributionRange
  DistributionSet
  DistributionSetElement
  DomeImage
  DynamicConstraints
  EndOfRoadCondition
  Entities
  EntityAction
  EntityCondition
  EntityObject
  EntityRef
  EntitySelection
  Environment
  EnvironmentAction
  EnvironmentCatalogLocation
  Event
  ExternalObjectReference
  File
  FileHeader
  FinalSpeed
  Fog
  FollowTrajectoryAction
  Gear
  GeoPosition
  GlobalAction
  Histogram
  HistogramBin
  InRoutePosition
  InfrastructureAction
  Init
  InitActions
  Knot
  LaneChangeAction
  LaneChangeTarget
  LaneOffsetAction
  LaneOffsetActionDynamics
  LaneOffsetTarget
  LanePosition
  LateralAction
  LateralDistanceAction
  License
  LightState
  LightStateAction
  LightType
  LongitudinalAction
  LongitudinalDistanceAction
  Maneuver
  ManeuverCatalogLocation
  ManeuverGroup
  ManualGear
  MiscObject
  MiscObjectCatalogLocation
D ModifyRule
  None
  NormalDistribution
  Nurbs
  ObjectController
  OffroadCondition
  OpenScenario
  OpenScenarioCategory
  Orientation
  OverrideBrakeAction
  OverrideClutchAction
  OverrideControllerValueAction
  OverrideGearAction
  OverrideParkingBrakeAction
  OverrideSteeringWheelAction
  OverrideThrottleAction
D ParameterAction
D ParameterAddValueRule
  ParameterAssignment
  ParameterCondition
  ParameterDeclaration
D ParameterModifyAction
D ParameterMultiplyByValueRule
D ParameterSetAction
  ParameterValueDistribution
  ParameterValueDistributionDefinition
  ParameterValueSet
  Pedestrian
  PedestrianAnimation
  PedestrianCatalogLocation
  PedestrianGesture
  Performance
  Phase
  PoissonDistribution
  Polyline
  Position
  PositionInLaneCoordinates
  PositionInRoadCoordinates
  PositionOfCurrentEntity
  Precipitation
  Private
  PrivateAction
  ProbabilityDistributionSet
  ProbabilityDistributionSetElement
  Properties
  Property
  Range
D ReachPositionCondition
  RelativeClearanceCondition
  RelativeDistanceCondition
  RelativeLanePosition
  RelativeLaneRange
  RelativeObjectPosition
  RelativeRoadPosition
  RelativeSpeedCondition
  RelativeSpeedToMaster
  RelativeTargetLane
  RelativeTargetLaneOffset
  RelativeTargetSpeed
  RelativeWorldPosition
  RoadCondition
  RoadNetwork
  RoadPosition
  Route
  RouteCatalogLocation
  RoutePosition
  RouteRef
  RoutingAction
  ScenarioDefinition
  ScenarioObject
  SelectedEntities
  SensorReference
  SensorReferenceSet
  Shape
  SimulationTimeCondition
  SpeedAction
  SpeedActionTarget
  SpeedCondition
  SpeedProfileAction
  SpeedProfileEntry
  StandStillCondition
  SteadyState
  Stochastic
  StochasticDistribution
  StochasticDistributionType
  Story
  Storyboard
  StoryboardElementStateCondition
  Sun
  SynchronizeAction
  TargetDistanceSteadyState
  TargetTimeSteadyState
  TeleportAction
  TimeHeadwayCondition
  TimeOfDay
  TimeOfDayCondition
  TimeReference
  TimeToCollisionCondition
  TimeToCollisionConditionTarget
  Timing
  TrafficAction
  TrafficDefinition
  TrafficSignalAction
  TrafficSignalCondition
  TrafficSignalController
  TrafficSignalControllerAction
  TrafficSignalControllerCondition
  TrafficSignalGroupState
  TrafficSignalState
  TrafficSignalStateAction
  TrafficSinkAction
  TrafficSourceAction
  TrafficStopAction
  TrafficSwarmAction
  Trajectory
  TrajectoryCatalogLocation
  TrajectoryFollowingMode
  TrajectoryPosition
  TrajectoryRef
  TransitionDynamics
  TraveledDistanceCondition
  Trigger
  TriggeringEntities
  UniformDistribution
  UsedArea
  UserDefinedAction
  UserDefinedAnimation
  UserDefinedComponent
  UserDefinedDistribution
  UserDefinedLight
  UserDefinedValueCondition
  ValueConstraint
  ValueConstraintGroup
  ValueSetDistribution
  VariableAction
  VariableAddValueRule
  VariableCondition
  VariableDeclaration
  VariableModifyAction
  VariableModifyRule
  VariableMultiplyByValueRule
  VariableSetAction
  Vehicle
  VehicleCatalogLocation
  VehicleCategoryDistribution
  VehicleCategoryDistributionEntry
  VehicleComponent
  VehicleLight
  VehicleRoleDistribution
  VehicleRoleDistributionEntry
  Vertex
  VisibilityAction
  Waypoint
  Weather
  Wind
  WorldPosition

All Enumerations
  AutomaticGearType
D CloudState
  ColorType
  ConditionEdge
  ControllerType
  CoordinateSystem
  DirectionalDimension
  DynamicsDimension
  DynamicsShape
  FollowingMode
  FractionalCloudCover
  LateralDisplacement
  LightMode
  LongitudinalDisplacement
  MiscObjectCategory
  ObjectType
  ParameterType
  PedestrianCategory
  PedestrianGestureType
  PedestrianMotionType
  PrecipitationType
  Priority
  ReferenceContext
  RelativeDistanceType
  Role
  RouteStrategy
  RoutingAlgorithm
  Rule
  SpeedTargetValueType
  StoryboardElementState
  StoryboardElementType
  TriggeringEntitiesRule
  VehicleCategory
  VehicleComponentType
  VehicleLightType
  Wetness

All Interfaces
  CatalogElement
  Entity
  MotionControlAction
  SpawnedObject
  StoryboardElement

All Primitive Types
  Boolean
  DateTime
  Double
  Int
  String
  UnsignedInt
  UnsignedShort

Class RelativeRoadPosition

Applied Stereotypes:
XSDcomplexType

Position defined in terms of the relative distance (ds) along the road's reference line and the relative lateral offset (dt) to the road's reference line which are derived from the position of the reference entity.

The target position may be either on the same road segment (defined by roadId) where the reference entity is positioned or on a connecting road. In the latter case, the ds-coordinate is calculated along the road reference line of the connecting road. It is assumed that the reference line of the road of the reference entity continues seamlessly on the connecting road (even if its shape changes). It is assumed that the target position relates to the routing of the reference entity. Otherwise, the calculation of the target position cannot be interpreted within the OpenSCENARIO standard.

The ds- and dt-coordinates should be specified so that the target position is within a road defined by roadId taken from the respective road network definition file (external to the ASAM OpenSCENARIO). If the target position would be outside the road boundaries, the z-coordinate of the position is undefined.

Used in:
Position
Properties
  Name Type Cardinality AppliedStereotypes Description
  ds double 1..1 XSDattribute The offset along the road's reference line relative to the s-coordinate of the reference entity. Unit: [m].
  dt double 1..1 XSDattribute The offset on the axis orthogonal to the road's reference line relative to the t-coordinate of the reference entity. Unit: [m].
  entityRef Entity 1..1 nameRef, XSDattribute reference entity.
  orientation Orientation 0..1 XSDelement The Pitch and Roll angles are determined by the underlying road surface at the target position and therefore undefined by the OpenSCENARIO standard.
The absolute reference context refers to the orientation with respect to the World coordinate system. Only the Heading angle at the target position can be arbitrarily specified on the (X,Y)-plane counting from the X-axis.
The relative reference context refers to the orientation with respect to the (s,t)-coordinate system of the road of the reference entity. Only the Heading angle at the target position on the (s,t)-plane can be arbitrarily specified. To calculate the Heading, the imaginary straight axis at the target position is built parallel to the tangent to the reference road s-axis at the s-position of the reference entity. The Heading is counted from this imaginary axis.
Missing Orientation property is interpreted as the absolute reference context with Heading=Pitch=Roll=0.

XSD 1.2 Representation


<xsd:complexType name="RelativeRoadPosition">
<xsd:all>
<xsd:element name="Orientation" type="Orientation" minOccurs="0"/>
</xsd:all>
<xsd:attribute name="entityRef" type="String" use="required"/>
<xsd:attribute name="ds" type="Double" use="required"/>
<xsd:attribute name="dt" type="Double" use="required"/>
</xsd:complexType>

Change log from version 1.1
  • Annotation changed
    • New Value
      Position defined in terms of the relative distance (ds) along the road's reference line and the relative lateral offset (dt) to the road's reference line which are derived from the position of the reference entity. The target position may be either on the same road segment (defined by roadId) where the reference entity is positioned or on a connecting road. In the latter case, the ds-coordinate is calculated along the road reference line of the connecting road. It is assumed that the reference line of the road of the reference entity continues seamlessly on the connecting road (even if its shape changes). It is assumed that the target position relates to the routing of the reference entity. Otherwise, the calculation of the target position cannot be interpreted within the OpenSCENARIO standard. The ds- and dt-coordinates should be specified so that the target position is within a road defined by roadId taken from the respective road network definition file (external to the ASAM OpenSCENARIO). If the target position would be outside the road boundaries, the z-coordinate of the position is undefined.
      From 1.1.0
      Defines an absolute position derived from relative road coordinates delta s [ds] and delta t [dt] to a reference entity.
  • Property 'ds'. Annotation changed.
    • New Value
      The offset along the road's reference line relative to the s-coordinate of the reference entity. Unit: [m].
      From 1.1.0
      Relative ds road coordinate to s coordinate of the reference entity.
  • Property 'dt'. Annotation changed.
    • New Value
      The offset on the axis orthogonal to the road's reference line relative to the t-coordinate of the reference entity. Unit: [m].
      From 1.1.0
      Relative dt road coordinate to t coordinate of the reference entity.
  • Property 'orientation'. Annotation changed.
    • New Value
      The Pitch and Roll angles are determined by the underlying road surface at the target position and therefore undefined by the OpenSCENARIO standard. The absolute reference context refers to the orientation with respect to the World coordinate system. Only the Heading angle at the target position can be arbitrarily specified on the (X,Y)-plane counting from the X-axis. The relative reference context refers to the orientation with respect to the (s,t)-coordinate system of the road of the reference entity. Only the Heading angle at the target position on the (s,t)-plane can be arbitrarily specified. To calculate the Heading, the imaginary straight axis at the target position is built parallel to the tangent to the reference road s-axis at the s-position of the reference entity. The Heading is counted from this imaginary axis. Missing Orientation property is interpreted as the absolute reference context with Heading=Pitch=Roll=0.
      From 1.1.0
      Orientation. The relative reference context refers to the referenced road's s and t coordinates.

Stereotype Details Information
  • Class
    • XSDcomplexType [modelGroup: "all"; mixed: "false"]
  • Property ds
    • XSDattribute
  • Property dt
    • XSDattribute
  • Property entityRef
    • nameRef [xsdType: "string"]
    • XSDattribute
  • Property orientation
    • XSDelement [position: "2"]

To XSD