ned2ecefv

Rotate local north-east-down vector to geocentric Earth-centered Earth-fixed

Syntax

[U,V,W] = ned2ecefv(uNorth,vEast,wDown,lat0,lon0)

[___] = ned2ecefv(___,angleUnit)

Description

[U,V,W] = ned2ecefv(uNorth,vEast,wDown,lat0,lon0) returns vector components U, V, and W in a geocentric Earth-centered Earth-fixed (ECEF) system corresponding to vector components uNorth, vEast, and wDown in a local north-east-down (NED) system. Specify the origin of the system with the geodetic coordinates lat0 and lon0. Each coordinate input argument must match the others in size or be scalar.

[___] = ned2ecefv(___,angleUnit) specifies the units for latitude and longitude. Specify angleUnit as 'degrees' (the default) or 'radians'.

Examples

Calculate ECEF Vector Components from NED Components

Find the ECEF velocity components of an aircraft using its NED velocity components.

Specify the geodetic coordinates of the aircraft in degrees and the NED velocity components in kilometers per hour.

lat0 = 61.64;
lon0 = 30.70;

uNorth = -434.0403;
vEast = 152.4451;
wDown = -684.6964;

Calculate the ECEF components of the aircraft. The units for the ECEF components match the units for the NED components. Thus, the ECEF components are returned in kilometers per hour. The rotation performed by ned2ecefv does not affect the speed of the aircraft.

[U,V,W] = ned2ecefv(uNorth,vEast,wDown,lat0,lon0)

U = 530.2445

V = 492.1283

W = 396.3459

Reverse the rotation using the ecef2nedv function.

[uNorth,vEast,wDown] = ecef2nedv(U,V,W,lat0,lon0)

uNorth = -434.0403

vEast = 152.4451

wDown = -684.6964

Input Arguments

uNorth — NED x-components

scalar value | vector | matrix | N-D array

NED x-components of one or more vectors in the local NED system, specified as a scalar value, vector, matrix, or N-D array.

Data Types: single | double

vEast — NED y-components

scalar value | vector | matrix | N-D array

NED y-components of one or more vectors in the local NED system, specified as a scalar value, vector, matrix, or N-D array.

Data Types: single | double

wDown — NED z-components

scalar value | vector | matrix | N-D array

NED z-components of one or more vectors in the local NED system, specified as a scalar value, vector, matrix, or N-D array.

Data Types: single | double

lat0 — Geodetic latitude of local origin

scalar | vector | matrix | N-D array

Geodetic latitude of the local origin, specified as a scalar, vector, matrix, or N-D array. The local origin can refer to one point or a series of points (for example, a moving platform). Specify the values in degrees. To use values in radians, specify the angleUnit argument as 'radians'.

Data Types: single | double

lon0 — Geodetic longitude of local origin

scalar | vector | matrix | N-D array

Geodetic longitude of the local origin, specified as a scalar, vector, matrix, or N-D array. The local origin can refer to one point or a series of points (for example, a moving platform). Specify the values in degrees. To use values in radians, specify the angleUnit argument as 'radians'.

Data Types: single | double

angleUnit — Angle units

'degrees' (default) | 'radians'

Angle units, specified as 'degrees' (the default) or 'radians'.

Output Arguments

U — ECEF x-components

scalar value | vector | matrix | N-D array

ECEF x-components of one or more vectors, returned as a scalar value, vector, matrix, or N-D array. Values are returned in the units specified by uNorth, vEast, and wDown.

V — ECEF y-components

scalar value | vector | matrix | N-D array

ECEF y-components of one or more vectors, returned as a scalar value, vector, matrix, or N-D array. Values are returned in the units specified by uNorth, vEast, and wDown.

W — ECEF z-components

scalar value | vector | matrix | N-D array

ECEF z-components of one or more vectors, returned as a scalar value, vector, matrix, or N-D array. Values are returned in the units specified by uNorth, vEast, and wDown.

Tips

To transform coordinate locations instead of vectors, use the ned2ecef function.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.