GeoPositionXYZ

GeoPositionXYZ[{x,y,z}]

represents a position in a Cartesian geocentric coordinate system.

GeoPositionXYZ[{x,y,z},datum]

represents a point referred to the specified datum.

GeoPositionXYZ[{{x1,y1,z1},{x2,y2,z2},},datum]

represents an array of points in a Cartesian geocentric coordinate system.

GeoPositionXYZ[entity]

returns the Cartesian geocentric position of the given geographical entity.

Details

  • GeoPositionXYZ uses an Earth-centered, Earth-fixed Cartesian coordinate system.
  • In GeoPositionXYZ[{x,y,z}], coordinate numeric values x,y,z are assumed to be in meters.
  • GeoPositionXYZ[{x,y,z,t}] includes a time t measured in seconds since the beginning of January 1, 1900 in the GMT time zone.
  • A GeoPositionXYZ object with no explicit time assumes the current date.
  • GeoPositionXYZ[{x,y,z}] assumes the default datum "ITRF00".
  • Standard datums can be specified by name. Typical named datums include:
  • "ITRF00"International Terrestrial Reference Frame 2000
    "NAD27"North American Datum of 1927
    "NAD83CORS96"North American Datum of 1983 (CORS96)
  • The complete list of named datums and reference ellipsoids is given by GeodesyData[].
  • GeoPositionXYZ[GeoPositionXYZ[{x,y,z},datum1],datum2] converts between datums.
  • GeoPositionXYZ[pos,datum] converts from any geographic position type. The following geographic position types can be given: GeoPosition, GeoPositionXYZ, GeoPositionENU, GeoGridPosition.
  • GeoPositionXYZ[pos] converts from any type of geographic position, keeping the same datum of pos.
  • For extended entities, GeoPositionXYZ[entity] uses when possible the position of the geographic center of the entity.
  • GeoPositionXYZ[][prop] gives the specified property of a Cartesian geo position.
  • Possible properties include:
  • "AbsoluteTime"date as number of seconds since Jan 1, 1900, 00:00 GMT
    "Count"number of positions in the GeoPositionXYZ object
    "Data"first argument of the GeoPositionXYZ object
    "DateList"date list {y,m,d,h,m,s} in GMT time
    "DateObject"full date object
    "Datum"datum of the GeoPositionYXZ object
    "Depth"point depth: 0 for a single position, 1 for a list of them,
    "Dimension"number of coordinates for each position
    "PackingType"Integer or Real if data is packed; None otherwise
    "X"numeric coordinate x in meters
    "Y"numeric coordinate y in meters
    "Z"numeric coordinate z in meters
    "XYZ"numeric {x,y,z} triple in meters
    "XY"numeric {x,y} pair in meters
    "XZ"numeric {x,z} pair in meters
    "YZ"numeric {y,z} pair in meters

Examples

open all close all

Basic Examples  (4)

Geodetic point defined by its Earth-centered Cartesian coordinates in meters:

In[1]:=
Click for copyable input
Out[1]=

Convert to its {lat,lon,height} form:

In[2]:=
Click for copyable input
Out[2]=

Cartesian coordinates of a geographic location:

In[1]:=
Click for copyable input
Out[1]=

Current Cartesian coordinates and time for the International Space Station:

In[1]:=
Click for copyable input
Out[1]=

Convert Earth-centered coordinates from the default "ITRF00" datum to the "NAD83CORS96" datum:

In[1]:=
Click for copyable input
Out[1]=

Convert back to the "ITRF00" datum, with numerical errors smaller than a micrometer:

In[2]:=
Click for copyable input
Out[2]=

Scope  (11)

Generalizations & Extensions  (3)

Applications  (2)

Properties & Relations  (6)

Introduced in 2008
(7.0)
|
Updated in 2019
(12.0)