geodetic2ned

Geodetic to local Cartesian NED

Syntax

  • [xNorth,yEast,zDown] = geodetic2ned(lat,lon,h,lat0,lon0,h0,spheroid)
  • [___] = geodetic2ned(___,angleUnit)

Description

[xNorth,yEast,zDown] = geodetic2ned(lat,lon,h,lat0,lon0,h0,spheroid) transforms point locations from geodetic coordinates (lat, lon, h) to local, north-east-down (NED), Cartesian coordinates (xNorth, yEast, zDown), given a local coordinate system defined by the geodetic coordinates of its origin (lat0, lon0, h0). The geodetic coordinates refer to the reference body specified by the spheroid object, spheroid. Each coordinate input argument must match the others in size or be scalar.

[___] = geodetic2ned(___,angleUnit) specifies the unit of the latitude and longitude input arguments, lat, lon, lat0, and lon0.

Input Arguments

expand all

lat — Geodetic latitudesscalar value | vector | matrix | N-D array

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

lon — Longitudesscalar value | vector | matrix | N-D array

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

h — Ellipsoidal heightsscalar value | vector | matrix | N-D array

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

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 spheroidscalar referenceEllipsoid | oblateSpheroid | referenceSphere object

Reference spheroid, specified as a scalar referenceEllipsoid, oblateSpheroid, or referenceSphere object.

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

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

Data Types: char

Output Arguments

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

Was this topic helpful?