# targetPoses

Target positions and orientations relative to ego vehicle

## Syntax

``poses = targetPoses(ac)``
``poses = targetPoses(ac,range)``

## Description

example

````poses = targetPoses(ac)` returns the poses of all targets in a driving scenario with respect to the ego vehicle actor, `ac`. See Ego Vehicle and Targets for more details.```

example

````poses = targetPoses(ac,range)` returns the poses of targets that are within a specified range around the ego vehicle actor.```

## Examples

collapse all

In a simple driving scenario, obtain the poses of target vehicles in the coordinate system of the ego vehicle. Then convert these poses back to the world coordinates of the driving scenario.

Create a driving scenario.

`scenario = drivingScenario;`

Create target actors.

```actor(scenario,'ClassID',1, ... 'Position',[10 20 30], ... 'Velocity',[12 113 14], ... 'Yaw',54, ... 'Pitch',25, ... 'Roll',22, ... 'AngularVelocity',[24 42 27]); actor(scenario,'ClassID',1, ... 'Position',[17 22 12], ... 'Velocity',[19 13 15], ... 'Yaw',45, ... 'Pitch',52, ... 'Roll',2, ... 'AngularVelocity',[42 24 29]);```

```egoActor = actor(scenario,'ClassID',1, ... 'Position',[1 2 3], ... 'Velocity',[1.2 1.3 1.4], ... 'Yaw',4, ... 'Pitch',5, ... 'Roll',2, ... 'AngularVelocity',[4 2 7]);```

Use the `actorPoses` function to return the poses of all actors in the scenario. Pose properties (position, velocity, and orientation) are in the world coordinates of the driving scenario. Save the target actors to a separate variable and inspect the pose of the first target actor.

```allPoses = actorPoses(scenario); targetPosesScenarioCoords = allPoses(1:2); targetPosesScenarioCoords(1)```
```ans = struct with fields: ActorID: 1 Position: [10 20 30] Velocity: [12 113 14] Roll: 22 Pitch: 25 Yaw: 54 AngularVelocity: [24 42 27] ```

Use the `driving.scenario.targetsToEgo` function to convert the target poses to the ego-centric coordinates of the ego actor. Inspect the pose of the first actor.

```targetPosesEgoCoords = driving.scenario.targetsToEgo(targetPosesScenarioCoords,egoActor); targetPosesEgoCoords(1)```
```ans = struct with fields: ActorID: 1 Position: [7.8415 18.2876 27.1675] Velocity: [18.6826 112.0403 9.2960] Roll: 16.4327 Pitch: 23.2186 Yaw: 47.8114 AngularVelocity: [-3.3744 47.3021 18.2569] ```

Alternatively, use the `targetPoses` function to obtain all target actor poses in ego vehicle coordinates. Display the first target pose, which matches the previously calculated pose.

```targetPosesEgoCoords = targetPoses(egoActor); targetPosesEgoCoords(1)```
```ans = struct with fields: ActorID: 1 ClassID: 1 Position: [7.8415 18.2876 27.1675] Velocity: [18.6826 112.0403 9.2960] Roll: 16.4327 Pitch: 23.2186 Yaw: 47.8114 AngularVelocity: [-3.3744 47.3021 18.2569] ```

Use the `driving.scenario.targetsToScenario` to convert the target poses back to the world coordinates of the scenario. Display the first target pose, which matches the original target pose.

```targetPosesScenarioCoords = driving.scenario.targetsToScenario(targetPosesEgoCoords,egoActor); targetPosesScenarioCoords(1)```
```ans = struct with fields: ActorID: 1 ClassID: 1 Position: [10.0000 20.0000 30.0000] Velocity: [12.0000 113.0000 14.0000] Roll: 22 Pitch: 25.0000 Yaw: 54 AngularVelocity: [24.0000 42.0000 27.0000] ```

Obtain the poses of targets that are within the maximum range of a sensor mounted to the ego vehicle.

Create a driving scenario. The scenario contains a 75-meter straight road, an ego vehicle, and two target vehicles.

• The nearest target vehicle is 45 meters away and in the same lane as the ego vehicle.

• The farthest target vehicle is 65 meters away and in the opposite lane of the ego vehicle.

Plot the driving scenario.

```scenario = drivingScenario; roadCenters = [0 0 0; 75 0 0]; laneSpecification = lanespec([1 1]); road(scenario,roadCenters,'Lanes',laneSpecification,'Name','Road'); egoVehicle = vehicle(scenario, ... 'ClassID',1, ... 'Position',[4 -2 0], ... 'Name','Ego'); vehicle(scenario, ... 'ClassID',1, ... 'Position',[45 -1.7 0], ... 'Name','Near Target'); vehicle(scenario, ... 'ClassID',1, ... 'Position',[65 2 0], ... 'Yaw',-180, ... 'Name','Far Target'); plot(scenario)```

Create a vision sensor mounted to the front bumper of the ego vehicle. Configure the sensor to have a maximum detection range of 50 meters.

```sensor = visionDetectionGenerator('SensorIndex',1, ... 'SensorLocation',[3.7 0], ... 'MaxRange',50);```

Plot the outlines of the vehicles and the coverage area of the sensor. The nearest target vehicle is within range of the sensor but the farthest target vehicle is not.

```bep = birdsEyePlot; olPlotter = outlinePlotter(bep); [position,yaw,length,width,originOffset,color] = targetOutlines(egoVehicle); plotOutline(olPlotter,position,yaw,length,width, ... 'OriginOffset',originOffset,'Color',color) caPlotter = coverageAreaPlotter(bep,'DisplayName','Coverage area','FaceColor','blue'); mountPosition = sensor.SensorLocation; range = sensor.MaxRange; orientation = sensor.Yaw; fieldOfView = sensor.FieldOfView(1); plotCoverageArea(caPlotter,mountPosition,range,orientation,fieldOfView);```

Obtain the poses of targets that are within the range of the sensor. The output structure contains the pose of only the nearest target, which is under 50 meters away from the ego vehicle.

`poses = targetPoses(egoVehicle,range)`
```poses = struct with fields: ActorID: 2 ClassID: 1 Position: [41 0.3000 0] Velocity: [0 0 0] Roll: 0 Pitch: 0 Yaw: 0 AngularVelocity: [0 0 0] ```

## Input Arguments

collapse all

Actor belonging to a `drivingScenario` object, specified as an `Actor` or `Vehicle` object. To create these objects, use the `actor` and `vehicle` functions, respectively.

Circular range around the ego vehicle actor, specified as a nonnegative real scalar. The `targetPoses` function returns only the poses of targets that lie within this range. Units are in meters.

## Output Arguments

collapse all

Target poses, in ego vehicle coordinates, returned as a structure or as an array of structures. The pose of the ego vehicle actor, `ac`, is not included.

A target pose defines the position, velocity, and orientation of a target in ego vehicle coordinates. Target poses also include the rates of change in actor position and orientation.

Each pose structure has these fields.

FieldDescription
`ActorID`

Scenario-defined actor identifier, specified as a positive integer.

`ClassID`Classification identifier, specified as a nonnegative integer. `0` represents an object of an unknown or unassigned class.
`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 scalar. Units are in degrees.

`Pitch`

Pitch angle of actor, specified as a real scalar. Units are in degrees.

`Yaw`

Yaw angle of actor, specified as a real 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.

For full definitions of these structure fields, see the `actor` and `vehicle` functions.

collapse all

### Ego Vehicle and Targets

In a driving scenario, you can specify one actor as the observer of all other actors, similar to how the driver of a car observes all other cars. The observer actor is called the ego actor or, more specifically, the ego vehicle. From the perspective of the ego vehicle, all other actors (such as vehicles and pedestrians) are the observed actors, called targets. Ego vehicle coordinates are centered and oriented with reference to the ego vehicle. The coordinates of the driving scenario are world coordinates.

## Version History

Introduced in R2017a