US City Block

US city block 3D environment

Description

The US City Block scene is a 3D environment of a US city block that contains 15 intersections and 30 traffic lights. The scene is created using RoadRunner.

For information about additional scenes, see 3D Scenes for Simulation in Unreal Engine Environment.

Setup

To simulate a driving maneuver in the US city block 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.

Layout

The scene uses the world coordinate system to locate objects.

Overall	Active Area

Scene Dimensions

This table provides the scene area corner locations in the world coordinate system. Dimensions are in m.

Locations	X (m)	Y (m)	Z (m)
Scene — Top left	-1020	-1020	0
Scene — Bottom right	1020	1020	0
Active area — Bottom left	-240.77	151.67	0

Recommended Starting Location

This table provides the recommended starting location for the vehicle in the world coordinate system. Dimensions are in m and deg.

Recommended Starting Location
X (m)	Y (m)	Z (m)	Roll (deg)	Pitch (deg)	Yaw (deg)
-125.19	1.65	0.04 -0.04 in vehicle Z-down coordinate system	0	0	0

Intersections

The US City Block scene has 15 intersections, as indicated in this diagram.

This table provides the intersection locations in the world coordinate system. Dimensions are in m.

Intersection	Center Location
	X (m)	Y (m)	Z (m)
1	-202.60	-108	.01
2	-112.60	-108	.01
3	-20.38	-108	.01
4	74.58	-108	.01
5	166.40	-108	.01
6	-184.60	0	.01
7	-112.60	0	.01
8	-20.34	0	.01
9	76.40	0	.01
10	166.46	0	.01
11	-184.60	110.50	.01
12	-112.60	110.50	.01
13	-22.60	110.50	.01
14	76.40	110.50	.01
15	166.40	112.50	.01

Lane Dimensions

The scene contains three types of roads.

Road Type 1

This figure and table provides the road type 1 lane dimensions, in m.

Variable	Dimension (m)
lw1	0.65
lw2	3.85
lw3	3.85
lw4	0.65
ml	1.5
s	4.5
mw	0.125
W	9

Road Type 2

This figure and table provides the road type 2 lane dimensions, in m.

Variable	Dimension (m)
lw1	0.73
lw2	3.77
lw3	3.77
lw4	4.5
lw5	0.73
ml	1.5
s	4.5
mw	0.125
W	13.5

Road Type 3

This figure and table provides the road type 3 lane dimensions, in m.

Variable	Dimension (m)
lw1	0.65
lw2	3.85
lw3	3.85
lw4	3.15
ml	1.5
s	4.5
mw	0.125
W	11.5

World Coordinate System

The 3D visualization environment uses a world coordinate system with axes that are fixed in the inertial reference frame.

Axis	Description
X	Forward direction of the vehicle Roll — Right-handed rotation about X-axis
Y	Extends to the right of the vehicle, parallel to the ground plane Pitch — Right-handed rotation about Y-axis
Z	Extends upwards Yaw — Left-handed rotation about Z-axis

Objects

Barrier

Locations

This table provides the object names and locations in the world coordinate system. Dimensions are in m.

Unreal Engine® Editor Name		Location
		X	Y	Z	Roll	Pitch	Yaw
f_shaped_barrier_mesh_	PropNode2552	69.71	150.15	0.09	0	0	0
	PropNode2554	74.43	150.15	0.01	0	0	0
	PropNode2559	168.36	150.15	0.01	0	0	0
	PropNode2594	-110.71	-147.37	0.01	0	0	0
	PropNode2538	-191.29	150.15	0.08	0	0	0
	PropNode2527	-192.46	-147.40	0.03	0	0	0
	PropNode2592	-102.49	-147.40	0.04	0	0	0
	PropNode2568	197.05	1.98	0.01	0	0	-90°
	PropNode2524	-204.50	-147.40	0.01	0	0	0
	PropNode2537	-240.00	-120.63	0.07	0	0	-90°
	PropNode2571	197.05	-101.32	0.06	0	0	-90°
	PropNode2586	-16.60	-147.40	0.01	0	0	0
	PropNode2540	-182.61	150.15	0.01	0	0	0
	PropNode2525	-200.71	-147.40	0.01	0	0	0
	PropNode2531	-240.00	6.67	0.12	0	0	-90°
	PropNode2530	-240.00	1.93	0.01	0	0	-90°
	PropNode2588	-29.31	-147.40	0.04	0	0	0
	PropNode2595	-114.52	-147.40	0.01	0	0	0
	PropNode2584	-24.42	-147.40	0.01	0	0	0
	PropNode2529	-240.00	-1.82	0.01	0	0	-90°
	PropNode2556	159.73	150.15	0.11	0	0	0
	PropNode2569	197.05	5.43	0.01	0	0	-90°
	PropNode2574	164.46	-147.40	0.11	0	0	-180°
	PropNode2526	-195.90	-105.25	0	0	0	0
	PropNode2561	197.05	114.37	0.01	0	0	-90°
	PropNode2575	168.39	-147.40	0.01	0	0	0
	PropNode2549	-16.49	150.15	0.11	0	0	0
	PropNode2581	82.13	-147.40	0.03	0	0	0
	PropNode2543	119.29	150.15	0.13	0	0	0
	PropNode2566	197.05	12.11	0.05	0	0	-90°
	PropNode2593	-105.93	-147.40	0.10	0	0	0
	PropNode2523	-208.80	-147.40	0.13	0	0	0
	PropNode2577	156.30	-147.40	0.03	0	0	0
	PropNode2590	-7.98	-147.40	0.03	0	0	0
	PropNode2582	65.37	-147.40	0.12	0	0	0
	PropNode2570	197.05	-114.66	0.13	0	0	-90°
	PropNode2550	-24.53	150.15	0.01	0	0	0
	PropNode2548	-29.31	150.15	0.06	0	0	0
	PropNode2567	197.05	-1.90	0.01	0	0	-90°
	PropNode2557	173.10	150.15	0.12	0	0	0
	PropNode2553	83.12	150.15	0.03	0	0	0
	PropNode2597	-122.75	-147.37	0.04	0	0	0
	PropNode2555	78.37	150.15	0.01	0	0	0
	PropNode2591	-99.03	-147.40	0.04	0	0	0
	PropNode2560	197.05	119.24	0.12	0	0	-90°
	PropNode2573	197.05	-106.00	0.01	0	0	-90°
	PropNode2547	-110.71	150.15	0.01	0	0
	PropNode2533	-240.00	103.96	0.04	0	0	-90°
	PropNode2534	-240.00	108.62	0.01	0	0	-90°
	PropNode2579	73.95	-147.40	0.01	0	0
	PropNode2564	197.05	-6.67	0.07	0	0	-90°
	PropNode2589	-32.70	-147.40	0.04	0	0
	PropNode2520	-32.70	-109.92	0.01	0	0	-90°
	PropNode2562	197.05	110.62	0.01	0	0	-90°
	PropNode2532	-240.00	100.81	0.04	0	0	-90°
	PropNode2563	197.05	105.79	0.07	0	0	-90°
	PropNode2522	-240.00	101.32	0.03	0	0	-90°
	PropNode2545	-102.57	150.15	0.03	0	0	0
	PropNode2541	-177.93	150.15	0.04	0	0	0
	PropNode2587	-11.39	147. 40	0.12	0	0	0
	PropNode2558	164.52	150.15	0.12	0	0	0
	PropNode2546	-114.50	150.15	0.01	0	0	0
	PropNode2565	-197.05	8.89	0.11	0	0	-90°
	PropNode2572	197.05	-109.93	0.01	0	0	-90°
PropNode2521	-240.00	-106.09	0.01	0	0	-90°
PropNode2536	-240.00	117.19	0.13	0	0	-90°
PropNode2528	-240.00	-6.67	0.07	0	0	-90°
PropNode2583	62.05	-147.40	0.04	0	0	0
PropNode2544	-105.91	150.15	0.10	0	0	0
PropNode2794	159.70	-147.40	0.11	0	0	0
PropNode2585	-20.74	-147.40	0.01	0	0	0
PropNode2576	173.09	-147.40	0.12	0	0	0
PropNode2535	-240.00	112.41	0.01	0	0	-90°
PropNode2551	-20.68	150.15	0.01	0	0	0
PropNode2578	70.13	-147.40	0.01	0	0	0
PropNode2596	-119.32	-147.41	0.13	0	0	0
PropNode2580	78.73	-147.40	0.11	0	0	0
PropNode2542	-174.47	-150.15	0.04	0	0	0

Traffic Lights

The US City Block scene contains 30 traffic lights, two at each of the 15 intersections. Each intersection has a traffic light group. If you have the Customize 3D Scenes for Vehicle Dynamics Simulations for customizing scenes, you can control the timing of the traffic lights.

Locations

This table provides the traffic light names and locations in the world coordinate system. Dimensions are in m. Only one of the traffic lights in the group can be green at a time. The traffic lights are green for 10 s and yellow for 3 s. At the start of the simulation, the first traffic lights in the group are green (for example, SM_TrafficLights1_3 and SM_TrafficLights2_3). The second lights in the group are red (for example, SM_TrafficLights1_4 and SM_TrafficLights2_4).

Intersection	Unreal Engine Editor Name		Location
	Traffic Light Group	Traffic Light	X	Y	Z	Roll	Pitch	Yaw
1	TrafficLightGroup	SM_TrafficLights1_3	-196.55	-100.65	0	0	0	90°
		SM_TrafficLights1_4	-210.20	-113.40	0	0	0	0
2	TrafficLightGroup2	SM_TrafficLights2_3	-106.35	98.35	0	0	0	-90°
		SM_TrafficLights2_4	-120.40	-113.50	0	0	0	0
3	TrafficLightGroup3	SM_TrafficLights3_1	-13.10	-116.20	0.2	0	0	90°
		SM_TrafficLights3_4	-30.60	-113.80	0	0	0	0
4	TrafficLightGroup4	SM_TrafficLights4_3	71.40	-100.30	0	0	0	-100°
		SM_TrafficLights4_4	64.80	-113.0	0	0	0	0
5	TrafficLightGroup5	SM_TrafficLights5_1	171.50	-115.70	0	0	0	90°
		SM_TrafficLights5_4	157.40	-113.50	0	0	0	0
6	TrafficLightGroup6	SM_TrafficLights6_2	-177.30	5.70	0	0	0	180°
		SM_TrafficLights6_3	-189.60	7.40	0	0	0	-90°
7	TrafficLightGroup7	SM_TrafficLights7_2	-105.20	5.50	0	0	0	180°
		SM_TrafficLights7_3	-117.80	7.70	0.2	0	0	-90°
8	TrafficLightGroup8	SM_TrafficLights8_1	-13.10	-7.60	0.1	0	0	90°
		SM_TrafficLights8_2	-10.90	5.60	0	0	0	180°
9	TrafficLightGroup9	SM_TrafficLights9_2	85.90	7.60	0.2	0	0	180°
		SM_TrafficLights9_3	70.90	9.20	0	0	0	-90°
10	TrafficLightGroup10	SM_TrafficLights10_1	172.10	-7.70	0	0	0	90°
		SM_TrafficLights10_2	173.70	7.50	0	0	0	180°
11	TrafficLightGroup11	SM_TrafficLights11_3	-189.80	118.45	0	0	0	-90°
		SM_TrafficLights11_4	-191.05	104.55	0	0	0	0
12	TrafficLightGroup12	SM_TrafficLights12_3	-117.60	117.60	0	0	0	-90°
		SM_TrafficLights12_4	-120.50	105.40	0	0	0	0
13	TrafficLightGroup13	SM_TrafficLights13_1	-12.80	102.50	0	0	0	90°
		SM_TrafficLights13_4	-30.50	105.30	0	0	0	0
14	TrafficLightGroup14	SM_TrafficLights14_3	70.90	118.70	0	0	0	-90°
		SM_TrafficLights14_4	69.30	105.30	0	0	0	0
15	TrafficLightGroup15	SM_TrafficLights15_1	171.40	105.20	0	0	0	90°
		SM_TrafficLights15_4	158.40	107.20	0	0	0	0

Tips

• If you have the Vehicle Dynamics Blockset™ 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 USCityBlock.

  For more details on customizing scenes, see Customize 3D Scenes for Vehicle Dynamics Simulations.

Version History

Introduced in R2018b

R2025a: Install scene

You can install the US City Block 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 City Block 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.