Accelerating the pace of engineering and science

aer2enu

Local spherical AER to local Cartesian ENU

Syntax

• [xEast,yNorth,zUp] = aer2enu(az,elev,slantRange)
• [___] = aer2enu(___,angleUnit)

Description

[xEast,yNorth,zUp] = aer2enu(az,elev,slantRange) returns coordinates in a local east-north-up (ENU) Cartesian system corresponding to coordinates az, elev, slantRange in a local spherical system having the same origin. Any of the three numerical input arguments can be scalar, even when the others are nonscalar; but all nonscalar numeric arguments must match in size.

[___] = aer2enu(___,angleUnit) adds angleUnit which specifies the units of inputs az and elev..

Input Arguments

expand all

az — Azimuth angles scalar value | vector | matrix | N-D array

Azimuth angles in the local spherical system, specified as a scalar, vector, matrix, or N-D array. Azimuths are measured clockwise from north. Values must be in units that match the input argument angleUnit, if supplied, and in degrees, otherwise.

Data Types: single | double

elev — Elevation angles scalar value | vector | matrix | N-D array

Elevation angles in the local spherical system, specified as a scalar, vector, matrix, or N-D array. Elevations are with respect to a plane perpendicular to the spheroid surface normal. Values must be in units that match the input argument angleUnit, if supplied, and in degrees, otherwise.

Data Types: single | double

slantRange — Distances from local originscalar value | vector | matrix | N-D array

Distances from origin in the local spherical system, returned as a scalar, vector, matrix, or N-D array. The straight-line, 3-D Cartesian distance is used. Units are determined by the LengthUnit property of the spheroid input.

Data Types: single | double

angleUnit — Units of angles'degrees' (default) | 'radians'

Units of angles, specified as ‘degrees' (default), or 'radians'.

Data Types: char

Output Arguments

expand all

xEast — Local ENU x-coordinatesscalar value | vector | matrix | N-D array

x-coordinates of one or more points in the local ENU system, returned as a scalar value, vector, matrix, or N-D array.

yNorth — Local ENU y-coordinatesscalar value | vector | matrix | N-D array

y-coordinates of one or more points in the local ENU system, returned as a scalar value, vector, matrix, or N-D array.

zUp — Local ENU z-coordinatesscalar value | vector | matrix | N-D array

z-coordinates of one or more points in the local ENU system, returned as a scalar value, vector, matrix, or N-D array.