Skip to content

Commit 5b93a54

Browse files
Conic projection descriptions (#757)
* Add projection description to conic_albers.py * Add projection description to conic_equidistant.py * Add projection description to conic_lambert.py * Add projection description to polyconic.py
1 parent 27a58e8 commit 5b93a54

File tree

4 files changed

+37
-0
lines changed

4 files changed

+37
-0
lines changed

examples/projections/conic/conic_albers.py

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,15 @@
22
Albers Conic Equal Area
33
=======================
44
5+
This projection, developed by Heinrich C. Albers in 1805, is predominantly used to map
6+
regions of large east-west extent, in particular the United States. It is a conic,
7+
equal-area projection, in which parallels are unequally spaced arcs of concentric
8+
circles, more closely spaced at the north and south edges of the map. Meridians, on the
9+
other hand, are equally spaced radii about a common center, and cut the parallels at
10+
right angles. Distortion in scale and shape vanishes along the two standard parallels.
11+
Between them, the scale along parallels is too small; beyond them it is too large.
12+
The opposite is true for the scale along meridians.
13+
514
``Blon0/lat0/lat1/lat2/width``: Give projection center ``lon0/lat0`` and two standard
615
parallels ``lat1/lat2``.
716
"""

examples/projections/conic/conic_equidistant.py

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,11 @@
22
Equidistant conic
33
=================
44
5+
The equidistant conic projection was described by the Greek philosopher Claudius
6+
Ptolemy about A.D. 150. It is neither conformal or equal-area, but serves as a
7+
compromise between them. The scale is true along all meridians and the
8+
standard parallels.
9+
510
``Dlon0/lat0/lat1/lat2/width``: Give projection center ``lon0/lat0``, two standard
611
parallels ``lat1/lat2``, and the map width.
712
"""

examples/projections/conic/conic_lambert.py

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,13 @@
22
Lambert Conic Conformal Projection
33
==================================
44
5+
This conic projection was designed by the Alsatian mathematician Johann Heinrich
6+
Lambert (1772) and has been used extensively for mapping of regions with predominantly
7+
east-west orientation, just like the Albers projection. Unlike the Albers projection,
8+
Lambert’s conformal projection is not equal-area. The parallels are arcs of circles
9+
with a common origin, and meridians are the equally spaced radii of these circles. As
10+
with Albers projection, it is only the two standard parallels that are distortion-free.
11+
512
``Llon0/lat0/lat1/lat2/width``: Give projection center ``lon0/lat0``, two standard
613
parallels ``lat1/lat2``, and the map width.
714
"""

examples/projections/conic/polyconic.py

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,22 @@
22
Polyconic Projection
33
====================
44
5+
The polyconic projection, in Europe usually referred to as the American polyconic
6+
projection, was introduced shortly before 1820 by the Swiss-American cartographer
7+
Ferdinand Rodulph Hassler (1770–1843). As head of the Survey of the Coast, he was
8+
looking for a projection that would give the least distortion for mapping the coast of
9+
the United States. The projection acquired its name from the construction of each
10+
parallel, which is achieved by projecting the parallel onto the cone while it is rolled
11+
around the globe, along the central meridian, tangent to that parallel. As a
12+
consequence, the projection involves many cones rather than a single one used in
13+
regular conic projections.
14+
15+
The polyconic projection is neither equal-area, nor conformal. It is true to scale
16+
without distortion along the central meridian. Each parallel is true to scale as well,
17+
but the meridians are not as they get further away from the central meridian. As a
18+
consequence, no parallel is standard because conformity is lost with the lengthening of
19+
the meridians.
20+
521
``Poly/width``: The only additional argument for the projection is the map width.
622
"""
723
import pygmt

0 commit comments

Comments
 (0)