US Highway

US highway 3D environment

Description

The US Highway scene is a 3D environment of a US highway that contains barriers, cones, and traffic signs. The scene is created using RoadRunner.

Setup

To simulate a driving algorithm in the US highway scene:

1. Add a Simulation 3D Scene Configuration block to your Simulink^® model.

2. In this block, set the Scene source parameter to Default Scenes.

3. View the currently available scenes in the Scene name parameter. If the scene is not available, you must install it.

4. To install the scene:

   1. Click Install.

   2. In the Add-on installer dialog box, select the scene.

   3. Click Next and follow the prompts.

   MATLAB^® restarts after the scene is installed.

5. Select the scene name from the Scene name parameter.

Examples

Explore US Highway Scene

Explore the 3D US Highway scene and inspect its dimensions by using a corresponding 2D top-view image of the scene.

You can use this image to inspect the scene before simulation and choose starting coordinates for vehicles. For details on using these images to select waypoints for path-following applications, see the Select Waypoints for Unreal Engine Simulation example.

Load the 2D spatial referencing object that corresponds to the scene. This imref2d object describes the relationship between the pixels in the image and the world coordinates of the scene.

data = load('sim3d_SpatialReferences.mat');
spatialRef = data.spatialReference.USHighway

spatialRef = 
  imref2d with properties:

           XWorldLimits: [2820 5086]
           YWorldLimits: [-3748 -1482]
              ImageSize: [5096 5096]
    PixelExtentInWorldX: 0.4447
    PixelExtentInWorldY: 0.4447
    ImageExtentInWorldX: 2266
    ImageExtentInWorldY: 2266
       XIntrinsicLimits: [0.5000 5.0965e+03]
       YIntrinsicLimits: [0.5000 5.0965e+03]

Display the image corresponding to the scene. Use the spatial referencing object to display the axes in the world coordinates of the scene. Units are in meters.

By default, the imshow function displays Y-axis values that increase from top to bottom. To align with the Automated Driving Toolbox™ world coordinate system, set the Y-direction to 'normal' so that Y-axis values increase from bottom to top.

The image displays only the area of the scene containing the highway. The full scene has a length and width of 10,160 meters. The origin of the scene is outside the range of the displayed image.

figure
fileName = 'sim3d_USHighway.jpg';
I = imshow(fileName,spatialRef);
set(gca,'YDir','normal')
xlabel('X (m)')
ylabel('Y (m)')

Tips

• If you have the Automated Driving Toolbox™ Interface for Unreal Engine^® Projects support package, then you can modify this scene. In the Unreal Engine project file that comes with the support package, this scene is named USHighway.

  For more details on customizing scenes, see Customize Unreal Engine Scenes for Automated Driving.

Version History

Introduced in R2019b

R2025a: Install scene

You can install the US Highway scene if it is not available in the Scene view parameter list. To install the scene, use the Install option in the Simulation 3D Scene Configuration block.

R2022b: Scene rendered using RoadRunner

Starting from R2022b, the US Highway scene in the Unreal Engine 3D environment is rendered using RoadRunner. As a result, the locations of scene objects, including cones and parked vehicles, are moved from their pre-R2022b locations.