ecef2enuv

Rotate vector from geocentric ECEF to local ENU

Syntax

  • [uEast,vNorth,wUp] = ecef2enuv(U,V,W,lat0,lon0)
  • [___] = ecef2enuv(___,angleUnit)

Description

[uEast,vNorth,wUp] = ecef2enuv(U,V,W,lat0,lon0) returns Cartesian 3-vector components in a local east-north-up (ENU) system corresponding to the 3-vector with components U, V, W in an Earth-Centered Earth-Fixed (ECEF) spheroid-centric Cartesian system. Any of the five numerical input arguments can be scalar, even when the others are nonscalar; but all nonscalar numeric arguments must match in size.

[___] = ecef2enuv(___,angleUnit) adds angleUnit which specifies the units of inputs lat0 and lon0.

Input Arguments

expand all

U — Vector x-components in ECEF systemscalar value | vector | matrix | N-D array

x-components of one or more Cartesian vectors in the spheroid-centric ECEF system, specified as a scalar value, vector, matrix, or N-D array.

Data Types: single | double

V — Vector y-components in ECEF systemscalar value | vector | matrix | N-D array

y-components of one or more Cartesian vectors in the spheroid-centric ECEF system, specified as a scalar value, vector, matrix, or N-D array.

Data Types: single | double

W — Vector z-components in ECEF systemscalar value | vector | matrix | N-D array

z-components of one or more Cartesian vectors in the spheroid-centric ECEF system, specified as a scalar value, vector, matrix, or N-D array.

Data Types: single | double

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

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

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

Data Types: char

Output Arguments

expand all

uEast — Vector x-components in ENU systemscalar value | vector | matrix | N-D array

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

vNorth — Vector y-components in ENU systemscalar value | vector | matrix | N-D array

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

wUp — Vector z-components in ENU systemscalar value | vector | matrix | N-D array

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

Was this topic helpful?