OpenSCENARIO

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 ParameterDeclaration

Applied Stereotypes:

XSDcomplexType, XSDwrapperType

Declaration of a typed parameter with a name and a default value. It is used for creating variations of the same scenario by using the ParameterValueDistributionDefinition in an additional file.
There are two options for applying ParameterValueDistributions:

* Pre-startup: Copy the scenario file and change/override the default value
* On startup: Keep the scenario file but on startup of the OSC Director inject parameter values e.g. through the command line.

The value of a parameter cannot change after startup during runtime.

Used in:

Controller , Environment , Maneuver , MiscObject , ParameterAction , ParameterAssignment , ParameterCondition , Pedestrian , Route , ScenarioDefinition , Story , Trajectory , Vehicle

Properties

Name Type Cardinality AppliedStereotypes Description   name string 1..1 XSDattribute Name of the parameter.   parameterType ParameterType 1..1 XSDattribute Type of the parameter.   value string 1..1 XSDattribute Value of the parameter as its default value.   constraintGroups ValueConstraintGroup 0..* XSDunwrapped, XSDelement Defines zero or more constraint groups to the parameter value. Multiple constraint groups are combined by an OR. That means at least one constraint group has to evaluate to true to get the simulation started. If none of the constraint groups is satisfied the scenario should not be evaluated.

XSD 1.2 Representation
<xsd:complexType name="ParameterDeclaration"> <xsd:sequence> <xsd:element name="ConstraintGroup" type="ValueConstraintGroup" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> <xsd:attribute name="name" type="String" use="required"/> <xsd:attribute name="parameterType" type="ParameterType" use="required"/> <xsd:attribute name="value" type="String" use="required"/> </xsd:complexType>

XSD Transformation
UML Element Stereotype Description Class XSDwrapperType A complex type wrapper is created in XSD for this type. See ParameterDeclarations constraintGroups XSDunwrapped This property represents an unwrapped list in XSD. The element name 'ConstraintGroup' is used for the list elements.

Change log from version 1.1

Annotation changed New Value Declaration of a typed parameter with a name and a default value. It is used for creating variations of the same scenario by using the ParameterValueDistributionDefinition in an additional file. There are two options for applying ParameterValueDistributions: * Pre-startup: Copy the scenario file and change/override the default value * On startup: Keep the scenario file but on startup of the OSC Director inject parameter values e.g. through the command line. The value of a parameter cannot change after startup during runtime. From 1.1.0 Declaration of a parameter.

Stereotype Details Information
Class XSDcomplexType [modelGroup: "sequence"; mixed: "false"] XSDwrapperType [min: "0"; xsdWrapperElementName: "ParameterDeclaration"; max: "-1"; xsdWrapperType: "ParameterDeclarations"] Property name XSDattribute Property parameterType XSDattribute Property value XSDattribute Property constraintGroups XSDunwrapped [xsdElementName: "ConstraintGroup"] XSDelement [position: "1"]

To XSD