1CPTCLIP(1)                       User commands                      CPTCLIP(1)
2
3
4

NAME

6       cptclip - extract a sub-table from a GMT colour palette table (cpt).
7

SYNOPSIS

9       cptclip -R min/max [-h] [-o file] [-s] [-v] [-V] [file]
10

DESCRIPTION

12       The cptclip utility extracts a sub-table from a cpt format file. The
13       arguments to the mandatory -R option, min/max, are interpreted as the
14       (z) limits of the output unless the -s switch is specified, in which
15       case they are the segment numbers.
16
17       The program will read from stdin if a file is not specified as the
18       final argument, and write to stdout if the -o option is not specified.
19
20       Note that much of the functionality of this program is included in
21       recent versions of the GMT program makecpt(1).
22

OPTIONS

24       --backtrace-file path
25           Specify a file to which to write a formatted backtrace. The file
26           will only be created if there is a backtrace created, typically
27           when an error occurs.
28
29       --backtrace-format format
30           Specify the format of the backtrace written to the files specified
31           by --backtrace-file, one of plain, xml or json.
32
33       -h, --help
34           Brief help.
35
36       -o, --output file
37           Write the output to file, rather than stdout.
38
39       -R, --range min/max
40           The (z) range of the output, or the segments if the -s switch is
41           also given.
42
43       -s, --segments
44           The min and max arguments of the -R switch are interpreted as the
45           segment numbers (starting at one).
46
47       -v, --verbose
48           Verbose operation.
49
50       -V, --version
51           Version information.
52

EXAMPLES

54       Extract the table with z-range from 2.5 to 5:
55
56           cptclip -v -o new.cpt -R 2.5/5 old.cpt
57
58       Extract the table with the first 5 segments:
59
60           cptclip -v -s -o new.cpt -R 1/5 old.cpt
61

AUTHOR

63       J. J. Green
64

SEE ALSO

66       GMT(1), makecpt(1).
67
68
69
70CPTUTILS                       9 September 2020                     CPTCLIP(1)
Impressum