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