Skip to content

Commit f68c379

Browse files
Add SRTM Relief doc (#135)
* Add SRTM Relief doc * Optimised images with calibre/image-actions --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 240680d commit f68c379

7 files changed

Lines changed: 72 additions & 0 deletions

File tree

docs/_static/GMT_earth_dist.jpg

-34.7 KB
Loading
-12.9 KB
Loading

docs/_static/GMT_srtm_relief.jpg

186 KB
Loading
63 KB
Loading

docs/index.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,12 @@ Information about the GMT data server and mirrors can be found on the
106106
:img-bottom: /_static/GMT_earth_daynight_thumbnail.jpg
107107
:text-align: center
108108

109+
.. grid-item-card:: NASA SRTM Relief
110+
:link: srtm-relief
111+
:link-type: doc
112+
:img-bottom: /_static/GMT_srtm_relief_thumbnail.jpg
113+
:text-align: center
114+
109115
.. grid-item-card:: WDMAM World Digital Magnetic Anomaly Map
110116
:link: earth-wdmam
111117
:link-type: doc

docs/srtm-relief.rst

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
NASA SRTM Relief
2+
-----------------
3+
4+
.. figure:: /_static/nasa-logo-web-rgb.png
5+
:align: right
6+
:scale: 20 %
7+
8+
.. figure:: /_static/GMT_srtm_relief.jpg
9+
:height: 888 px
10+
:width: 1774 px
11+
:align: center
12+
:scale: 40 %
13+
14+
Usage
15+
~~~~~
16+
17+
You access a SRTM relief grid by specifying the special name
18+
19+
@srtm_relief[_\ *rru*\]
20+
21+
The SRTM (version 3) 1 and 3 arc-sec tiles are only available over land between 60 degrees south and north latitude.
22+
This dataset contains a digital elevation model (DEM) of Earth using radar interferometry.
23+
The following codes for the optional *rr*\ *u* are supported:
24+
25+
.. _tbl-srtm_relief:
26+
27+
==== ================= === ======= ==================================================
28+
Code Dimensions Reg Size Description
29+
==== ================= === ======= ==================================================
30+
03s 432001 x 216001 g 6.8 GB 3 arc second global relief (SRTM3S original)
31+
01s 1296001 x 432001 g 41 GB 1 arc second global relief (SRTM1S original)
32+
==== ================= === ======= ==================================================
33+
34+
Note that both resolutions are tiled.
35+
See :gmt-docs:`Remote Datasets <datasets/remote-data.html>` for more information.
36+
37+
See :gmt-docs:`GMT remote dataset usage <datasets/remote-data.html#usage>` for when resolution codes are optional or required.
38+
All of these data will, when downloaded, be placed in your ~/.gmt/server directory, with
39+
the srtm_relief files being placed in an ``earth/earth_relief`` sub-directory. If you
40+
do not specify a CPT then the default CPT for this dataset (the GMT master *geo* CPT) will be used.
41+
42+
Technical Information
43+
~~~~~~~~~~~~~~~~~~~~~
44+
45+
The 3 and 1 arc second data are the SRTM 1x1 degree tiles from NASA. The data is stored as highly compressed JPEG2000 tiles on the GMT server.
46+
These are individually downloaded as requested, converted to netCDF grids and stored in subdirectories srtm1 and srtm3 under the server directory,
47+
and assembled into a seamless grid using grdblend.
48+
**Note**: This dataset is utilized by other relief grids (e.g., earth_relief) when resolutions of 03s or 01s are requested. In these cases, the other grid is automatically up-sampled to fill in missing values over the oceans and in high-latitude regions (above 60°).
49+
50+
Data References
51+
~~~~~~~~~~~~~~~
52+
53+
#. SRTMGL3 tiles: [https://lpdaac.usgs.gov/products/srtmgl3v003].
54+
#. SRTMGL1 tiles: [https://lpdaac.usgs.gov/products/srtmgl1v003].

scripts/GMT_srtm_relief.sh

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
gmt begin GMT_srtm_relief jpg
2+
gmt set GMT_THEME cookbook GMT_DATA_SERVER candidate
3+
gmt grdclip @earth_relief_10m -Gearth_relief.nc -Sb0/NaN -R-180/180/-60/60
4+
gmt basemap -Rd -JQ0/15c -B+g128
5+
gmt grdimage earth_relief.nc -I -Q
6+
gmt coast -Da -W1/0.2p
7+
gmt psconvert -A -P -E150 -FGMT_srtm_relief_thumbnail -Tj
8+
gmt end
9+
10+
rm -f gmt.conf gmt.history earth_relief.nc
11+
mv GMT_srtm_relief.jpg ../docs/_static/
12+
mv GMT_srtm_relief_thumbnail.jpg ../docs/_static/

0 commit comments

Comments
 (0)