PSMASK
Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index
Return to Main Contents
NAME
psmask - To clip or mask areas of no data on a map
SYNOPSIS
psmask [xyzfile] -Idx[m|c][/dy[m|c]] -Jparameters
-Rwest/east/south/north[r] [ -Btickinfo ] [ -Cradius[m|c] ]
[ -Ddumpfile ] [ -Eazimuth/elevation ] [ -Fred/green/blue ] [ -Gr/g/b ]
[ -H ] [ -K ] [ -N ] [ -O ] [ -P ] [ -S ] [ -T ]
[ -U[/dx/dy/][label] ] [ -V ] [ -Xx-shift ] [ -Yy-shift ]
[ -ccopies ] [ -: ] [ -b[d] ]
DESCRIPTION
psmask reads a (x,y,z) file [or standard input] and uses this information to find out
which grid cells are reliable. Only gridcells which have one or more data points are considered
reliable. As an option, you may specify a radius of influence. Then, all gridcells that are
within radius of a data point are considered reliable. Furthermore, an option is provided to
reverse the sense of the test. Having found the reliable/not reliable points, psmask will
either paint tiles to mask these nodes (with the -T) switch, or use contouring to create
polygons that will clip out regions of no interest.
- xyzfile
-
File with (x,y,z) values (e.g., that was used to run surface). If no file
is given, standard input is read. For binary files, see -b.
- -I
-
dx [and optionally dy] are the size of the gridblocks. Append m to indicate minutes, or c to indicate seconds.
#include "explain_-j.txt"
#include "explain_-R.txt"
OPTIONS
No space between the option flag and the associated arguments
#include "explain_-b.txt"
- -C
-
Sets radius of influence. Grid nodes within radius of a data point are considered reliable. [Default is 0, which
means that only grid cells with data in them are reliable]. Append m to indicate minutes, or c to indicate seconds.
- -D
-
Dumps out the resulting clipping polygons to disk. Ignored if -T is set.
- -E
-
Sets the viewpoint's azimuth and elevation for perspective plots [180/90]
- -F
-
Sets the color used for Frame and annotation. [Default is black]
- -G
-
Paint the clip polygons [or tiles] with the gray-shade (0-255) or color (r/g/b, each 0-255) [Default is no fill]
#include "explain_-H.txt"
Not used with binary data.
#include "explain_-K.txt"
- -N
-
Invert the sense of the test, i.e. clip regions where there is data coverage.
#include "explain_-O.txt"
#include "explain_-P.txt"
- -S
-
Mark end of existing clip path. No input file is needed. Implicitly sets -O.
- -T
-
Plot tiles instead of clip polygons (Only works with -Jx, -Jm, -Jq, and -Jy).
#include "explain_-U.txt"
#include "explain_-V.txt"
#include "explain_-XY.txt"
#include "explain_-t.txt"
#include "explain_-c.txt"
EXAMPLES
To make an overlay PostScript file that will mask out the regions of a contour map
where there is no control data using clip polygons, try:
psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10 -O -K > mask.ps
The same example but this time we use tiling:
psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10 -T -O -K > mask.ps
SEE ALSO
gmt, surface, psbasemap, psclip
#include "refs.i"
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 07:10:54 GMT, January 07, 2025