The utm Reference Manual

Table of Contents

Next: , Previous: , Up: (dir)   [Contents][Index]

The utm Reference Manual

This is the utm Reference Manual, version 1.0, generated automatically by Declt version 2.3 "Robert April" on Tue Feb 20 09:29:37 2018 GMT+0.


Next: , Previous: , Up: Top   [Contents][Index]

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.


Next: , Previous: , Up: Top   [Contents][Index]

2 Systems

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


Previous: , Up: Systems   [Contents][Index]

2.1 utm

Author

Jeremiah LaRocco <jeremiah.larocco@gmail.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

Next: , Previous: , Up: Top   [Contents][Index]

3 Files

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


Next: , Previous: , Up: Files   [Contents][Index]

3.1 Lisp


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.1 utm.asd

Location

utm.asd

Systems

utm (system)


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.2 utm/package.lisp

Dependency

license (file)

Parent

utm (system)

Location

package.lisp

Packages

utm


Previous: , Up: Lisp files   [Contents][Index]

3.1.3 utm/utm.lisp

Dependency

package.lisp (file)

Parent

utm (system)

Location

utm.lisp

Exported Definitions
Internal Definitions

Previous: , Up: Files   [Contents][Index]

3.2 Other


Previous: , Up: Other files   [Contents][Index]

3.2.1 utm/LICENSE

Parent

utm (system)

Location

LICENSE


Next: , Previous: , Up: Top   [Contents][Index]

4 Packages

Packages are listed by definition order.


Previous: , Up: Packages   [Contents][Index]

4.1 utm

Source

package.lisp (file)

Use List

common-lisp

Exported Definitions
Internal Definitions

Next: , Previous: , Up: Top   [Contents][Index]

5 Definitions

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


Next: , Previous: , Up: Definitions   [Contents][Index]

5.1 Exported definitions


Previous: , Up: Exported definitions   [Contents][Index]

5.1.1 Functions

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)


Previous: , Up: Definitions   [Contents][Index]

5.2 Internal definitions


Next: , Previous: , Up: Internal definitions   [Contents][Index]

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)


Next: , Previous: , Up: Internal definitions   [Contents][Index]

5.2.2 Special variables

Special Variable: *ellipsoids*
Package

utm

Source

utm.lisp (file)


Previous: , Up: Internal definitions   [Contents][Index]

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)


Previous: , Up: Top   [Contents][Index]

Appendix A Indexes


Next: , Previous: , Up: Indexes   [Contents][Index]

A.1 Concepts

Jump to:   F   L   O   U  
Index Entry  Section

F
File, Lisp, utm.asd: The utm<dot>asd file
File, Lisp, utm/package.lisp: The utm/package<dot>lisp file
File, Lisp, utm/utm.lisp: The utm/utm<dot>lisp file
File, other, utm/LICENSE: The utm/license file

L
Lisp File, utm.asd: The utm<dot>asd file
Lisp File, utm/package.lisp: The utm/package<dot>lisp file
Lisp File, utm/utm.lisp: The utm/utm<dot>lisp file

O
Other File, utm/LICENSE: The utm/license file

U
utm.asd: The utm<dot>asd file
utm/LICENSE: The utm/license file
utm/package.lisp: The utm/package<dot>lisp file
utm/utm.lisp: The utm/utm<dot>lisp file

Jump to:   F   L   O   U  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.2 Functions

Jump to:   D   E   F   L   R   U  
Index Entry  Section

D
deg2rad: Internal functions

E
ellipsoid-names: Exported functions

F
fill-ellipsoids: Internal functions
Function, deg2rad: Internal functions
Function, ellipsoid-names: Exported functions
Function, fill-ellipsoids: Internal functions
Function, lat-lon-to-utm: Exported functions
Function, rad2deg: Internal functions
Function, utm-to-lat-lon: Exported functions

L
lat-lon-to-utm: Exported functions

R
rad2deg: Internal functions

U
utm-to-lat-lon: Exported functions

Jump to:   D   E   F   L   R   U  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.3 Variables

Jump to:   *  
C   E   K   N   S  
Index Entry  Section

*
*ellipsoids*: Internal special variables

C
Constant, e0: Internal constants
Constant, k0: Internal constants
Constant, n0: Internal constants

E
e0: Internal constants

K
k0: Internal constants

N
n0: Internal constants

S
Special Variable, *ellipsoids*: Internal special variables

Jump to:   *  
C   E   K   N   S  

Previous: , Up: Indexes   [Contents][Index]

A.4 Data types

Jump to:   P   S   U  
Index Entry  Section

P
Package, utm: The utm package

S
System, utm: The utm system

U
utm: The utm system
utm: The utm package

Jump to:   P   S   U