Run a Vehicle Dynamics Maneuver in 3D Environment
This example shows how to run a vehicle dynamics maneuver in a 3D environment. By integrating vehicle dynamics models with a 3D environment, you can test advanced driver assistance systems (ADAS) and automated driving (AD) perception, planning, and control software. For the 3D visualization engine platform requirements and hardware recommendations, see Unreal Engine Simulation Environment Requirements and Limitations.
Create and open a working copy of a maneuver reference application. For example, open the double-lane change reference application.
Run the maneuver simulation. By default, the 3D environment is disabled.
When you run the simulation, the Visualization subsystem provides driver, vehicle, and response information. The reference application logs vehicle signals during the maneuver, including steering, vehicle and engine speed, and lateral acceleration. You can use the Simulation Data Inspector to import the logged signals and examine the data.
Lane Change Scope block
Lateral vehicle displacement versus time:
Red line — Cones marking right lane boundary
Orange line — Cones marking left lane boundary
Blue line — Reference trajectory
Green line — Actual trajectory
Steer, Velocity, Lat Accel Scope block
SteerAngle— Steering angle versus time
<xdot>— Longitudinal vehicle velocity versus time
<ay>— Lateral acceleration versus time
Vehicle XY Plotter
Vehicle longitudinal versus lateral distance
ISO 15037-1:2006 block
Display ISO standard measurement signals in the Simulation Data Inspector, including steering wheel angle and torque, longitudinal and lateral velocity, and sideslip angle
Enable the 3D visualization environment. In the Visualization subsystem, open the 3D Engine block. Set these parameters.
3D Engine to Enabled.
Scene name to one of the scenes, for example
Double lane change.
To position the vehicle in the scene:
Select the position initialization method:
Recommended for scene — Set the initial vehicle position to values recommended for the scene
User-specified — Set your own initial vehicle position
Click Update the model workspaces with the initial values to overwrite the initial vehicle position in the model workspaces with the applied values.
Rerun the reference application. As the simulation runs, in the Simulation 3D Viewer, view the vehicle response.
To smoothly change the camera views, use these key commands.
Key Camera View
For additional camera controls, use these key commands.
Key Camera Control Tab
Cycle the view between all vehicles in the scene.
Mouse scroll wheel
Control the camera distance from the vehicle.
Toggle a camera lag effect on or off. When you enable the lag effect, the camera view includes:
Position lag, based on the vehicle translational acceleration
Rotation lag, based on the vehicle rotational velocity
This lag enables improved visualization of overall vehicle acceleration and rotation.
Toggle the free camera mode on or off. When you enable the free camera mode, you can use the mouse to change the pitch and yaw of the camera. This mode enables you to orbit the camera around the vehicle.
For example, when you run the double-lane change maneuver, use the cameras to visualize the vehicle as it changes lanes.
To open and close the Simulation 3D Viewer, use the Simulink® Run and Stop buttons. If you manually close the Simulation 3D Viewer, Simulink stops the simulation with an error.
When you enable the 3D visualization environment, you cannot step the simulation back.