Coordinates of a position in a specified Model. A position provides both geodetic latitude & longitude, height and geocentric coordinates. The horizontal position (i.e. coordinates at the surface of the celestial body) is also provided as n-vector.

The "show" instance gives position in degrees, minutes, seconds, milliseconds (Angle "show" instance), height (Length "show" instance) and the model (Model "show" instance).

The "eq" instance returns True if and only if, both positions have the same horizontal position, height and model.

geodetic latitude

geodetic longitude

height above the surface of the celestial body

n-vector representing the horizontal coordinates of the position

vector representing the geocentric coordinates of the position (metres)

model (e.g. WGS84)

normal vector to the surface of a celestial body.

Orientation: z-axis points to the North Pole along the body's rotation axis, x-axis points towards the point where latitude = longitude = 0.

x-component of the given n-vector.

y-component of the given n-vector.

z-component of the given n-vector.

nvector p returns the horizontal position of p as a n-vector.

Examples

>>> import Data.Geo.Jord.Position
>>> 
>>> nvector (northPole S84)
n-vector {0.0, 0.0, 1.0}

>>> nvector (wgs84Pos 54 154 (metres 1000))
n-vector {-0.5282978852629286, 0.2576680951131586, 0.8090169943749475}

Geocentric (cartesian) coordinates in the fixed-body coordinates system.

x-y plane is the equatorial plane, x is on the prime meridian, and z on the polar axis.

On a spherical celestial body, an n-vector is equivalent to a normalised version of an geocentric cartesian coordinate.

Note: For Earth, this is known as the Earth-Centred Earth Fixed coordinates system (ECEF).

x-coordinate of the given Geocentric coordinates.

y-coordinate of the given Geocentric coordinates.

z-coordinate of the given Geocentric coordinates.

geocentric p returns the Geocentric coordinates of position p.

Examples

>>> import Data.Geo.Jord.Position
>>> 
>>> geocentric (wgs84Pos 54 154 (metres 1000))
geocentric {-3377.4908375km, 1647.312349km, 5137.5528484km}

Ground Position from given geodetic latitude & longitude in decimal degrees in the given model.

Latitude & longitude values are first converted to Angle to ensure a consistent resolution with the rest of the API, then wrapped to their respective range.

This is equivalent to:

    latLongHeightPos lat lon zero model

Position from given geodetic latitude & longitude in decimal degrees and height in the given model

Latitude & longitude values are first converted to Angle to ensure a consistent resolution with the rest of the API, then wrapped to their respective range.

Ground Position from given geodetic latitude & longitude in the given model. Latitude & longitude values are wrapped to their respective range.

This is equivalent to:

    latLongHeightPos' lat lon zero model

Position from given geodetic latitude & longitude and height in the given model. Latitude & longitude values are wrapped to their respective range.

Position from given geodetic latitude & longitude in decimal degrees and height in the WGS84 datum.

Latitude & longitude values are first converted to Angle to ensure a consistent resolution with the rest of the API, then wrapped to their respective range.

This is equivalent to:

    latLongHeightPos lat lon h WGS84

Position from given geodetic latitude & longitude and height in the WGS84 datum. Latitude & longitude values are wrapped to their respective range.

This is equivalent to:

    latLongHeightPos' lat lon h WGS84

Position from given latitude & longitude in decimal degrees and height in the spherical datum derived from WGS84.

Latitude & longitude values are first converted to Angle to ensure a consistent resolution with the rest of the API, then wrapped to their respective range.

This is equivalent to:

    latLongHeightPos lat lon h S84

Position from given latitude & longitude and height in the spherical datum derived from WGS84. Latitude & longitude values are wrapped to their respective range.

This is equivalent to:

    latLongHeightPos' lat lon h S84

Position from given n-vector x, y, z coordinates in the given model. Vector (x, y, z) will be normalised to a unit vector to get a valid n-vector.

This is equivalent to:

    nvectorHeightPos lat lon zero model

Position from given n-vector x, y, z coordinates and height in the given model. Vector (x, y, z) will be normalised to a unit vector to get a valid n-vector.

Position from given geocentric coordinates x, y and z in the given model.

Position from given geocentric coordinates x, y and z in metres in the given model.

x, y, z lengths are first converted to Length to ensure a consistent resolution with the rest of the API.

position from n-vector, height and model; this method is to be used only if

Reads a Position from the given string using positionP.

Parses and returns a Position.

Supported formats:

• DD(MM)(SS)[N|S]DDD(MM)(SS)[E|W] - e.g. 553621N0130002E or 0116S03649E or 47N122W
• Angle[N|S] Angle[E|W] - e.g. 55°36'21''N 13°0'02''E or 11°16'S 36°49'E or 47°N 122°W

Additionally the string may end by a valid Length.

Examples

>>> import Data.Geo.Jord.Position
>>> 
>>> readPosition "55°36'21''N 013°00'02''E" WGS84
Just 55°36'21.000"N,13°0'2.000"E 0.0m (WGS84)
>>> 
>>> readPosition "55°36'21''N 013°00'02''E 1500m" WGS84
Just 55°36'21.000"N,13°0'2.000"E 1500.0m (WGS84)

nvectorFromLatLong ll returns n-vector equivalent to the given (latitude, longitude) pair ll.

You should prefer using:

    nvector (latLongPos lat lon model)

nvectorToLatLong nv returns (latitude, longitude) pair equivalent to the given n-vector nv.

You should prefer using:

    latLong (nvectorPos x y z model)

Latitude is always in [-90°, 90°] and longitude in [-180°, 180°].

nvectorFromGeocentric g e returns the n-vector equivalent to the geocentric coordinates g using the ellispoid e.

You should prefer using:

    nvector (geocentricMetresPos x y z model)

nvectorToGeocentric (nv, h) e returns the geocentric coordinates equivalent to the given n-vector nv and height h using the ellispoid e.

You should prefer using:

    geocentric (nvectorHeightPos x y z h model)

antipode p computes the antipodal position of p: the position which is diametrically opposite to p.

(latitude, longitude) pair in decimal degrees from given position.

(latitude, longitude) pair from given position.

Horizontal position of the North Pole in the given model.

Horizontal position of the South Pole in the given model.

Horizontal position of the North Pole (n-vector).

Horizontal position of the South Pole (n-vector).