Documentation Center

  • Trial Software
  • Product Updates

ecefOffset

Class: referenceEllipsoid

Cartesian ECEF offset between geodetic positions

Syntax

[U,V,W] = ecefOffset(spheroid,lat1,lon1,h1,lat2,lon2,h2)
[U,V,W] = ecefOffset(___, angleUnit)

Description

[U,V,W] = ecefOffset(spheroid,lat1,lon1,h1,lat2,lon2,h2) returns the components of the 3-D offset vector from an initial geodetic position specified bylat1,lon1,h1 to a final position specified by lat2,lon2,h2 with respect to an Earth-Centered Earth-Fixed (ECEF) spheroid-centric Cartesian system. Any of the six numerical arguments can be scalar, even when the others are nonscalar; but all nonscalar numeric arguments must match in size.

[U,V,W] = ecefOffset(___, angleUnit) adds angleUnit which specifies the units of inputs lat1, lon1, lat2, and lon2.

Input Arguments

expand all

spheroid — Reference spheroidscalar referenceEllipsoid | oblateSpheroid | referenceSphere object

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

lat1 — Initial geodetic latitudesscalar value | vector | matrix | N-D array

Geodetic latitudes of one or more initial positions, 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

lon1 — Initial longitudesscalar value | vector | matrix | N-D array

Longitudes of one or more initial positions, 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

h1 — Initial ellipsoidal heightsscalar value | vector | matrix | N-D array

Ellipsoidal heights of one or more initial positions, 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

lat2 — Final geodetic latitudesscalar value | vector | matrix | N-D array

Geodetic latitudes of one or more final positions, 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

lon2 — Final longitudesscalar value | vector | matrix | N-D array

Longitudes of one or more final positions, 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

h2 — Final ellipsoidal heightsscalar value | vector | matrix | N-D array

Ellipsoidal heights of one or more final positions, 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

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

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

Data Types: char

Output Arguments

expand all

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

x-components of one or more Cartesian offset vectors in the spheroid-centric ECEF system, returned as a scalar value, vector, matrix, or N-D array. Values equal the difference in ECEF x-coordinates between initial and final positions. Units are determined by the LengthUnit property of the spheroid object.

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

y-components of one or more Cartesian offset vectors in the spheroid-centric ECEF system, returned as a scalar value, vector, matrix, or N-D array. Values equal the difference in ECEF y-coordinates between initial and final positions. Units are determined by the LengthUnit property of the spheroid object.

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

z-components of one or more Cartesian offset vectors in the spheroid-centric ECEF system, returned as a scalar value, vector, matrix, or N-D array. Values equal the difference in ECEF z-coordinates between initial and final positions. Units are determined by the LengthUnit property of the spheroid object.

See Also

|

Was this topic helpful?