Skip to content

Commit d643019

Browse files
Add descriptions for cylindric projections (#761)
* Add description on cyl_cassini.py * Add description on cyl_equal_area.py * Add description on cyl_equidistant.py * Add description on cyl_mercator.py * Add description on cyl_miller.py * Add description on cyl_stereographic.py * Add description on cyl_transverse_mercator.py * Add description on cyl_universal_transverse_mercator.py
1 parent fd688bc commit d643019

File tree

8 files changed

+62
-1
lines changed

8 files changed

+62
-1
lines changed

examples/projections/cyl/cyl_cassini.py

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,15 @@
22
Cassini Cylindrical
33
============================
44
5+
This cylindrical projection was developed in 1745 by César-François Cassini de Thury
6+
for the survey of France. It is occasionally called Cassini-Soldner since the latter
7+
provided the more accurate mathematical analysis that led to the development of the
8+
ellipsoidal formulae. The projection is neither conformal nor equal-area, and behaves
9+
as a compromise between the two end-members. The distortion is zero along the central
10+
meridian. It is best suited for mapping regions of north-south extent. The central
11+
meridian, each meridian 90° away, and equator are straight lines; all other meridians
12+
and parallels are complex curves.
13+
514
``Clon0/lat0/width``: ``lon0`` and ``lat0`` specifies the projection center.
615
"""
716
import pygmt

examples/projections/cyl/cyl_equal_area.py

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,12 @@
22
Cylindrical equal-area
33
======================
44
5-
``Ylon0/lat0/width``: Give central meridian ``lon0``, the standard parallel ``lat0``, and the figure ``width``.
5+
This cylindrical projection is actually several projections, depending on what
6+
latitude is selected as the standard parallel. However, they are all equal area and
7+
hence non-conformal. All meridians and parallels are straight lines.
8+
9+
``Ylon0/lat0/width``: Give central meridian ``lon0``, the standard parallel ``lat0``,
10+
and the figure ``width``.
611
"""
712
import pygmt
813

examples/projections/cyl/cyl_equidistant.py

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22
Cylindrical equidistant
33
=======================
44
5+
This simple cylindrical projection is really a linear scaling of longitudes and
6+
latitudes. The most common form is the Plate Carrée projection, where the scaling of
7+
longitudes and latitudes is the same. All meridians and parallels are straight lines.
8+
59
``Qwidth``: Give the figure ``width``.
610
"""
711
import pygmt

examples/projections/cyl/cyl_mercator.py

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22
Mercator
33
========
44
5+
The Mercator projection takes its name from the Flemish cartographer Gheert Cremer,
6+
better known as Gerardus Mercator, who presented it in 1569. The projection is a
7+
cylindrical and conformal, with no distortion along the equator. A major navigational
8+
feature of the projection is that a line of constant azimuth is straight. Such a line
9+
is called a rhumb line or loxodrome. Thus, to sail from one point to another one only
10+
had to connect the points with a straight line, determine the azimuth of the line, and
11+
keep this constant course for the entire voyage. The Mercator projection has been used
12+
extensively for world maps in which the distortion towards the polar regions grows
13+
rather large.
14+
515
``M[lon0/][lat0/]width``: Give central meridian ``lon0`` (optional) and
616
standard parallel ``lat0`` (optional).
717
"""

examples/projections/cyl/cyl_miller.py

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,13 @@
22
Miller cylindrical
33
==================
44
5+
This cylindrical projection, presented by Osborn Maitland Miller of the American
6+
Geographic Society in 1942, is neither equal nor conformal. All meridians and
7+
parallels are straight lines. The projection was designed to be a compromise between
8+
Mercator and other cylindrical projections. Specifically, Miller spaced the parallels
9+
by using Mercator’s formula with 0.8 times the actual latitude, thus avoiding the
10+
singular poles; the result was then divided by 0.8.
11+
512
``J[lon0/]width``: Give the optional central meridian ``lon0`` and the figure ``width``.
613
"""
714
import pygmt

examples/projections/cyl/cyl_stereographic.py

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,14 @@
22
Cylindrical Stereographic
33
=========================
44
5+
The cylindrical stereographic projections are certainly not as notable as other
6+
cylindrical projections, but are still used because of their relative simplicity and
7+
their ability to overcome some of the downsides of other cylindrical projections, like
8+
extreme distortions of the higher latitudes. The stereographic projections are
9+
perspective projections, projecting the sphere onto a cylinder in the direction of the
10+
antipodal point on the equator. The cylinder crosses the sphere at two standard
11+
parallels, equidistant from the equator.
12+
513
``Cyl_stere/[lon0/][lat0/]width``: Give central meridian ``lon0`` (optional) and
614
standard parallel ``lat0`` (optional). The standard parallel is typically one of these
715
(but can be any value):

examples/projections/cyl/cyl_transverse_mercator.py

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,12 @@
22
Transverse Mercator
33
===================
44
5+
The transverse Mercator was invented by Johann Heinrich Lambert in 1772. In this
6+
projection the cylinder touches a meridian along which there is no distortion. The
7+
distortion increases away from the central meridian and goes to infinity at 90° from
8+
center. The central meridian, each meridian 90° away from the center, and equator are
9+
straight lines; other parallels and meridians are complex curves.
10+
511
``T[lon0/][lat0/]width``: Give central meridian ``lon0``, the latitude of the
612
origin ``lat0`` (optional), and the figure width.
713
"""

examples/projections/cyl/cyl_universal_transverse_mercator.py

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,18 @@
22
Universal Transverse Mercator
33
=============================
44
5+
A particular subset of the transverse Mercator is the Universal Transverse Mercator
6+
(UTM) which was adopted by the US Army for large-scale military maps. Here, the globe
7+
is divided into 60 zones between 84°S and 84°N, most of which are 6 wide. Each of these
8+
UTM zones have their unique central meridian. Furthermore, each zone is divided into
9+
latitude bands but these are not needed to specify the projection for most cases.
10+
11+
In order to minimize the distortion in any given zone, a scale factor of 0.9996 has
12+
been factored into the formulae. This makes the UTM projection a secant projection and
13+
not a tangent projection like the transverse Mercator above. The scale only varies by
14+
1 part in 1,000 from true scale at equator. The ellipsoidal projection expressions are
15+
accurate for map areas that extend less than 10 away from the central meridian.
16+
517
``U[UTM Zone/][lat0/]width``: Give UTM Zone ``UTM Zone``, and the figure width.
618
"""
719
import pygmt

0 commit comments

Comments
 (0)