aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorHoward Butler <howard@hobu.co>2016-09-11 13:37:33 -0500
committerHoward Butler <howard@hobu.co>2016-09-11 13:37:33 -0500
commit67eac9ce4486ea9f925bcbd0fc43ea6854d40c39 (patch)
tree75a6527766eb84244f16f24868b8f653f74c5185 /docs
parent869e4106024519cacf513754b52980448de4b063 (diff)
downloadPROJ-67eac9ce4486ea9f925bcbd0fc43ea6854d40c39.tar.gz
PROJ-67eac9ce4486ea9f925bcbd0fc43ea6854d40c39.zip
add global references, update hatano page
Diffstat (limited to 'docs')
-rw-r--r--docs/source/index.rst1
-rw-r--r--docs/source/projections/hatano.rst56
-rw-r--r--docs/source/projections/merc.rst9
-rw-r--r--docs/source/references.rst11
4 files changed, 62 insertions, 15 deletions
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 <http://map-projections.net/single-view/hatano>`__
+#. `Mathworks <http://www.mathworks.com/help/map/hatano.html>`__
+
+
+
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 <http://mathworld.wolfram.com/MercatorProjection.html>`_
-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 <https://github.com/OSGeo/proj.4/blob/master/docs/old/proj_4_3_12.pdf>`__
+
+.. [Evenden2005] Evenden, G. I., 2005, `libproj4: A Comprehensive Library of Cartographic Projection Functions (Preliminary Draft) <https://github.com/OSGeo/proj.4/blob/master/docs/old/libproj.pdf>`__
+