aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEven Rouault <even.rouault@spatialys.com>2022-02-21 16:38:06 +0100
committerGitHub <noreply@github.com>2022-02-21 16:38:06 +0100
commit1941f06e2767891e0d24e0547bbf7508b2839963 (patch)
tree6d2da3cc57fd19ffefeb8ea78240dd6bee396eaf
parent0bcdaae07d17f1f7b2df4b56523c8902a76de858 (diff)
parent009d9a401bb7c321e1d4c387b9fe2fb4f1645879 (diff)
downloadPROJ-1941f06e2767891e0d24e0547bbf7508b2839963.tar.gz
PROJ-1941f06e2767891e0d24e0547bbf7508b2839963.zip
Merge pull request #3064 from rouault/doc_gall_peters
Doc: mention Behrmann and Gall-Peters projections as specializations of cea
-rw-r--r--docs/source/operations/projections/cea.rst27
-rw-r--r--docs/source/operations/projections/gall.rst4
2 files changed, 30 insertions, 1 deletions
diff --git a/docs/source/operations/projections/cea.rst b/docs/source/operations/projections/cea.rst
index 3799fbcb..3f8af65f 100644
--- a/docs/source/operations/projections/cea.rst
+++ b/docs/source/operations/projections/cea.rst
@@ -28,6 +28,22 @@ Equal Area Cylindrical
proj-string: ``+proj=cea``
+Named specializations
+################################################################################
+
+The Equal Area Cylindrical projection is sometimes known under other names when
+it is instanciated with particular values of the ``lat_ts`` parameter:
+
++----------------------------------+------------+
+| **Name** | **lat_ts** |
++----------------------------------+------------+
+| Lambert cylindrical equal-area | 0 |
++----------------------------------+------------+
+| Behrmann | 30 |
++----------------------------------+------------+
+| Gall-Peters | 45 |
++----------------------------------+------------+
+
Parameters
################################################################################
@@ -51,4 +67,13 @@ Parameters
``lat_ts`` and ``k_0`` are mutually exclusive. If ``lat_ts``
is specified, it is equivalent to setting ``k_0`` to
- :math:`\frac{\cos \phi_{ts}}{\sqrt{1 - e^2 \sin^2 \phi_{ts}}}` \ No newline at end of file
+ :math:`\frac{\cos \phi_{ts}}{\sqrt{1 - e^2 \sin^2 \phi_{ts}}}`
+
+Further reading
+###############
+
+#. `Wikipedia: Lambert cylindrical equal-area <https://en.wikipedia.org/wiki/Lambert_cylindrical_equal-area_projection>`_
+
+#. `Wikipedia: Gall-Peters <https://en.wikipedia.org/wiki/Gall%E2%80%93Peters_projection>`_
+
+#. `Wikipedia: Behrmann <https://en.wikipedia.org/wiki/Behrmann_projection>`_
diff --git a/docs/source/operations/projections/gall.rst b/docs/source/operations/projections/gall.rst
index 8114815a..ba83d450 100644
--- a/docs/source/operations/projections/gall.rst
+++ b/docs/source/operations/projections/gall.rst
@@ -42,6 +42,10 @@ 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.
+.. note::
+
+ The Gall projection must not be confused with the Gall-Peters one, the later
+ being a specialization of :ref:`cea`.
Example using Gall Stereographic ::