Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update GMT argument in the azimuthal projections gallery to doc standards #776

Merged
merged 30 commits into from
Jan 1, 2021
Merged
Show file tree
Hide file tree
Changes from 12 commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
adf4526
Update azim_equidistant.py to GMT argument doc standards
willschlitzer Dec 30, 2020
bdb9afa
Testing format deployment
willschlitzer Dec 30, 2020
0a367f3
Test removing space around
willschlitzer Dec 30, 2020
d4284f6
Test formatting by cancelling spaces
willschlitzer Dec 30, 2020
600d7cf
Fix formatting typo
willschlitzer Dec 30, 2020
0ce84f1
Formatting docstring
willschlitzer Dec 30, 2020
ee3fb6f
Update formatting; include scale/width description
willschlitzer Dec 30, 2020
e386a28
Update docstring for azim_general_perspective.py
willschlitzer Dec 31, 2020
16e31bc
Update docstring for azim_general_stereographic.py to GMT argument st…
willschlitzer Dec 31, 2020
6911024
Making docstring r-strings in azim_general_perspective.py and azim_ge…
willschlitzer Dec 31, 2020
c879dc4
Removing explanation for the region parameter in azim_general_stereog…
willschlitzer Dec 31, 2020
5e99754
Merge branch 'master' into gmt-args-proj-azim
willschlitzer Dec 31, 2020
13fa4e3
Add scale/width explanation to azim_general_stereographic.py
willschlitzer Dec 31, 2020
e506c1a
Add projection explanation to azim_general_stereographic.py
willschlitzer Dec 31, 2020
b60dfdf
Clean up docstring in azim_general_stereographic.py
willschlitzer Jan 1, 2021
686115a
Clean up docstring in azim_general_perspective.py
willschlitzer Jan 1, 2021
c4c4165
Clean up docstring in azim_general_perspective.py
willschlitzer Jan 1, 2021
52434e7
Clean up docstring in azim_equidistant.py
willschlitzer Jan 1, 2021
8859a4b
Merge branch 'master' into gmt-args-proj-azim
willschlitzer Jan 1, 2021
9ab9a52
Clean up docstring in azim_gnomonic.py
willschlitzer Jan 1, 2021
99bc7a9
Clean up docstring in azim_gnomonic.py
willschlitzer Jan 1, 2021
3fbe7ab
Clean up docstring in azim_lambert.py
willschlitzer Jan 1, 2021
be7760e
Clean up docstring in azim_orthographic.py
willschlitzer Jan 1, 2021
0d56291
Clean up docstring in azim_equidistant.py
willschlitzer Jan 1, 2021
6aa5a53
Clean up docstring in azim_general_perspective.py.py
willschlitzer Jan 1, 2021
b73d1b7
Clean up docstring in azim_orthographic.py
willschlitzer Jan 1, 2021
6359c74
Clean up docstring in azim_general_stereographic.py
willschlitzer Jan 1, 2021
bdb8a2d
Update examples/projections/azim/azim_equidistant.py
willschlitzer Jan 1, 2021
487ae99
Merge branch 'master' into gmt-args-proj-azim
willschlitzer Jan 1, 2021
0d816cb
Update examples/projections/azim/azim_lambert.py
seisman Jan 1, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions examples/projections/azim/azim_equidistant.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
"""
r"""
Azimuthal Equidistant
=====================

Expand All @@ -8,11 +8,13 @@
that lie within a certain distance or for comparing distances of different
locations relative to the projection center.

``elon0/lat0[/horizon]/scale`` or ``Elon0/lat0[/horizon]/width``
**e**\ *lon0*\ **/**\ *lat0*\ [**/**\ *horizon*]\ **/**\ *scale* or
**E**\ *lon0*\ **/**\ *lat0*\ [**/**\ *horizon*]\ **/**\ *width*
willschlitzer marked this conversation as resolved.
Show resolved Hide resolved

``lon0/lat0`` specifies the projection center. The optional parameter
``horizon`` specifies the max distance to the projection center (i.e. the
visibile portion of the rest of the world map) in degrees <= 180° (default 180°).
*lon0*\ **/**\ *lat0* specifies the projection center. The optional parameter
*horizon* specifies the max distance to the projection center (i.e. the
visibile portion of the rest of the world map) in degrees <= 180° (default 180°). The
size of the figure is set by *scale* or *width*.
"""
import pygmt

Expand Down
17 changes: 10 additions & 7 deletions examples/projections/azim/azim_general_perspective.py
Original file line number Diff line number Diff line change
@@ -1,21 +1,24 @@
"""
r"""
General Perspective
===================

The general perspective projection imitates the view of the Earth from a finite
point in space. In a full view of the earth one third of its surface area can
be seen.

``lon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale`` or ``width``
**g**\ *lon0*\ **/**\ *lat0*\ **/**\ *altitude*\ **/**\ *azimuth*\ **/**\ *tilt*\ **/**\ *twist*\ **/**\ *Width*\ **/**\ *Height*\ **/**\ *scale*
or **G**\ *lon0*\ **/**\ *lat0*\ **/**\ *altitude*\ **/**\ *azimuth*\ **/**\ *tilt*\ **/**\ *twist*\ **/**\ *Width*\ **/**\ *Height*\ **/**\ *width*

``lon0/lat0`` specifies the projection center, ``altitude`` the height
The ``projection`` is set with **g** or **G**.
*lon0*\ **/**\ *lat0* specifies the projection center, *altitude* the height
in km of the viewpoint above local sea level (If altitude is less than 10,
then it is the distance from the center of the earth to the viewpoint in earth
radii). With ``azimuth`` the direction (in degrees) in which you are looking is
specified, measured clockwise from north. ``tilt`` is given in degrees and is the
radii). With *azimuth* the direction (in degrees) in which you are looking is
specified, measured clockwise from north. *tilt* is given in degrees and is the
viewing angle relative to zenith. A tilt of 0° is looking straight down, 60° is
looking 30° above horizon. ``twist`` is the clockwise rotation of the image (in
degrees). ``Width`` and ``Height`` describe the viewport angle in degrees.
looking 30° above horizon. *twist* is the clockwise rotation of the image (in
degrees). *Width* and *Height* describe the viewport angle in degrees, and *scale*
or *width* determine the size of the figure.

The example shows the coast of northern europe viewed from 250 km above sea
level looking 30° from north at a tilt of 45°. The height and width of the
Expand Down
14 changes: 4 additions & 10 deletions examples/projections/azim/azim_general_stereographic.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
"""
r"""
General Stereographic
=====================

Expand All @@ -9,17 +9,11 @@
It is often used as a hemisphere map like the Lambert Azimuthal Equal Area
projection.

``slon0/lat0[/horizon]/scale`` or ``Slon0/lat0[/horizon]/width``
**s**\ *lon0*\ **/**\ *lat0*\ [\ **/**\ *horizon*\ ]\ **/**\ *scale*
or **S**\ *lon0*\ **/**\ *lat0*\ [\ **/**\ *horizon*\ ]\ **/**\ *width*

``lon0/lat0`` specifies the projection center, the optional ``horizon`` parameter
*lon0*\ **/**\ *lat0* specifies the projection center, the optional *horizon* parameter
specifies the max distance from projection center (in degrees, < 180, default 90).

This projection can be displayed:

* With map boundaries coinciding with longitude and latitude:
``region`` specified via ``xmin/xmax/ymin/ymax``
* As a map with rectangular boundaries: ``region`` specified as lower left and
upper right corner ``xlleft/ylleft/xuright/yurightr``. Note the appended ``r``.
"""
import pygmt

Expand Down