Documentation Center

  • 評価版
  • 製品アップデート

ecef2aer

Geocentric ECEF to local spherical AER

Syntax

  • [az,elev,slantRange] = ecef2aer(X,Y,Z,lat0,lon0,h0,spheroid)
  • [___] = ecef2aer(___,angleUnit)

Description

[az,elev,slantRange] = ecef2aer(X,Y,Z,lat0,lon0,h0,spheroid) returns coordinates in a local spherical system corresponding to coordinates X, Y, Z in an Earth-Centered Earth-Fixed (ECEF) spheroid-centric Cartesian system. Any of the first six numeric input arguments can be scalar, even when the others are nonscalar; but all nonscalar numeric arguments must match in size.

[___] = ecef2aer(___,angleUnit) adds angleUnit which specifies the units of inputs lat0, lon0, and outputs az, elev.

Input Arguments

expand all

X — ECEF x-coordinatesscalar value | vector | matrix | N-D array

x-coordinates of one or more points in the spheroid-centric ECEF system, specified as a scalar value, vector, matrix, or N-D array. Values must be in units that match the LengthUnit property of the spheroid object.

Data Types: single | double

Y — ECEF y-coordinatesscalar value | vector | matrix | N-D array

y-coordinates of one or more points in the spheroid-centric ECEF system, specified as a scalar value, vector, matrix, or N-D array. Values must be in units that match the LengthUnit property of the spheroid object.

Data Types: single | double

Z — ECEF y-coordinatesscalar value | vector | matrix | N-D array

z-coordinates of one or more points in the spheroid-centric ECEF system, returned as a scalar value, vector, matrix, or N-D array. Units are determined by the LengthUnit property of the spheroid object.

lat0 — Geodetic latitude of local originscalar value | vector | matrix | N-D array

Geodetic latitude of local origin (reference) point(s), specified as a scalar value, vector, matrix, or N-D array. In many cases there is one origin (reference) point, and the value of lat0 is scalar, but it need not be. (It may refer to a moving platform, for example). Values must be in units that match the input argument angleUnit, if supplied, and in degrees, otherwise.

Data Types: single | double

lon0 — Longitude of local originscalar value | vector | matrix | N-D array

Longitude of local origin (reference) point(s), specified as a scalar value, vector, matrix, or N-D array. In many cases there is one origin (reference) point, and the value of lon0 is scalar, but it need not be. (It may refer to a moving platform, for example). Values must be in units that match the input argument angleUnit, if supplied, and in degrees, otherwise.

Data Types: single | double

h0 — Ellipsoidal height of local originscalar value | vector | matrix | N-D array

Ellipsoidal height of local origin (reference) point(s), specified as a scalar value, vector, matrix, or N-D array. In many cases there is one origin (reference) point, and the value of h0 is scalar, but it need not be. (It may refer to a moving platform, for example). Units are determined by the LengthUnit property of the spheroid input.

Data Types: single | double

spheroid — Reference spheroidscalar referenceEllipsoid | oblateSpheroid | referenceSphere object

Reference spheroid, specified as a scalar referenceEllipsoid, oblateSpheroid, or referenceSphere object.

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

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

Data Types: char

Output Arguments

expand all

az — Azimuth anglesscalar value | vector | matrix | N-D array

Azimuth angles in the local spherical system, returned as a scalar value, vector, matrix, or N-D array. Azimuths are measured clockwise from north. Units are determined by the input argument angleUnit, if supplied; values are in degrees, otherwise. When in degrees, they lie in the half-open interval [0 360).

elev — Elevation anglesscalar value | vector | matrix | N-D array

Elevation angles in the local spherical system, returned as a scalar value, vector, matrix, or N-D array. Elevations are with respect to a plane perpendicular to the spheroid surface normal. Units determined by the input argument angleUnit, if supplied; values are in degrees, otherwise. When in degrees, they lie in the closed interval [-90 90].

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

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

See Also

| | |

Was this topic helpful?