GeodeticPoint
A metatype for representing a 3D point using geodetic coordinates.
Attributes
| Name | Type | Description |
|---|---|---|
| latitude | double |
Geodetic latitude, in deg. |
| longitude | double |
Geodetic longitude, in deg. |
| altitude | double |
Altitude w.r.t. the WGS84 ellipsoid, in m. |
Note
Geodetic coordinates are w.r.t. the WGS84 ellipsoid, e.g. as GPS coordinates. In order to get the altitude w.r.t. the sea level one must correct from the geoid undulations.
Constructor
Synopsis
pumas.GeodeticPoint(latitude, longitude, altitude)
pumas.GeodeticPoint{latitude=, longitude=, altitude=}
pumas.GeodeticPoint(coordinates)
Note
For the two first forms the latitude, longitude and altitude arguments are optional, but for the sake of simplicity only the full forms are reported. When an argument is missing the corresponding attribute is set to zero.
Arguments
| Name | Type | Description |
|---|---|---|
| latitude | number |
Geodetic latitude, in deg. |
| longitude | number |
Geodetic longitude, in deg. |
| altitude | number |
Altitude w.r.t. the WGS84 ellipsoid, in m. |
| coordinates | Coordinates | Other point coordinates e.g. as returned by State.position. |
See also
CartesianPoint, CartesianVector, HorizontalVector, SphericalPoint, SphericalVector.
GeodeticPoint.clone
Get a copy (clone) of the coordinates instance.
Synopsis
GeodeticPoint:clone()
Arguments
None, except self.
Returns
| Type | Description |
|---|---|
| GeodeticPoint | Copy of the point coordinates. |
See also
GeodeticPoint.get
Get the point coordinates as a double [3] array of x, y and z
Cartesian coordinates. The coordinates are given in the Earth-Centered
Earth-Fixed (ECEF) reference frame.
Synopsis
GeodeticPoint:get()
Arguments
None, except self.
Returns
| Type | Description |
|---|---|
double [3] |
C array containing the x, y and z coordinates in the ECEF frame. |
See also
GeodeticPoint.set
Set the point coordinates from another Coordinates instance
The input coordinates are transformed to the ECEF frame if needed, i.e. if
their frame attribute is not nil.
Synopsis
GeodeticPoint:set(coordinates)
Arguments
| Name | Type | Description |
|---|---|---|
| coordinates | Coordinates | Input coordinates. |
Note
The input coordinates must be a point instance (CartesianPoint, GeodeticPoint, SphericalPoint) or a C array, e.g. as returned by State.position.
Returns
| Type | Description |
|---|---|
| GeodeticPoint | Reference to the updated coordinates. |