1PSSCALE(1) Generic Mapping Tools PSSCALE(1)
2
6 psscale - Plot gray scale or color scale on maps
7
9 psscale -Dxpos/ypos/length/width[h] [ -A ] [ -B[p|s]parameters ] [
10 -Ccpt_file ] [ -E[b|f][length] ] [ -I[max_intens|low_i/high_i] ] [ -K ]
11 [ -L[i][gap] ] [ -M ] [ -Ndpi ] [ -O ] [ -P ] [ -Q ] [
12 -U[just/dx/dy/][c|label] ] [ -V ] [ -X[a|c|r][x-shift[u]] ] [
13 -Y[a|c|r][y-shift[u]] ] [ -Zzfile ] [ -ccopies ]
14
16 psscale plots gray scales or color scales on maps. Both horizontal and
17 vertical scales are supported. For cpt_files with gradational colors
18 (i.e., the lower and upper boundary of an interval have different r/g/b
19 values) psscale will interpolate to give a continuous scale. Varia‐
20 tions in intensity due to shading/illumination may be displayed by set‐
21 ting the option -I. Colors may be spaced according to a linear scale,
22 all be equal size, or by providing a file with individual tile widths.
23 -D Defines the position of the center/top (for horizontal scale) or
25 center/left (for vertical scale) and the dimensions of the
26 scale. Give a negative length to reverse the scalebar. Append
27 h to get a horizontal scale [Default is vertical].
28
30 No space between the option flag and the associated arguments.
31 -A Place annotations above (instead of below) horizontal scalebars
33 and to the left (instead of the right) of vertical scalebars.
34 -B Set annotation, tick, and gridline interval for the colorbar.
36 The xaxis label will plot beneath a horizontal bar (or verti‐
37 cally to the right of a vertical bar). As an option, use the
38 yaxis label to plot the data unit to the right of a horizontal
39 bar (and above a vertical bar). If no values are provided, the
40 default is to annotate every color level (which may be overrid‐
41 den by ULB flags in the cpt file). Note that since vertical
42 labels will be plotted as a column of individual characters, no
43 octal escape characters embedded in the label are allowed. Text
44 with such characters will be plotted horizontally (relative to
45 the color scale). By default, labels are generated from the
46 numerical entries. To specify custom text labels for intervals,
47 you must append ;label to each z-slice in the cpt file.
48 -C cpt_file is the color palette file to be used. By default all
50 color changes are annotated. To use a subset, add an extra col‐
51 umn to the cpt-file with a L, U, or B to annotate Lower, Upper,
52 or Both color segment boundaries (but see -B). If not given,
53 psscale will read stdin. As for grdview, psscale can understand
54 pattern specifications in the cpt file.
55 -E Add sidebar triangles for back- and/or foreground colors. Add f
57 or b for only one sidebar triangle [Default gives both].
58 Optionally, append triangle height [Default is half the bar‐
59 width].
60 -I Add illumination effects. Optionally, set the range of intensi‐
62 ties from - to + max_intens. If not specified, 1 is used.
63 Alternatively, append low/high intensities to specify an asym‐
64 metric range [Default is no illumination].
65 -K More PostScript code will be appended later [Default terminates
67 the plot system].
68 -L Gives equal-sized color rectangles. Default scales rectangles
70 according to the z-range in the cpt-file (Also see -Z). If
71 set, any equal interval annotation set with -B will be ignored.
72 If gap is appended and the cpt table is discrete we will center
73 each annotation on each rectangle, using the lower boundary z-
74 value for the annotation. If i is prepended we annotate the
75 interval range instead. If -I is used then each rectangle will
76 have its constant color modified by the specified intensity.
77 -M Force a monochrome graybar using the (television) YIQ transfor‐
79 mation.
80 -N Effective dots-per-inch for the rectangular image making up the
82 color scale [300].
83 -O Selects Overlay plot mode [Default initializes a new plot sys‐
85 tem].
86 -P Selects Portrait plotting mode [Default is Landscape, see gmtde‐
88 faults to change this].
89 -Q Select logarithmic scale and power of ten annotations. All z-
91 values in the cpt file will be converted to p = log10(z) and
92 only integer p values will be annotated using the 10^p format
93 [Default is linear scale].
94 -S Do not separate different colour intervals with black lines.
96 -U Draw Unix System time stamp on plot. By adding just/dx/dy/, the
98 user may specify the justification of the stamp and where the
99 stamp should fall on the page relative to lower left corner of
100 the plot. For example, BL/0/0 will align the lower left corner
101 of the time stamp with the lower left corner of the plot.
102 Optionally, append a label, or c (which will plot the command
103 string.). The GMT parameters UNIX_TIME, UNIX_TIME_POS, and
104 UNIX_TIME_FORMAT can affect the appearance; see the gmtdefaults
105 man page for details. The time string will be in the locale set
106 by the environment variable TZ (generally local time).
107 -V Selects verbose mode, which will send progress reports to stderr
109 [Default runs "silently"].
110 -X -Y Shift plot origin relative to the current origin by (x-shift,y-
112 shift) and optionally append the length unit (c, i, m, p). You
113 can prepend a to shift the origin back to the original position
114 after plotting, or prepend r [Default] to reset the current
115 origin to the new location. If -O is used then the default (x-
116 shift,y-shift) is (0,0), otherwise it is (r1i, r1i) or (r2.5c,
117 r2.5c). Alternatively, give c to align the center coordinate (x
118 or y) of the plot with the center of the page based on current
119 page size.
120 -Z File with colorbar-width per color entry. By default, width of
122 entry is scaled to color range, i.e., z = 0-100 gives twice the
123 width as z = 100-150 (Also see -L).
124 -c Specifies the number of plot copies. [Default is 1].
126
128 To append a vertical color scale (7.5 cm long; 1.25 cm wide) to the
129 right of a plot that is 6 inch wide and 4 inch high, using illumina‐
130 tion, and show back- and foreground colors, and annotating every 5
131 units, use
132 psscale -D6.5i/2i/7.5c/1.25c -O -Ccolors.cpt -I -E -B5:BATHYMETRY:/:m:
134 >> map.ps
135
137 When the cpt file is discrete and no illumination is specified, the
138 color bar will be painted using polygons. For all other cases we must
139 paint with an image. Some color printers may give slightly different
140 colors for the two methods given identical RGB values.
141
143 GMT(1), makecpt(1), grd2cpt(1)
144GMT 4.3.1 15 May 2008 PSSCALE(1)