aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations
diff options
context:
space:
mode:
authorKristian Evers <kristianevers@gmail.com>2018-07-20 14:25:23 +0100
committerKristian Evers <kristianevers@gmail.com>2018-07-20 14:25:23 +0100
commit2d6f1782baffc83b6a0b053173315cdf590ea257 (patch)
treecb682cb9ac8003bdc3519240e97becfdad3f50ef /docs/source/operations
parent0903f85798a9ffa1f9de9750de7cecdcbe85cd23 (diff)
downloadPROJ-2d6f1782baffc83b6a0b053173315cdf590ea257.tar.gz
PROJ-2d6f1782baffc83b6a0b053173315cdf590ea257.zip
Add UTM docs
Diffstat (limited to 'docs/source/operations')
-rw-r--r--docs/source/operations/projections/utm.rst73
1 files changed, 70 insertions, 3 deletions
diff --git a/docs/source/operations/projections/utm.rst b/docs/source/operations/projections/utm.rst
index 7fb66cb8..ac65aa1a 100644
--- a/docs/source/operations/projections/utm.rst
+++ b/docs/source/operations/projections/utm.rst
@@ -4,7 +4,74 @@
Universal Transverse Mercator (UTM)
********************************************************************************
-.. image:: ./images/utm.png
- :scale: 50%
- :alt: Universal Transverse Mercator (UTM)
+The Universal Transverse Mercator is a system of map projections divided into
+sixty zones across the globe, with each zone corresponding to 6 degrees of
+longigude.
++---------------------+----------------------------------------------------------+
+| **Classification** | Transverse cylindrical, conformal |
++---------------------+----------------------------------------------------------+
+| **Available forms** | Forward and inverse, Spherical and Elliptical |
++---------------------+----------------------------------------------------------+
+| **Defined area** | Within the used zone, but transformations of coordinates |
+| | in adjacent zones can be expected to be accurate as well |
++---------------------+----------------------------------------------------------+
+| **Alias** | utm |
++---------------------+----------------------------------------------------------+
+| **Domain** | 2D |
++---------------------+----------------------------------------------------------+
+| **Input type** | Geodetic coordinates |
++---------------------+----------------------------------------------------------+
+| **Output type** | Projected coordinates |
++---------------------+----------------------------------------------------------+
+
+.. figure:: ../../../images/utm_zones.png
+ :alt: Universal Transverse Mercator (UTM) zones
+ :figwidth: 100%
+ :align: center
+
+ UTM zones.
+
+UTM projections are really the :ref:`Transverse Mercator<tmerc>`
+to which specific parameters, such as central meridians, have been applied.
+The Earth is divided into 60 zones each generally 6° wide in longitude.
+Bounding meridians are evenly divisible by 6°, and zones are
+numbered from 1 to 60 proceeding east from the 180th meridian from Greenwich
+with minor exceptions [Snyder1987]_.
+
+Usage
+#####
+
+Convert geodetic coordinate to UTM Zone 32 on the northern hemisphere::
+
+ $ echo 12 56 | proj +proj=utm +zone=32
+ 687071.44 6210141.33
+
+Convert geodetic coordinate to UTM Zone 59 on the souther hemisphere::
+
+ $ echo 174 -44 | proj +proj=utm +zone=59 +south
+ 740526.32 5123750.87
+
+Parameters
+################################################################################
+
+Required
+-------------------------------------------------------------------------------
+
+.. option:: +zone=<value>
+
+ Select which UTM zone to use. Can be a value between 1-60.
+
+.. option:: +south
+
+ Add this flag when using the UTM on the southern hemisphere.
+
+Optional
+-------------------------------------------------------------------------------
+
+.. include:: ../options/ellps.rst
+
+Further reading
+###############
+
+#. `Wikipedia <https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system>`_