diff options
| author | Kristian Evers <kristianevers@gmail.com> | 2017-09-18 22:21:20 +0200 |
|---|---|---|
| committer | Kristian Evers <kristianevers@gmail.com> | 2017-09-18 22:21:20 +0200 |
| commit | 6d1a1ff4e470bb4d26be46bdf01de3d94e6ab8e9 (patch) | |
| tree | 7bec3d77463fba3ff68ebabcc127ad504da0836d /docs/source/usage | |
| parent | 1f60b8c407ac202916cf4570683935fcca451531 (diff) | |
| download | PROJ-6d1a1ff4e470bb4d26be46bdf01de3d94e6ab8e9.tar.gz PROJ-6d1a1ff4e470bb4d26be46bdf01de3d94e6ab8e9.zip | |
Moved projection list to using chapter and created a list of transformations. Both are grouped in a section called operations.
Diffstat (limited to 'docs/source/usage')
279 files changed, 2864 insertions, 0 deletions
diff --git a/docs/source/usage/index.rst b/docs/source/usage/index.rst index 8c12c026..5979426a 100644 --- a/docs/source/usage/index.rst +++ b/docs/source/usage/index.rst @@ -17,4 +17,5 @@ command line applications or the C API that is a part of the software package. projections transformation resource_files + operations/index diff --git a/docs/source/usage/operations/index.rst b/docs/source/usage/operations/index.rst new file mode 100644 index 00000000..21200c93 --- /dev/null +++ b/docs/source/usage/operations/index.rst @@ -0,0 +1,18 @@ +.. _operations: + +================================================================================ +Coordinate operations +================================================================================ + +Coordinate operations in PROJ.4 are divided into two groups: +Projections and transformations. +Projections are purely cartographic mappings of the sphere onto the plane whereas +transformations are mostly geodetic operations concerned with changes in +reference frames. + +.. toctree:: + :maxdepth: 1 + + projections/index + transformations/index + diff --git a/docs/source/usage/operations/projections/aeqd.rst b/docs/source/usage/operations/projections/aeqd.rst new file mode 100644 index 00000000..949cd8a0 --- /dev/null +++ b/docs/source/usage/operations/projections/aeqd.rst @@ -0,0 +1,10 @@ +.. _aeqd: + +******************************************************************************** +Azimuthal Equidistant +******************************************************************************** + +.. image:: ./images/aeqd.png + :scale: 50% + :alt: Azimuthal Equidistant + diff --git a/docs/source/usage/operations/projections/airy.rst b/docs/source/usage/operations/projections/airy.rst new file mode 100644 index 00000000..307af3e3 --- /dev/null +++ b/docs/source/usage/operations/projections/airy.rst @@ -0,0 +1,10 @@ +.. _airy: + +******************************************************************************** +Airy +******************************************************************************** + +.. image:: ./images/airy.png + :scale: 50% + :alt: Airy + diff --git a/docs/source/usage/operations/projections/aitoff.rst b/docs/source/usage/operations/projections/aitoff.rst new file mode 100644 index 00000000..4d681468 --- /dev/null +++ b/docs/source/usage/operations/projections/aitoff.rst @@ -0,0 +1,10 @@ +.. _aitoff: + +******************************************************************************** +Aitoff +******************************************************************************** + +.. image:: ./images/aitoff.png + :scale: 50% + :alt: Aitoff + diff --git a/docs/source/usage/operations/projections/alsk.rst b/docs/source/usage/operations/projections/alsk.rst new file mode 100644 index 00000000..f7a7a0ef --- /dev/null +++ b/docs/source/usage/operations/projections/alsk.rst @@ -0,0 +1,10 @@ +.. _alsk: + +******************************************************************************** +Mod. Stererographics of Alaska +******************************************************************************** + +.. image:: ./images/alsk.png + :scale: 50% + :alt: Mod. Stererographics of Alaska + diff --git a/docs/source/usage/operations/projections/apian.rst b/docs/source/usage/operations/projections/apian.rst new file mode 100644 index 00000000..add501ea --- /dev/null +++ b/docs/source/usage/operations/projections/apian.rst @@ -0,0 +1,10 @@ +.. _apian: + +******************************************************************************** +Apian Globular I +******************************************************************************** + +.. image:: ./images/apian.png + :scale: 50% + :alt: Apian Globular I + diff --git a/docs/source/usage/operations/projections/august.rst b/docs/source/usage/operations/projections/august.rst new file mode 100644 index 00000000..e2ad3516 --- /dev/null +++ b/docs/source/usage/operations/projections/august.rst @@ -0,0 +1,10 @@ +.. _august: + +******************************************************************************** +August Epicycloidal +******************************************************************************** + +.. image:: ./images/august.png + :scale: 50% + :alt: August Epicycloidal + diff --git a/docs/source/usage/operations/projections/bacon.rst b/docs/source/usage/operations/projections/bacon.rst new file mode 100644 index 00000000..a87ea7d8 --- /dev/null +++ b/docs/source/usage/operations/projections/bacon.rst @@ -0,0 +1,10 @@ +.. _bacon: + +******************************************************************************** +Bacon Globular +******************************************************************************** + +.. image:: ./images/bacon.png + :scale: 50% + :alt: Bacon Globular + diff --git a/docs/source/usage/operations/projections/bipc.rst b/docs/source/usage/operations/projections/bipc.rst new file mode 100644 index 00000000..7045f04a --- /dev/null +++ b/docs/source/usage/operations/projections/bipc.rst @@ -0,0 +1,10 @@ +.. _bipc: + +******************************************************************************** +Bipolar conic of western hemisphere +******************************************************************************** + +.. image:: ./images/bipc.png + :scale: 50% + :alt: Bipolar conic of western hemisphere + diff --git a/docs/source/usage/operations/projections/boggs.rst b/docs/source/usage/operations/projections/boggs.rst new file mode 100644 index 00000000..1dd7d19f --- /dev/null +++ b/docs/source/usage/operations/projections/boggs.rst @@ -0,0 +1,10 @@ +.. _boggs: + +******************************************************************************** +Boggs Eumorphic +******************************************************************************** + +.. image:: ./images/boggs.png + :scale: 50% + :alt: Boggs Eumorphic + diff --git a/docs/source/usage/operations/projections/bonne.rst b/docs/source/usage/operations/projections/bonne.rst new file mode 100644 index 00000000..ef87d7c9 --- /dev/null +++ b/docs/source/usage/operations/projections/bonne.rst @@ -0,0 +1,10 @@ +.. _bonne: + +******************************************************************************** +Bonne (Werner lat_1=90) +******************************************************************************** + +.. image:: ./images/bonne.png + :scale: 50% + :alt: Bonne (Werner lat_1=90) + diff --git a/docs/source/usage/operations/projections/calcofi.rst b/docs/source/usage/operations/projections/calcofi.rst new file mode 100644 index 00000000..650416c1 --- /dev/null +++ b/docs/source/usage/operations/projections/calcofi.rst @@ -0,0 +1,95 @@ +.. _calcofi: + +******************************************************************************** +Cal Coop Ocean Fish Invest Lines/Stations +******************************************************************************** + +The CalCOFI pseudo-projection is the line and station coordinate system of the +California Cooperative Oceanic Fisheries Investigations program, known as CalCOFI, for sampling offshore of the west coast of the U.S. and Mexico. + ++---------------------+----------------------------------------------------------+ +| **Classification** | Conformal cylindrical | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Only valid for the west coast of USA and Mexico | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Frank Warmerdam | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `No special options for this projection` | ++---------------------+----------------------------------------------------------+ + + +.. image:: ../../../../images/calcofi.png + :scale: 50% + :align: center + :alt: Cal Coop Ocean Fish Invest Lines/Stations + +The coordinate system is based on the Mercator projection with units rotated -30 +degrees from the meridian so that they are oriented with the coastline of the Southern California Bight and Baja California. +Lines increase from Northwest to Southeast. +A unit of line is 12 nautical miles. Stations increase from inshore to offshore. +A unit of station is equal to 4 nautical miles. +The rotation point is located at line 80, station 60, or 34.15 degrees N, -121.15 degrees W, and is depicted by the red dot in the figure. +By convention, the ellipsoid of Clarke 1866 is used to calculate CalCOFI coordinates. + +The CalCOFI program is a joint research effort by the U.S. National Oceanic and +Atmospheric Administration, University of California Scripps Oceanographic Institute, and California Department of Fish and Game. +Surveys have been conducted for the CalCOFI program since 1951, creating one of the oldest and most scientifically valuable joint oceanographic and fisheries data sets in the world. +The CalCOFI line and station coordinate system is now used by several other programs including the Investigaciones Mexicanas de la Corriente de California (IMECOCAL) program offshore of Baja California. +The figure depicts some commonly sampled locations from line 40 to line 156.7 and offshore to station 120. Blue numbers indicate line (bottom) or station (left) numbers along the grid. Note that lines spaced at approximate 3-1/3 intervals are commonly sampled, e.g., lines 43.3 and 46.7. + +Usage +############################################################################### + +A typical forward CalCOFI projection would be from lon/lat coordinates on the +Clark 1866 ellipsoid. +For example:: + + proj +proj=calcofi +ellps=clrk66 -E <<EOF + -121.15 34.15 + EOF + +Output of the above command:: + + -121.15 34.15 80.00 60.00 + +The reverse projection from line/station coordinates to lon/lat would be entered +as:: + + proj +proj=calcofi +ellps=clrk66 -I -E -f "%.2f" <<EOF + 80.0 60.0 + EOF + +Output of the above command:: + + 80.0 60.0 -121.15 34.15 + +Mathematical definition +################################################################################ + +The algorithm used to make conversions is described in [EberHewitt1979]_ with +a few corrections reported in [WeberMoore2013]_. + + +Further reading +################################################################################ + +#. `General information about the CalCOFI program <http://www.calcofi.org>`_ +#. `The Investigaciones Mexicanas de la Corriente de California <http://imecocal.cicese.mx>`_ + + + + + + + + + + + + + + diff --git a/docs/source/usage/operations/projections/cass.rst b/docs/source/usage/operations/projections/cass.rst new file mode 100644 index 00000000..83f8c2ce --- /dev/null +++ b/docs/source/usage/operations/projections/cass.rst @@ -0,0 +1,145 @@ +.. _cass: + +******************************************************************************** +Cassini (Cassini-Soldner) +******************************************************************************** + +Although the Cassini projection has been largely replaced by the Transverse Mercator, it is still in limited use outside the United States and was one of the major topographic mapping projections until the early 20th century. + ++---------------------+-------------------------------------------------------------------------+ +| **Classification** | Transverse and oblique cylindrical | ++---------------------+-------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse, Spherical and Elliptical | ++---------------------+-------------------------------------------------------------------------+ +| **Defined area** | Global, but best used near the central meridian with long, narrow areas | ++---------------------+-------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+-------------------------------------------------------------------------+ +| **Options** | ++---------------------+-------------------------------------------------------------------------+ +| `+lat_0` | Latitude of origin (Default to 0) | ++---------------------+-------------------------------------------------------------------------+ + +.. image:: ./images/cass.png + :scale: 50% + :alt: Cassini + +Usage +##### + +There has been little usage of the spherical version of the Cassini, but the ellipsoidal Cassini-Soldner version was adopted by the Ordnance Survey for the official survey of Great Britain during the second half of the 19th century [Steers1970]_. +Many of these maps were prepared at a scale of 1:2,500. +The Cassini-Soldner was also used for the detailed mapping of many German states during the same period. + + +Example using EPSG 30200 (Trinidad 1903, units in clarke's links):: + + $ echo 0.17453293 -1.08210414 | proj +proj=cass +lat_0=10.44166666666667 +lon_0=-61.33333333333334 +x_0=86501.46392051999 +y_0=65379.0134283 +a=6378293.645208759 +b=6356617.987679838 +to_meter=0.201166195164 +no_defs + 66644.94 82536.22 + +Example using EPSG 3068 (Soldner Berlin):: + + $ echo 13.5 52.4 | proj +proj=cass +lat_0=52.41864827777778 +lon_0=13.62720366666667 +x_0=40000 +y_0=10000 +ellps=bessel +datum=potsdam +units=m +no_defs + 31343.05 7932.76 + + +Mathematical definition +####################### + +The formulas describing the Cassini projection are taken from Snyder's [Snyder1987]_. + +:math:`\phi_0` is the latitude of origin that match the center of the map (default to 0). It can be set with ``+lat_0``. + + +Spherical form +============== + +Forward projection +------------------ + +.. math:: + + x = \arcsin(\cos(\phi) \sin(\lambda)) + +.. math:: + + y = \arctan2(\tan(\phi), \cos(\lambda)) - \phi_0 + +Inverse projection +------------------ + +.. math:: + + \phi = \arcsin(\sin(y+\phi_0) \cos(x)) + +.. math:: + + \lambda = \arctan2(\tan(x), \cos(y+\phi_0)) + +Elliptical form +=============== + +Forward projection +------------------ + +.. math:: + + N = (1 - e^2 \sin^2(\phi))^{-1/2} + +.. math:: + + T = \tan^2(\phi) + +.. math:: + + A = \lambda \cos(\phi) + +.. math:: + + C = \frac{e^2}{1-e^2} cos^2(\phi) + +.. math:: + + x = N ( A - T \frac{A^3}{6} - (8-T+8C)T\frac{A^5}{120}) + +.. math:: + + y = M(\phi) - M(\phi_0) + N \tan(\phi)(\frac{A^2}{2} + (5-T+6C)\frac{A^4}{24}) + +and M() is the meridionial distance function. + +Inverse projection +------------------ + +.. math:: + + \phi' = M^{-1}(M(\phi_0)+y) + +if :math:`\phi' = \frac{\pi}{2}` then :math:`\phi=\phi'` and :math:`\lambda=0` + +otherwise evaluate T and N above using :math:`\phi'` and + +.. math:: + + R = (1 - e^2)(1 - e^2 sin^2 \phi')^{-3/2} + +.. math:: + + D = x/N + +.. math:: + + \phi = \phi' - \tan \phi' \frac{N}{R}(\frac{D^2}{2}-(1+3T)\frac{D^4}{24}) + +.. math:: + + \lambda = \frac{(D - T\frac{D^3}{3} + (1+3T)T\frac{D^5}{15})}{\cos \phi'} + +.. _further-reading: + +Further reading +############### + +#. `Wikipedia <https://en.wikipedia.org/wiki/Equirectangular_projection>`_ +#. [Snyder1987]_ +#. `EPSG, POSC literature pertaining to Coordinate Conversions and Transformations including Formulas <http://www.ihsenergy.com/epsg/guid7.pdf>`_ diff --git a/docs/source/usage/operations/projections/cc.rst b/docs/source/usage/operations/projections/cc.rst new file mode 100644 index 00000000..5b30e6c6 --- /dev/null +++ b/docs/source/usage/operations/projections/cc.rst @@ -0,0 +1,10 @@ +.. _cc: + +******************************************************************************** +Central Cylindrical +******************************************************************************** + +.. image:: ./images/cc.png + :scale: 50% + :alt: Central Cylindrical + diff --git a/docs/source/usage/operations/projections/cea.rst b/docs/source/usage/operations/projections/cea.rst new file mode 100644 index 00000000..20ebc285 --- /dev/null +++ b/docs/source/usage/operations/projections/cea.rst @@ -0,0 +1,10 @@ +.. _cea: + +******************************************************************************** +Equal Area Cylindrical +******************************************************************************** + +.. image:: ./images/cea.png + :scale: 50% + :alt: Equal Area Cylindrical + diff --git a/docs/source/usage/operations/projections/chamb.rst b/docs/source/usage/operations/projections/chamb.rst new file mode 100644 index 00000000..2ec9bffe --- /dev/null +++ b/docs/source/usage/operations/projections/chamb.rst @@ -0,0 +1,10 @@ +.. _chamb: + +******************************************************************************** +Chamberlin Trimetric +******************************************************************************** + +.. image:: ./images/chamb.png + :scale: 50% + :alt: Chamberlin Trimetric + diff --git a/docs/source/usage/operations/projections/collg.rst b/docs/source/usage/operations/projections/collg.rst new file mode 100644 index 00000000..aa16182a --- /dev/null +++ b/docs/source/usage/operations/projections/collg.rst @@ -0,0 +1,10 @@ +.. _collg: + +******************************************************************************** +Collignon +******************************************************************************** + +.. image:: ./images/collg.png + :scale: 50% + :alt: Collignon + diff --git a/docs/source/usage/operations/projections/crast.rst b/docs/source/usage/operations/projections/crast.rst new file mode 100644 index 00000000..9d17f274 --- /dev/null +++ b/docs/source/usage/operations/projections/crast.rst @@ -0,0 +1,10 @@ +.. _crast: + +******************************************************************************** +Craster Parabolic (Putnins P4) +******************************************************************************** + +.. image:: ./images/crast.png + :scale: 50% + :alt: Craster Parabolic (Putnins P4) + diff --git a/docs/source/usage/operations/projections/denoy.rst b/docs/source/usage/operations/projections/denoy.rst new file mode 100644 index 00000000..a885ab0e --- /dev/null +++ b/docs/source/usage/operations/projections/denoy.rst @@ -0,0 +1,10 @@ +.. _denoy: + +******************************************************************************** +Denoyer Semi-Elliptical +******************************************************************************** + +.. image:: ./images/denoy.png + :scale: 50% + :alt: Denoyer Semi-Elliptical + diff --git a/docs/source/usage/operations/projections/eck1.rst b/docs/source/usage/operations/projections/eck1.rst new file mode 100644 index 00000000..841533ec --- /dev/null +++ b/docs/source/usage/operations/projections/eck1.rst @@ -0,0 +1,18 @@ +.. _eck1: + +******************************************************************************** +Eckert I +******************************************************************************** + +.. image:: ./images/eck1.png + :scale: 50% + :alt: Eckert I + + +.. math:: + + x &= 2 \sqrt{2/3\pi} \lambda (1- |\phi|/\pi) + + y &= 2 \sqrt{2/3\pi}\phi + + diff --git a/docs/source/usage/operations/projections/eck2.rst b/docs/source/usage/operations/projections/eck2.rst new file mode 100644 index 00000000..b1bd3179 --- /dev/null +++ b/docs/source/usage/operations/projections/eck2.rst @@ -0,0 +1,10 @@ +.. _eck2: + +******************************************************************************** +Eckert II +******************************************************************************** + +.. image:: ./images/eck2.png + :scale: 50% + :alt: Eckert II + diff --git a/docs/source/usage/operations/projections/eck3.rst b/docs/source/usage/operations/projections/eck3.rst new file mode 100644 index 00000000..ecacc32d --- /dev/null +++ b/docs/source/usage/operations/projections/eck3.rst @@ -0,0 +1,10 @@ +.. _eck3: + +******************************************************************************** +Eckert III +******************************************************************************** + +.. image:: ./images/eck3.png + :scale: 50% + :alt: Eckert III + diff --git a/docs/source/usage/operations/projections/eck4.rst b/docs/source/usage/operations/projections/eck4.rst new file mode 100644 index 00000000..3fc6a9fd --- /dev/null +++ b/docs/source/usage/operations/projections/eck4.rst @@ -0,0 +1,19 @@ +.. _eck4: + +******************************************************************************** +Eckert IV +******************************************************************************** + +.. image:: ./images/eck4.png + :scale: 50% + :alt: Eckert IV + + +.. math:: + + x = \lambda(1+cos\phi) / \sqrt{ 2 + \pi } + +.. math:: + y = 2 \phi / \sqrt { 2 + \pi } + + diff --git a/docs/source/usage/operations/projections/eck5.rst b/docs/source/usage/operations/projections/eck5.rst new file mode 100644 index 00000000..1442d99d --- /dev/null +++ b/docs/source/usage/operations/projections/eck5.rst @@ -0,0 +1,10 @@ +.. _eck5: + +******************************************************************************** +Eckert V +******************************************************************************** + +.. image:: ./images/eck5.png + :scale: 50% + :alt: Eckert V + diff --git a/docs/source/usage/operations/projections/eck6.rst b/docs/source/usage/operations/projections/eck6.rst new file mode 100644 index 00000000..caeaefa6 --- /dev/null +++ b/docs/source/usage/operations/projections/eck6.rst @@ -0,0 +1,10 @@ +.. _eck6: + +******************************************************************************** +Eckert VI +******************************************************************************** + +.. image:: ./images/eck6.png + :scale: 50% + :alt: Eckert VI + diff --git a/docs/source/usage/operations/projections/eqc.rst b/docs/source/usage/operations/projections/eqc.rst new file mode 100644 index 00000000..be431977 --- /dev/null +++ b/docs/source/usage/operations/projections/eqc.rst @@ -0,0 +1,110 @@ +.. _eqc: + +******************************************************************************** +Equidistant Cylindrical (Plate Carrée) +******************************************************************************** + +The simplest of all projections. Standard parallels (0° when omitted) may be specified that determine latitude of true scale (k=h=1). + ++---------------------+----------------------------------------------------------+ +| **Classification** | Conformal cylindrical | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global, but best used near the equator | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_ts` | Latitude of true scale. Defaults to 0.0 | ++---------------------+----------------------------------------------------------+ +| `+lat_0` | Center of the map : latitude of origin | ++---------------------+----------------------------------------------------------+ + +.. image:: ./images/eqc.png + :scale: 50% + :alt: Equidistant Cylindrical (Plate Carrée) + +Usage +######## + +Because of the distortions introduced by this projection, it has little use in navigation or cadastral mapping and finds its main use in thematic mapping. +In particular, the plate carrée has become a standard for global raster datasets, such as Celestia and NASA World Wind, because of the particularly simple relationship between the position of an image pixel on the map and its corresponding geographic location on Earth. + +The following table gives special cases of the cylindrical equidistant projection. + ++---------------------------------------------------------+--------------------------+ +| Projection Name | (lat ts=) :math:`\phi_0` | ++---------------------------------------------------------+--------------------------+ +| Plain/Plane Chart | 0° | ++---------------------------------------------------------+--------------------------+ +| Simple Cylindrical | 0° | ++---------------------------------------------------------+--------------------------+ +| Plate Carrée | 0° | ++---------------------------------------------------------+--------------------------+ +| Ronald Miller—minimum overall scale distortion | 37°30′ | ++---------------------------------------------------------+--------------------------+ +| E.Grafarend and A.Niermann | 42° | ++---------------------------------------------------------+--------------------------+ +| Ronald Miller—minimum continental scale distortion | 43°30′ | ++---------------------------------------------------------+--------------------------+ +| Gall Isographic | 45° | ++---------------------------------------------------------+--------------------------+ +| Ronald Miller Equirectangular | 50°30′ | ++---------------------------------------------------------+--------------------------+ +| E.Grafarend and A.Niermann minimum linear distortion | 61°7′ | ++---------------------------------------------------------+--------------------------+ + + +Example using EPSG 32662 (WGS84 Plate Carrée):: + + $ echo 2 47 | proj +proj=eqc +lat_ts=0 +lat_0=0 +lon_0=0 +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs + 222638.98 5232016.07 + +Example using Plate Carrée projection with true scale at latitude 30° and central meridian 90°W:: + + $ echo -88 30 | proj +proj=eqc +lat_ts=30 +lat_0=90w + -8483684.61 13358338.90 + + +Mathematical definition +####################### + +The formulas describing the Equidistant Cylindrical projection are all taken from Snyder's [Snyder1987]_. + +:math:`\phi_{ts}` is the latitude of true scale, that mean the standard parallels where the scale of the projection is true. It can be set with ``+lat_ts``. + +:math:`\phi_0` is the latitude of origin that match the center of the map. It can be set with ``+lat_0``. + + +Forward projection +================== + +.. math:: + + x = \lambda \cos \phi_{ts} + +.. math:: + + y = \phi - \phi_0 + +Inverse projection +================== + +.. math:: + + \lambda = x / cos \phi_{ts} + +.. math:: + + \phi = y + \phi_0 + + +Further reading +############### + +#. `Wikipedia <https://en.wikipedia.org/wiki/Equirectangular_projection>`_ +#. `Wolfram Mathworld <http://mathworld.wolfram.com/CylindricalEquidistantProjection.html>`_ + + diff --git a/docs/source/usage/operations/projections/eqdc.rst b/docs/source/usage/operations/projections/eqdc.rst new file mode 100644 index 00000000..3ee5999d --- /dev/null +++ b/docs/source/usage/operations/projections/eqdc.rst @@ -0,0 +1,10 @@ +.. _eqdc: + +******************************************************************************** +Equidistant Conic +******************************************************************************** + +.. image:: ./images/eqdc.png + :scale: 50% + :alt: Equidistant Conic + diff --git a/docs/source/usage/operations/projections/etmerc.rst b/docs/source/usage/operations/projections/etmerc.rst new file mode 100644 index 00000000..b7f89032 --- /dev/null +++ b/docs/source/usage/operations/projections/etmerc.rst @@ -0,0 +1,10 @@ +.. _etmerc: + +******************************************************************************** +Extended Transverse Mercator +******************************************************************************** + +.. image:: ./images/etmerc.png + :scale: 50% + :alt: Extended Transverse Mercator + diff --git a/docs/source/usage/operations/projections/euler.rst b/docs/source/usage/operations/projections/euler.rst new file mode 100644 index 00000000..e495063f --- /dev/null +++ b/docs/source/usage/operations/projections/euler.rst @@ -0,0 +1,10 @@ +.. _euler: + +******************************************************************************** +Euler +******************************************************************************** + +.. image:: ./images/euler.png + :scale: 50% + :alt: Euler + diff --git a/docs/source/usage/operations/projections/fahey.rst b/docs/source/usage/operations/projections/fahey.rst new file mode 100644 index 00000000..2e09337f --- /dev/null +++ b/docs/source/usage/operations/projections/fahey.rst @@ -0,0 +1,10 @@ +.. _fahey: + +******************************************************************************** +Fahey +******************************************************************************** + +.. image:: ./images/fahey.png + :scale: 50% + :alt: Fahey + diff --git a/docs/source/usage/operations/projections/fouc.rst b/docs/source/usage/operations/projections/fouc.rst new file mode 100644 index 00000000..7467dcb1 --- /dev/null +++ b/docs/source/usage/operations/projections/fouc.rst @@ -0,0 +1,10 @@ +.. _fouc: + +******************************************************************************** +Foucaut +******************************************************************************** + +.. image:: ./images/fouc.png + :scale: 50% + :alt: Foucaut + diff --git a/docs/source/usage/operations/projections/fouc_s.rst b/docs/source/usage/operations/projections/fouc_s.rst new file mode 100644 index 00000000..ac353adb --- /dev/null +++ b/docs/source/usage/operations/projections/fouc_s.rst @@ -0,0 +1,25 @@ +.. _fouc_s: + +******************************************************************************** +Foucaut Sinusoidal +******************************************************************************** + +.. image:: ./images/fouc_s.png + :scale: 50% + :alt: Foucaut Sinusoidal + + +The `y`-axis is based upon a weighted mean of the cylindrical equal-area and +the sinusoidal projections. Parameter :math:`n=n` is the weighting factor where +:math:`0 <= n <= 1`. + +.. math:: + + x &= \lambda \cos \phi / (n + (1 - n) \ cos \phi) + + y &= n \phi + (1 - n) \sin \phi + +For the inverse, the Newton-Raphson method can be used to determine +:math:`\phi` from the equation for :math:`y` above. As :math:`n \rightarrow 0` and +:math:`\phi \rightarrow \pi/2`, convergence is slow but for :math:`n = 0`, :math:`\phi = +\sin^1y` diff --git a/docs/source/usage/operations/projections/gall.rst b/docs/source/usage/operations/projections/gall.rst new file mode 100644 index 00000000..b9120d9f --- /dev/null +++ b/docs/source/usage/operations/projections/gall.rst @@ -0,0 +1,84 @@ +.. _gall: + +******************************************************************************** +Gall (Gall Stereographic) +******************************************************************************** + +The Gall stereographic projection, presented by James Gall in 1855, is a cylindrical projection. +It is neither equal-area nor conformal but instead tries to balance the distortion inherent in any projection. + ++---------------------+--------------------------------------------------------------------------------+ +| **Classification** | Transverse and oblique cylindrical | ++---------------------+--------------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse, Spherical | ++---------------------+--------------------------------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+--------------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+--------------------------------------------------------------------------------+ +| **Options** | No special options for this projection | ++---------------------+--------------------------------------------------------------------------------+ + + +.. image:: ./images/gall.png + :scale: 50% + :alt: Gall (Gall Stereographic) + +Usage +##### + +The need for a world map which avoids some of the scale exaggeration of the Mercator projection has led to some commonly used cylindrical modifications, as well as to other modifications which are not cylindrical. +The earliest common cylindrical example was developed by James Gall of Edinburgh about 1855 (Gall, 1885, p. 119-123). +His meridians are equally spaced, but the parallels are spaced at increasing intervals away from the Equator. +The parallels of latitude are actually projected onto a cylinder wrapped about the sphere, but cutting it at lats. 45° N. and S., the point of perspective being a point on the Equator opposite the meridian being projected. +It is used in several British atlases, but seldom in the United States. +The Gall projection is neither conformal nor equal-area, but has a blend of various features. +Unlike the Mercator, the Gall shows the poles as lines running across the top and bottom of the map. + + +Example using Gall Stereographical :: + + $ echo 9 51 | proj +proj=gall +lon_0=0 +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs + 708432.90 5193386.36 + +Example using Gall Stereographical (Central meridian 90°W) :: + + $ echo 9 51 | proj +proj=gall +lon_0=90w +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs + 7792761.91 5193386.36 + +Mathematical definition +####################### + +The formulas describing the Gall Stereographical are all taken from Snyder's [Snyder1993]_. + +Spherical form +************** + +Forward projection +================== + +.. math:: + + x = \frac{\lambda}{\sqrt{2}} + +.. math:: + + y = (1+\frac{\sqrt{2}}{2}) \tan(\phi/2) + +Inverse projection +================== + +.. math:: + + \phi = 2 \arctan( \frac{y}{1+\frac{\sqrt{2}}{2}} ) + +.. math:: + + \lambda = \sqrt{2} x + + +Further reading +############### + +#. `Wikipedia <https://en.wikipedia.org/wiki/Gall_stereographic_projection>`_ +#. `Cartographic Projection Procedures for the UNIX Environment-A User's Manual <http://sites.lsa.umich.edu/zhukov/wp-content/uploads/sites/140/2014/08/projection-procedures.pdf>`_ diff --git a/docs/source/usage/operations/projections/geos.rst b/docs/source/usage/operations/projections/geos.rst new file mode 100644 index 00000000..3b24e1f7 --- /dev/null +++ b/docs/source/usage/operations/projections/geos.rst @@ -0,0 +1,72 @@ +.. _geos: + +******************************************************************************** +Geostationary Satellite View +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Azimuthal | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden and Martin Raspaud$ | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+h` | Satellite height above earth. Required. | ++---------------------+----------------------------------------------------------+ +| `+sweep` | Sweep angle axis of the viewing instrument. | +| | Valid options are ``x`` and ``y``. Defaults to ``y``. | ++---------------------+----------------------------------------------------------+ +| `+lon_0` | Subsatellite longitude point. | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/geos.png + :scale: 50% + :alt: Geostationary Satellite View + +The geos projection pictures how a geostationary satellite scans the earth at regular +scanning angle intervals. + + +Usage +############################################################################### + +In order to project using the geos projection you can do the following:: + + proj +proj=geos +h=35785831.0 + +The required argument ``h`` is the viewing point (satellite position) height above +the earth. + +The projection coordinate relate to the scanning angle by the following simple +relation:: + + scanning_angle (radians) = projection_coordinate / h + + +Note on sweep angle +------------------------------------------------------------------------------- + +The viewing instrument on-board geostationary satellites described by this +projection have a two-axis gimbal viewing geometry. This means that the different +scanning positions are obtained by rotating the gimbal along a N/S axis (or ``y``) +and a E/W axis (or ``x``). + +.. image:: ../../../../images/geos_sweep.png + :scale: 50% + :alt: Gimbal geometry + +In the image above, the outer-gimbal axis, or sweep-angle axis, is the N/S axis (``y``) +while the inner-gimbal axis, or fixed-angle axis, is the E/W axis (``x``). + +This example represents the scanning geometry of the Meteosat series satellite. +However, the GOES satellite series use the opposite scanning geometry, with the +E/W axis (``x``) as the sweep-angle axis, and the N/S (``y``) as the fixed-angle axis. + +The sweep argument is used to tell PROJ.4 which on which axis the outer-gimbal +is rotating. The possible values are x or y, y being the default. Thus, the +scanning geometry of the Meteosat series satellite should take sweep as x, and +GOES should take sweep as y. diff --git a/docs/source/usage/operations/projections/gins8.rst b/docs/source/usage/operations/projections/gins8.rst new file mode 100644 index 00000000..f6adb092 --- /dev/null +++ b/docs/source/usage/operations/projections/gins8.rst @@ -0,0 +1,10 @@ +.. _gins8: + +******************************************************************************** +Ginsburg VIII (TsNIIGAiK) +******************************************************************************** + +.. image:: ./images/gins8.png + :scale: 50% + :alt: Ginsburg VIII (TsNIIGAiK) + diff --git a/docs/source/usage/operations/projections/gn_sinu.rst b/docs/source/usage/operations/projections/gn_sinu.rst new file mode 100644 index 00000000..c1017c27 --- /dev/null +++ b/docs/source/usage/operations/projections/gn_sinu.rst @@ -0,0 +1,10 @@ +.. _gn_sinu: + +******************************************************************************** +General Sinusoidal Series +******************************************************************************** + +.. image:: ./images/gn_sinu.png + :scale: 50% + :alt: General Sinusoidal Series + diff --git a/docs/source/usage/operations/projections/gnom.rst b/docs/source/usage/operations/projections/gnom.rst new file mode 100644 index 00000000..08d0db5f --- /dev/null +++ b/docs/source/usage/operations/projections/gnom.rst @@ -0,0 +1,10 @@ +.. _gnom: + +******************************************************************************** +Gnomonic +******************************************************************************** + +.. image:: ./images/gnom.png + :scale: 50% + :alt: Gnomonic + diff --git a/docs/source/usage/operations/projections/goode.rst b/docs/source/usage/operations/projections/goode.rst new file mode 100644 index 00000000..c4590bf2 --- /dev/null +++ b/docs/source/usage/operations/projections/goode.rst @@ -0,0 +1,10 @@ +.. _goode: + +******************************************************************************** +Goode Homolosine +******************************************************************************** + +.. image:: ./images/goode.png + :scale: 50% + :alt: Goode Homolosine + diff --git a/docs/source/usage/operations/projections/gs48.rst b/docs/source/usage/operations/projections/gs48.rst new file mode 100644 index 00000000..bdaa367c --- /dev/null +++ b/docs/source/usage/operations/projections/gs48.rst @@ -0,0 +1,10 @@ +.. _gs48: + +******************************************************************************** +Mod. Stererographics of 48 U.S. +******************************************************************************** + +.. image:: ./images/gs48.png + :scale: 50% + :alt: Mod. Stererographics of 48 U.S. + diff --git a/docs/source/usage/operations/projections/gs50.rst b/docs/source/usage/operations/projections/gs50.rst new file mode 100644 index 00000000..0d4b7e81 --- /dev/null +++ b/docs/source/usage/operations/projections/gs50.rst @@ -0,0 +1,10 @@ +.. _gs50: + +******************************************************************************** +Mod. Stererographics of 50 U.S. +******************************************************************************** + +.. image:: ./images/gs50.png + :scale: 50% + :alt: Mod. Stererographics of 50 U.S. + diff --git a/docs/source/usage/operations/projections/gstmerc.rst b/docs/source/usage/operations/projections/gstmerc.rst new file mode 100644 index 00000000..fc587ab0 --- /dev/null +++ b/docs/source/usage/operations/projections/gstmerc.rst @@ -0,0 +1,10 @@ +.. _gstmerc: + +******************************************************************************** +Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion) +******************************************************************************** + +.. image:: ./images/gstmerc.png + :scale: 50% + :alt: Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion) + diff --git a/docs/source/usage/operations/projections/hammer.rst b/docs/source/usage/operations/projections/hammer.rst new file mode 100644 index 00000000..e795b91b --- /dev/null +++ b/docs/source/usage/operations/projections/hammer.rst @@ -0,0 +1,10 @@ +.. _hammer: + +******************************************************************************** +Hammer & Eckert-Greifendorff +******************************************************************************** + +.. image:: ./images/hammer.png + :scale: 50% + :alt: Hammer & Eckert-Greifendorff + diff --git a/docs/source/usage/operations/projections/hatano.rst b/docs/source/usage/operations/projections/hatano.rst new file mode 100644 index 00000000..5d0c63b7 --- /dev/null +++ b/docs/source/usage/operations/projections/hatano.rst @@ -0,0 +1,70 @@ +.. _hatano: + +******************************************************************************** +Hatano Asymmetrical Equal Area +******************************************************************************** + + + + ++---------------------+----------------------------------------------------------+ +| **Classification** | :term:`Pseudocylindrical Projection` | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global, but best between standard parallels | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_1` | Standard Parallel 1 | ++---------------------+----------------------------------------------------------+ +| `+lat_2` | Standard Parallel 2 | ++---------------------+----------------------------------------------------------+ +| `+sym` | Symmetric form used instead of asymmetric | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/hatano.png + :scale: 50% + :alt: Hatano Asymmetrical Equal Area + + + +Mathematical Definition +-------------------------------------------------------------------------------- + +Forward +................................................................................ + +.. math:: + + x &= 0.85\lambda \cos \theta + + y &= C_y \sin \theta + + P(\theta) &= 2\theta + \sin 2\theta - C_p \sin \phi + + P'(\theta) &= 2(1 + \cos 2\theta) + + \theta_0 &= 2\phi + + +==================================== ================== =================== +Condition :math:`C_p` :math:`C_p` +==================================== ================== =================== +if ``+sym`` or :math:`\phi > 0` 1.75859 2.67595 +if not ``+sym`` and :math:`\phi < 0` 1.93052 2.43763 +==================================== ================== =================== + +For :math:`\phi = 0`, :math:`y \leftarrow 0`, and :math:`x \leftarrow 0.85\lambda`. + +Further reading +-------------------------------------------------------------------------------- + +#. `Compare Map Projections <http://map-projections.net/single-view/hatano>`__ +#. `Mathworks <http://www.mathworks.com/help/map/hatano.html>`__ + + + diff --git a/docs/source/usage/operations/projections/healpix.rst b/docs/source/usage/operations/projections/healpix.rst new file mode 100644 index 00000000..20815d76 --- /dev/null +++ b/docs/source/usage/operations/projections/healpix.rst @@ -0,0 +1,55 @@ +.. _healpix: + +******************************************************************************** +HEALPix +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Mixed | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Alex Raichev and Michael Speth | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `No special options for this projection` | ++---------------------+----------------------------------------------------------+ + +.. image:: ../../../../images/healpix.png + :scale: 75% + :alt: HEALPix + +The HEALPix projection is area preserving and can be used with a spherical and +ellipsoidal model. It was initially developed for mapping cosmic background +microwave radiation. The image below is the graphical representation of the +mapping and consists of eight isomorphic triangular interrupted map graticules. +The north and south contains four in which straight meridians converge polewards +to a point and unequally spaced horizontal parallels. HEALPix provides a mapping +in which points of equal latitude and equally spaced longitude are mapped to points +of equal latitude and equally spaced longitude with the module of the polar +interruptions. + + +Usage +############################################################################### + +To run a forward HEALPix projection on a unit sphere model, use the following command:: + + proj +proj=healpix +lon_0=0 +a=1 -E <<EOF + 0 0 + EOF + # output + 0 0 0.00 0.00 + +Further reading +################################################################################ + +#. `NASA <http://healpix.jpl.nasa.gov/>`_ +#. `Wikipedia <https://en.wikipedia.org/wiki/HEALPix>`_ + + + + + diff --git a/docs/source/usage/operations/projections/igh.rst b/docs/source/usage/operations/projections/igh.rst new file mode 100644 index 00000000..d74e1362 --- /dev/null +++ b/docs/source/usage/operations/projections/igh.rst @@ -0,0 +1,10 @@ +.. _igh: + +******************************************************************************** +Interrupted Goode Homolosine +******************************************************************************** + +.. image:: ./images/igh.png + :scale: 50% + :alt: Interrupted Goode Homolosine + diff --git a/docs/source/usage/operations/projections/images/aea.png b/docs/source/usage/operations/projections/images/aea.png Binary files differnew file mode 100644 index 00000000..7fdd4ece --- /dev/null +++ b/docs/source/usage/operations/projections/images/aea.png diff --git a/docs/source/usage/operations/projections/images/aeqd.png b/docs/source/usage/operations/projections/images/aeqd.png Binary files differnew file mode 100644 index 00000000..8e45b2c0 --- /dev/null +++ b/docs/source/usage/operations/projections/images/aeqd.png diff --git a/docs/source/usage/operations/projections/images/airy.png b/docs/source/usage/operations/projections/images/airy.png Binary files differnew file mode 100644 index 00000000..a441e317 --- /dev/null +++ b/docs/source/usage/operations/projections/images/airy.png diff --git a/docs/source/usage/operations/projections/images/aitoff.png b/docs/source/usage/operations/projections/images/aitoff.png Binary files differnew file mode 100644 index 00000000..3449dcd5 --- /dev/null +++ b/docs/source/usage/operations/projections/images/aitoff.png diff --git a/docs/source/usage/operations/projections/images/alsk.png b/docs/source/usage/operations/projections/images/alsk.png Binary files differnew file mode 100644 index 00000000..6f6e2014 --- /dev/null +++ b/docs/source/usage/operations/projections/images/alsk.png diff --git a/docs/source/usage/operations/projections/images/apian.png b/docs/source/usage/operations/projections/images/apian.png Binary files differnew file mode 100644 index 00000000..95857ae3 --- /dev/null +++ b/docs/source/usage/operations/projections/images/apian.png diff --git a/docs/source/usage/operations/projections/images/august.png b/docs/source/usage/operations/projections/images/august.png Binary files differnew file mode 100644 index 00000000..9d9fece6 --- /dev/null +++ b/docs/source/usage/operations/projections/images/august.png diff --git a/docs/source/usage/operations/projections/images/bacon.png b/docs/source/usage/operations/projections/images/bacon.png Binary files differnew file mode 100644 index 00000000..62deae63 --- /dev/null +++ b/docs/source/usage/operations/projections/images/bacon.png diff --git a/docs/source/usage/operations/projections/images/bipc.png b/docs/source/usage/operations/projections/images/bipc.png Binary files differnew file mode 100644 index 00000000..7b8ab39c --- /dev/null +++ b/docs/source/usage/operations/projections/images/bipc.png diff --git a/docs/source/usage/operations/projections/images/boggs.png b/docs/source/usage/operations/projections/images/boggs.png Binary files differnew file mode 100644 index 00000000..42dd4c13 --- /dev/null +++ b/docs/source/usage/operations/projections/images/boggs.png diff --git a/docs/source/usage/operations/projections/images/bonne.png b/docs/source/usage/operations/projections/images/bonne.png Binary files differnew file mode 100644 index 00000000..12f93217 --- /dev/null +++ b/docs/source/usage/operations/projections/images/bonne.png diff --git a/docs/source/usage/operations/projections/images/calcofi.png b/docs/source/usage/operations/projections/images/calcofi.png Binary files differnew file mode 100644 index 00000000..2fd405ac --- /dev/null +++ b/docs/source/usage/operations/projections/images/calcofi.png diff --git a/docs/source/usage/operations/projections/images/cass.png b/docs/source/usage/operations/projections/images/cass.png Binary files differnew file mode 100644 index 00000000..e44c46af --- /dev/null +++ b/docs/source/usage/operations/projections/images/cass.png diff --git a/docs/source/usage/operations/projections/images/cc.png b/docs/source/usage/operations/projections/images/cc.png Binary files differnew file mode 100644 index 00000000..3beaedfd --- /dev/null +++ b/docs/source/usage/operations/projections/images/cc.png diff --git a/docs/source/usage/operations/projections/images/cea.png b/docs/source/usage/operations/projections/images/cea.png Binary files differnew file mode 100644 index 00000000..eca2319d --- /dev/null +++ b/docs/source/usage/operations/projections/images/cea.png diff --git a/docs/source/usage/operations/projections/images/chamb.png b/docs/source/usage/operations/projections/images/chamb.png Binary files differnew file mode 100644 index 00000000..a87e6c68 --- /dev/null +++ b/docs/source/usage/operations/projections/images/chamb.png diff --git a/docs/source/usage/operations/projections/images/collg.png b/docs/source/usage/operations/projections/images/collg.png Binary files differnew file mode 100644 index 00000000..851201da --- /dev/null +++ b/docs/source/usage/operations/projections/images/collg.png diff --git a/docs/source/usage/operations/projections/images/comill.png b/docs/source/usage/operations/projections/images/comill.png Binary files differnew file mode 100644 index 00000000..725a0118 --- /dev/null +++ b/docs/source/usage/operations/projections/images/comill.png diff --git a/docs/source/usage/operations/projections/images/crast.png b/docs/source/usage/operations/projections/images/crast.png Binary files differnew file mode 100644 index 00000000..abd4d32a --- /dev/null +++ b/docs/source/usage/operations/projections/images/crast.png diff --git a/docs/source/usage/operations/projections/images/denoy.png b/docs/source/usage/operations/projections/images/denoy.png Binary files differnew file mode 100644 index 00000000..2871cf84 --- /dev/null +++ b/docs/source/usage/operations/projections/images/denoy.png diff --git a/docs/source/usage/operations/projections/images/eck1.png b/docs/source/usage/operations/projections/images/eck1.png Binary files differnew file mode 100644 index 00000000..b892d39e --- /dev/null +++ b/docs/source/usage/operations/projections/images/eck1.png diff --git a/docs/source/usage/operations/projections/images/eck2.png b/docs/source/usage/operations/projections/images/eck2.png Binary files differnew file mode 100644 index 00000000..ff011598 --- /dev/null +++ b/docs/source/usage/operations/projections/images/eck2.png diff --git a/docs/source/usage/operations/projections/images/eck3.png b/docs/source/usage/operations/projections/images/eck3.png Binary files differnew file mode 100644 index 00000000..f828eed0 --- /dev/null +++ b/docs/source/usage/operations/projections/images/eck3.png diff --git a/docs/source/usage/operations/projections/images/eck4.png b/docs/source/usage/operations/projections/images/eck4.png Binary files differnew file mode 100644 index 00000000..d7ff87bb --- /dev/null +++ b/docs/source/usage/operations/projections/images/eck4.png diff --git a/docs/source/usage/operations/projections/images/eck5.png b/docs/source/usage/operations/projections/images/eck5.png Binary files differnew file mode 100644 index 00000000..3df303c6 --- /dev/null +++ b/docs/source/usage/operations/projections/images/eck5.png diff --git a/docs/source/usage/operations/projections/images/eck6.png b/docs/source/usage/operations/projections/images/eck6.png Binary files differnew file mode 100644 index 00000000..d22f4956 --- /dev/null +++ b/docs/source/usage/operations/projections/images/eck6.png diff --git a/docs/source/usage/operations/projections/images/eqc.png b/docs/source/usage/operations/projections/images/eqc.png Binary files differnew file mode 100644 index 00000000..b2d8ba23 --- /dev/null +++ b/docs/source/usage/operations/projections/images/eqc.png diff --git a/docs/source/usage/operations/projections/images/eqdc.png b/docs/source/usage/operations/projections/images/eqdc.png Binary files differnew file mode 100644 index 00000000..f2330a8e --- /dev/null +++ b/docs/source/usage/operations/projections/images/eqdc.png diff --git a/docs/source/usage/operations/projections/images/etmerc.png b/docs/source/usage/operations/projections/images/etmerc.png Binary files differnew file mode 100644 index 00000000..8e6bb39b --- /dev/null +++ b/docs/source/usage/operations/projections/images/etmerc.png diff --git a/docs/source/usage/operations/projections/images/euler.png b/docs/source/usage/operations/projections/images/euler.png Binary files differnew file mode 100644 index 00000000..c9c6e4c8 --- /dev/null +++ b/docs/source/usage/operations/projections/images/euler.png diff --git a/docs/source/usage/operations/projections/images/fahey.png b/docs/source/usage/operations/projections/images/fahey.png Binary files differnew file mode 100644 index 00000000..8b870b8a --- /dev/null +++ b/docs/source/usage/operations/projections/images/fahey.png diff --git a/docs/source/usage/operations/projections/images/fouc.png b/docs/source/usage/operations/projections/images/fouc.png Binary files differnew file mode 100644 index 00000000..6d33216b --- /dev/null +++ b/docs/source/usage/operations/projections/images/fouc.png diff --git a/docs/source/usage/operations/projections/images/fouc_s.png b/docs/source/usage/operations/projections/images/fouc_s.png Binary files differnew file mode 100644 index 00000000..401f5ee4 --- /dev/null +++ b/docs/source/usage/operations/projections/images/fouc_s.png diff --git a/docs/source/usage/operations/projections/images/gall.png b/docs/source/usage/operations/projections/images/gall.png Binary files differnew file mode 100644 index 00000000..819b5d12 --- /dev/null +++ b/docs/source/usage/operations/projections/images/gall.png diff --git a/docs/source/usage/operations/projections/images/geos.png b/docs/source/usage/operations/projections/images/geos.png Binary files differnew file mode 100644 index 00000000..e44fa41b --- /dev/null +++ b/docs/source/usage/operations/projections/images/geos.png diff --git a/docs/source/usage/operations/projections/images/gins8.png b/docs/source/usage/operations/projections/images/gins8.png Binary files differnew file mode 100644 index 00000000..12fbae93 --- /dev/null +++ b/docs/source/usage/operations/projections/images/gins8.png diff --git a/docs/source/usage/operations/projections/images/gn_sinu.png b/docs/source/usage/operations/projections/images/gn_sinu.png Binary files differnew file mode 100644 index 00000000..f02e119e --- /dev/null +++ b/docs/source/usage/operations/projections/images/gn_sinu.png diff --git a/docs/source/usage/operations/projections/images/gnom.png b/docs/source/usage/operations/projections/images/gnom.png Binary files differnew file mode 100644 index 00000000..c079d31a --- /dev/null +++ b/docs/source/usage/operations/projections/images/gnom.png diff --git a/docs/source/usage/operations/projections/images/goode.png b/docs/source/usage/operations/projections/images/goode.png Binary files differnew file mode 100644 index 00000000..7001e8d2 --- /dev/null +++ b/docs/source/usage/operations/projections/images/goode.png diff --git a/docs/source/usage/operations/projections/images/gs48.png b/docs/source/usage/operations/projections/images/gs48.png Binary files differnew file mode 100644 index 00000000..574e368f --- /dev/null +++ b/docs/source/usage/operations/projections/images/gs48.png diff --git a/docs/source/usage/operations/projections/images/gs50.png b/docs/source/usage/operations/projections/images/gs50.png Binary files differnew file mode 100644 index 00000000..7244b160 --- /dev/null +++ b/docs/source/usage/operations/projections/images/gs50.png diff --git a/docs/source/usage/operations/projections/images/gstmerc.png b/docs/source/usage/operations/projections/images/gstmerc.png Binary files differnew file mode 100644 index 00000000..d553ea60 --- /dev/null +++ b/docs/source/usage/operations/projections/images/gstmerc.png diff --git a/docs/source/usage/operations/projections/images/hammer.png b/docs/source/usage/operations/projections/images/hammer.png Binary files differnew file mode 100644 index 00000000..83848479 --- /dev/null +++ b/docs/source/usage/operations/projections/images/hammer.png diff --git a/docs/source/usage/operations/projections/images/hatano.png b/docs/source/usage/operations/projections/images/hatano.png Binary files differnew file mode 100644 index 00000000..b3f47377 --- /dev/null +++ b/docs/source/usage/operations/projections/images/hatano.png diff --git a/docs/source/usage/operations/projections/images/healpix.png b/docs/source/usage/operations/projections/images/healpix.png Binary files differnew file mode 100644 index 00000000..c58a155c --- /dev/null +++ b/docs/source/usage/operations/projections/images/healpix.png diff --git a/docs/source/usage/operations/projections/images/igh.png b/docs/source/usage/operations/projections/images/igh.png Binary files differnew file mode 100644 index 00000000..36336eec --- /dev/null +++ b/docs/source/usage/operations/projections/images/igh.png diff --git a/docs/source/usage/operations/projections/images/imw_p.png b/docs/source/usage/operations/projections/images/imw_p.png Binary files differnew file mode 100644 index 00000000..74cfe81b --- /dev/null +++ b/docs/source/usage/operations/projections/images/imw_p.png diff --git a/docs/source/usage/operations/projections/images/isea.png b/docs/source/usage/operations/projections/images/isea.png Binary files differnew file mode 100644 index 00000000..23cfbf74 --- /dev/null +++ b/docs/source/usage/operations/projections/images/isea.png diff --git a/docs/source/usage/operations/projections/images/kav5.png b/docs/source/usage/operations/projections/images/kav5.png Binary files differnew file mode 100644 index 00000000..d5c45400 --- /dev/null +++ b/docs/source/usage/operations/projections/images/kav5.png diff --git a/docs/source/usage/operations/projections/images/kav7.png b/docs/source/usage/operations/projections/images/kav7.png Binary files differnew file mode 100644 index 00000000..50d7e6e6 --- /dev/null +++ b/docs/source/usage/operations/projections/images/kav7.png diff --git a/docs/source/usage/operations/projections/images/krovak.png b/docs/source/usage/operations/projections/images/krovak.png Binary files differnew file mode 100644 index 00000000..d0d69547 --- /dev/null +++ b/docs/source/usage/operations/projections/images/krovak.png diff --git a/docs/source/usage/operations/projections/images/labrd.png b/docs/source/usage/operations/projections/images/labrd.png Binary files differnew file mode 100644 index 00000000..e4a174c0 --- /dev/null +++ b/docs/source/usage/operations/projections/images/labrd.png diff --git a/docs/source/usage/operations/projections/images/laea.png b/docs/source/usage/operations/projections/images/laea.png Binary files differnew file mode 100644 index 00000000..f52c7c1f --- /dev/null +++ b/docs/source/usage/operations/projections/images/laea.png diff --git a/docs/source/usage/operations/projections/images/lagrng.png b/docs/source/usage/operations/projections/images/lagrng.png Binary files differnew file mode 100644 index 00000000..e48210bb --- /dev/null +++ b/docs/source/usage/operations/projections/images/lagrng.png diff --git a/docs/source/usage/operations/projections/images/larr.png b/docs/source/usage/operations/projections/images/larr.png Binary files differnew file mode 100644 index 00000000..967b91d2 --- /dev/null +++ b/docs/source/usage/operations/projections/images/larr.png diff --git a/docs/source/usage/operations/projections/images/lask.png b/docs/source/usage/operations/projections/images/lask.png Binary files differnew file mode 100644 index 00000000..dff0e8fa --- /dev/null +++ b/docs/source/usage/operations/projections/images/lask.png diff --git a/docs/source/usage/operations/projections/images/lcc.png b/docs/source/usage/operations/projections/images/lcc.png Binary files differnew file mode 100644 index 00000000..4714b74e --- /dev/null +++ b/docs/source/usage/operations/projections/images/lcc.png diff --git a/docs/source/usage/operations/projections/images/lcca.png b/docs/source/usage/operations/projections/images/lcca.png Binary files differnew file mode 100644 index 00000000..0c404670 --- /dev/null +++ b/docs/source/usage/operations/projections/images/lcca.png diff --git a/docs/source/usage/operations/projections/images/leac.png b/docs/source/usage/operations/projections/images/leac.png Binary files differnew file mode 100644 index 00000000..1f57d192 --- /dev/null +++ b/docs/source/usage/operations/projections/images/leac.png diff --git a/docs/source/usage/operations/projections/images/lee_os.png b/docs/source/usage/operations/projections/images/lee_os.png Binary files differnew file mode 100644 index 00000000..3e258393 --- /dev/null +++ b/docs/source/usage/operations/projections/images/lee_os.png diff --git a/docs/source/usage/operations/projections/images/loxim.png b/docs/source/usage/operations/projections/images/loxim.png Binary files differnew file mode 100644 index 00000000..a03ba94e --- /dev/null +++ b/docs/source/usage/operations/projections/images/loxim.png diff --git a/docs/source/usage/operations/projections/images/lsat.png b/docs/source/usage/operations/projections/images/lsat.png Binary files differnew file mode 100644 index 00000000..ec608544 --- /dev/null +++ b/docs/source/usage/operations/projections/images/lsat.png diff --git a/docs/source/usage/operations/projections/images/mbt_fps.png b/docs/source/usage/operations/projections/images/mbt_fps.png Binary files differnew file mode 100644 index 00000000..e97cd21e --- /dev/null +++ b/docs/source/usage/operations/projections/images/mbt_fps.png diff --git a/docs/source/usage/operations/projections/images/mbt_s.png b/docs/source/usage/operations/projections/images/mbt_s.png Binary files differnew file mode 100644 index 00000000..4432e83b --- /dev/null +++ b/docs/source/usage/operations/projections/images/mbt_s.png diff --git a/docs/source/usage/operations/projections/images/mbtfpp.png b/docs/source/usage/operations/projections/images/mbtfpp.png Binary files differnew file mode 100644 index 00000000..3d0c4fb5 --- /dev/null +++ b/docs/source/usage/operations/projections/images/mbtfpp.png diff --git a/docs/source/usage/operations/projections/images/mbtfpq.png b/docs/source/usage/operations/projections/images/mbtfpq.png Binary files differnew file mode 100644 index 00000000..b31c52ce --- /dev/null +++ b/docs/source/usage/operations/projections/images/mbtfpq.png diff --git a/docs/source/usage/operations/projections/images/mbtfps.png b/docs/source/usage/operations/projections/images/mbtfps.png Binary files differnew file mode 100644 index 00000000..83891be6 --- /dev/null +++ b/docs/source/usage/operations/projections/images/mbtfps.png diff --git a/docs/source/usage/operations/projections/images/merc.png b/docs/source/usage/operations/projections/images/merc.png Binary files differnew file mode 100644 index 00000000..8202789e --- /dev/null +++ b/docs/source/usage/operations/projections/images/merc.png diff --git a/docs/source/usage/operations/projections/images/mil_os.png b/docs/source/usage/operations/projections/images/mil_os.png Binary files differnew file mode 100644 index 00000000..3316d317 --- /dev/null +++ b/docs/source/usage/operations/projections/images/mil_os.png diff --git a/docs/source/usage/operations/projections/images/mill.png b/docs/source/usage/operations/projections/images/mill.png Binary files differnew file mode 100644 index 00000000..f62e517c --- /dev/null +++ b/docs/source/usage/operations/projections/images/mill.png diff --git a/docs/source/usage/operations/projections/images/misrsom.png b/docs/source/usage/operations/projections/images/misrsom.png Binary files differnew file mode 100644 index 00000000..493baff3 --- /dev/null +++ b/docs/source/usage/operations/projections/images/misrsom.png diff --git a/docs/source/usage/operations/projections/images/moll.png b/docs/source/usage/operations/projections/images/moll.png Binary files differnew file mode 100644 index 00000000..5d599579 --- /dev/null +++ b/docs/source/usage/operations/projections/images/moll.png diff --git a/docs/source/usage/operations/projections/images/murd1.png b/docs/source/usage/operations/projections/images/murd1.png Binary files differnew file mode 100644 index 00000000..34d628c5 --- /dev/null +++ b/docs/source/usage/operations/projections/images/murd1.png diff --git a/docs/source/usage/operations/projections/images/murd2.png b/docs/source/usage/operations/projections/images/murd2.png Binary files differnew file mode 100644 index 00000000..b3fdabdd --- /dev/null +++ b/docs/source/usage/operations/projections/images/murd2.png diff --git a/docs/source/usage/operations/projections/images/murd3.png b/docs/source/usage/operations/projections/images/murd3.png Binary files differnew file mode 100644 index 00000000..354b009c --- /dev/null +++ b/docs/source/usage/operations/projections/images/murd3.png diff --git a/docs/source/usage/operations/projections/images/natearth.png b/docs/source/usage/operations/projections/images/natearth.png Binary files differnew file mode 100644 index 00000000..0e182a0b --- /dev/null +++ b/docs/source/usage/operations/projections/images/natearth.png diff --git a/docs/source/usage/operations/projections/images/natearth2.png b/docs/source/usage/operations/projections/images/natearth2.png Binary files differnew file mode 100644 index 00000000..3757646c --- /dev/null +++ b/docs/source/usage/operations/projections/images/natearth2.png diff --git a/docs/source/usage/operations/projections/images/nell.png b/docs/source/usage/operations/projections/images/nell.png Binary files differnew file mode 100644 index 00000000..c0dbdcac --- /dev/null +++ b/docs/source/usage/operations/projections/images/nell.png diff --git a/docs/source/usage/operations/projections/images/nell_h.png b/docs/source/usage/operations/projections/images/nell_h.png Binary files differnew file mode 100644 index 00000000..a5a27076 --- /dev/null +++ b/docs/source/usage/operations/projections/images/nell_h.png diff --git a/docs/source/usage/operations/projections/images/nicol.png b/docs/source/usage/operations/projections/images/nicol.png Binary files differnew file mode 100644 index 00000000..711db115 --- /dev/null +++ b/docs/source/usage/operations/projections/images/nicol.png diff --git a/docs/source/usage/operations/projections/images/nsper.png b/docs/source/usage/operations/projections/images/nsper.png Binary files differnew file mode 100644 index 00000000..06f210a1 --- /dev/null +++ b/docs/source/usage/operations/projections/images/nsper.png diff --git a/docs/source/usage/operations/projections/images/nzmg.png b/docs/source/usage/operations/projections/images/nzmg.png Binary files differnew file mode 100644 index 00000000..3625f331 --- /dev/null +++ b/docs/source/usage/operations/projections/images/nzmg.png diff --git a/docs/source/usage/operations/projections/images/ob_tran.png b/docs/source/usage/operations/projections/images/ob_tran.png Binary files differnew file mode 100644 index 00000000..9b1e0d44 --- /dev/null +++ b/docs/source/usage/operations/projections/images/ob_tran.png diff --git a/docs/source/usage/operations/projections/images/ocea.png b/docs/source/usage/operations/projections/images/ocea.png Binary files differnew file mode 100644 index 00000000..41a5a813 --- /dev/null +++ b/docs/source/usage/operations/projections/images/ocea.png diff --git a/docs/source/usage/operations/projections/images/oea.png b/docs/source/usage/operations/projections/images/oea.png Binary files differnew file mode 100644 index 00000000..601ead55 --- /dev/null +++ b/docs/source/usage/operations/projections/images/oea.png diff --git a/docs/source/usage/operations/projections/images/omerc.png b/docs/source/usage/operations/projections/images/omerc.png Binary files differnew file mode 100644 index 00000000..50a3d2b7 --- /dev/null +++ b/docs/source/usage/operations/projections/images/omerc.png diff --git a/docs/source/usage/operations/projections/images/ortel.png b/docs/source/usage/operations/projections/images/ortel.png Binary files differnew file mode 100644 index 00000000..c6a5bf4f --- /dev/null +++ b/docs/source/usage/operations/projections/images/ortel.png diff --git a/docs/source/usage/operations/projections/images/ortho.png b/docs/source/usage/operations/projections/images/ortho.png Binary files differnew file mode 100644 index 00000000..e8b0b9b2 --- /dev/null +++ b/docs/source/usage/operations/projections/images/ortho.png diff --git a/docs/source/usage/operations/projections/images/patterson.png b/docs/source/usage/operations/projections/images/patterson.png Binary files differnew file mode 100644 index 00000000..f8014249 --- /dev/null +++ b/docs/source/usage/operations/projections/images/patterson.png diff --git a/docs/source/usage/operations/projections/images/pconic.png b/docs/source/usage/operations/projections/images/pconic.png Binary files differnew file mode 100644 index 00000000..7d7f9f92 --- /dev/null +++ b/docs/source/usage/operations/projections/images/pconic.png diff --git a/docs/source/usage/operations/projections/images/poly.png b/docs/source/usage/operations/projections/images/poly.png Binary files differnew file mode 100644 index 00000000..ccf25529 --- /dev/null +++ b/docs/source/usage/operations/projections/images/poly.png diff --git a/docs/source/usage/operations/projections/images/putp1.png b/docs/source/usage/operations/projections/images/putp1.png Binary files differnew file mode 100644 index 00000000..c81f574c --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp1.png diff --git a/docs/source/usage/operations/projections/images/putp2.png b/docs/source/usage/operations/projections/images/putp2.png Binary files differnew file mode 100644 index 00000000..377a027c --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp2.png diff --git a/docs/source/usage/operations/projections/images/putp3.png b/docs/source/usage/operations/projections/images/putp3.png Binary files differnew file mode 100644 index 00000000..08692ca1 --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp3.png diff --git a/docs/source/usage/operations/projections/images/putp3p.png b/docs/source/usage/operations/projections/images/putp3p.png Binary files differnew file mode 100644 index 00000000..9e42319c --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp3p.png diff --git a/docs/source/usage/operations/projections/images/putp4p.png b/docs/source/usage/operations/projections/images/putp4p.png Binary files differnew file mode 100644 index 00000000..43cb10c6 --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp4p.png diff --git a/docs/source/usage/operations/projections/images/putp5.png b/docs/source/usage/operations/projections/images/putp5.png Binary files differnew file mode 100644 index 00000000..4e45de6d --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp5.png diff --git a/docs/source/usage/operations/projections/images/putp5p.png b/docs/source/usage/operations/projections/images/putp5p.png Binary files differnew file mode 100644 index 00000000..76dcb767 --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp5p.png diff --git a/docs/source/usage/operations/projections/images/putp6.png b/docs/source/usage/operations/projections/images/putp6.png Binary files differnew file mode 100644 index 00000000..c73585ee --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp6.png diff --git a/docs/source/usage/operations/projections/images/putp6p.png b/docs/source/usage/operations/projections/images/putp6p.png Binary files differnew file mode 100644 index 00000000..d64c2c20 --- /dev/null +++ b/docs/source/usage/operations/projections/images/putp6p.png diff --git a/docs/source/usage/operations/projections/images/qsc.png b/docs/source/usage/operations/projections/images/qsc.png Binary files differnew file mode 100644 index 00000000..5824cf64 --- /dev/null +++ b/docs/source/usage/operations/projections/images/qsc.png diff --git a/docs/source/usage/operations/projections/images/qua_aut.png b/docs/source/usage/operations/projections/images/qua_aut.png Binary files differnew file mode 100644 index 00000000..6bc2d811 --- /dev/null +++ b/docs/source/usage/operations/projections/images/qua_aut.png diff --git a/docs/source/usage/operations/projections/images/rhealpix.png b/docs/source/usage/operations/projections/images/rhealpix.png Binary files differnew file mode 100644 index 00000000..dc1c344a --- /dev/null +++ b/docs/source/usage/operations/projections/images/rhealpix.png diff --git a/docs/source/usage/operations/projections/images/robin.png b/docs/source/usage/operations/projections/images/robin.png Binary files differnew file mode 100644 index 00000000..42a49da2 --- /dev/null +++ b/docs/source/usage/operations/projections/images/robin.png diff --git a/docs/source/usage/operations/projections/images/rouss.png b/docs/source/usage/operations/projections/images/rouss.png Binary files differnew file mode 100644 index 00000000..2eca0fed --- /dev/null +++ b/docs/source/usage/operations/projections/images/rouss.png diff --git a/docs/source/usage/operations/projections/images/rpoly.png b/docs/source/usage/operations/projections/images/rpoly.png Binary files differnew file mode 100644 index 00000000..343127c1 --- /dev/null +++ b/docs/source/usage/operations/projections/images/rpoly.png diff --git a/docs/source/usage/operations/projections/images/sinu.png b/docs/source/usage/operations/projections/images/sinu.png Binary files differnew file mode 100644 index 00000000..9bef143a --- /dev/null +++ b/docs/source/usage/operations/projections/images/sinu.png diff --git a/docs/source/usage/operations/projections/images/somerc.png b/docs/source/usage/operations/projections/images/somerc.png Binary files differnew file mode 100644 index 00000000..1248e6ea --- /dev/null +++ b/docs/source/usage/operations/projections/images/somerc.png diff --git a/docs/source/usage/operations/projections/images/stere.png b/docs/source/usage/operations/projections/images/stere.png Binary files differnew file mode 100644 index 00000000..840050f0 --- /dev/null +++ b/docs/source/usage/operations/projections/images/stere.png diff --git a/docs/source/usage/operations/projections/images/sterea.png b/docs/source/usage/operations/projections/images/sterea.png Binary files differnew file mode 100644 index 00000000..d2aad552 --- /dev/null +++ b/docs/source/usage/operations/projections/images/sterea.png diff --git a/docs/source/usage/operations/projections/images/tcc.png b/docs/source/usage/operations/projections/images/tcc.png Binary files differnew file mode 100644 index 00000000..f968f62d --- /dev/null +++ b/docs/source/usage/operations/projections/images/tcc.png diff --git a/docs/source/usage/operations/projections/images/tcea.png b/docs/source/usage/operations/projections/images/tcea.png Binary files differnew file mode 100644 index 00000000..44212bd8 --- /dev/null +++ b/docs/source/usage/operations/projections/images/tcea.png diff --git a/docs/source/usage/operations/projections/images/tissot.png b/docs/source/usage/operations/projections/images/tissot.png Binary files differnew file mode 100644 index 00000000..2f785477 --- /dev/null +++ b/docs/source/usage/operations/projections/images/tissot.png diff --git a/docs/source/usage/operations/projections/images/tmerc.png b/docs/source/usage/operations/projections/images/tmerc.png Binary files differnew file mode 100644 index 00000000..b206c502 --- /dev/null +++ b/docs/source/usage/operations/projections/images/tmerc.png diff --git a/docs/source/usage/operations/projections/images/tpeqd.png b/docs/source/usage/operations/projections/images/tpeqd.png Binary files differnew file mode 100644 index 00000000..50291b68 --- /dev/null +++ b/docs/source/usage/operations/projections/images/tpeqd.png diff --git a/docs/source/usage/operations/projections/images/tpers.png b/docs/source/usage/operations/projections/images/tpers.png Binary files differnew file mode 100644 index 00000000..480f6dce --- /dev/null +++ b/docs/source/usage/operations/projections/images/tpers.png diff --git a/docs/source/usage/operations/projections/images/ups.png b/docs/source/usage/operations/projections/images/ups.png Binary files differnew file mode 100644 index 00000000..354b64ac --- /dev/null +++ b/docs/source/usage/operations/projections/images/ups.png diff --git a/docs/source/usage/operations/projections/images/urm5.png b/docs/source/usage/operations/projections/images/urm5.png Binary files differnew file mode 100644 index 00000000..088671c9 --- /dev/null +++ b/docs/source/usage/operations/projections/images/urm5.png diff --git a/docs/source/usage/operations/projections/images/urmfps.png b/docs/source/usage/operations/projections/images/urmfps.png Binary files differnew file mode 100644 index 00000000..86432790 --- /dev/null +++ b/docs/source/usage/operations/projections/images/urmfps.png diff --git a/docs/source/usage/operations/projections/images/utm.png b/docs/source/usage/operations/projections/images/utm.png Binary files differnew file mode 100644 index 00000000..3dcd5ee0 --- /dev/null +++ b/docs/source/usage/operations/projections/images/utm.png diff --git a/docs/source/usage/operations/projections/images/vandg.png b/docs/source/usage/operations/projections/images/vandg.png Binary files differnew file mode 100644 index 00000000..46fe2346 --- /dev/null +++ b/docs/source/usage/operations/projections/images/vandg.png diff --git a/docs/source/usage/operations/projections/images/vandg2.png b/docs/source/usage/operations/projections/images/vandg2.png Binary files differnew file mode 100644 index 00000000..597b5ae1 --- /dev/null +++ b/docs/source/usage/operations/projections/images/vandg2.png diff --git a/docs/source/usage/operations/projections/images/vandg3.png b/docs/source/usage/operations/projections/images/vandg3.png Binary files differnew file mode 100644 index 00000000..36d1ad04 --- /dev/null +++ b/docs/source/usage/operations/projections/images/vandg3.png diff --git a/docs/source/usage/operations/projections/images/vandg4.png b/docs/source/usage/operations/projections/images/vandg4.png Binary files differnew file mode 100644 index 00000000..163c1558 --- /dev/null +++ b/docs/source/usage/operations/projections/images/vandg4.png diff --git a/docs/source/usage/operations/projections/images/vitk1.png b/docs/source/usage/operations/projections/images/vitk1.png Binary files differnew file mode 100644 index 00000000..31034b3a --- /dev/null +++ b/docs/source/usage/operations/projections/images/vitk1.png diff --git a/docs/source/usage/operations/projections/images/wag1.png b/docs/source/usage/operations/projections/images/wag1.png Binary files differnew file mode 100644 index 00000000..a2bc8adc --- /dev/null +++ b/docs/source/usage/operations/projections/images/wag1.png diff --git a/docs/source/usage/operations/projections/images/wag2.png b/docs/source/usage/operations/projections/images/wag2.png Binary files differnew file mode 100644 index 00000000..b4abb48c --- /dev/null +++ b/docs/source/usage/operations/projections/images/wag2.png diff --git a/docs/source/usage/operations/projections/images/wag3.png b/docs/source/usage/operations/projections/images/wag3.png Binary files differnew file mode 100644 index 00000000..a2053815 --- /dev/null +++ b/docs/source/usage/operations/projections/images/wag3.png diff --git a/docs/source/usage/operations/projections/images/wag4.png b/docs/source/usage/operations/projections/images/wag4.png Binary files differnew file mode 100644 index 00000000..7d1c50b3 --- /dev/null +++ b/docs/source/usage/operations/projections/images/wag4.png diff --git a/docs/source/usage/operations/projections/images/wag5.png b/docs/source/usage/operations/projections/images/wag5.png Binary files differnew file mode 100644 index 00000000..487f6022 --- /dev/null +++ b/docs/source/usage/operations/projections/images/wag5.png diff --git a/docs/source/usage/operations/projections/images/wag6.png b/docs/source/usage/operations/projections/images/wag6.png Binary files differnew file mode 100644 index 00000000..dd49e8d0 --- /dev/null +++ b/docs/source/usage/operations/projections/images/wag6.png diff --git a/docs/source/usage/operations/projections/images/wag7.png b/docs/source/usage/operations/projections/images/wag7.png Binary files differnew file mode 100644 index 00000000..b9682755 --- /dev/null +++ b/docs/source/usage/operations/projections/images/wag7.png diff --git a/docs/source/usage/operations/projections/images/weren.png b/docs/source/usage/operations/projections/images/weren.png Binary files differnew file mode 100644 index 00000000..7deb132f --- /dev/null +++ b/docs/source/usage/operations/projections/images/weren.png diff --git a/docs/source/usage/operations/projections/images/wink1.png b/docs/source/usage/operations/projections/images/wink1.png Binary files differnew file mode 100644 index 00000000..6cbf48ae --- /dev/null +++ b/docs/source/usage/operations/projections/images/wink1.png diff --git a/docs/source/usage/operations/projections/images/wink2.png b/docs/source/usage/operations/projections/images/wink2.png Binary files differnew file mode 100644 index 00000000..21a23634 --- /dev/null +++ b/docs/source/usage/operations/projections/images/wink2.png diff --git a/docs/source/usage/operations/projections/images/wintri.png b/docs/source/usage/operations/projections/images/wintri.png Binary files differnew file mode 100644 index 00000000..54a0a85a --- /dev/null +++ b/docs/source/usage/operations/projections/images/wintri.png diff --git a/docs/source/usage/operations/projections/imw_p.rst b/docs/source/usage/operations/projections/imw_p.rst new file mode 100644 index 00000000..1fd3ded0 --- /dev/null +++ b/docs/source/usage/operations/projections/imw_p.rst @@ -0,0 +1,10 @@ +.. _imw_p: + +******************************************************************************** +International Map of the World Polyconic +******************************************************************************** + +.. image:: ./images/imw_p.png + :scale: 50% + :alt: International Map of the World Polyconic + diff --git a/docs/source/usage/operations/projections/index.rst b/docs/source/usage/operations/projections/index.rst new file mode 100644 index 00000000..ae8ef1ee --- /dev/null +++ b/docs/source/usage/operations/projections/index.rst @@ -0,0 +1,142 @@ +.. _projections: + +================================================================================ +Projections +================================================================================ + +.. toctree:: + :maxdepth: 1 + + aeqd + airy + aitoff + alsk + apian + august + bacon + bipc + boggs + bonne + calcofi + cass + cc + cea + chamb + collg + crast + denoy + eck1 + eck2 + eck3 + eck4 + eck5 + eck6 + eqc + eqdc + euler + etmerc + fahey + fouc + fouc_s + gall + geos + gins8 + gn_sinu + gnom + goode + gs48 + gs50 + hammer + hatano + healpix + rhealpix + igh + imw_p + isea + kav5 + kav7 + krovak + labrd + laea + lagrng + larr + lask + lonlat + latlon + lcc + lcca + leac + lee_os + loxim + lsat + mbt_s + mbt_fps + mbtfpp + mbtfpq + mbtfps + merc + mil_os + mill + moll + murd1 + murd2 + murd3 + natearth + nell + nell_h + nicol + nsper + nzmg + ob_tran + ocea + oea + omerc + ortel + ortho + pconic + poly + putp1 + putp2 + putp3 + putp3p + putp4p + putp5 + putp5p + putp6 + putp6p + qua_aut + qsc + robin + rouss + rpoly + sinu + somerc + stere + sterea + gstmerc + tcc + tcea + tissot + tmerc + tpeqd + tpers + ups + urm5 + urmfps + utm + vandg + vandg2 + vandg3 + vandg4 + vitk1 + wag1 + wag2 + wag3 + wag4 + wag5 + wag6 + wag7 + weren + wink1 + wink2 + wintri diff --git a/docs/source/usage/operations/projections/isea.rst b/docs/source/usage/operations/projections/isea.rst new file mode 100644 index 00000000..1b6457af --- /dev/null +++ b/docs/source/usage/operations/projections/isea.rst @@ -0,0 +1,10 @@ +.. _isea: + +******************************************************************************** +Icosahedral Snyder Equal Area +******************************************************************************** + +.. image:: ./images/isea.png + :scale: 50% + :alt: Icosahedral Snyder Equal Area + diff --git a/docs/source/usage/operations/projections/kav5.rst b/docs/source/usage/operations/projections/kav5.rst new file mode 100644 index 00000000..2ec5d1c1 --- /dev/null +++ b/docs/source/usage/operations/projections/kav5.rst @@ -0,0 +1,10 @@ +.. _kav5: + +******************************************************************************** +Kavraisky V +******************************************************************************** + +.. image:: ./images/kav5.png + :scale: 50% + :alt: Kavraisky V + diff --git a/docs/source/usage/operations/projections/kav7.rst b/docs/source/usage/operations/projections/kav7.rst new file mode 100644 index 00000000..8371e6ea --- /dev/null +++ b/docs/source/usage/operations/projections/kav7.rst @@ -0,0 +1,10 @@ +.. _kav7: + +******************************************************************************** +Kavraisky VII +******************************************************************************** + +.. image:: ./images/kav7.png + :scale: 50% + :alt: Kavraisky VII + diff --git a/docs/source/usage/operations/projections/krovak.rst b/docs/source/usage/operations/projections/krovak.rst new file mode 100644 index 00000000..6c774825 --- /dev/null +++ b/docs/source/usage/operations/projections/krovak.rst @@ -0,0 +1,10 @@ +.. _krovak: + +******************************************************************************** +Krovak +******************************************************************************** + +.. image:: ./images/krovak.png + :scale: 50% + :alt: Krovak + diff --git a/docs/source/usage/operations/projections/labrd.rst b/docs/source/usage/operations/projections/labrd.rst new file mode 100644 index 00000000..5be58db5 --- /dev/null +++ b/docs/source/usage/operations/projections/labrd.rst @@ -0,0 +1,10 @@ +.. _labrd: + +******************************************************************************** +Laborde +******************************************************************************** + +.. image:: ./images/labrd.png + :scale: 50% + :alt: Laborde + diff --git a/docs/source/usage/operations/projections/laea.rst b/docs/source/usage/operations/projections/laea.rst new file mode 100644 index 00000000..2377f294 --- /dev/null +++ b/docs/source/usage/operations/projections/laea.rst @@ -0,0 +1,10 @@ +.. _laea: + +******************************************************************************** +Lambert Azimuthal Equal Area +******************************************************************************** + +.. image:: ./images/laea.png + :scale: 50% + :alt: Lambert Azimuthal Equal Area + diff --git a/docs/source/usage/operations/projections/lagrng.rst b/docs/source/usage/operations/projections/lagrng.rst new file mode 100644 index 00000000..de9e5640 --- /dev/null +++ b/docs/source/usage/operations/projections/lagrng.rst @@ -0,0 +1,10 @@ +.. _lagrng: + +******************************************************************************** +Lagrange +******************************************************************************** + +.. image:: ./images/lagrng.png + :scale: 50% + :alt: Lagrange + diff --git a/docs/source/usage/operations/projections/larr.rst b/docs/source/usage/operations/projections/larr.rst new file mode 100644 index 00000000..9529f83f --- /dev/null +++ b/docs/source/usage/operations/projections/larr.rst @@ -0,0 +1,10 @@ +.. _larr: + +******************************************************************************** +Larrivee +******************************************************************************** + +.. image:: ./images/larr.png + :scale: 50% + :alt: Larrivee + diff --git a/docs/source/usage/operations/projections/lask.rst b/docs/source/usage/operations/projections/lask.rst new file mode 100644 index 00000000..d34dc8a0 --- /dev/null +++ b/docs/source/usage/operations/projections/lask.rst @@ -0,0 +1,10 @@ +.. _lask: + +******************************************************************************** +Laskowski +******************************************************************************** + +.. image:: ./images/lask.png + :scale: 50% + :alt: Laskowski + diff --git a/docs/source/usage/operations/projections/latlon.rst b/docs/source/usage/operations/projections/latlon.rst new file mode 100644 index 00000000..6712fa7b --- /dev/null +++ b/docs/source/usage/operations/projections/latlon.rst @@ -0,0 +1,6 @@ +.. _latlon: + +******************************************************************************** +Lat/long (Geodetic alias) +******************************************************************************** + diff --git a/docs/source/usage/operations/projections/lcc.rst b/docs/source/usage/operations/projections/lcc.rst new file mode 100644 index 00000000..a3075e76 --- /dev/null +++ b/docs/source/usage/operations/projections/lcc.rst @@ -0,0 +1,10 @@ +.. _lcc: + +******************************************************************************** +Lambert Conformal Conic +******************************************************************************** + +.. image:: ./images/lcc.png + :scale: 50% + :alt: Lambert Conformal Conic + diff --git a/docs/source/usage/operations/projections/lcca.rst b/docs/source/usage/operations/projections/lcca.rst new file mode 100644 index 00000000..ca87e67e --- /dev/null +++ b/docs/source/usage/operations/projections/lcca.rst @@ -0,0 +1,10 @@ +.. _lcca: + +******************************************************************************** +Lambert Conformal Conic Alternative +******************************************************************************** + +.. image:: ./images/lcca.png + :scale: 50% + :alt: Lambert Conformal Conic Alternative + diff --git a/docs/source/usage/operations/projections/leac.rst b/docs/source/usage/operations/projections/leac.rst new file mode 100644 index 00000000..2957798e --- /dev/null +++ b/docs/source/usage/operations/projections/leac.rst @@ -0,0 +1,10 @@ +.. _leac: + +******************************************************************************** +Lambert Equal Area Conic +******************************************************************************** + +.. image:: ./images/leac.png + :scale: 50% + :alt: Lambert Equal Area Conic + diff --git a/docs/source/usage/operations/projections/lee_os.rst b/docs/source/usage/operations/projections/lee_os.rst new file mode 100644 index 00000000..711dc754 --- /dev/null +++ b/docs/source/usage/operations/projections/lee_os.rst @@ -0,0 +1,10 @@ +.. _lee_os: + +******************************************************************************** +Lee Oblated Stereographic +******************************************************************************** + +.. image:: ./images/lee_os.png + :scale: 50% + :alt: Lee Oblated Stereographic + diff --git a/docs/source/usage/operations/projections/lonlat.rst b/docs/source/usage/operations/projections/lonlat.rst new file mode 100644 index 00000000..589cc813 --- /dev/null +++ b/docs/source/usage/operations/projections/lonlat.rst @@ -0,0 +1,6 @@ +.. _lonlat: + +******************************************************************************** +Lat/long (Geodetic) +******************************************************************************** + diff --git a/docs/source/usage/operations/projections/loxim.rst b/docs/source/usage/operations/projections/loxim.rst new file mode 100644 index 00000000..e50ba472 --- /dev/null +++ b/docs/source/usage/operations/projections/loxim.rst @@ -0,0 +1,10 @@ +.. _loxim: + +******************************************************************************** +Loximuthal +******************************************************************************** + +.. image:: ./images/loxim.png + :scale: 50% + :alt: Loximuthal + diff --git a/docs/source/usage/operations/projections/lsat.rst b/docs/source/usage/operations/projections/lsat.rst new file mode 100644 index 00000000..fb64bdb2 --- /dev/null +++ b/docs/source/usage/operations/projections/lsat.rst @@ -0,0 +1,10 @@ +.. _lsat: + +******************************************************************************** +Space oblique for LANDSAT +******************************************************************************** + +.. image:: ./images/lsat.png + :scale: 50% + :alt: Space oblique for LANDSAT + diff --git a/docs/source/usage/operations/projections/mbt_fps.rst b/docs/source/usage/operations/projections/mbt_fps.rst new file mode 100644 index 00000000..55ebcf6c --- /dev/null +++ b/docs/source/usage/operations/projections/mbt_fps.rst @@ -0,0 +1,10 @@ +.. _mbt_fps: + +******************************************************************************** +McBryde-Thomas Flat-Pole Sine (No. 2) +******************************************************************************** + +.. image:: ./images/mbt_fps.png + :scale: 50% + :alt: McBryde-Thomas Flat-Pole Sine (No. 2) + diff --git a/docs/source/usage/operations/projections/mbt_s.rst b/docs/source/usage/operations/projections/mbt_s.rst new file mode 100644 index 00000000..9a355ec8 --- /dev/null +++ b/docs/source/usage/operations/projections/mbt_s.rst @@ -0,0 +1,10 @@ +.. _mbt_s: + +******************************************************************************** +McBryde-Thomas Flat-Polar Sine (No. 1) +******************************************************************************** + +.. image:: ./images/mbt_s.png + :scale: 50% + :alt: McBryde-Thomas Flat-Polar Sine (No. 1) + diff --git a/docs/source/usage/operations/projections/mbtfpp.rst b/docs/source/usage/operations/projections/mbtfpp.rst new file mode 100644 index 00000000..9be309d9 --- /dev/null +++ b/docs/source/usage/operations/projections/mbtfpp.rst @@ -0,0 +1,10 @@ +.. _mbtfpp: + +******************************************************************************** +McBride-Thomas Flat-Polar Parabolic +******************************************************************************** + +.. image:: ./images/mbtfpp.png + :scale: 50% + :alt: McBride-Thomas Flat-Polar Parabolic + diff --git a/docs/source/usage/operations/projections/mbtfpq.rst b/docs/source/usage/operations/projections/mbtfpq.rst new file mode 100644 index 00000000..295e814d --- /dev/null +++ b/docs/source/usage/operations/projections/mbtfpq.rst @@ -0,0 +1,10 @@ +.. _mbtfpq: + +******************************************************************************** +McBryde-Thomas Flat-Polar Quartic +******************************************************************************** + +.. image:: ./images/mbtfpq.png + :scale: 50% + :alt: McBryde-Thomas Flat-Polar Quartic + diff --git a/docs/source/usage/operations/projections/mbtfps.rst b/docs/source/usage/operations/projections/mbtfps.rst new file mode 100644 index 00000000..b9365361 --- /dev/null +++ b/docs/source/usage/operations/projections/mbtfps.rst @@ -0,0 +1,10 @@ +.. _mbtfps: + +******************************************************************************** +McBryde-Thomas Flat-Polar Sinusoidal +******************************************************************************** + +.. image:: ./images/mbtfps.png + :scale: 50% + :alt: McBryde-Thomas Flat-Polar Sinusoidal + diff --git a/docs/source/usage/operations/projections/merc.rst b/docs/source/usage/operations/projections/merc.rst new file mode 100644 index 00000000..64ba98a4 --- /dev/null +++ b/docs/source/usage/operations/projections/merc.rst @@ -0,0 +1,140 @@ +.. _merc: + +******************************************************************************** +Mercator +******************************************************************************** + +The Mercator projection is a cylindrical map projection that origins from the 15th +century. It is widely recognized as the first regularly used map projection. +The projection is conformal which makes it suitable for navigational purposes. + + ++---------------------+----------------------------------------------------------+ +| **Classification** | Conformal cylindrical | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global, but best used near the equator | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_ts` | Latitude of true scale. Defaults to 0.0 | ++---------------------+----------------------------------------------------------+ +| `+k_0` | Scaling factor. Defaults to 1.0 | ++---------------------+----------------------------------------------------------+ + + + +.. image:: ./images/merc.png + :scale: 50% + :alt: Mercator + + +Usage +######## + +Applications should be limited to equatorial regions, but is frequently +used for navigational charts with latitude of true scale (``+lat_ts``) specified within +or near chart's boundaries. +Often inappropriately used for world maps since the regions near the poles +cannot be shown [Evenden1995]_. + + +Example using latitude of true scale:: + + $ echo 56.35 12.32 | proj +proj=merc +lat_ts=56.5 + 3470306.37 759599.90 + +Example using scaling factor:: + + echo 56.35 12.32 | proj +proj=merc +k_0=2 + 12545706.61 2746073.80 + + +Note that ``+lat_ts`` and ``+k_0`` are mutually excusive. +If used together, ``+lat_ts`` takes precedence over ``+k_0``. + +Mathematical definition +####################### + +The formulas describing the Mercator projection are all taken from G. Evenden's libproj manuals [Evenden2005]_. + +Spherical form +************** +For the spherical form of the projection we introduce the scaling factor: + +.. math:: + + k_0 = \cos \phi_{ts} + +Forward projection +================== + +.. math:: + + x = k_0 \lambda + +.. math:: + + y = k_0 \ln \left[ \tan \left(\frac{\pi}{4} + \frac{\phi}{2} \right) \right] + + +Inverse projection +================== + +.. math:: + + \lambda = \frac{x}{k_0} + +.. math:: + + \phi = \frac{\pi}{2} - 2 \arctan \left[ e^{-y/k_0} \right] + + +Elliptical form +*************** + +For the elliptical form of the projection we introduce the scaling factor: + +.. math:: + + k_0 = m\left( \phi_ts \right) + +where :math:`m\left(\phi\right)` is the parallel radius at latitude :math:`\phi`. + +We also use the Isometric Latitude kernel function :math:`t()`. + +.. note:: + m() and t() should be described properly on a separate page about the theory of projections on the ellipsoid. + +Forward projection +================== +.. math:: + + x = k_0 \lambda + +.. math:: + + y = k_0 \ln t \left( \phi \right) + + +Inverse projection +================== + +.. math:: + + \lambda = \frac{x}{k_0} + +.. math:: + + \phi = t^{-1}\left[ e^{ -y/k_0 } \right] + +Further reading +############### + +#. `Wikipedia <https://en.wikipedia.org/wiki/Mercator_projection>`_ +#. `Wolfram Mathworld <http://mathworld.wolfram.com/MercatorProjection.html>`_ + + diff --git a/docs/source/usage/operations/projections/mil_os.rst b/docs/source/usage/operations/projections/mil_os.rst new file mode 100644 index 00000000..5547e43c --- /dev/null +++ b/docs/source/usage/operations/projections/mil_os.rst @@ -0,0 +1,10 @@ +.. _mil_os: + +******************************************************************************** +Miller Oblated Stereographic +******************************************************************************** + +.. image:: ./images/mil_os.png + :scale: 50% + :alt: Miller Oblated Stereographic + diff --git a/docs/source/usage/operations/projections/mill.rst b/docs/source/usage/operations/projections/mill.rst new file mode 100644 index 00000000..eb9c2092 --- /dev/null +++ b/docs/source/usage/operations/projections/mill.rst @@ -0,0 +1,72 @@ +.. _mill: + +******************************************************************************** +Miller Cylindrical +******************************************************************************** + +The Miller cylindrical projection is a modified Mercator projection, proposed by Osborn Maitland Miller in 1942. +The latitude is scaled by a factor of :math:`\frac{4}{5}`, projected according to Mercator, and then the result is multiplied by :math:`\frac{5}{4}` to retain scale along the equator. + ++---------------------+--------------------------------------------------------------------------------+ +| **Classification** | Neither conformal nor equal area cylindrical | ++---------------------+--------------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse spherical | ++---------------------+--------------------------------------------------------------------------------+ +| **Defined area** | Global, but best used near the equator | ++---------------------+--------------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+--------------------------------------------------------------------------------+ +| **Options** | ++---------------------+--------------------------------------------------------------------------------+ +| `+lat_0` | Latitude of origin (Default to 0) | ++---------------------+--------------------------------------------------------------------------------+ + +.. image:: ./images/mill.png + :scale: 50% + :alt: Miller Cylindrical + +Usage +######## + +The Miller Cylindrical projection is used for world maps and in several atlases, +including the National Atlas of the United States (USGS, 1970, p. 330-331) [Snyder1987]_. + +Example using Central meridian 90°W:: + + $ echo -100 35 | proj +proj=mill +lon_0=90w + -1113194.91 4061217.24 + +Mathematical definition +####################### + +The formulas describing the Miller projection are all taken from Snyder's manuals [Snyder1987]_. + + +Forward projection +================== + +.. math:: + + x = \lambda + +.. math:: + + y = 1.25 * \ln \left[ \tan \left(\frac{\pi}{4} + 0.4 * \phi \right) \right] + + +Inverse projection +================== + +.. math:: + + \lambda = x + +.. math:: + + \phi = 2.5 * ( \arctan \left[ e^{0.8 * y} \right] - \frac{\pi}{4} ) + +Further reading +############### + +#. `Wikipedia <https://en.wikipedia.org/wiki/Miller_cylindrical_projection>`_ + diff --git a/docs/source/usage/operations/projections/moll.rst b/docs/source/usage/operations/projections/moll.rst new file mode 100644 index 00000000..1bd3d005 --- /dev/null +++ b/docs/source/usage/operations/projections/moll.rst @@ -0,0 +1,10 @@ +.. _moll: + +******************************************************************************** +Mollweide +******************************************************************************** + +.. image:: ./images/moll.png + :scale: 50% + :alt: Mollweide + diff --git a/docs/source/usage/operations/projections/murd1.rst b/docs/source/usage/operations/projections/murd1.rst new file mode 100644 index 00000000..71cbf155 --- /dev/null +++ b/docs/source/usage/operations/projections/murd1.rst @@ -0,0 +1,10 @@ +.. _murd1: + +******************************************************************************** +Murdoch I +******************************************************************************** + +.. image:: ./images/murd1.png + :scale: 50% + :alt: Murdoch I + diff --git a/docs/source/usage/operations/projections/murd2.rst b/docs/source/usage/operations/projections/murd2.rst new file mode 100644 index 00000000..b55cde35 --- /dev/null +++ b/docs/source/usage/operations/projections/murd2.rst @@ -0,0 +1,10 @@ +.. _murd2: + +******************************************************************************** +Murdoch II +******************************************************************************** + +.. image:: ./images/murd2.png + :scale: 50% + :alt: Murdoch II + diff --git a/docs/source/usage/operations/projections/murd3.rst b/docs/source/usage/operations/projections/murd3.rst new file mode 100644 index 00000000..70cc9276 --- /dev/null +++ b/docs/source/usage/operations/projections/murd3.rst @@ -0,0 +1,10 @@ +.. _murd3: + +******************************************************************************** +Murdoch III +******************************************************************************** + +.. image:: ./images/murd3.png + :scale: 50% + :alt: Murdoch III + diff --git a/docs/source/usage/operations/projections/natearth.rst b/docs/source/usage/operations/projections/natearth.rst new file mode 100644 index 00000000..57dd96db --- /dev/null +++ b/docs/source/usage/operations/projections/natearth.rst @@ -0,0 +1,47 @@ +.. _natearth: + +******************************************************************************** +Natural Earth +******************************************************************************** ++---------------------+--------------------------------------------------------+ +| **Classification** | Pseudo cylindrical | ++---------------------+--------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical projection | ++---------------------+--------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+--------------------------------------------------------+ +| **Implemented by** | Bernhard Jenny | ++---------------------+--------------------------------------------------------+ +| **Options** | ++---------------------+--------------------------------------------------------+ +| `No special options for this projection` | ++---------------------+--------------------------------------------------------+ + +.. image:: ./images/natearth.png + :scale: 50% + :alt: Natural Earth + + +The Natural Earth projection is intended for making world maps. A distinguishing trait +is its slightly rounded corners fashioned to emulate the spherical shape of Earth. +The meridians (except for the central meridian) bend acutely inward as they approach +the pole lines, giving the projection a hint of three-dimensionality. This bending +also suggests that the meridians converge at the poles instead of truncating at the +top and bottom edges. The distortion characteristics of the Natural Earth projection +compare favorably to other world map projections. + + +Usage +############################################################################### + +The Natural Earth projection has no special options so usage is simple. Here is +an example of an inverse projection on a sphere with a radius of 7500 m:: + + $ echo 3500 -8000 | proj -I +proj=natearth +a=7500 + 37d54'6.091"E 61d23'4.582"S + + +Further reading +################################################################################ + +#. `Wikipedia <https://en.wikipedia.org/wiki/Natural_Earth_projection>`_ diff --git a/docs/source/usage/operations/projections/nell.rst b/docs/source/usage/operations/projections/nell.rst new file mode 100644 index 00000000..c6a3771c --- /dev/null +++ b/docs/source/usage/operations/projections/nell.rst @@ -0,0 +1,10 @@ +.. _nell: + +******************************************************************************** +Nell +******************************************************************************** + +.. image:: ./images/nell.png + :scale: 50% + :alt: Nell + diff --git a/docs/source/usage/operations/projections/nell_h.rst b/docs/source/usage/operations/projections/nell_h.rst new file mode 100644 index 00000000..6a3b26ba --- /dev/null +++ b/docs/source/usage/operations/projections/nell_h.rst @@ -0,0 +1,10 @@ +.. _nell_h: + +******************************************************************************** +Nell-Hammer +******************************************************************************** + +.. image:: ./images/nell_h.png + :scale: 50% + :alt: Nell-Hammer + diff --git a/docs/source/usage/operations/projections/nicol.rst b/docs/source/usage/operations/projections/nicol.rst new file mode 100644 index 00000000..995cedb5 --- /dev/null +++ b/docs/source/usage/operations/projections/nicol.rst @@ -0,0 +1,10 @@ +.. _nicol: + +******************************************************************************** +Nicolosi Globular +******************************************************************************** + +.. image:: ./images/nicol.png + :scale: 50% + :alt: Nicolosi Globular + diff --git a/docs/source/usage/operations/projections/nsper.rst b/docs/source/usage/operations/projections/nsper.rst new file mode 100644 index 00000000..4a8651fc --- /dev/null +++ b/docs/source/usage/operations/projections/nsper.rst @@ -0,0 +1,10 @@ +.. _nsper: + +******************************************************************************** +Near-sided perspective +******************************************************************************** + +.. image:: ./images/nsper.png + :scale: 50% + :alt: Near-sided perspective + diff --git a/docs/source/usage/operations/projections/nzmg.rst b/docs/source/usage/operations/projections/nzmg.rst new file mode 100644 index 00000000..926655d8 --- /dev/null +++ b/docs/source/usage/operations/projections/nzmg.rst @@ -0,0 +1,10 @@ +.. _nzmg: + +******************************************************************************** +New Zealand Map Grid +******************************************************************************** + +.. image:: ./images/nzmg.png + :scale: 50% + :alt: New Zealand Map Grid + diff --git a/docs/source/usage/operations/projections/ob_tran.rst b/docs/source/usage/operations/projections/ob_tran.rst new file mode 100644 index 00000000..3c996336 --- /dev/null +++ b/docs/source/usage/operations/projections/ob_tran.rst @@ -0,0 +1,10 @@ +.. _ob_tran: + +******************************************************************************** +General Oblique Transformation +******************************************************************************** + +.. image:: ./images/ob_tran.png + :scale: 50% + :alt: General Oblique Transformation + diff --git a/docs/source/usage/operations/projections/ocea.rst b/docs/source/usage/operations/projections/ocea.rst new file mode 100644 index 00000000..40005d9e --- /dev/null +++ b/docs/source/usage/operations/projections/ocea.rst @@ -0,0 +1,10 @@ +.. _ocea: + +******************************************************************************** +Oblique Cylindrical Equal Area +******************************************************************************** + +.. image:: ./images/ocea.png + :scale: 50% + :alt: Oblique Cylindrical Equal Area + diff --git a/docs/source/usage/operations/projections/oea.rst b/docs/source/usage/operations/projections/oea.rst new file mode 100644 index 00000000..379dc157 --- /dev/null +++ b/docs/source/usage/operations/projections/oea.rst @@ -0,0 +1,10 @@ +.. _oea: + +******************************************************************************** +Oblated Equal Area +******************************************************************************** + +.. image:: ./images/oea.png + :scale: 50% + :alt: Oblated Equal Area + diff --git a/docs/source/usage/operations/projections/omerc.rst b/docs/source/usage/operations/projections/omerc.rst new file mode 100644 index 00000000..114b9fa3 --- /dev/null +++ b/docs/source/usage/operations/projections/omerc.rst @@ -0,0 +1,10 @@ +.. _omerc: + +******************************************************************************** +Oblique Mercator +******************************************************************************** + +.. image:: ./images/omerc.png + :scale: 50% + :alt: Oblique Mercator + diff --git a/docs/source/usage/operations/projections/ortel.rst b/docs/source/usage/operations/projections/ortel.rst new file mode 100644 index 00000000..03f132ef --- /dev/null +++ b/docs/source/usage/operations/projections/ortel.rst @@ -0,0 +1,10 @@ +.. _ortel: + +******************************************************************************** +Ortelius Oval +******************************************************************************** + +.. image:: ./images/ortel.png + :scale: 50% + :alt: Ortelius Oval + diff --git a/docs/source/usage/operations/projections/ortho.rst b/docs/source/usage/operations/projections/ortho.rst new file mode 100644 index 00000000..131dbfc7 --- /dev/null +++ b/docs/source/usage/operations/projections/ortho.rst @@ -0,0 +1,10 @@ +.. _ortho: + +******************************************************************************** +Orthographic +******************************************************************************** + +.. image:: ./images/ortho.png + :scale: 50% + :alt: Orthographic + diff --git a/docs/source/usage/operations/projections/pconic.rst b/docs/source/usage/operations/projections/pconic.rst new file mode 100644 index 00000000..6bc0018e --- /dev/null +++ b/docs/source/usage/operations/projections/pconic.rst @@ -0,0 +1,10 @@ +.. _pconic: + +******************************************************************************** +Perspective Conic +******************************************************************************** + +.. image:: ./images/pconic.png + :scale: 50% + :alt: Perspective Conic + diff --git a/docs/source/usage/operations/projections/poly.rst b/docs/source/usage/operations/projections/poly.rst new file mode 100644 index 00000000..e252feb5 --- /dev/null +++ b/docs/source/usage/operations/projections/poly.rst @@ -0,0 +1,10 @@ +.. _poly: + +******************************************************************************** +Polyconic (American) +******************************************************************************** + +.. image:: ./images/poly.png + :scale: 50% + :alt: Polyconic (American) + diff --git a/docs/source/usage/operations/projections/putp1.rst b/docs/source/usage/operations/projections/putp1.rst new file mode 100644 index 00000000..68971a46 --- /dev/null +++ b/docs/source/usage/operations/projections/putp1.rst @@ -0,0 +1,10 @@ +.. _putp1: + +******************************************************************************** +Putnins P1 +******************************************************************************** + +.. image:: ./images/putp1.png + :scale: 50% + :alt: Putnins P1 + diff --git a/docs/source/usage/operations/projections/putp2.rst b/docs/source/usage/operations/projections/putp2.rst new file mode 100644 index 00000000..01ea8073 --- /dev/null +++ b/docs/source/usage/operations/projections/putp2.rst @@ -0,0 +1,10 @@ +.. _putp2: + +******************************************************************************** +Putnins P2 +******************************************************************************** + +.. image:: ./images/putp2.png + :scale: 50% + :alt: Putnins P2 + diff --git a/docs/source/usage/operations/projections/putp3.rst b/docs/source/usage/operations/projections/putp3.rst new file mode 100644 index 00000000..3aa6b9e6 --- /dev/null +++ b/docs/source/usage/operations/projections/putp3.rst @@ -0,0 +1,10 @@ +.. _putp3: + +******************************************************************************** +Putnins P3 +******************************************************************************** + +.. image:: ./images/putp3.png + :scale: 50% + :alt: Putnins P3 + diff --git a/docs/source/usage/operations/projections/putp3p.rst b/docs/source/usage/operations/projections/putp3p.rst new file mode 100644 index 00000000..5b87512e --- /dev/null +++ b/docs/source/usage/operations/projections/putp3p.rst @@ -0,0 +1,10 @@ +.. _putp3p: + +******************************************************************************** +Putnins P3' +******************************************************************************** + +.. image:: ./images/putp3p.png + :scale: 50% + :alt: Putnins P3' + diff --git a/docs/source/usage/operations/projections/putp4p.rst b/docs/source/usage/operations/projections/putp4p.rst new file mode 100644 index 00000000..b211ad9b --- /dev/null +++ b/docs/source/usage/operations/projections/putp4p.rst @@ -0,0 +1,10 @@ +.. _putp4p: + +******************************************************************************** +Putnins P4' +******************************************************************************** + +.. image:: ./images/putp4p.png + :scale: 50% + :alt: Putnins P4' + diff --git a/docs/source/usage/operations/projections/putp5.rst b/docs/source/usage/operations/projections/putp5.rst new file mode 100644 index 00000000..5b60a961 --- /dev/null +++ b/docs/source/usage/operations/projections/putp5.rst @@ -0,0 +1,10 @@ +.. _putp5: + +******************************************************************************** +Putnins P5 +******************************************************************************** + +.. image:: ./images/putp5.png + :scale: 50% + :alt: Putnins P5 + diff --git a/docs/source/usage/operations/projections/putp5p.rst b/docs/source/usage/operations/projections/putp5p.rst new file mode 100644 index 00000000..f586b889 --- /dev/null +++ b/docs/source/usage/operations/projections/putp5p.rst @@ -0,0 +1,10 @@ +.. _putp5p: + +******************************************************************************** +Putnins P5' +******************************************************************************** + +.. image:: ./images/putp5p.png + :scale: 50% + :alt: Putnins P5' + diff --git a/docs/source/usage/operations/projections/putp6.rst b/docs/source/usage/operations/projections/putp6.rst new file mode 100644 index 00000000..94683ace --- /dev/null +++ b/docs/source/usage/operations/projections/putp6.rst @@ -0,0 +1,10 @@ +.. _putp6: + +******************************************************************************** +Putnins P6 +******************************************************************************** + +.. image:: ./images/putp6.png + :scale: 50% + :alt: Putnins P6 + diff --git a/docs/source/usage/operations/projections/putp6p.rst b/docs/source/usage/operations/projections/putp6p.rst new file mode 100644 index 00000000..8c3add71 --- /dev/null +++ b/docs/source/usage/operations/projections/putp6p.rst @@ -0,0 +1,10 @@ +.. _putp6p: + +******************************************************************************** +Putnins P6' +******************************************************************************** + +.. image:: ./images/putp6p.png + :scale: 50% + :alt: Putnins P6' + diff --git a/docs/source/usage/operations/projections/qsc.rst b/docs/source/usage/operations/projections/qsc.rst new file mode 100644 index 00000000..e3af2cee --- /dev/null +++ b/docs/source/usage/operations/projections/qsc.rst @@ -0,0 +1,158 @@ +.. _qsc: + +******************************************************************************** +Quadrilateralized Spherical Cube +******************************************************************************** + ++---------------------+----------------------------------------------------------+ +| **Classification** | Azimuthal | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Martin Lambers | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_0` | Latitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ +| `+lon_0` | Longitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ + +The purpose of the Quadrilateralized Spherical Cube (QSC) projection is to project +a sphere surface onto the six sides of a cube: + +.. image:: ../../../../images/qsc_concept.jpg + :scale: 50% + :align: center + :alt: Quadrilateralized Spherical Cube + +For this purpose, other alternatives can be used, notably :ref:`gnom` or +:ref:`healpix`. However, QSC projection has the following favorable properties: + +It is an equal-area projection, and at the same time introduces only limited angular +distortions. It treats all cube sides equally, i.e. it does not use different +projections for polar areas and equatorial areas. These properties make QSC +projection a good choice for planetary-scale terrain rendering. Map data can be +organized in quadtree structures for each cube side. See [LambersKolb2012]_ for an example. + +The QSC projection was introduced by [ONeilLaubscher1976]_, +building on previous work by [ChanONeil1975]_. For clarity: The +earlier QSC variant described in [ChanONeil1975]_ became known as the COBE QSC since it +was used by the NASA Cosmic Background Explorer (COBE) project; it is an approximately +equal-area projection and is not the same as the QSC projection. + +See also [CalabrettaGreisen2002]_ Sec. 5.6.2 and 5.6.3 for a description of both and +some analysis. + +In this implementation, the QSC projection projects onto one side of a circumscribed +cube. The cube side is selected by choosing one of the following six projection centers: + ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=0`` | front cube side | ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=90`` | right cube side | ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=180`` | back cube side | ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=-90`` | left cube side | ++-------------------------+--------------------+ +| ``+lat_0=90`` | top cube side | ++-------------------------+--------------------+ +| ``+lat_0=-90`` | bottom cube side | ++-------------------------+--------------------+ + +Furthermore, this implementation allows the projection to be applied to ellipsoids. +A preceding shift to a sphere is performed automatically; see [LambersKolb2012]_ for details. + + +Usage +############################################################################### + +The following example uses QSC projection via GDAL to create the six cube side +maps from a world map for the WGS84 ellipsoid:: + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=0" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff frontside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=90" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff rightside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=180" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff backside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=-90" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff leftside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=90 +lon_0=0" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff topside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=-90 +lon_0=0" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff bottomside.tiff + + +Explanation: + +* QSC projection is selected with ``+wktext +proj=qsc``. +* The WGS84 ellipsoid is specified with ``+ellps=WGS84``. +* The cube side is selected with ``+lat_0=... +lon_0=...``. +* The ``-wo`` options are necessary for GDAL to avoid holes in the output maps. +* The ``-te`` option limits the extends of the output map to the major axis diameter + (from -radius to +radius in both x and y direction). These are the dimensions of one side + of the circumscribing cube. + + +The resulting images can be laid out in a grid like below. + + +.. |topside| image:: ../../../../images/qsc_topside.jpg + :scale: 50% + :align: middle + :alt: Top side + +.. |leftside| image:: ../../../../images/qsc_leftside.jpg + :scale: 50% + :align: middle + :alt: Left side + +.. |frontside| image:: ../../../../images/qsc_frontside.jpg + :scale: 50% + :align: middle + :alt: Front side + +.. |rightside| image:: ../../../../images/qsc_rightside.jpg + :scale: 50% + :align: middle + :alt: Right side + +.. |backside| image:: ../../../../images/qsc_backside.jpg + :scale: 50% + :align: middle + :alt: Back side + +.. |bottomside| image:: ../../../../images/qsc_bottomside.jpg + :scale: 50% + :align: middle + :alt: Bottom side + + ++------------+--------------+-------------+------------+ +| | |topside| | | | ++------------+--------------+-------------+------------+ +| |leftside| | |frontside| | |rightside| | |backside| | ++------------+--------------+-------------+------------+ +| | |bottomside| | | | ++------------+--------------+-------------+------------+ + +Further reading +################################################################################ + +#. `Wikipedia <https://en.wikipedia.org/wiki/Quadrilateralized_spherical_cube>`_ +#. `NASA <https://lambda.gsfc.nasa.gov/product/cobe/skymap_info_new.cfm>`_ diff --git a/docs/source/usage/operations/projections/qua_aut.rst b/docs/source/usage/operations/projections/qua_aut.rst new file mode 100644 index 00000000..d3a0aece --- /dev/null +++ b/docs/source/usage/operations/projections/qua_aut.rst @@ -0,0 +1,10 @@ +.. _qua_aut: + +******************************************************************************** +Quartic Authalic +******************************************************************************** + +.. image:: ./images/qua_aut.png + :scale: 50% + :alt: Quartic Authalic + diff --git a/docs/source/usage/operations/projections/rhealpix.rst b/docs/source/usage/operations/projections/rhealpix.rst new file mode 100644 index 00000000..5808cfaa --- /dev/null +++ b/docs/source/usage/operations/projections/rhealpix.rst @@ -0,0 +1,51 @@ +.. _rhealpix: + +******************************************************************************** +rHEALPix +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Mixed | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Alex Raichev and Michael Speth | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+north_square` | Position of the north polar square. | +| | Valid inputs are 0--3. Defaults to 0. | ++---------------------+----------------------------------------------------------+ +| `+south_square` | Position of the south polar square. | +| | Valid inputs are 0--3. Defaults to 0. | ++---------------------+----------------------------------------------------------+ + +.. image:: ../../../../images/rhealpix.png + :scale: 75% + :alt: rHEALPix + +rHEALPix is a projection based on the HEALPix projection. The implementation of +rHEALPix uses the HEALPix projection. The rHEALPix combines the peaks of the +HEALPix into a square. The square's position can be translated and rotated across +the x-axis which is a noval approach for the rHEALPix projection. The initial +intention of using rHEALPix in the Spatial Computation Engine Science Collaboration +Environment (SCENZGrid). + +Usage +############################################################################### + +To run a rHEALPix projection on a WGS84 ellipsoidal model, use the following +command:: + + proj +proj=rhealpix -f '%.2f' +ellps=WGS84 +south_square=0 +north_square=2 -E << EOF + > 55 12 + > EOF + 55 12 6115727.86 1553840.13 + + +Further reading +################################################################################ + +#. `NASA <http://healpix.jpl.nasa.gov/>`_ +#. `Wikipedia <https://en.wikipedia.org/wiki/HEALPix>`_ diff --git a/docs/source/usage/operations/projections/robin.rst b/docs/source/usage/operations/projections/robin.rst new file mode 100644 index 00000000..3e58be46 --- /dev/null +++ b/docs/source/usage/operations/projections/robin.rst @@ -0,0 +1,10 @@ +.. _robin: + +******************************************************************************** +Robinson +******************************************************************************** + +.. image:: ./images/robin.png + :scale: 50% + :alt: Robinson + diff --git a/docs/source/usage/operations/projections/rouss.rst b/docs/source/usage/operations/projections/rouss.rst new file mode 100644 index 00000000..e27fb1cf --- /dev/null +++ b/docs/source/usage/operations/projections/rouss.rst @@ -0,0 +1,10 @@ +.. _rouss: + +******************************************************************************** +Roussilhe Stereographic +******************************************************************************** + +.. image:: ./images/rouss.png + :scale: 50% + :alt: Roussilhe Stereographic + diff --git a/docs/source/usage/operations/projections/rpoly.rst b/docs/source/usage/operations/projections/rpoly.rst new file mode 100644 index 00000000..80e0d640 --- /dev/null +++ b/docs/source/usage/operations/projections/rpoly.rst @@ -0,0 +1,10 @@ +.. _rpoly: + +******************************************************************************** +Rectangular Polyconic +******************************************************************************** + +.. image:: ./images/rpoly.png + :scale: 50% + :alt: Rectangular Polyconic + diff --git a/docs/source/usage/operations/projections/sinu.rst b/docs/source/usage/operations/projections/sinu.rst new file mode 100644 index 00000000..a7ebd232 --- /dev/null +++ b/docs/source/usage/operations/projections/sinu.rst @@ -0,0 +1,24 @@ +.. _sinu: + +******************************************************************************** +Sinusoidal (Sanson-Flamsteed) +******************************************************************************** + +.. image:: ./images/sinu.png + :scale: 50% + :alt: Sinusoidal (Sanson-Flamsteed) + +MacBryde and Thomas developed generalized formulas for sever of the +pseudocylindricals with sinusoidal meridians: + +.. math:: + + x = C\lambda(m+cos\theta) / ( m + 1) + +.. math:: + y = C\theta + +.. math:: + + C = \sqrt { (m + 1 ) / n } + diff --git a/docs/source/usage/operations/projections/somerc.rst b/docs/source/usage/operations/projections/somerc.rst new file mode 100644 index 00000000..c572622b --- /dev/null +++ b/docs/source/usage/operations/projections/somerc.rst @@ -0,0 +1,10 @@ +.. _somerc: + +******************************************************************************** +Swiss. Obl. Mercator +******************************************************************************** + +.. image:: ./images/somerc.png + :scale: 50% + :alt: Swiss. Obl. Mercator + diff --git a/docs/source/usage/operations/projections/stere.rst b/docs/source/usage/operations/projections/stere.rst new file mode 100644 index 00000000..d4958ec9 --- /dev/null +++ b/docs/source/usage/operations/projections/stere.rst @@ -0,0 +1,10 @@ +.. _stere: + +******************************************************************************** +Stereographic +******************************************************************************** + +.. image:: ./images/stere.png + :scale: 50% + :alt: Stereographic + diff --git a/docs/source/usage/operations/projections/sterea.rst b/docs/source/usage/operations/projections/sterea.rst new file mode 100644 index 00000000..4f2f8727 --- /dev/null +++ b/docs/source/usage/operations/projections/sterea.rst @@ -0,0 +1,10 @@ +.. _sterea: + +******************************************************************************** +Oblique Stereographic Alternative +******************************************************************************** + +.. image:: ./images/sterea.png + :scale: 50% + :alt: Oblique Stereographic Alternative + diff --git a/docs/source/usage/operations/projections/tcc.rst b/docs/source/usage/operations/projections/tcc.rst new file mode 100644 index 00000000..586dd3b8 --- /dev/null +++ b/docs/source/usage/operations/projections/tcc.rst @@ -0,0 +1,10 @@ +.. _tcc: + +******************************************************************************** +Transverse Central Cylindrical +******************************************************************************** + +.. image:: ./images/tcc.png + :scale: 50% + :alt: Transverse Central Cylindrical + diff --git a/docs/source/usage/operations/projections/tcea.rst b/docs/source/usage/operations/projections/tcea.rst new file mode 100644 index 00000000..cf5549a3 --- /dev/null +++ b/docs/source/usage/operations/projections/tcea.rst @@ -0,0 +1,10 @@ +.. _tcea: + +******************************************************************************** +Transverse Cylindrical Equal Area +******************************************************************************** + +.. image:: ./images/tcea.png + :scale: 50% + :alt: Transverse Cylindrical Equal Area + diff --git a/docs/source/usage/operations/projections/tissot.rst b/docs/source/usage/operations/projections/tissot.rst new file mode 100644 index 00000000..7ec1a741 --- /dev/null +++ b/docs/source/usage/operations/projections/tissot.rst @@ -0,0 +1,10 @@ +.. _tissot: + +******************************************************************************** +Tissot +******************************************************************************** + +.. image:: ./images/tissot.png + :scale: 50% + :alt: Tissot + diff --git a/docs/source/usage/operations/projections/tmerc.rst b/docs/source/usage/operations/projections/tmerc.rst new file mode 100644 index 00000000..03aa2830 --- /dev/null +++ b/docs/source/usage/operations/projections/tmerc.rst @@ -0,0 +1,197 @@ +.. _tmerc: + +******************************************************************************** +Transverse Mercator +******************************************************************************** + +The transverse Mercator projection in its various forms is the most widely used projected coordinate system for world topographical and offshore mapping. + ++---------------------+--------------------------------------------------------------------------------+ +| **Classification** | Transverse and oblique cylindrical | ++---------------------+--------------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse, Spherical and Elliptical | ++---------------------+--------------------------------------------------------------------------------+ +| **Defined area** | Global, but reasonably accurate only within 15 degrees of the central meridian | ++---------------------+--------------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+--------------------------------------------------------------------------------+ +| **Options** | ++---------------------+--------------------------------------------------------------------------------+ +| `+lat_0` | Latitude of origin (Default to 0) | ++---------------------+--------------------------------------------------------------------------------+ +| `+k0` | Scale factor at natural origin (Default to 1) | ++---------------------+--------------------------------------------------------------------------------+ + + +.. image:: ./images/tmerc.png + :scale: 50% + :alt: Transverse Mercator + +Usage +##### + + +Prior to the development of the Universal Transverse Mercator coordinate system, several European nations demonstrated the utility of grid-based conformal maps by mapping their territory during the interwar period. +Calculating the distance between two points on these maps could be performed more easily in the field (using the Pythagorean theorem) than was possible using the trigonometric formulas required under the graticule-based system of latitude and longitude. +In the post-war years, these concepts were extended into the Universal Transverse Mercator/Universal Polar Stereographic (UTM/UPS) coordinate system, which is a global (or universal) system of grid-based maps. + +The following table gives special cases of the Transverse Mercator projection. + ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Projection Name | Areas | Central meridian | Zone width | Scale Factor | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Transverse Mercator | World wide | Various | less than 6° | Various | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Transverse Mercator south oriented | Southern Africa | 2° intervals E of 11°E | 2° | 1.000 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| UTM North hemisphere | World wide equator to 84°N | 6° intervals E & W of 3° E & W | Always 6° | 0.9996 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| UTM South hemisphere | World wide north of 80°S to equator | 6° intervals E & W of 3° E & W | Always 6° | 0.9996 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Gauss-Kruger | Former USSR, Yugoslavia, Germany, S. America, China | Various, according to area | Usually less than 6°, often less than 4° | 1.0000 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Gauss Boaga | Italy | Various, according to area | 6° | 0.9996 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ + + + +Example using Gauss-Kruger on Germany area (aka EPSG:31467) :: + + $ echo 9 51 | proj +proj=tmerc +lat_0=0 +lon_0=9 +k=1 +x_0=3500000 +y_0=0 +ellps=bessel +datum=potsdam +units=m +no_defs + 3500000.00 5651505.56 + +Example using Gauss Boaga on Italy area (EPSG:3004) :: + + $ echo 15 42 | proj +proj=tmerc +lat_0=0 +lon_0=15 +k=0.9996 +x_0=2520000 +y_0=0 +ellps=intl +units=m +no_defs + 2520000.00 4649858.60 + +Mathematical definition +####################### + +The formulas describing the Transverse Mercator are all taken from Evenden's [Evenden2005]_. + +:math:`\phi_0` is the latitude of origin that match the center of the map. It can be set with ``+lat_0``. + +:math:`k_0` is the scale factor at the natural origin (on the central meridian). It can be set with ``+k_0``. + +:math:`M(\phi)` is the meridianal distance. + +Spherical form +************** + +Forward projection +================== + +.. math:: + + B = \cos \phi \sin \lambda + +.. math:: + + x = \frac{k_0}{2} \ln(\frac{1+B}{1-B}) + +.. math:: + + y = k_0 ( \arctan(\frac{\tan(\phi)}{\cos \lambda}) - \phi_0) + + +Inverse projection +================== + +.. math:: + + D = \frac{y}{k_0} + \phi_0 + +.. math:: + + x' = \frac{x}{k_0} + +.. math:: + + \phi = \arcsin(\frac{\sin D}{\cosh x'}) + +.. math:: + + \lambda = \arctan(\frac{\sinh x'}{\cos D}) + + +Elliptical form +*************** + +Forward projection +================== + +.. math:: + + N = \frac{k_0}{(1 - e^2 \sin^2\phi)^{1/2}} + +.. math:: + + R = \frac{k_0(1-e^2)}{(1-e^2 \sin^2\phi)^{3/2}} + +.. math:: + + t = \tan(\phi) + +.. math:: + + \eta = \frac{e^2}{1-e^2}cos^2\phi + +.. math:: + + x &= k_0 \lambda \cos \phi \\ + &+ \frac{k_0 \lambda^3 \cos^3\phi}{3!}(1-t^2+\eta^2) \\ + &+ \frac{k_0 \lambda^5 \cos^5\phi}{5!}(5-18t^2+t^4+14\eta^2-58t^2\eta^2) \\ + &+\frac{k_0 \lambda^7 \cos^7\phi}{7!}(61-479t^2+179t^4-t^6) + +.. math:: + + y &= M(\phi) \\ + &+ \frac{k_0 \lambda^2 \sin(\phi) \cos \phi}{2!} \\ + &+ \frac{k_0 \lambda^4 \sin(\phi) \cos^3\phi}{4!}(5-t^2+9\eta^2+4\eta^4) \\ + &+ \frac{k_0 \lambda^6 \sin(\phi) \cos^5\phi}{6!}(61-58t^2+t^4+270\eta^2-330t^2\eta^2) \\ + &+ \frac{k_0 \lambda^8 \sin(\phi) \cos^7\phi}{8!}(1385-3111t^2+543t^4-t^6) + +Inverse projection +================== + +.. math:: + + \phi_1 = M^-1(y) + +.. math:: + + N_1 = \frac{k_0}{1 - e^2 \sin^2\phi_1)^{1/2}} + +.. math:: + + R_1 = \frac{k_0(1-e^2)}{(1-e^2 \sin^2\phi_1)^{3/2}} + +.. math:: + + t_1 = \tan(\phi_1) + +.. math:: + + \eta_1 = \frac{e^2}{1-e^2}cos^2\phi_1 + +.. math:: + + \phi &= \phi_1 \\ + &- \frac{t_1 x^2}{2! R_1 N_1} \\ + &+ \frac{t_1 x^4}{4! R_1 N_1^3}(5+3t_1^2+\eta_1^2-4\eta_1^4-9\eta_1^2t_1^2) \\ + &- \frac{t_1 x^6}{6! R_1 N_1^5}(61+90t_1^2+46\eta_1^2+45t_1^4-252t_1^2\eta_1^2) \\ + &+ \frac{t_1 x^8}{8! R_1 N_1^7}(1385+3633t_1^2+4095t_1^4+1575t_1^6) + +.. math:: + + \lambda &= \frac{x}{\cos \phi N_1} \\ + &- \frac{x^3}{3! \cos \phi N_1^3}(1+2t_1^2+\eta_1^2) \\ + &+ \frac{x^5}{5! \cos \phi N_1^5}(5+6\eta_1^2+28t_1^2-3\eta_1^2+8t_1^2\eta_1^2) \\ + &- \frac{x^7}{7! \cos \phi N_1^7}(61+662t_1^2+1320t_1^4+720t_1^6) + +Further reading +############### + +#. `Wikipedia <https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system>`_ +#. `EPSG, POSC literature pertaining to Coordinate Conversions and Transformations including Formulas <http://www.ihsenergy.com/epsg/guid7.pdf>`_ diff --git a/docs/source/usage/operations/projections/tpeqd.rst b/docs/source/usage/operations/projections/tpeqd.rst new file mode 100644 index 00000000..e6d7ef29 --- /dev/null +++ b/docs/source/usage/operations/projections/tpeqd.rst @@ -0,0 +1,10 @@ +.. _tpeqd: + +******************************************************************************** +Two Point Equidistant +******************************************************************************** + +.. image:: ./images/tpeqd.png + :scale: 50% + :alt: Two Point Equidistant + diff --git a/docs/source/usage/operations/projections/tpers.rst b/docs/source/usage/operations/projections/tpers.rst new file mode 100644 index 00000000..345a5faa --- /dev/null +++ b/docs/source/usage/operations/projections/tpers.rst @@ -0,0 +1,39 @@ +.. _tpers: + +******************************************************************************** +Tilted perspective +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Azimuthal | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+h` | Height (in meters) above the surface. Required. | ++---------------------+----------------------------------------------------------+ +| `+azi` | Bearing (in degrees) from due north. | ++---------------------+----------------------------------------------------------+ +| `+tilt` | Angle (in degrees) away from nadir. | ++---------------------+----------------------------------------------------------+ +| `+lat_0` | Latitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ +| `+lon_0` | Longitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/tpers.png + :scale: 50% + :alt: Tilted perspective + + +Tilted Perspective is similar to :ref:`nsper` (``nsper``) in that it simulates a +perspective view from a hight. Where ``nsper`` projects onto a plane tangent to +the surface, Tilted Perspective orients the plane towards the direction of the +view. Thus, extra parameters azi and tilt are required beyond `nsper``'s ``h``. +As with ``nsper``, ``lat_0`` & ``lon_0`` are also required +for satellite position. diff --git a/docs/source/usage/operations/projections/ups.rst b/docs/source/usage/operations/projections/ups.rst new file mode 100644 index 00000000..7a9ab50b --- /dev/null +++ b/docs/source/usage/operations/projections/ups.rst @@ -0,0 +1,10 @@ +.. _ups: + +******************************************************************************** +Universal Polar Stereographic +******************************************************************************** + +.. image:: ./images/ups.png + :scale: 50% + :alt: Universal Polar Stereographic + diff --git a/docs/source/usage/operations/projections/urm5.rst b/docs/source/usage/operations/projections/urm5.rst new file mode 100644 index 00000000..91d06308 --- /dev/null +++ b/docs/source/usage/operations/projections/urm5.rst @@ -0,0 +1,10 @@ +.. _urm5: + +******************************************************************************** +Urmaev V +******************************************************************************** + +.. image:: ./images/urm5.png + :scale: 50% + :alt: Urmaev V + diff --git a/docs/source/usage/operations/projections/urmfps.rst b/docs/source/usage/operations/projections/urmfps.rst new file mode 100644 index 00000000..515ced84 --- /dev/null +++ b/docs/source/usage/operations/projections/urmfps.rst @@ -0,0 +1,10 @@ +.. _urmfps: + +******************************************************************************** +Urmaev Flat-Polar Sinusoidal +******************************************************************************** + +.. image:: ./images/urmfps.png + :scale: 50% + :alt: Urmaev Flat-Polar Sinusoidal + diff --git a/docs/source/usage/operations/projections/utm.rst b/docs/source/usage/operations/projections/utm.rst new file mode 100644 index 00000000..7fb66cb8 --- /dev/null +++ b/docs/source/usage/operations/projections/utm.rst @@ -0,0 +1,10 @@ +.. _utm: + +******************************************************************************** +Universal Transverse Mercator (UTM) +******************************************************************************** + +.. image:: ./images/utm.png + :scale: 50% + :alt: Universal Transverse Mercator (UTM) + diff --git a/docs/source/usage/operations/projections/vandg.rst b/docs/source/usage/operations/projections/vandg.rst new file mode 100644 index 00000000..cdc772bb --- /dev/null +++ b/docs/source/usage/operations/projections/vandg.rst @@ -0,0 +1,10 @@ +.. _vandg: + +******************************************************************************** +van der Grinten (I) +******************************************************************************** + +.. image:: ./images/vandg.png + :scale: 50% + :alt: van der Grinten (I) + diff --git a/docs/source/usage/operations/projections/vandg2.rst b/docs/source/usage/operations/projections/vandg2.rst new file mode 100644 index 00000000..556929e2 --- /dev/null +++ b/docs/source/usage/operations/projections/vandg2.rst @@ -0,0 +1,10 @@ +.. _vandg2: + +******************************************************************************** +van der Grinten II +******************************************************************************** + +.. image:: ./images/vandg2.png + :scale: 50% + :alt: van der Grinten II + diff --git a/docs/source/usage/operations/projections/vandg3.rst b/docs/source/usage/operations/projections/vandg3.rst new file mode 100644 index 00000000..d767c4d5 --- /dev/null +++ b/docs/source/usage/operations/projections/vandg3.rst @@ -0,0 +1,10 @@ +.. _vandg3: + +******************************************************************************** +van der Grinten III +******************************************************************************** + +.. image:: ./images/vandg3.png + :scale: 50% + :alt: van der Grinten III + diff --git a/docs/source/usage/operations/projections/vandg4.rst b/docs/source/usage/operations/projections/vandg4.rst new file mode 100644 index 00000000..097ba1d8 --- /dev/null +++ b/docs/source/usage/operations/projections/vandg4.rst @@ -0,0 +1,10 @@ +.. _vandg4: + +******************************************************************************** +van der Grinten IV +******************************************************************************** + +.. image:: ./images/vandg4.png + :scale: 50% + :alt: van der Grinten IV + diff --git a/docs/source/usage/operations/projections/vitk1.rst b/docs/source/usage/operations/projections/vitk1.rst new file mode 100644 index 00000000..b9081547 --- /dev/null +++ b/docs/source/usage/operations/projections/vitk1.rst @@ -0,0 +1,10 @@ +.. _vitk1: + +******************************************************************************** +Vitkovsky I +******************************************************************************** + +.. image:: ./images/vitk1.png + :scale: 50% + :alt: Vitkovsky I + diff --git a/docs/source/usage/operations/projections/wag1.rst b/docs/source/usage/operations/projections/wag1.rst new file mode 100644 index 00000000..dd1ed39e --- /dev/null +++ b/docs/source/usage/operations/projections/wag1.rst @@ -0,0 +1,10 @@ +.. _wag1: + +******************************************************************************** +Wagner I (Kavraisky VI) +******************************************************************************** + +.. image:: ./images/wag1.png + :scale: 50% + :alt: Wagner I (Kavraisky VI) + diff --git a/docs/source/usage/operations/projections/wag2.rst b/docs/source/usage/operations/projections/wag2.rst new file mode 100644 index 00000000..9c7b0edc --- /dev/null +++ b/docs/source/usage/operations/projections/wag2.rst @@ -0,0 +1,18 @@ +.. _wag2: + +******************************************************************************** +Wagner II +******************************************************************************** + +.. image:: ./images/wag2.png + :scale: 50% + :alt: Wagner II + + +.. math:: + + x &= 0.92483 \lambda \cos \theta + + y &= 1.38725\theta + + \sin \theta &= 0.88022 \sin(0.8855\phi) diff --git a/docs/source/usage/operations/projections/wag3.rst b/docs/source/usage/operations/projections/wag3.rst new file mode 100644 index 00000000..fb70a0a6 --- /dev/null +++ b/docs/source/usage/operations/projections/wag3.rst @@ -0,0 +1,16 @@ +.. _wag3: + +******************************************************************************** +Wagner III +******************************************************************************** + +.. image:: ./images/wag3.png + :scale: 50% + :alt: Wagner III + + +.. math:: + + x &= [\cos\phi_{ts} / \cos ( 2\phi_{ts} / 3)] \lambda \cos (2\phi /3) + + y = \phi diff --git a/docs/source/usage/operations/projections/wag4.rst b/docs/source/usage/operations/projections/wag4.rst new file mode 100644 index 00000000..7b8dac96 --- /dev/null +++ b/docs/source/usage/operations/projections/wag4.rst @@ -0,0 +1,10 @@ +.. _wag4: + +******************************************************************************** +Wagner IV +******************************************************************************** + +.. image:: ./images/wag4.png + :scale: 50% + :alt: Wagner IV + diff --git a/docs/source/usage/operations/projections/wag5.rst b/docs/source/usage/operations/projections/wag5.rst new file mode 100644 index 00000000..f880290b --- /dev/null +++ b/docs/source/usage/operations/projections/wag5.rst @@ -0,0 +1,10 @@ +.. _wag5: + +******************************************************************************** +Wagner V +******************************************************************************** + +.. image:: ./images/wag5.png + :scale: 50% + :alt: Wagner V + diff --git a/docs/source/usage/operations/projections/wag6.rst b/docs/source/usage/operations/projections/wag6.rst new file mode 100644 index 00000000..f74749a5 --- /dev/null +++ b/docs/source/usage/operations/projections/wag6.rst @@ -0,0 +1,10 @@ +.. _wag6: + +******************************************************************************** +Wagner VI +******************************************************************************** + +.. image:: ./images/wag6.png + :scale: 50% + :alt: Wagner VI + diff --git a/docs/source/usage/operations/projections/wag7.rst b/docs/source/usage/operations/projections/wag7.rst new file mode 100644 index 00000000..be1401b8 --- /dev/null +++ b/docs/source/usage/operations/projections/wag7.rst @@ -0,0 +1,10 @@ +.. _wag7: + +******************************************************************************** +Wagner VII +******************************************************************************** + +.. image:: ./images/wag7.png + :scale: 50% + :alt: Wagner VII + diff --git a/docs/source/usage/operations/projections/weren.rst b/docs/source/usage/operations/projections/weren.rst new file mode 100644 index 00000000..de7c5abf --- /dev/null +++ b/docs/source/usage/operations/projections/weren.rst @@ -0,0 +1,10 @@ +.. _weren: + +******************************************************************************** +Werenskiold I +******************************************************************************** + +.. image:: ./images/weren.png + :scale: 50% + :alt: Werenskiold I + diff --git a/docs/source/usage/operations/projections/wink1.rst b/docs/source/usage/operations/projections/wink1.rst new file mode 100644 index 00000000..00346765 --- /dev/null +++ b/docs/source/usage/operations/projections/wink1.rst @@ -0,0 +1,10 @@ +.. _wink1: + +******************************************************************************** +Winkel I +******************************************************************************** + +.. image:: ./images/wink1.png + :scale: 50% + :alt: Winkel I + diff --git a/docs/source/usage/operations/projections/wink2.rst b/docs/source/usage/operations/projections/wink2.rst new file mode 100644 index 00000000..7e9b48a7 --- /dev/null +++ b/docs/source/usage/operations/projections/wink2.rst @@ -0,0 +1,10 @@ +.. _wink2: + +******************************************************************************** +Winkel II +******************************************************************************** + +.. image:: ./images/wink2.png + :scale: 50% + :alt: Winkel II + diff --git a/docs/source/usage/operations/projections/wintri.rst b/docs/source/usage/operations/projections/wintri.rst new file mode 100644 index 00000000..bfd5032f --- /dev/null +++ b/docs/source/usage/operations/projections/wintri.rst @@ -0,0 +1,10 @@ +.. _wintri: + +******************************************************************************** +Winkel Tripel +******************************************************************************** + +.. image:: ./images/wintri.png + :scale: 50% + :alt: Winkel Tripel + diff --git a/docs/source/usage/operations/transformations/cart.rst b/docs/source/usage/operations/transformations/cart.rst new file mode 100644 index 00000000..0c3c7c23 --- /dev/null +++ b/docs/source/usage/operations/transformations/cart.rst @@ -0,0 +1,24 @@ +.. _cart: + +================================================================================ +Cartesian to geodetic conversion +================================================================================ + +Convert geodetic coordinates to cartesian coordinates. + ++--------------+--------------------------------------------------------------------+ +| **Options** | ++--------------+--------------------------------------------------------------------+ +| `+ellps` | Ellipsoid of the input coordinates. If used together with the | +| | ellipsoid parameters below, ``+ellps`` is overwritten. | ++--------------+--------------------------------------------------------------------+ +| `+a` | Semi-major radius of ellipsoid axis. | ++--------------+--------------------------------------------------------------------+ +| `+b` | Semi-minor radius of ellipsoid axis. | ++--------------+--------------------------------------------------------------------+ +| `+es` | Eccentricity of ellipsoid. | ++--------------+--------------------------------------------------------------------+ +| `+f` | Flattening of ellipsoid. | ++--------------+--------------------------------------------------------------------+ + + diff --git a/docs/source/usage/operations/transformations/helmert.rst b/docs/source/usage/operations/transformations/helmert.rst new file mode 100644 index 00000000..46073b63 --- /dev/null +++ b/docs/source/usage/operations/transformations/helmert.rst @@ -0,0 +1,7 @@ +.. _helmert: + +================================================================================ +Helmert transform +================================================================================ + +Change reference frame by Helmert shift. diff --git a/docs/source/usage/operations/transformations/hgridshift.rst b/docs/source/usage/operations/transformations/hgridshift.rst new file mode 100644 index 00000000..78e46aa9 --- /dev/null +++ b/docs/source/usage/operations/transformations/hgridshift.rst @@ -0,0 +1,32 @@ +.. _hgridshift: + +================================================================================ +Horizontal grid shift +================================================================================ + +Change of horizontal datum by grid shift. + ++--------------+--------------------------------------------------------------------+ +| **Options** | ++--------------+--------------------------------------------------------------------+ +| `+grids` | Comma-separated list of grids to load. | ++--------------+--------------------------------------------------------------------+ + +The horizontal grid shift is done by offsetting the planar input coordinates by +a specific amount determined by the loaded grids. The simplest use case of the +horizontal grid shift is applying a single grid:: + + +hgridshift +grids=nzgr2kgrid0005.gsb + + +More than one grid can be loaded at the same time, for instance in case the +dataset needs to be transformed spans several countries. In this example grids +of the continental US, Alaska and Canada is loaded at the same time:: + + +hgridshift +grids=@conus,@alaska,@ntv2_0.gsb,@ntv_can.dat + +The ``@`` in the above example states that the grid is optional, in case the grid +is not found in the PROJ.4 search path. The list of grids is prioritized so that +grids in the start of the list takes presedence over the grids in the back of the +list. + diff --git a/docs/source/usage/operations/transformations/index.rst b/docs/source/usage/operations/transformations/index.rst new file mode 100644 index 00000000..8bf2a890 --- /dev/null +++ b/docs/source/usage/operations/transformations/index.rst @@ -0,0 +1,15 @@ +.. _transformation_list: + +================================================================================ +Transformations +================================================================================ + +.. toctree:: + :maxdepth: 1 + + cart + helmert + molodensky + hgridshift + vgridshift + unitconvert diff --git a/docs/source/usage/operations/transformations/molodensky.rst b/docs/source/usage/operations/transformations/molodensky.rst new file mode 100644 index 00000000..3fa8f9a8 --- /dev/null +++ b/docs/source/usage/operations/transformations/molodensky.rst @@ -0,0 +1,7 @@ +.. _molodensky: + +================================================================================ +Molodensky transform +================================================================================ + +Perform a datum shift in geodetic coordinate space. diff --git a/docs/source/usage/operations/transformations/unitconvert.rst b/docs/source/usage/operations/transformations/unitconvert.rst new file mode 100644 index 00000000..458d0c15 --- /dev/null +++ b/docs/source/usage/operations/transformations/unitconvert.rst @@ -0,0 +1,7 @@ +.. _unitconvert: + +================================================================================ +Unit conversion +================================================================================ + +Convert between various distance and time units. diff --git a/docs/source/usage/operations/transformations/vgridshift.rst b/docs/source/usage/operations/transformations/vgridshift.rst new file mode 100644 index 00000000..f48d40c8 --- /dev/null +++ b/docs/source/usage/operations/transformations/vgridshift.rst @@ -0,0 +1,34 @@ +.. _vgridshift: + +================================================================================ +Vertical grid shift +================================================================================ + +Change Vertical datum change by grid shift + ++--------------+--------------------------------------------------------------------+ +| **Options** | ++--------------+--------------------------------------------------------------------+ +| `+grids` | Comma-separated list of grids to load. | ++--------------+--------------------------------------------------------------------+ + +The vertical grid shift is done by offsetting the vertical input coordinates by +a specific amount determined by the loaded grids. The simplest use case of the +horizontal grid shift is applying a single grid. Here we change the vertical +reference from the ellipsoid to the global geoid model, EGM96:: + + +vgridshift +grids=egm96_16.gtx + + +More than one grid can be loaded at the same time, for instance in the case where +a better geoid model than the global is available for a certain area. Here the +gridshift is set up so that the local DVR90 geoid model takes presedence over +the global model:: + + +vgridshift +grids=@dvr90.gtx,egm96_16.gtx + +The ``@`` in the above example states that the grid is optional, in case the grid +is not found in the PROJ.4 search path. The list of grids is prioritized so that +grids in the start of the list takes presedence over the grids in the back of the +list. + |
