Display object outlines on bird's-eye plot
displays the rectangular outlines of cuboid objects on a bird's-eye plot.
Specify the position, yaw angle of rotation, length, and width of each cuboid.
The outline plotter,
olPlotter, is associated with a
birdsEyePlot object and
configures the display of the specified outlines.
To remove all outlines associated with outline plotter
olPlotter, call the
clearData function and specify
the input argument.
To display the outlines of actors that are in a driving scenario, first use
targetOutlines to get the dimensions of the actors. Then, after
outlinePlotter to create a plotter object, use the
plotOutline function to display the outlines of all the
actors in a bird's-eye plot.
Create a driving scenario. Create a 25 m road segment, add a pedestrian and a vehicle, and specify their trajectories to follow. The pedestrian crosses the road at 1 m/s. The vehicle drives along the road at 10 m/s.
scenario = drivingScenario; road(scenario,[0 0 0; 25 0 0]); p = actor(scenario,'ClassID',4,'Length',0.2,'Width',0.4,'Height',1.7); v = vehicle(scenario,'ClassID',1); trajectory(p,[15 -3 0; 15 3 0],1); trajectory(v,[v.RearOverhang 0 0; 25-v.Length+v.RearOverhang 0 0], 10);
Use a chase plot to display the scenario from the perspective of the vehicle.
Create a bird's-eye plot, outline plotter, and lane boundary plotter.
bep = birdsEyePlot('XLim',[-25 25],'YLim',[-10 10]); olPlotter = outlinePlotter(bep); lbPlotter = laneBoundaryPlotter(bep); legend('off')
Run the simulation loop. Update the plotter with outlines for the targets.
while advance(scenario) % Obtain the road boundaries and rectangular outlines. rb = roadBoundaries(v); [position,yaw,length,width,originOffset,color] = targetOutlines(v); % Update the bird's-eye plotters with the road and actors. plotLaneBoundary(lbPlotter,rb); plotOutline(olPlotter,position,yaw,length,width, ... 'OriginOffset',originOffset,'Color',color); % Allow time for plot to update. pause(0.01) end
olPlotter— Outline plotter
positions— Positions of detected objects
Positions of detected objects in vehicle coordinates, specified as an M-by-2 real-valued matrix of (X, Y) positions. M is the number of detected objects. The positive X-direction points ahead of the center of the vehicle. The positive Y-direction points to the left of the origin of the vehicle, which is the center of the rear axle, as shown in this figure of the vehicle coordinate system.
yaw— Angles of rotation
Angles of rotation for object outlines, specified as an M-element real-valued vector, where M is the number of objects.
length— Lengths of outlines
Lengths of object outlines, specified as an M-element real-valued vector, where M is the number of objects.
width— Widths of outlines
Widths of object outlines, specified as an M-element real-valued vector, where M is the number of objects.
comma-separated pairs of
the argument name and
Value is the corresponding value.
Name must appear inside quotes. You can specify several name and value
pair arguments in any order as
'OriginOffset'— Rotational centers of rectangles relative to origin
Rotational centers of rectangles relative to origin, specified as the
comma-separated pair consisting of
and an M-by-2 real-valued matrix.
M is the number of objects. Each row corresponds
to the rotational center about which to rotate the corresponding
rectangle, specified as an (X,Y)
displacement from the geometrical center of that rectangle.
'Color'— Outline color
Outline color, specified as the comma-separated pair consisting of
'Color' and an M-by-3 matrix
of RGB triplets. M is the number of objects. If you
do not specify this argument, the function uses the default colormap for
[0 0.5 0.75; 0.8 0.3