Coordinates

This module contains classes for coordinates and functions for converting between different coordinate types.

class geodepy.coord.CoordCart(xaxis, yaxis, zaxis, nval=None)[source]

Cartesian Coordinate Class

Used for working with coordinates representing points in a 3 dimensional earth-centred earth-fixed system. N Value (optional) is the distance (m) at the coordinate that a reference surface (typically a geoid) is above or below an ellipsoid.

Parameters:

  • xaxis (float) – Distance (m) along X Axis (positive when passing through intersection of equator and prime meridian)

  • yaxis (float) – Distance (m) along Y Axis (positive when passing through intersection of equator and 90 degrees east longitude)

  • zaxis (float) – Distance (m) along Z Axis (positive when passing through north pole)

  • nval (float) – Distance (m) between a reference surface (typically a geoid) and an ellipsoid (positive when surface is above ellipsoid)

geo(ellipsoid=<geodepy.constants.Ellipsoid object>, notation=<class 'geodepy.angles.DECAngle'>)[source]

Convert coordinates to Geographic

Note: If no N Value, no Orthometric Height set.

Parameters:

  • ellipsoid – geodepy.constants.Ellipsoid Object (default: grs80)

  • notation (geodepy.angle class or float) – Latitude and Longitude Angle Notation format

Returns:

Geographic Coordinate

Return type:

CoordGeo

tm(ellipsoid=<geodepy.constants.Ellipsoid object>, projection=<geodepy.constants.Projection object>)[source]

Convert coordinates to Transverse Mercator

Parameters:

  • ellipsoid – geodepy.constants.Ellipsoid Object (default: grs80)

  • projection – geodepy.constants.Projection Object (default: utm)

Returns:

Transverse Mercator Projection Coordinate

Return type:

CoordTM

class geodepy.coord.CoordGeo(lat, lon, ell_ht=None, orth_ht=None)[source]

Geographic Coordinate Class

Used for working with coordinates representing points in an ellipsoidal system with ellipsoid heights (m) relative to the surface of the ellipsoid. Orthometric heights (m) are relative to a different reference surface (typically a geoid).

Parameters:

  • lat (float (decimal degrees) or any Angle object in geodepy.angles) – Geographic Latitude (angle between +90 and -90 degrees, positive values are north of equator)

  • lon (float (decimal degrees) or any Angle object in geodepy.angles) – Geographic Longitude (angle between +180 and -180 degrees, positive values are east of central meridian)

  • ell_ht (float) – Ellipsoid Height (m, positive is outside ellipsoid)

  • orth_ht (float) – Orthometric Height (m)

cart(ellipsoid=<geodepy.constants.Ellipsoid object>)[source]

Convert coordinates to Cartesian

Note: If no ellipsoid height set, uses 0m. No N Value output

Parameters:

ellipsoid – geodepy.constants.Ellipsoid Object (default: grs80)

Returns:

Cartesian Coordinate

Return type:

CoordCart

tm(ellipsoid=<geodepy.constants.Ellipsoid object>, projection=<geodepy.constants.Projection object>)[source]

Convert coordinates to Universal Transverse Mercator Projection

Note: Heights are not used in calculation

Parameters:

  • ellipsoid – geodepy.constants.Ellipsoid Object (default: grs80)

  • projection – geodepy.constants.Projection Object (default: utm)

Returns:

Transverse Mercator Projection Coordinate

Return type:

CoordTM

class geodepy.coord.CoordTM(zone, east, north, ell_ht=None, orth_ht=None, hemi_north=False, projection=<geodepy.constants.Projection object>)[source]

Transverse Mercator Coordinate Class

Used for working with coordinates representing points in a Transverse Mercator projected planar system. Coordinates are related to an ellipsoid via a projection (default is Universal Transverse Mercator, see geodepy.constants.Projection for more details). Ellipsoid heights (m) are relative to the surface of the ellipsoid. Orthometric heights (m) are relative to a different reference surface (typically a geoid).

Parameters:

  • zone (int) – Transverse Mercator Zone Number - 1 to 60

  • east (float) – Easting (m, within 3330km of Central Meridian)

  • north (float) – Northing (m, 0 to 10,000,000m)

  • ell_ht (float) – Ellipsoid Height (m, positive is outside ellipsoid)

  • orth_ht (float) – Orthometric Height (m)

  • hemi_north (bool) – True if coordinate in Northern Hemisphere, False if coordinate in Southern Hemisphere (default)

  • projection (geodepy.constants.Projection object (default: geodepy.constants.utm)) – Information defining relationship between projected coordinate and the ellipsoid

cart(ellipsoid=<geodepy.constants.Ellipsoid object>)[source]

Convert coordinates to Cartesian

Note: If no ellipsoid height set, uses 0m. No N Value output

Parameters:

ellipsoid – geodepy.constants.Ellipsoid Object (default: grs80)

Returns:

Cartesian Coordinate

Return type:

CoordCart

geo(ellipsoid=<geodepy.constants.Ellipsoid object>, notation=<class 'geodepy.angles.DECAngle'>)[source]
Parameters:

  • ellipsoid – geodepy.constants.Ellipsoid Object (default: grs80)

  • notation (geodepy.angle class or float) – Latitude and Longitude Angle Notation format

Returns:

Geographic Coordinate

Return type:

CoordGeo