enu2geodetic
Transform local east-north-up coordinates to geodetic
Syntax
Description
[
transforms the local east-north-up (ENU) Cartesian coordinates specified by
lat
,lon
,h
]
= enu2geodetic(xEast
,yNorth
,zUp
,lat0
,lon0
,h0
,spheroid
)xEast
, yNorth
, and
zUp
to the geodetic coordinates specified by
lat
, lon
, and h
.
Specify the origin of the local ENU system with the geodetic coordinates
lat0
, lon0
, and
h0
. Each coordinate input argument must match the others
in size or be scalar. Specify spheroid
as the reference
spheroid for the geodetic coordinates.
[___] = enu2geodetic(___,
specifies the units for latitude and longitude. Specify
angleUnit
)angleUnit
as 'degrees'
(the default) or
'radians'
.
Examples
Calculate Geodetic Coordinates from ENU Coordinates
Find the geodetic coordinates of the Matterhorn, using the ENU coordinates of the Matterhorn with respect to the geodetic coordinates of Zermatt, Switzerland.
First, specify the reference spheroid as WGS84. For more information about WGS84, see Comparison of Reference Spheroids. The units for ellipsoidal height and ENU coordinates must match the units specified by the LengthUnit
property of the reference spheroid. The default length unit for the reference spheroid created by wgs84Ellipsoid
is 'meter'
.
wgs84 = wgs84Ellipsoid;
Specify the geodetic coordinates of the local origin. In this example, the local origin is Zermatt. Specify h0
as ellipsoidal height in meters.
lat0 = 46.017; lon0 = 7.750; h0 = 1673;
Specify the ENU coordinates of the point of interest. In this example, the point of interest is the Matterhorn.
xEast = -7134.8; yNorth = -4556.3; zUp = 2852.4;
Then, calculate the geodetic coordinates of the Matterhorn. The result h
is the ellipsoidal height of the mountain in meters. To view the results in standard notation, specify the display format as shortG
.
format shortG
[lat,lon,h] = enu2geodetic(xEast,yNorth,zUp,lat0,lon0,h0,wgs84)
lat = 45.976
lon = 7.658
h = 4531
Reverse the transformation using the geodetic2enu
function.
[xEast,yNorth,zUp] = geodetic2enu(lat,lon,h,lat0,lon0,h0,wgs84)
xEast = -7134.8
yNorth = -4556.3
zUp = 2852.4
Input Arguments
xEast
— ENU x-coordinates
scalar | vector | matrix | N-D array
ENU x-coordinates of one or more points in the local ENU system,
specified as a scalar, vector, matrix, or N-D array. Specify values in units that match
the LengthUnit
property of the spheroid
argument. For example, the default length unit for the reference ellipsoid created by
wgs84Ellipsoid
is
'meter'
.
Data Types: single
| double
yNorth
— ENU y-coordinates
scalar | vector | matrix | N-D array
ENU y-coordinates of one or more points in the local ENU system,
specified as a scalar, vector, matrix, or N-D array. Specify values in units that match
the LengthUnit
property of the spheroid
argument. For example, the default length unit for the reference ellipsoid created by
wgs84Ellipsoid
is
'meter'
.
Data Types: single
| double
zUp
— ENU z-coordinates
scalar | vector | matrix | N-D array
ENU z-coordinates of one or more points in the local ENU system,
specified as a scalar, vector, matrix, or N-D array. Specify values in units that match
the LengthUnit
property of the spheroid
argument. For example, the default length unit for the reference ellipsoid created by
wgs84Ellipsoid
is
'meter'
.
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
h0
— Ellipsoidal height of local origin
scalar | vector | matrix | N-D array
Ellipsoidal height 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 values in units that match the LengthUnit
property
of the spheroid
object. For example, the default length unit for
the reference ellipsoid created by wgs84Ellipsoid
is 'meter'
.
For more information about ellipsoidal height, see Find Ellipsoidal Height from Orthometric Height.
Data Types: single
| double
spheroid
— Reference spheroid
referenceEllipsoid
object | oblateSpheroid
object | referenceSphere
object
Reference spheroid, specified as a referenceEllipsoid
object, oblateSpheroid
object, or referenceSphere
object. The term reference spheroid is used synonymously
with reference ellipsoid. To create a reference spheroid, use the creation function for
the object. To specify the reference ellipsoid for WGS84, use the wgs84Ellipsoid
function.
For more information about reference spheroids, see Comparison of Reference Spheroids.
Example: spheroid = referenceEllipsoid('GRS 80');
angleUnit
— Angle units
'degrees'
(default) | 'radians'
Angle units, specified as 'degrees'
(the default) or
'radians'
.
Output Arguments
lat
— Geodetic latitude
scalar | vector | matrix | N-D array
Geodetic latitude of one or more points, returned as a scalar, vector, matrix, or N-D
array. Values are specified in degrees within the interval [-90 90]
.
To use values in radians, specify the angleUnit
argument as
'radians'
.
lon
— Geodetic longitude
scalar | vector | matrix | N-D array
Geodetic longitude of one or more points, returned as a scalar, vector, matrix, or N-D
array. Values are specified in degrees within the interval [-180
180]
. To use values in radians, specify the angleUnit
argument as 'radians'
.
h
— Ellipsoidal height
scalar | vector | matrix | N-D array
Ellipsoidal height of one or more points, returned as a scalar, vector, matrix, or N-D
array. Values are specified in units that match the LengthUnit
property of the spheroid
object. For example, the default length
unit for the reference ellipsoid created by wgs84Ellipsoid
is 'meter'
.
For more information about ellipsoidal height, see Find Ellipsoidal Height from Orthometric Height.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Version History
Introduced in R2012bR2021a: Generate C and C++ code using MATLAB Coder
The enu2geodetic
function supports code generation.
See Also
Commande MATLAB
Vous avez cliqué sur un lien qui correspond à cette commande MATLAB :
Pour exécuter la commande, saisissez-la dans la fenêtre de commande de MATLAB. Les navigateurs web ne supportent pas les commandes MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)