Cuboid To 3D Simulation

Convert actor from cuboid coordinates to 3D simulation coordinates

Since R2020a

• 

×

Libraries:
Automated Driving Toolbox / Driving Scenario and Sensor Modeling

Description

The Cuboid To 3D Simulation block converts a cuboid actor pose in world coordinates to the X, Y, and Yaw coordinates used by the Simulation 3D Vehicle with Ground Following block. Use the converted values to set vehicle positions within the 3D simulation environment for actors created using the Driving Scenario Designer app. The ground terrain of the scene determines the roll (x-axis rotation), pitch (y-axis rotation), and elevation (z-axis position) of the vehicle.

You can specify a bus containing a single actor pose or multiple actor poses. By default, the block converts the pose of the first actor in the bus. To specify the actor whose pose you want to convert, specify the ActorID of that actor.

In cuboid and 3D simulation driving scenarios, the coordinate systems are the same, but the origins of vehicles differ. In cuboid driving scenarios, the vehicle origin is on the ground, under the center of the rear axle. The block transforms this origin to the origin used in the 3D simulation environment, which is under the geometric center of the vehicle. The table shows the origin difference between the two environments. You must read the cuboid driving scenario using the Scenario Reader block.

Cuboid Vehicle Origin	3D Simulation Vehicle Origin

Examples

Visualize Sensor Data from Unreal Engine Simulation Environment

Visualize sensor coverage areas and detections obtained from high-fidelity radar and lidar sensors in the Unreal Engine^® simulation environment.

• Open Live Script

Ports

Input

Actor — Cuboid actor pose in world coordinates

Simulink^® bus containing MATLAB^® structure

Cuboid actor pose in world coordinates, specified as a Simulink bus containing a MATLAB structure.

To obtain this structure input, use the Scenario Reader block to read actors from a scenario. By default, the Scenario Reader block outputs actors in ego vehicle coordinates. To convert these poses from ego vehicle to world coordinates, use the Vehicle To World block.

The structure in this bus can contain a single actor pose or multiple actor poses.

Single-Pose Structure

To specify a single actor pose, the structure must contain these fields.

Field	Description
ActorID	Scenario-defined actor identifier, specified as a positive integer.
In R2024b: FrontAxlePosition	Front-axle position of the vehicle, specified as a three-element row vector in the form [x y z]. Units are in meters. Note If the driving scenario does not contain a front-axle trajectory for at least one vehicle, then the ActorPoses structure does not contain this field.
Position	Position of actor, specified as a real-valued vector of the form [x y z]. Units are in meters.
Velocity	Velocity (v) of actor in the x- y-, and z-directions, specified as a real-valued vector of the form [vx vy vz]. Units are in meters per second.
Roll	Roll angle of actor, specified as a real-valued scalar. Units are in degrees.
Pitch	Pitch angle of actor, specified as a real-valued scalar. Units are in degrees.
Yaw	Yaw angle of actor, specified as a real-valued scalar. Units are in degrees.
AngularVelocity	Angular velocity (ω) of actor in the x-, y-, and z-directions, specified as a real-valued vector of the form [ωx ωy ωz]. Units are in degrees per second.

Multiple-Pose Structure

To specify multiple actor poses, the structure must contain these fields.

Field	Description	Type
NumActors	Number of actors	Nonnegative integer
Time	Current simulation time	Real-valued scalar
Actors	Actor poses	NumActors-length array of actor pose structures

Each actor pose structure in Actors must have these fields.

Field	Description
ActorID	Scenario-defined actor identifier, specified as a positive integer.
In R2024b: FrontAxlePosition	Front-axle position of the vehicle, specified as a three-element row vector in the form [x y z]. Units are in meters. Note If the driving scenario does not contain a front-axle trajectory for at least one vehicle, then the ActorPoses structure does not contain this field.
Position	Position of actor, specified as a real-valued vector of the form [x y z]. Units are in meters.
Velocity	Velocity (v) of actor in the x- y-, and z-directions, specified as a real-valued vector of the form [vx vy vz]. Units are in meters per second.
Roll	Roll angle of actor, specified as a real-valued scalar. Units are in degrees.
Pitch	Pitch angle of actor, specified as a real-valued scalar. Units are in degrees.
Yaw	Yaw angle of actor, specified as a real-valued scalar. Units are in degrees.
AngularVelocity	Angular velocity (ω) of actor in the x-, y-, and z-directions, specified as a real-valued vector of the form [ωx ωy ωz]. Units are in degrees per second.

The block converts only one pose from the Actors array. To specify which pose to convert, select Specify Actor ID, and then specify the ActorID of the actor by using the ActorID used for conversion parameter.

Output

X — Longitudinal position of actor in 3D simulation coordinates

numeric scalar

Longitudinal position of the actor in 3D simulation coordinates, returned as a numeric scalar. Units are in meters.

In this coordinate system, when looking in the positive direction of the X-axis, the positive Y-axis points left, and the Z-axis points up.

To specify the X-position of a vehicle in the 3D simulation environment, connect this port to the X input port of a Simulation 3D Vehicle with Ground Following block.

Y — Lateral position of actor in 3D simulation coordinates

numeric scalar

Lateral position of the actor in 3D simulation coordinates, returned as a numeric scalar. Units are in meters.

In this coordinate system, when looking in the positive direction of the X-axis, the positive Y-axis points left, and the Z-axis points up.

To specify the Y-position of a vehicle in the 3D simulation environment, connect this port to the Y input port of a Simulation 3D Vehicle with Ground Following block.

Yaw — Yaw orientation angle of actor in 3D simulation coordinates

numeric scalar

Yaw orientation angle of the actor about the Z-axis in 3D simulation coordinates, returned as a numeric scalar. Units are in degrees.

In this coordinate system, when looking in the positive direction of the Z-axis, yaw is clockwise-positive. However, if you view the simulation from a 2D top-down perspective, then yaw is counterclockwise-positive, because you are viewing the scene along the negative Z-axis.

To specify the yaw orientation angle of a vehicle in the 3D simulation environment, connect this port to the Yaw input port of a Simulation 3D Vehicle with Ground Following block.

Parameters

Specify Actor ID — Enable ID specification of cuboid actor

off (default) | on

Select this parameter to enable the ActorID used for conversion parameter, where you can specify the ActorID of the cuboid actor pose to convert to 3D simulation coordinates.

If you clear this parameter, then the block converts the first actor pose in the input Actor bus.

ActorID used for conversion — ActorID value of cuboid actor

1 (default) | positive integer

ActorID value of the cuboid actor to convert to 3D simulation coordinates, specified as a positive integer. This parameter must be a valid ActorID from the input Actor bus.

Dependencies

To enable this parameter, select Specify Actor ID.

Simulate using — Type of simulation to run

Interpreted execution (default) | Code generation

• Interpreted execution — Simulate the model using the MATLAB interpreter. This option shortens startup time. In Interpreted execution mode, you can debug the source code of the block.

• Code generation — Simulate the model using generated C/C++ code. The first time you run a simulation, Simulink generates C/C++ code for the block. The C code is reused for subsequent simulations as long as the model does not change. This option requires additional startup time.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2020a