Geographical coordinates

Geographical coordinates toolbox.

This toolbox provides functions to work with different geographical coordinate systems. Latitude/longitude position is represented by parameter latlong with one of these formats:

• (latitude degrees, longitude degrees)
• (latitude degrees, longitude degrees, altitude)
• (latitude degrees, minutes, longitude degrees, minutes)
• (latitude degrees, minutes, longitude degrees, minutes, altitude)
• (latitude degrees, minutes, seconds, longitude degrees, minutes, seconds)
• (latitude degrees, minutes, seconds, longitude degrees, minutes, seconds, altitude)

The altitude is always specified in meters, with negative values being depth below water surface.

pos represents position in a local coordinate system (easting, northing) or (easting, northing, altitude) specified by a UTM zone.

arlpy.geo.d(latlong)

Convert latitude/longitude to (latitude degrees, longitude degrees) format.

arlpy.geo.distance(pos1, pos2)

Compute distance between two UTM positions.

arlpy.geo.dm(latlong)

Convert latitude/longitude to (latitude degrees, minutes, longitude degrees, minutes) format.

arlpy.geo.dms(latlong)

Convert latitude/longitude to (latitude degrees, minutes, seconds, longitude degrees, minutes, seconds) format.

arlpy.geo.dmsz(latlong)

Convert latitude/longitude to (latitude degrees, minutes, seconds, longitude degrees, minutes, seconds, altitude) format.

arlpy.geo.dmz(latlong)

Convert latitude/longitude to (latitude degrees, minutes, longitude degrees, minutes, altitude) format.

arlpy.geo.dz(latlong)

Convert latitude/longitude to (latitude degrees, longitude degrees, altitude) format.

arlpy.geo.latlong(pos, zone=None, origin=None)

Convert local coordinate system position to latitude/longitude.

To convert a UTM position into a global latitude/longitude, the local coordinate system has to be specified in terms of a UTM zone 2-tuple, e.g. (32, 'U'). Alternatively a local coordinate system can be specified in terms of an origin latitude/longitude.

arlpy.geo.pos(latlong, zonenum=None, origin=None)

Convert latitude/longitude to local coordinate system position.

If an origin is specified, the local coordinate system is set up with that origin and East-North axis. If no origin is specified, the UTM local coordinate system is used. A specific UTM zone can be forced by specifying zonenum, if desired.

arlpy.geo.str(latlong)

Convert latitude/longitude information in various formats into a pretty printable Unicode string.

arlpy.geo.zone(latlong)

Convert latitude/longitude to UTM zone.