- Add dymaxion projection entry to he documentation

OSGeo · Oct 30, 2024 · 44ef3a9 · 44ef3a9
1 parent dc922de
commit 44ef3a9
Show file tree

Hide file tree

Showing 5 changed files with 77 additions and 0 deletions.
diff --git a/docs/plot/plotdefs.json b/docs/plot/plotdefs.json
@@ -269,6 +269,18 @@
         "res": "low",
         "type": "poly"
     },
+    {
+        "filename": "dymaxion.png",
+        "latmax": 90,
+        "latmin": -90,
+        "lonmax": 180,
+        "lonmin": -180,
+        "name": "dymaxion",
+        "projstring": "+proj=dymaxion",
+        "res": "low",
+        "type": "line",
+        "delta_cut": 1e6
+    },
     {
         "filename": "eck1.png",
         "latmax": 90,

diff --git a/docs/source/operations/projections/dymaxion.rst b/docs/source/operations/projections/dymaxion.rst
@@ -0,0 +1,52 @@
+.. _dymaxion:
+
+********************************************************************************
+Dymaxion Fuller
+********************************************************************************
+
+The Dymaxion Fuller map projection is a icosahedron polyhedral projection that intends
+to lay out most of continental landmasses unto a flat surface with as few land cuts
+as possible while minimizing scale and angular distorsion.
+In comparison to the Snyder's Icosahedral Equal Area, this projection relies on a specific way 
+to orient and cut the icosahedron so that most interruptions lie in the ocean. The projection
+was first invented by Buckminster Fuller in 1943 using a cubostahedron as basis.
+The idea to use an icosahedron came later in 1954, and it wasn't until 1978 that the projection 
+was formally mathematically defined :cite:`Gray1995`.
+
++---------------------+----------------------------------------------------------+
+| **Classification**  | Polyhedral, equal area                                   |
++---------------------+----------------------------------------------------------+
+| **Available forms** | Forward and inverse, spherical                           |
++---------------------+----------------------------------------------------------+
+| **Defined area**    | Global                                                   |
++---------------------+----------------------------------------------------------+
+| **Alias**           | dymaxion                                                 |
++---------------------+----------------------------------------------------------+
+| **Domain**          | 2D                                                       |
++---------------------+----------------------------------------------------------+
+| **Input type**      | Geodetic coordinates                                     |
++---------------------+----------------------------------------------------------+
+| **Output type**     | Projected coordinates                                    |
++---------------------+----------------------------------------------------------+
+
+
+.. figure:: ./images/dymaxion.png
+   :width: 500 px
+   :align: center
+   :alt:   Dymaxion Fuller
+
+   proj-string: ``+proj=dymaxion``
+
+
+Parameters
+################################################################################
+
+.. note:: All parameters are optional for the projection.
+
+.. include:: ../options/lon_0.rst
+
+.. include:: ../options/R.rst
+
+.. include:: ../options/x_0.rst
+
+.. include:: ../options/y_0.rst
diff --git a/docs/source/operations/projections/images/dymaxion.png b/docs/source/operations/projections/images/dymaxion.png
diff --git a/docs/source/operations/projections/index.rst b/docs/source/operations/projections/index.rst
@@ -38,6 +38,7 @@ Projections map the spherical 3D space to a flat 2D space.
    comill
    crast
    denoy
+   dymaxion
    eck1
    eck2
    eck3

diff --git a/docs/source/references.bib b/docs/source/references.bib
@@ -73,6 +73,18 @@ @TechReport{Deakin2004
   Url                      = {http://www.mygeodesy.id.au/documents/Molodensky%20V2.pdf}
 }
 
+@Article{Gray1995,
+  Title                    = {Exact Transformation Equations for Fuller's World Map},
+  Author                   = {Robert W. Gray},
+  Journal                  = {Cartographica},
+  Year                     = {1995},
+  Number                   = {3},
+  Pages                    = {17--25},
+  Volume                   = {32},
+
+  Doi                      = {10.3138/1677-3273-Q862-1885}
+}
+
 @Article{EberHewitt1979,
   Title                    = {Conversion algorithms for the {CalCOFI} station grid},
   Author                   = {L. E. Eber and Roger P. Hewitt},