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.

ecef2ned

Geocentric ECEF to local Cartesian NED

Syntax

``````[xNorth,yEast,zDown] = ecef2ned(X,Y,Z,lat0,lon0,h0,spheroid)``````
``[___] = ecef2ned(___,angleUnit)``

Description

``````[xNorth,yEast,zDown] = ecef2ned(X,Y,Z,lat0,lon0,h0,spheroid)``` returns coordinates in a local north-east-down (NED) Cartesian 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.```
````[___] = ecef2ned(___,angleUnit)` adds `angleUnit` which specifies the units of inputs `lat0`, and `lon0`.```

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

x-coordinates of one or more points in the local NED system, returned as a scalar value, vector, matrix, or N-D array. Units are determined by the `LengthUnit` property of the `spheroid` input.

y-coordinates of one or more points in the local NED system, returned as a scalar value, vector, matrix, or N-D array. Units are determined by the `LengthUnit` property of the `spheroid` input.

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