Engee documentation

targetPoses

The positions of all targets in the scenario relative to the platform.

Library

EngeeRadars

Syntax

Function call

  • poses = targetPoses(plat) — returns the positions of all targets in the scenario relative to the observation platform plat. Targets are defined as platforms observable from the platform plat. The position represents the coordinates, velocity and orientation of the target in the coordinate system of the platform plat. Targets must be pre-added to the radar scenario.

  • poses = targetPoses(plat,format) — also allows you to set the format of the platform orientation representation: "quaternion" or "rotmat".

Arguments

Input arguments

# plat — surveillance platform

+ Platform object

Details

Observation platform specified as a system object EngeeRadars.Platform using the function platform. Targets are defined as the platforms visible by the object plat. Platforms (targets) must be added in advance to the radar scenario.

# format — position orientation format

+ "quaternion" (by default) | "rotmat"

Details

The format of the platform position orientation, set by one of the following values:

  • "quaternion" — field Orientation in the structure poses returned as a quaternion;

  • "rotmat" — field Orientation It is returned as a rotation matrix.

Типы данных

String

Output arguments

# poses — positions of all goals

+ Structure | array of structures

Details

The positions of all targets in the scenario relative to the observing platform plat, returned as a structure or an array of structures. Position of the observation platform plat it is not included in the output data. The position consists of the coordinates, velocity, orientation and signature of the target in the coordinate system of the platform. Each structure contains the following fields:

  • PlatformID — unique platform identifier specified as a positive integer. This is a required field that does not have a by default value.

  • ClassID — Goal classification ID set as a non-negative integer. Value 0 reserved by default for unclassified platform types.

  • Position — the position of the target in meters in the coordinate system of the platform, specified as a real vector of length 3. This is a required field that does not have a by default value.

  • Velocity — target velocity in m/s in the platform coordinate system, specified as a real row vector of length 3. By default: [0 0 0].

  • Acceleration — acceleration of the target in m/s ^2 ^ in the coordinate system of the platform, specified as a row vector of length 3. By default: [0 0 0].

  • Orientation — the orientation of the target relative to the coordinate system of the platform, specified as a scalar quaternion or a rotation matrix of the size 3 on 3. The orientation determines the rotation of the coordinate system from the platform coordinate system to the current coordinate system of the target body. A dimensionless quantity. By default: quaternion(1,0,0,0).

  • AngularVelocity — the angular velocity of the target in degrees per second in the platform coordinate system, specified as a real row vector of length 3. The vector module determines the angular velocity, and the direction sets the axis of rotation clockwise. By default: [0 0 0].

Типы данных

struct