PSSCALE

Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index Return to Main Contents
#ifdef SI #define UNIT    cm
#define LEN_1   7.5
#define LEN_2   5
#define LEN_3   15
#define LEN_4   10
#define SCALE   -D16.5/5/7.5/1.25
#else #define UNIT    inch
#define LEN_1   3
#define LEN_2   0.5
#define LEN_3   6
#define LEN_4   4
#define SCALE   -D6.5/2/3/0.5
#endif  

NAME

psscale - Create grayscale or colorscale for maps  

SYNOPSIS

psscale -Ccpt_file -Dxpos/ypos/length/width[h] [ -Btickinfo ] [ -Fred/green/blue ] [ -I[max_intens] ] [ -K ] [ -L ] [ -Ndpi ] [ -O ] [ -P ] [ -U[/dx/dy/][label] ] [ -V ] [ -Xx-shift ] [ -Yy-shift ] [ -Zzfile ] [ -ccopies ] [ -0 || -1 || -2 ]  

DESCRIPTION

psscale plots grayscales or colorscales on maps. Both horizontal and vertical scales are supported. For cpt_files with gradational colors (i.e., the lower and upper boundary of an interval have different r/g/b values) psscale will interpolate to give a continuous scale. Variations in intensity due to shading/illumination may be displayed by setting the option -I. Colors may be spaced according to a linear scale, all be equal size, or by providing a file with individual tile widths.
-C
cpt_file 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.
-D
Defines the position of the center/top (for horizontal scale) or center/left (for vertical scale) and the dimensions of the scale. Append h to get a horizontal scale [Default is vertical].
 

OPTIONS

No space between the option flag and the associated arguments.
-B
Here, only used to set the scale label, i.e., -B:."Scale label:". Note that since vertical labels will be plotted as a column of individual characters, no octal escape characters imbedded in the label are allowed.
-F
Sets the color used for Frame and annotations. [Default is black]
-I
Add illumination effects. Optionally, set the range of intensities from + to - max_intens. If not specify, 1.0 is used. [Default is no illumination] #include "explain_-K.txt"
-L
Gives equal-sized color rectangles. Default scales rectangles according to the z-range in the cpt-file (Also see -Z).
-N
Effective dots-per-inch for the rectangular image making up the color scale [50]. #include "explain_-O.txt" #include "explain_-P.txt" #include "explain_-U.txt" #include "explain_-V.txt" #include "explain_-XY.txt"
-Z
File with colorbar-width in UNIT 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 -L). #include "explain_-c.txt"
-0
Create the scale using the Adobe PostScript colorimage operator. This is the GMT default (which can be modified in the .gmtdefaults file).
-1
Create the scale by plotting individually colored tiles.
-2
Create the scale by color separation using three calls to image for later processing by psto24.
 

EXAMPLES

To append a vertical colorscale (LEN_1 UNIT long; LEN_2 UNIT wide) to the right of a plot that is LEN_3 UNIT wide and LEN_4 UNIT high, using illumination, try

psscale SCALE -O -Ccolors.cpt -I -B:.BATHYMETRY: >> map.ps  

SEE ALSO

gmt, makecpt, grd2cpt #include "refs.i"


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 07:11:25 GMT, January 07, 2025