Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

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

collapse all

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-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-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.

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

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

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

Reference spheroid, specified as a referenceEllipsoid, oblateSpheroid, or referenceSphere object. Use the constructor for one of these three classes, or the wgs84Ellipsoid function, to construct a Mapping Toolbox spheroid object. You can not directly pass in the name of your spheroid. Instead, pass that name to referenceEllipsoid or referenceSphere and use the resulting object.

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

Data Types: char

Output Arguments

collapse all

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).

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].

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.

Introduced in R2012b

Was this topic helpful?