GMT Remote Datasets
A remote data set is a data set that is stored on one or more remote servers. It may be a single grid file or a collection of subset tiles making up a larger grid. They are not distributed with GMT or installed during the installation procedures. GMT offers several remote global data grids that you can access via our remote file mechanism. The first time you access one of these files, GMT will download the file (or a subset tile) from the selected GMT server and save it to the server directory under your GMT user directory [~/.gmt]. From then on we read the local file from there.
We have processed and reformatted publicly available global data sets (grids and images) and standardized their file names. In GMT, you may access such data (or a subset only by using the region
option) by specifying the special name
@remote_name_rru[_reg]
Please refer to the GMT page for details of what is the remote
, name
, rru
and reg
parts of the name. Another very important aspect is that given the file sizes of the higher resolution versions (can reach out 41 GB), grids with resolutions higher or equal "5m" (five arc-minutes) are tilled to minimize the amount of necessary download data.
But in order to simplify accessing these data sets we have a helper function, remotegrid, that facilitates the name composability. For example, remotegrid("relief", res="6m")
returns the string"@earth_relief_06m"
that can be passed to modules that create images (viz
, grdimage, gmtread, grdcut, grdcontour, etc..)
The examples in next pages show the available dataset and use the remotegrid
function to compose their names but your, ofc, free to use the full dataset name if you feel comfortable with it.
These docs were autogenerated using GMT: v1.11.0