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 GeoPosition

Applied Stereotypes:
XSDcomplexType

Position defined in terms of the spherical geographic coordinates (angular Longitude and Latitude) derived from the geodetic datum specified in the respective road network definition file (external to the ASAM OpenSCENARIO). Optionally, the orientation of the position can be specified.
In the general case, the altitude of the target position above a conventional reference level (e.g., the mean sea level on the Earth) is determined by the surface of the underlying road, which is derived from the Longitude/Latitude-coordinates of the position. However, optionally, the altitude of the target position with respect to the road surface can be specified.
The orientation of the road in the inertial (X,Y,Z)-coordinate system, in turn, is specified in the respective road network definition file too.
The transformation of angular geographic coordinates into the flat (X,Y)-projection in the World coordinate system is entrusted to a simulation environment. However, if the target position would be outside the road boundaries, the Z-coordinate of the position is undefined by the OpenSCENARIO standard.

Used in:
Position
Properties
  Name Type Cardinality AppliedStereotypes Description
  altitude double 0..1 XSDattribute Altitude is the Earth gravity-related vertical distance from the target position, specified horizontally by its Longitude/Latitude coordinates, to the closest point on the underlying road surface.When calculating the closest point, it is accounted for an elevation of the road, an entire road super-elevation, or, in more complex cases, a road lateral shape profile that are specified in the road network definition (external to the OpenSCENARIO).Missing value is interpreted as altitude=0. Unit: [m]. Range: [0..inf[.
D height double 0..1 XSDattribute, deprecated Height above a reference surface (e.g. sea level, earth surface). Unit: [m]. If the value is omitted, height is interpreted as 0.
D latitude double 0..1 XSDattribute, deprecated The latitude of a point on earth's surface is the angle between the equatorial plane and the straight line that passes through that point and through the center of the earth. Unit: [rad]. Range: [-PI..PI].
  latitudeDeg double 0..1 XSDattribute The latitude of a point on earth's surface is the angle between the equatorial plane and the straight line that passes through that point and through the center of the earth. Unit: [°]. Range: [-90..90]. Missing value is interpreted as 0.
D longitude double 0..1 XSDattribute, deprecated The longitude of a point on earth's surface is the angle east or west of a reference meridian to another meridian that passes through that point. Unit: [rad]. Range: [-PI/2..PI/2].
  longitudeDeg double 0..1 XSDattribute The longitude of a point on earth's surface is the angle east or west of a reference meridian to another meridian that passes through that point. Unit: [°]. Range: [-180..180]. Missing value is interpreted as 0.
  orientation Orientation 0..1 XSDelement In the case of altitude=0, 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, which is assumed to be the projected coordinate system based on the spherical geographic coordinate system.
The relative reference context refers to the orientation with respect to the reference (s,t)-coordinate system of the lane on the road underlying the target position. 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 lane s-axis on the reference road. The Heading is counted from this imaginary axis.
Missing Orientation property is interpreted as the absolute reference context with Heading=Pitch=Roll=0.

Deprecation
  • Property height deprecated. With version 1.2. Use altitude instead.
  • Property latitude deprecated. With version 1.2. Use latitudeDeg instead.
  • Property longitude deprecated. With version 1.2. Use longitudeDeg instead.

XSD 1.2 Representation


<xsd:complexType name="GeoPosition">
<xsd:all>
<xsd:element name="Orientation" type="Orientation" minOccurs="0"/>
</xsd:all>
<xsd:attribute name="latitude" type="Double">
<xsd:annotation>
<xsd:appinfo>
deprecated
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="longitude" type="Double">
<xsd:annotation>
<xsd:appinfo>
deprecated
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="height" type="Double">
<xsd:annotation>
<xsd:appinfo>
deprecated
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="latitudeDeg" type="Double"/>
<xsd:attribute name="longitudeDeg" type="Double"/>
<xsd:attribute name="altitude" type="Double"/>
</xsd:complexType>

Change log from version 1.1
  • Annotation changed
    • New Value
      Position defined in terms of the spherical geographic coordinates (angular Longitude and Latitude) derived from the geodetic datum specified in the respective road network definition file (external to the ASAM OpenSCENARIO). Optionally, the orientation of the position can be specified. In the general case, the altitude of the target position above a conventional reference level (e.g., the mean sea level on the Earth) is determined by the surface of the underlying road, which is derived from the Longitude/Latitude-coordinates of the position. However, optionally, the altitude of the target position with respect to the road surface can be specified. The orientation of the road in the inertial (X,Y,Z)-coordinate system, in turn, is specified in the respective road network definition file too. The transformation of angular geographic coordinates into the flat (X,Y)-projection in the World coordinate system is entrusted to a simulation environment. However, if the target position would be outside the road boundaries, the Z-coordinate of the position is undefined by the OpenSCENARIO standard.
      From 1.1.0
      A position described in geographic terms.
  • Property 'altitude' created.
  • Property 'latitudeDeg' created.
  • Property 'longitudeDeg' created.
  • Property 'height'. Annotation changed.
    • New Value
      Height above a reference surface (e.g. sea level, earth surface). Unit: [m]. If the value is omitted, height is interpreted as 0.
      From 1.1.0
      Height above a reference surface (e.g. sea level, earth surface). Unit [m]. If the value is omitted, height is interpreted as 0.
  • Property 'height'. Stereotype <<deprecated>> applied.
  • Property 'latitude'. Lower cardinality changed.
    • New Value
      0
      From 1.1.0
      1
  • Property 'latitude'. Annotation changed.
    • New Value
      The latitude of a point on earth's surface is the angle between the equatorial plane and the straight line that passes through that point and through the center of the earth. Unit: [rad]. Range: [-PI..PI].
      From 1.1.0
      The latitude of a point on earth's surface is the angle between the equatorial plane and the straight line that passes through that point and through the center of the earth. Unit [rad]. Range [-PI...PI]
  • Property 'latitude'. Stereotype <<deprecated>> applied.
  • Property 'longitude'. Lower cardinality changed.
    • New Value
      0
      From 1.1.0
      1
  • Property 'longitude'. Annotation changed.
    • New Value
      The longitude of a point on earth's surface is the angle east or west of a reference meridian to another meridian that passes through that point. Unit: [rad]. Range: [-PI/2..PI/2].
      From 1.1.0
      The longitude of a point on earth's surface is the angle east or west of a reference meridian to another meridian that passes through that point. Unit [rad]. Range [-PI/2..PI/2]
  • Property 'longitude'. Stereotype <<deprecated>> applied.
  • Property 'orientation'. Annotation changed.
    • New Value
      In the case of altitude=0, 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, which is assumed to be the projected coordinate system based on the spherical geographic coordinate system. The relative reference context refers to the orientation with respect to the reference (s,t)-coordinate system of the lane on the road underlying the target position. 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 lane s-axis on the reference road. 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 geo coordinates. Missing value is interpreted as (heading=0, pitch=0, roll=0, type='absolute').

Stereotype Details Information
  • Class
    • XSDcomplexType [modelGroup: "all"; mixed: "false"]
  • Property altitude
    • XSDattribute
  • Property height
    • XSDattribute
    • deprecated [withVersion: "1.2"; comment: "Use altitude instead."]
  • Property latitude
    • XSDattribute
    • deprecated [withVersion: "1.2"; comment: "Use latitudeDeg instead."]
  • Property latitudeDeg
    • XSDattribute
  • Property longitude
    • XSDattribute
    • deprecated [withVersion: "1.2"; comment: "Use longitudeDeg instead."]
  • Property longitudeDeg
    • XSDattribute
  • Property orientation
    • XSDelement [position: "1"]

To XSD