aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations/projections/cea.rst
blob: 52763edb21d866b21f34694f7331aafc547cd1be (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
.. _cea:

********************************************************************************
Equal Area Cylindrical
********************************************************************************

Equal area cylindrical has a number of named specializations, 
such as `Gall–Peters https://en.wikipedia.org/wiki/Gall%E2%80%93Peters_projection`_ (lat_ts=45), 
`Behrmann https://en.wikipedia.org/wiki/Behrmann_projection`_ (lat_ts=30), and 
`Lambert cylindrical equal-area https://en.wikipedia.org/wiki/Lambert_cylindrical_equal-area_projection`_ (lat_ts=0).

+---------------------+----------------------------------------------------------+
| **Classification**  | Cylindrical                                              |
+---------------------+----------------------------------------------------------+
| **Available forms** | Forward and inverse, spherical and ellipsoidal           |
+---------------------+----------------------------------------------------------+
| **Defined area**    | Global                                                   |
+---------------------+----------------------------------------------------------+
| **Alias**           | cea                                                      |
+---------------------+----------------------------------------------------------+
| **Domain**          | 2D                                                       |
+---------------------+----------------------------------------------------------+
| **Input type**      | Geodetic coordinates                                     |
+---------------------+----------------------------------------------------------+
| **Output type**     | Projected coordinates                                    |
+---------------------+----------------------------------------------------------+


.. figure:: ./images/cea.png
   :width: 500 px
   :align: center
   :alt:   Equal Area Cylindrical

   proj-string: ``+proj=cea``

Parameters
################################################################################

.. note:: All parameters are optional for the Equal Area Cylindrical projection.

.. include:: ../options/lat_ts.rst

.. include:: ../options/lon_0.rst

.. include:: ../options/ellps.rst

.. include:: ../options/R.rst

.. include:: ../options/k_0.rst

.. include:: ../options/x_0.rst

.. include:: ../options/y_0.rst

.. note::

    ``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}}}`