- pygmt.which(fname, *, download=None, verbose=None, **kwargs)[source]
Find the full path to specified files.
Reports the full paths to the files given through
fname. We look for the file in (1) the current directory, (2) in $GMT_USERDIR (if defined), (3) in $GMT_DATADIR (if defined), or (4) in $GMT_CACHEDIR (if defined).
fnamecan also be a downloadable file (either a full URL, a @file special file for downloading from the GMT Site Cache, or @earth_relief_* topography grids). In these cases, use parameter
downloadto set the desired behavior. If
downloadis not used (or False), the file will not be found.
Full option list at https://docs.generic-mapping-tools.org/latest/gmtwhich.html
G = download
V = verbose
fname (str or list) – One or more file names of any data type (grids, tables, etc.).
download (bool or str) – [a|c|l|u]. If the fname argument is a downloadable file (either a complete URL, an @file for downloading from the GMT data server, or @earth_relief_xxy) we will try to download the file if it is not found in your local data or cache dirs. By default [
download="l"] we download to the current directory. Use a to place files in the appropriate folder under the user directory (this is where GMT normally places downloaded files), c to place it in the user cache directory, or u for the user data directory instead (i.e., ignoring any subdirectory structure).
Select verbosity level [Default is w], which modulates the messages written to stderr. Choose among 7 levels of verbosity:
q - Quiet, not even fatal error messages are produced
e - Error messages only
w - Warnings [Default]
t - Timings (report runtimes for time-intensive algorithms)
i - Informational messages (same as
c - Compatibility warnings
d - Debugging messages
path (str or list) – The path(s) to the file(s), depending on the parameters used.
FileNotFoundError – If the file is not found.