1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
<HTML>
<HEAD>
<TITLE>psscale</TITLE>
</HEAD>
<BODY>
<H1>psscale</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
psscale - Create grayscale or colorscale for maps
</PRE>
<H2>SYNOPSIS</H2><PRE>
<B>psscale</B> <B>-D</B><I>xpos/ypos/length/width[h]</I> [ <B>-B</B><I>tickinfo</I> ] [
<B>-C</B><I>cpt</I><B>_</B><I>file</I> ] [ <B>-E</B>[<I>length</I>] ] [ <B>-I</B>[<I>max</I><B>_</B><I>intens</I>] ] [ <B>-K</B> ] [ <B>-L</B>
] [ <B>-M</B> ] [ <B>-N</B><I>dpi</I> ] [ <B>-O</B> ] [ <B>-P</B> ] [ <B>-U</B>[<I>/dx/dy/</I>][<I>label</I>] ] [
<B>-V</B> ] [ <B>-X</B><I>x-shift</I> ] [ <B>-Y</B><I>y-shift</I> ] [ <B>-Z</B><I>zfile</I> ] [ <B>-c</B><I>copies</I> ]
</PRE>
<H2>DESCRIPTION</H2><PRE>
<B>psscale</B> plots grayscales or colorscales on maps. Both hor
izontal and vertical scales are supported. For cpt_files
with gradational colors (i.e., the lower and upper bound
ary of an interval have different r/g/b values) <B>psscale</B>
will interpolate to give a continuous scale. Variations in
intensity due to shading/illumination may be displayed by
setting the option <B>-I</B>. Colors may be spaced according to a
linear scale, all be equal size, or by providing a file
with individual tile widths.
<B>-D</B> Defines the position of the center/top (for hori
zontal scale) or center/left (for vertical scale)
and the dimensions of the scale. Append <I>h</I> to get a
horizontal scale [Default is vertical].
</PRE>
<H2>OPTIONS</H2><PRE>
No space between the option flag and the associated argu
ments.
<B>-B</B> Set anotation, tick, and gridline interval for the
colorbar. The xaxis label will plot beneath a hori
zontal bar (or vertically to the right of a verti
cal bar). As an option, use the yaxis label to plot
the data unit to the right of a horizontal bar (and
above a vertical bar). If no values are provided,
the default is to anotate every color level (which
may be overridden by ULB flags in the cpt file).
Note that since vertical labels will be plotted as
a column of individual characters, no octal escape
characters imbedded in the label are allowed.
<B>-C</B> <I>cpt</I><B>_</B><I>file</I> is the color palette file to be used. By
default all color changes are anotated. To use a
subset, add an extra column to the cpt-file with a
L, U, or B to anotate Lower, Upper, or Both color
segment boundaries (but see <B>-B</B>). If not given,
<B>psscale</B> will read stdin. As for <B><A HREF="grdview.html">grdview</A></B>, <B>psscale</B>
can understand pattern specifications in the cpt
file.
<B>-E</B> Add sidebar triangles for back- and foreground col
ors. Optionally, append triangle height [Default is
half the barwidth].
of intensities from + to - <I>max</I><B>_</B><I>intens</I>. If not spec
ified, 1.0 is used. [Default is no illumination]
<B>-K</B> More <I>PostScript</I> code will be appended later
[Default terminates the plot system].
<B>-L</B> Gives equal-sized color rectangles. Default scales
rectangles according to the z-range in the cpt-file
(Also see <B>-Z</B>).
<B>-M</B> Force a monochrome graybar using the (television)
YIQ transformation.
<B>-N</B> Effective dots-per-inch for the rectangular image
making up the color scale [300].
<B>-O</B> Selects Overlay plot mode [Default initializes a
new plot system].
<B>-P</B> Selects Portrait plotting mode [<B><A HREF="GMT.html">GMT</A></B> Default is
Landscape, see gmtdefaults to change this].
<B>-U</B> Draw Unix System time stamp on plot. User may spec
ify where the lower left corner of the stamp should
fall on the page relative to lower left corner of
plot. Optionally, append a label, or <B>c</B> (which will
plot the command string.). The GMT parameters
UNIX_TIME and UNIX_TIME_POS can affect the appear
ance; see the <B><A HREF="gmtdefaults.html">gmtdefaults</A></B> man page for details.
<B>-V</B> Selects verbose mode, which will send progress
reports to stderr [Default runs "silently"].
<B>-X</B> <B>-Y</B> Shift origin of plot by (<I>x-shift,y-shift</I>). Prepend
<B>a</B> for absolute coordinates; the default (<B>r</B>) will
reset plot origin.
<B>-Z</B> File with colorbar-width per color entry. By
default, width of entry is scaled to color range,
i.e., z = 0-100 gives twice the width as z =
100-150 (Also see <B>-L</B>).
<B>-c</B> Specifies the number of plot copies. [Default is 1]
</PRE>
<H2>EXAMPLES</H2><PRE>
To append a vertical colorscale (7.5 cm long; 1.25 cm
wide) to the right of a plot that is 6 inch wide and 4
inch high, using illumination, and show back- and fore
ground colors, and anotating every 5 units, try
psscale <B>-D</B>6.5<B>i</B>/2<B>i</B>/7.5<B>c</B>/1.25<B>c</B> <B>-O</B> <B>-C</B>colors.cpt <B>-I</B> <B>-E</B>
<B>-B</B>5:BATHYMETRY:/:m: >> map.ps
When the cpt file is discrete and no illumination is spec
ified, the color bar will be painted using polygons. For
all other cases we must paint with an image. Some color
printers may give slightly different colors for the two
methods given identical RGB values.
</PRE>
<H2>SEE ALSO</H2><PRE>
<I>gmt</I>(l), <I><A HREF="makecpt.html">makecpt</A></I>(l), <I><A HREF="grd2cpt.html">grd2cpt</A></I>(l)
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
<body bgcolor="#ffffff">
|
