# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English version of the page.

# geodetic2aer

Geodetic to local spherical AER

## Syntax

``````[az,elev,slantRange] = geodetic2aer(lat,lon,h,lat0,lon0,h0,spheroid)``````
``[___] = geodetic2aer(___,angleUnit)``

## Description

example

``````[az,elev,slantRange] = geodetic2aer(lat,lon,h,lat0,lon0,h0,spheroid)``` returns coordinates in a local spherical system corresponding to geodetic coordinates `lat`, `lon`, `h`. `spheroid` is an instance of a reference spheroid object. 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.```
````[___] = geodetic2aer(___,angleUnit)` adds `angleUnit` which specifies the units of inputs `lat`, `lon`, `lat0`, `lon0`, and outputs `az`, `elev`.```

## Examples

collapse all

Compute the azimuth (in degrees), elevation angle (in degrees), and line of sight distance from Zermatt, Switzerland to the summit of the Matterhorn (Monte Cervino). All distances and lengths are in meters.

Origin (reference point): Zermatt.

```fmt = get(0,'Format'); format short g lat0 = dm2degrees([46 1]) % convert degree-minutes to degrees lon0 = dm2degrees([ 7 45]) hOrthometric0 = 1620; hGeoid = 53; h0 = hOrthometric0 + hGeoid```
```lat0 = 46.017 lon0 = 7.75 h0 = 1673```

Point of Interest: Summit of Matterhorn.

```lat = dms2degrees([45 58 35]) lon = dms2degrees([ 7 39 30]) hOrthometric = 4478; hGeoid = 53; h = hOrthometric + hGeoid ```
```lat = 45.976 lon = 7.6583 h = 4531```

Azimuth, elevation angle, and slant range (line of sight distance) from Zermatt to Matterhorn summit.

```spheroid = referenceEllipsoid('WGS 84') [az,elev,slantRange] = geodetic2aer( ... lat,lon,h,lat0,lon0,h0,spheroid) format(fmt) ```
```spheroid = referenceEllipsoid with defining properties: Code: 7030 Name: 'World Geodetic System 1984' LengthUnit: 'meter' SemimajorAxis: 6378137 SemiminorAxis: 6356752.31424518 InverseFlattening: 298.257223563 Eccentricity: 0.0818191908426215 and additional properties: Flattening ThirdFlattening MeanRadius SurfaceArea Volume az = 237.8 elev = 18.755 slantRange = 8871.7```

## Input Arguments

collapse all

Geodetic latitudes of one or more points, specified as a scalar value, vector, matrix, or N-D array. Values must be in units that match the input argument `angleUnit`, if supplied, and in degrees, otherwise.

Data Types: `single` | `double`

Longitudes of one or more points, specified as a scalar value, vector, matrix, or N-D array. Values must be in units that match the input argument `angleUnit`, if supplied, and in degrees, otherwise.

Data Types: `single` | `double`

Ellipsoidal heights of one or more points, 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`

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. To create a spheroid object, use the creation function specific to the object, or the `wgs84Ellipsoid` function.

Example: `spheroid = referenceEllipsoid('GRS 80');`

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.