1GMTWHICH(1)                           GMT                          GMTWHICH(1)
2
3
4

NAME

6       gmtwhich - Find full path to specified files
7

SYNOPSIS

9       gmtwhich files [  -A ] [  -C ] [  -D ] [  -G ] [  -V[level] ]
10
11       Note:  No  space  is allowed between the option flag and the associated
12       arguments.
13

DESCRIPTION

15       gmtwhich reports the full paths to the files given on the command line.
16       We  look for the file in (1) the current directory, (2) in $GMT_USERDIR
17       (if defined), (3) in $GMT_DATADIR (if defined), or (4) in $GMT_CACHEDIR
18       (if  defined).  If  found we print the full path name to the file, just
19       the directory (see -D), or a confirmation (see  -C).  The  $GMT_USERDIR
20       and  $GMT_DATADIR  environment variables can be colon-separated list of
21       directories, and we search recursively down  any  directory  that  ends
22       with  / (i.e., /export/data is a single directory whereas /export/data/
23       will be searched recursively.)
24

REQUIRED ARGUMENTS

26       files  One or more file names of any data type (grids, tables, etc.).
27

OPTIONAL ARGUMENTS

29       -A     Only consider  files  that  the  user  has  permission  to  read
30              [Default consider all files found].
31
32       -C     Instead  of reporting the paths, print the confirmation Y if the
33              file is found and N if it is not.
34
35       -D     Instead of reporting the paths, print the directories that  con‐
36              tains the files.
37
38       -G     If  a  file argument is a downloadable file (either a full UR, a
39              @file  for   downloading   from   the   GMT   Site   Cache,   or
40              earth_relief_*.grd)  we  will  try  to  download the file if not
41              found in your local data or cache dirs.
42
43       -V[level] (more ...)
44              Select verbosity level [c].
45
46       -^ or just -
47              Print a short message about the  syntax  of  the  command,  then
48              exits (NOTE: on Windows just use -).
49
50       -+ or just +
51              Print  an extensive usage (help) message, including the explana‐
52              tion of any module-specific  option  (but  not  the  GMT  common
53              options), then exits.
54
55       -? or no arguments
56              Print a complete usage (help) message, including the explanation
57              of all options, then exits.
58

EXAMPLES

60       To see the full path to the file myjunk.txt, use
61
62              gmt which myjunk.txt
63
64       To download the 10 arc-minute global relief  file  from  the  GMT  data
65       site, use
66
67              gmt which -G earth_relief_10m.grd
68
69       which  will  print the path (after downloading if not already present).
70       The file will be placed in the user's GMT_USER_DIR.  To  obtain  a  GMT
71       example or test file from the GMT cache site, try
72
73              gmt which -G @hotspots.txt
74
75       which  will  print the path (after downloading if not already present).
76       The file will be placed in the user's GMT_CACHE_DIR directory.
77

SEE ALSO

79       gmt
80

82       2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
83
84
85
86
875.4.5                            Feb 24, 2019                      GMTWHICH(1)
Impressum