Programmatic Scenario Authoring

Programmatically create driving scenarios by using a drivingScenario object

The drivingScenario object enables you to author driving scenarios from the MATLAB^® command line. Use this object to design complex road networks or parking lots and specify actors and their trajectories. You can then generate synthetic data from these scenarios by using sensor models and visualize this data on a bird's-eye plot.

The flexible interface of the drivingScenario object enables you to create variations of a scenario for rapidly testing driving algorithms under various conditions. For more details, see Create Driving Scenario Variations Programmatically.

Functions

expand all

Driving Scenarios

Scenarios

`drivingScenario`	Create driving scenario
`advance`	Advance driving scenario simulation by one time step
`plot`	Plot driving scenario
`plotSim3d`	Plot driving scenario in Unreal Engine viewer (Since R2024a)
`record`	Run driving scenario and record actor states
`restart`	Restart driving scenario simulation from beginning
`updatePlots`	Update driving scenario plots
`export`	Export driving scenario to ASAM OpenDRIVE, ASAM OpenSCENARIO or RoadRunner HD Map file (Since R2020b)
`getRoadRunnerHDMap`	Get RoadRunner HD Map from Driving Scenario in MATLAB (Since R2023a)
`addSensors`	Add sensors to specific host vehicle (Since R2023a)
`startRoadRunnerForScenario`	Create and launch RoadRunner scenario from driving scenario (Since R2024a)

Actors

`actor`	Add actor to driving scenario
`vehicle`	Add vehicle to driving scenario
`trajectory`	Create actor or vehicle trajectory in driving scenario
`smoothTrajectory`	Create smooth, jerk-limited actor trajectory in driving scenario (Since R2021a)
`getReferencePosition`	Get reference position of vehicle (Since R2024b)
`state`	Inertial ground-truth state of actor (Since R2021a)
`actorPoses`	Positions, velocities, and orientations of actors in driving scenario
`actorProfiles`	Physical and radar characteristics of actors in driving scenario
`barrier`	Add a barrier to a driving scenario (Since R2021a)
`chasePlot`	Ego-centric projective perspective plot
`targetMeshes`	Mesh vertices and faces relative to specific actor (Since R2020b)
`targetOutlines`	Outlines of targets viewed by actor
`targetPoses`	Target positions and orientations relative to host vehicle
`driving.scenario.targetsToEgo`	Convert target poses from scenario to ego coordinates
`driving.scenario.targetsToScenario`	Convert target poses from ego to scenario coordinates (Since R2020a)

Roads

`road`	Add road to driving scenario or road group
`roadNetwork`	Add road network to driving scenario
`roadBoundaries`	Get road boundaries
`driving.scenario.roadBoundariesToEgo`	Convert road boundaries to ego vehicle coordinates
`roadMesh`	Mesh representation of roads near actor (Since R2020a)
`driving.scenario.RoadGroup`	Store specifications for road junction or intersection (Since R2021a)
`roadGroup`	Add road junction or intersection to driving scenario (Since R2021a)

Lanes

`lanespec`	Create road lane specifications
`laneType`	Create road lane type object
`laneMarking`	Create road lane marking object
`laneMarkingVertices`	Lane marking vertices and faces in driving scenario
`currentLane`	Get current lane of actor
`laneBoundaries`	Get lane boundaries of actor lane
`clothoidLaneBoundary`	Clothoid-shaped lane boundary model
`computeBoundaryModel`	Compute lane boundary points from clothoid lane boundary model
`compositeLaneSpec`	Create multiple lane specifications for road (Since R2021a)
`laneSpecConnector`	Define road segment connector specifications (Since R2021a)

Parking Lots

`parkingLot`	Add parking lot to driving scenario (Since R2021b)
`parkingSpace`	Define parking space for parking lot (Since R2021b)
`insertParkingSpaces`	Insert parking spaces into parking lot (Since R2021b)
`parkingLaneMarkingVertices`	Parking lane marking vertices and faces in driving scenario (Since R2021b)

Sensors

`drivingRadarDataGenerator`	Generate radar sensor detections or track reports from driving scenario or RoadRunner Scenario (Since R2021a)
`visionDetectionGenerator`	Generate vision detections for driving scenario or RoadRunner Scenario
`lidarPointCloudGenerator`	Generate lidar point cloud data for driving scenario or RoadRunner Scenario (Since R2020a)
`insSensor`	Inertial navigation system and GNSS/GPS simulation model (Since R2021a)
`ultrasonicDetectionGenerator`	Generate ultrasonic range detections in driving scenario or RoadRunner Scenario (Since R2022a)
`addSensors`	Add sensors to specific host vehicle (Since R2023a)

Meshes for Lidar Simulation

Mesh Creation

`extendedObjectMesh`	Mesh representation of extended object (Since R2020a)
`translate`	Translate mesh along coordinate axes (Since R2020a)
`rotate`	Rotate mesh about coordinate axes (Since R2020a)
`scale`	Scale mesh in each dimension (Since R2020a)
`applyTransform`	Apply forward transformation to mesh vertices (Since R2020a)
`join`	Join two object meshes (Since R2020a)
`scaleToFit`	Auto-scale object mesh to match specified cuboid dimensions (Since R2020a)
`show`	Display the mesh as a patch on the current axes (Since R2020a)

Prebuilt Meshes

`driving.scenario.bicycleMesh`	Mesh representation of bicycle in driving scenario (Since R2020a)
`driving.scenario.carMesh`	Mesh representation of car in driving scenario (Since R2020a)
`driving.scenario.pedestrianMesh`	Mesh representation of pedestrian in driving scenario (Since R2020a)
`driving.scenario.truckMesh`	Mesh representation of truck in driving scenario (Since R2020a)
`driving.scenario.jerseyBarrierMesh`	Mesh representation of Jersey barrier in driving scenario (Since R2021a)
`driving.scenario.guardrailMesh`	Mesh representation of guardrail in driving scenario (Since R2021a)

Bird's-Eye Plot

Plotter Creation

`birdsEyePlot`	Plot detections, tracks, and sensor coverages around vehicle
`coverageAreaPlotter`	Coverage area plotter for bird's-eye plot
`detectionPlotter`	Detection plotter for bird's-eye plot
`trackPlotter`	Track plotter for bird's-eye plot
`laneBoundaryPlotter`	Lane boundary plotter for bird's-eye plot
`laneMarkingPlotter`	Lane marking plotter for bird's-eye plot
`meshPlotter`	Mesh plotter for bird's-eye plot (Since R2020b)
`pathPlotter`	Path plotter for bird's-eye plot
`pointCloudPlotter`	Point cloud plotter for bird's-eye plot (Since R2020a)
`outlinePlotter`	Outline plotter for bird's-eye plot
`rangeDetectionPlotter`	Range detection plotter for bird's-eye plot (Since R2022a)

Plotter Display

`plotCoverageArea`	Display sensor coverage area on bird's-eye plot
`plotDetection`	Display object detections on bird's-eye plot
`plotLaneBoundary`	Display lane boundaries on bird’s-eye plot
`plotLaneMarking`	Display lane markings on bird’s-eye plot
`plotParkingLaneMarking`	Display parking lane markings on bird’s-eye plot (Since R2021b)
`plotMesh`	Display object meshes on bird's-eye plot (Since R2020b)
`plotOutline`	Display object outlines on bird's-eye plot
`plotBarrierOutline`	Display barrier outlines on bird's-eye plot (Since R2021a)
`plotPath`	Display actor paths on bird’s-eye plot
`plotPointCloud`	Display generated point cloud on bird's-eye plot (Since R2020a)
`plotRangeDetection`	Display range detections on bird's-eye plot (Since R2022a)
`plotTrack`	Display object tracks on bird's-eye plot

Plotter Utilities

`findPlotter`	Find plotters associated with bird’s-eye plot
`clearData`	Clear data from specific plotter of bird’s-eye plot
`clearPlotterData`	Clear data from bird’s-eye plot

Topics

Driving Scenarios

Create Driving Scenario Programmatically
Programmatically create ground truth driving scenarios for synthetic sensor data and tracking algorithms.
Define Road Layouts Programmatically
Programmatically create road junctions and combine these junctions to create more complicated road networks.
Simulate Vehicle Parking Maneuver in Driving Scenario
Simulate a parking maneuver and generate sensor detections in a large parking lot using a cuboid driving scenario.
Create Actor and Vehicle Trajectories Programmatically
Programmatically create actor and vehicle trajectories for a driving scenario.
Create Driving Scenario Variations Programmatically
Programmatically create variations of a driving scenario that was built using the Driving Scenario Designer app.
Visualize Sensor Coverage, Detections, and Tracks
Configure and use a bird's-eye plot to display sensor coverage, detections, and tracking results around the ego vehicle.
Automate Control of Intelligent Vehicles by Using Stateflow Charts
Model a highway scenario with intelligent vehicles that are controlled by decision logic defined by a Stateflow^® chart.

Sensors

Model Radar Sensor Detections
Model and simulate the output of an automotive radar sensor for various driving scenarios.
Radar Signal Simulation and Processing for Automated Driving
Model the hardware, signal processing, and propagation environment of a radar for a driving scenario.
Simulate Radar Ghosts Due to Multipath Return
Generate ghost targets that occur when signal energy is reflected off another target before returning to the radar.
Model Vision Sensor Detections
Model and simulate the output of an automotive vision sensor for various driving scenarios.
Simulate Inertial Sensor Readings from a Driving Scenario (Navigation Toolbox)
Generate synthetic sensor data from IMU, GPS, and wheel encoders using driving scenario generation tools from Automated Driving Toolbox™.

Featured Examples

Scenario Generation from Recorded Vehicle Data

Automatically generate virtual driving scenarios from recorded vehicle data.

Open Live Script

Automatic Scenario Generation

Automate scenario generation by using a drivingScenario object. In this example, you will automate:

Open Live Script

Generate High Definition Scene from Lane Detections and OpenStreetMap

Generate HD road scene using recorded lane detections, GPS data, and OpenStreetMap^® data.

Open Live Script

Generate Scenario from Actor Track List and GPS Data

Generate ASAM OpenSCENARIO^® v1.0 file using recorded actor tracklist and GPS data.

Open Live Script

Generate Scenario Variants for Testing AEB Pedestrian Systems

Generate scenario variants to test automated emergency braking (AEB) system using car-to-pedestrian European New Car Assessment Programme (Euro NCAP) test scenario.

Open Live Script