Main Content

platformPoses

Positions, velocities, and orientations of all platforms in tracking scenario

Description

poses = platformPoses(sc) returns the current poses for all platforms in the tracking scenario, sc. Pose is the position, velocity, and orientation of a platform relative to scenario coordinates. Platforms are Platform objects.

poses = platformPoses(sc,fmt) also specifies the format, fmt, of the returned platform orientation.

poses = platformPoses(___,'CoordinateSystem',coordinate) specifies the coordinate system of the poses output. You can only use this syntax only when the IsEarthCentered property of the tracking scenario,sc, is set to true.

Input Arguments

expand all

Tracking scenario, specified as a trackingScenario object.

Pose orientation format, specified as 'quaternion' or 'rotmat'. When specified as 'quaternion', the Orientation field of the platform pose structure is a quaternion. When specified as 'rotmat', the Orientation field is a rotation matrix.

Example: 'rotmat'

Data Types: char

Coordinate system to report poses, specified as:

  • 'Cartesian' — Report poses using Cartesian coordinates in the Earth-Centered-Earth-Fixed coordinate frame.

  • 'Geodetic' — Report positions using geodetic coordinates (latitude, longitude, and altitude). Report orientation, velocity, and acceleration in the local reference frame of each platform (North-East-Down by default) corresponding to the current waypoint.

.

You can only use this argument when the IsEarthCentered property of the tracking scenario,sc, is set to true.

Output Arguments

expand all

Poses of all platforms in the tracking scenario, returned as a structure or array of structures. The pose structure contains these fields:

FieldDescription
PlatformID

Unique identifier for the platform, specified as a positive integer. This is a required field with no default value.

ClassID

User-defined integer used to classify the type of target, specified as a nonnegative integer. Zero is reserved for unclassified platform types and is the default value.

Position

Position of target in scenario coordinates, specified as a real-valued 1-by-3 row vector.

  • If the coordinateSystem argument is specified as 'Cartesian', the Position is the 3-element Cartesian position coordinates in meters.

  • If the coordinateSystem argument is specified as 'Geodetic', the Position is the 3-element geodetic coordinates: latitude in degrees, longitude in degrees, and altitude in meters.

Velocity

Velocity of platform in scenario coordinates, specified as a real-valued 1-by-3 row vector. units are meters per second. The default value is [0 0 0].

Acceleration

Acceleration of the platform in scenario coordinates, specified as a 1-by-3 row vector in meters per second squared. The default value is [0 0 0].

Orientation

Orientation of the platform with respect to the local scenario navigation frame, specified as a scalar quaternion or a 3-by-3 rotation matrix. Orientation defines the frame rotation from the local navigation coordinate system to the current platform body coordinate system. Units are dimensionless. The default value is quaternion(1,0,0,0).

AngularVelocity

Angular velocity of the platform in scenario coordinates, specified as a real-valued 1-by-3 vector. The magnitude of the vector defines the angular speed. The direction defines the axis of clockwise rotation. units are degrees per second. The default value is [0 0 0].

Data Types: struct

Introduced in R2018b