aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations/transformations/molodensky.rst
diff options
context:
space:
mode:
authorKristian Evers <kristianevers@gmail.com>2018-04-30 22:42:59 +0200
committerKristian Evers <kristianevers@gmail.com>2018-04-30 22:57:05 +0200
commit970d708ff9d796f7d9ec00b22023e835fbdc7f2d (patch)
treecbee11737ed36f20e51ba19c9e8faa757e79ac0d /docs/source/operations/transformations/molodensky.rst
parentcd23e5f1b2630ee07567bd361373ba725774061b (diff)
downloadPROJ-970d708ff9d796f7d9ec00b22023e835fbdc7f2d.tar.gz
PROJ-970d708ff9d796f7d9ec00b22023e835fbdc7f2d.zip
Refactor operation doc pages
Extended the use of the :option: directive to all currently written operation doc pages. In the process several more default parameters were added for easy inclusion in other doc pages. Expanded the info tables for each operation with "domain", "alias", "input type" and "output type". Corrected various errors along the way. Mainly formatting errors and references to invalid parameters such as +sym in hatano.
Diffstat (limited to 'docs/source/operations/transformations/molodensky.rst')
-rw-r--r--docs/source/operations/transformations/molodensky.rst60
1 files changed, 41 insertions, 19 deletions
diff --git a/docs/source/operations/transformations/molodensky.rst b/docs/source/operations/transformations/molodensky.rst
index d4ff3e79..a90828cd 100644
--- a/docs/source/operations/transformations/molodensky.rst
+++ b/docs/source/operations/transformations/molodensky.rst
@@ -4,6 +4,8 @@
Molodensky transform
================================================================================
+.. versionadded:: 5.0.0
+
The Molodensky transformation resembles a :ref:`Helmert` with zero
rotations and a scale of unity, but converts directly from geodetic coordinates to
geodetic coordinates, without the intermediate shifts to and from cartesian
@@ -17,28 +19,13 @@ reasons, but nevertheless indispensable due to the large amount of data that has
already been transformed that way [EversKnudsen2017]_.
+---------------------+----------------------------------------------------------+
-| **Input type** | Geodetic coordinates. |
-+---------------------+----------------------------------------------------------+
-| **Output type** | Geodetic coordinates. |
-+---------------------+----------------------------------------------------------+
-| **Options** |
-+---------------------+----------------------------------------------------------+
-| `+da` | Difference in semimajor axis of the defining ellipsoids. |
-+---------------------+----------------------------------------------------------+
-| `+df` | Difference in flattening of the defining ellipsoids. |
-+---------------------+----------------------------------------------------------+
-| `+dx` | Offset of the X-axes of the defining ellipsoids. |
+| **Alias** | molodensky |
+---------------------+----------------------------------------------------------+
-| `+dy` | Offset of the Y-axes of the defining ellipsoids. |
+| **Domain** | 3D |
+---------------------+----------------------------------------------------------+
-| `+dz` | Offset of the Z-axes of the defining ellipsoids. |
+| **Input type** | Geodetic coordinates (horizontal), meters (vertical) |
+---------------------+----------------------------------------------------------+
-| `+ellps` | Ellipsoid definition of source coordinates. |
-| | Any specification can be used (e.g. `+a`, `+rf`, etc). |
-|   | If not specified, default ellipsoid is used. |
-+---------------------+----------------------------------------------------------+
-| `+abridged` | Use the abridged version of the Molodensky transform. |
-| | Optional. |
+| **output type** | Geodetic coordinates (horizontal), meters (vertical) |
+---------------------+----------------------------------------------------------+
The Molodensky transform can be used to perform a datum shift from coordinate
@@ -72,3 +59,38 @@ The same transformation using the standard Molodensky::
proj=molodensky a=6378160 rf=298.25 da=-23 df=-8.120449e-8 dx=-134 dy=-48 dz=149
+
+Parameters
+################################################################################
+
+Required
+-------------------------------------------------------------------------------
+
+.. option:: +da=<value>
+
+ Difference in semimajor axis of the defining ellipsoids.
+
+.. option:: +df=<value>
+
+ Difference in flattening of the defining ellipsoids.
+
+.. option:: +dx=<value>
+
+ Offset of the X-axes of the defining ellipsoids.
+
+.. option:: +dy=<value>
+
+ Offset of the Y-axes of the defining ellipsoids.
+
+.. option:: +dz=<value>
+
+ Offset of the Z-axes of the defining ellipsoids.
+
+.. include:: ../options/ellps.rst
+
+Optional
+-------------------------------------------------------------------------------
+
+.. option:: +abridged
+
+ Use the abridged version of the Molodensky transform.