The utm Reference Manual

Table of Contents

The utm Reference Manual

This is the utm Reference Manual, version 1.0, generated automatically by Declt version 3.0 "Montgomery Scott" on Fri Jun 26 12:34:07 2020 GMT+0.

1 Introduction

This library converts coordinates in latitude/longitude to UTM and from UTM to latitude/longitude.

Here's a sample run showing all off essentially all of the functionality.

    * (ql:quickload 'utm)
    To load "utm":
      Load 1 ASDF system:
        utm
    ; Loading "utm"
    
    (UTM)
    * (utm:lat-lon-to-utm 39.264657358 -105.396267073)
    
    465814.36361674307d0
    4346221.50650324d0
    13
    * (utm:utm-to-lat-lon 465814.36361674307d0 4346221.50650324d0 13)
    
    39.264654456410966d0
    -105.39627074290249d0
    * (utm:lat-lon-to-utm 39.264657358 -105.396267073 :ellipsoid "WGS72")
    
    465814.3743203891d0
    4346220.137838842d0
    13
    * (utm:utm-to-lat-lon 465814.3743203891d0 4346220.137838842d0 13 :ellipsoid "WGS72")
    
    39.26465442463012d0
    -105.39627074272353d0
    * (utm:ellipsoid-names)
    
    ("NAD83" "WGS84" "GRS80" "WGS72" "Australian1965" "Krasovsky1940"
     "International1924" "Hayford1909" "Clake1880" "Clarke1866" "Airy1830"
     "Bessel1841" "Everest1830")
    *

It is based heavily on information from Steve Dutch's UTM info website and UTM formula website.

It does not make any attempt to correct for the polar regions, so the results for those areas may be incorrect. To learn why UTM breaks at the polar regions, see here.

The calculations seem to be fairly accurate. Converting from lat/lon-> utm -> lat/lon returns the same latitude and longitude within 6 or 7 decimal places, which is probably more accurate than coordinates coming from a regular GPS unit. The results also match up with several online converters, such as this very good one on the University of Montana's website.

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 utm

Author

Jeremiah LaRocco <jeremiah_larocco@fastmail.com>

License

ISC (BSD-like)

Description

Library for converting back and forth between latitude/longitude and UTM, supporting several datums.

Version

1.0

Source

utm.asd (file)

Components

• license (file)
• package.lisp (file)
• utm.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 utm.asd

Location

utm.asd

Systems

utm (system)

3.1.2 utm/package.lisp

Dependency

license (file)

Parent

utm (system)

Location

package.lisp

Packages

utm

3.1.3 utm/utm.lisp

Dependency

package.lisp (file)

Parent

utm (system)

Location

utm.lisp

Exported Definitions

• decimal-to-deg-min-sec (function)
• deg-min-sec-to-decimal (function)
• ellipsoid-names (function)
• lat-lon-to-utm (function)
• utm-to-lat-lon (function)

Internal Definitions

• *ellipsoids* (special variable)
• deg2rad (function)
• e0 (constant)
• fill-ellipsoids (function)
• k0 (constant)
• n0 (constant)
• rad2deg (function)

3.2 Static

3.2.1 utm/LICENSE

Parent

utm (system)

Location

LICENSE

4 Packages

Packages are listed by definition order.

4.1 utm

Source

package.lisp (file)

Use List

common-lisp

Exported Definitions

• decimal-to-deg-min-sec (function)
• deg-min-sec-to-decimal (function)
• ellipsoid-names (function)
• lat-lon-to-utm (function)
• utm-to-lat-lon (function)

Internal Definitions

• *ellipsoids* (special variable)
• deg2rad (function)
• e0 (constant)
• fill-ellipsoids (function)
• k0 (constant)
• n0 (constant)
• rad2deg (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Functions

Function: decimal-to-deg-min-sec DECIMAL

Convert degree, minute, second format to decimal.

Package

utm

Source

utm.lisp (file)

Function: deg-min-sec-to-decimal DEGREE MINUTE SECOND

Convert degree, minute, second format to decimal.nn

Package

utm

Source

utm.lisp (file)

Function: ellipsoid-names ()

Return the names of all supported ellipsoids.

Package

utm

Source

utm.lisp (file)

Function: lat-lon-to-utm LAT LON &key ELLIPSOID ZONE

Convert a point given as latitude and longitude into UTM using the specified ellipsoid. The default ellipsoid is WGS84.

Package

utm

Source

utm.lisp (file)

Function: utm-to-lat-lon EASTING NORTHING ZONE &key ELLIPSOID

Convert a point given as UTM into latitude and longitude using the specified ellipsoid. The default ellipsoid is WGS84.

Package

utm

Source

utm.lisp (file)

5.2 Internal definitions

5.2.1 Constants

Constant: e0

Package

utm

Source

utm.lisp (file)

Constant: k0

Package

utm

Source

utm.lisp (file)

Constant: n0

Package

utm

Source

utm.lisp (file)

5.2.2 Special variables

Special Variable: *ellipsoids*

Package

utm

Source

utm.lisp (file)

5.2.3 Functions

Function: deg2rad D

Package

utm

Source

utm.lisp (file)

Function: fill-ellipsoids ()

Fill the hash table of supported ellipsoids.

Package

utm

Source

utm.lisp (file)

Function: rad2deg R

Package

utm

Source

utm.lisp (file)

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types