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` — 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 spheroidreferenceEllipsoid | oblateSpheroid | referenceSphere

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 a string that names your spheroid. Instead, pass that string to `referenceEllipsoid` or `referenceSphere` and use the resulting object.

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

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

Data Types: `char`

Output Arguments

collapse all

`xNorth` — Local NED x-coordinatesscalar value | vector | matrix | N-D array

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.

`yEast` — Local NED y-coordinatesscalar value | vector | matrix | N-D array

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.

`zDown` — Local NED z-coordinatesscalar value | vector | matrix | N-D array

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.