From 67eac9ce4486ea9f925bcbd0fc43ea6854d40c39 Mon Sep 17 00:00:00 2001 From: Howard Butler Date: Sun, 11 Sep 2016 13:37:33 -0500 Subject: add global references, update hatano page --- docs/source/index.rst | 1 + docs/source/projections/hatano.rst | 56 ++++++++++++++++++++++++++++++++------ docs/source/projections/merc.rst | 9 ++---- docs/source/references.rst | 11 ++++++++ 4 files changed, 62 insertions(+), 15 deletions(-) create mode 100644 docs/source/references.rst (limited to 'docs/source') diff --git a/docs/source/index.rst b/docs/source/index.rst index 7e4d66ec..6540738b 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -41,6 +41,7 @@ Documentation parameters projections/index glossary + references diff --git a/docs/source/projections/hatano.rst b/docs/source/projections/hatano.rst index 7fabbcab..6ba2d3a0 100644 --- a/docs/source/projections/hatano.rst +++ b/docs/source/projections/hatano.rst @@ -4,31 +4,71 @@ Hatano Asymmetrical Equal Area ******************************************************************************** + + + ++---------------------+----------------------------------------------------------+ +| **Classification** | :term:`Pseudocylindrical Projection` | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward | ++---------------------+----------------------------------------------------------+ +| **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 -:term:`Pseudocylindrical Projection` -.. note:: - If the ``+syn`` option is selected, the symmetric form of this projection is - used. Otherwise the asymmetric form is used by default. +Mathematical Definition +-------------------------------------------------------------------------------- + +Forward +................................................................................ .. math:: \begin{array} - x &= 0.85\lambda cos \theta + x &= 0.85\lambda \cos \theta - y &= C_y sin \theta + y &= C_y \sin \theta - P(\theta) &= 2\theta + sin 2\theta - C_p sin \phi + P(\theta) &= 2\theta + \sin 2\theta - C_p \sin \phi - P'(\theta) &= 2(1 + cos 2\theta) + P'(\theta) &= 2(1 + \cos 2\theta) \theta_0 &= 2\phi \end{array} +==================================== ================== =================== +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 `__ +#. `Mathworks `__ + + + diff --git a/docs/source/projections/merc.rst b/docs/source/projections/merc.rst index 5b19b3ff..a1361e45 100644 --- a/docs/source/projections/merc.rst +++ b/docs/source/projections/merc.rst @@ -37,7 +37,7 @@ 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 [0]. +cannot be shown [Evenden1995]_. Example:: @@ -49,7 +49,7 @@ Example:: Mathematical definition ####################### -The formulas describing the Mercator projection are all taken from G. Evenden's libproj manuals [1]. +The formulas describing the Mercator projection are all taken from G. Evenden's libproj manuals [Evenden2005]_. Spherical form ************** @@ -128,8 +128,3 @@ Further reading #. `Wolfram Mathworld `_ -References -########## -[0] Evenden, G. I., 1995, Cartograpic Projection Procedures for the UNIX Environment - A User's Manual. - -[1] Evenden, G. I., 2005, libproj4: A Comprehensive Library of Cartographic Projection Functions (Preliminary Draft). diff --git a/docs/source/references.rst b/docs/source/references.rst new file mode 100644 index 00000000..7604ed83 --- /dev/null +++ b/docs/source/references.rst @@ -0,0 +1,11 @@ +.. _references:: + +================================================================================ +References +================================================================================ + + +.. [Evenden1995] Evenden, G. I., 1995, `Cartograpic Projection Procedures for the UNIX Environment - A User's Manual `__ + +.. [Evenden2005] Evenden, G. I., 2005, `libproj4: A Comprehensive Library of Cartographic Projection Functions (Preliminary Draft) `__ + -- cgit v1.2.3