BLOCKMEAN

Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index Return to Main Contents
 

NAME

blockmean - filter to block average (x,y,z) data by L2 norm  

SYNOPSIS

blockmean [ xyz[w]file(s) ] -Ix_inc[m|c][/y_inc[m]] -Rwest/east/south/north[r] [ -H ] [ -N ] [ -V ] [ -W[io] ] [ -: ] [ -b[i|o][d] ]  

DESCRIPTION

blockmean reads arbitrarily located (x,y,z) triples [or optionally weighted quadruples (x,y,z,w)] from standard input [or xyz[w]file(s)] and writes to standard output a mean position and value for every non-empty block in a grid region defined by the -R and -I arguments. Either blockmean or blockmedian should be used as a pre-processor before running surface to avoid aliasing short wavelengths. These routines are also generally useful for decimating or averaging (x,y,z) data. You can modify the precision of the output format by editing the D_FORMAT parameter in your .gmtdefaults file, or you may choose binary input and/or output using single or double precision storage.
xyz[w]file(s)
3 [or 4] column ASCII file(s) [or binary, see -b] holding (x,y,z [w]) data values. [w] is an optional weight for the data. If no file is specified, blockmean will read from standard input.
-I
x_inc [and optionally y_inc] is the block size. Append m to indicate minutes or c to indicate seconds. #include "explain_-R.txt"
 

OPTIONS

#include "explain_-H.txt" Not used with binary data.

-N
Offsets the grid registration of the boxes. Use pixel registration instead of grid registration. By default, the centers of the blocks coincide with the defined lattice nodes; each block contains all points nearest to a lattice node. The -N option will offset the blocks so their edges coincide with the lattice lines. For example, suppose the arguments are -R10/15/10/15 and -I1 This defines a 6 x 6 block array; the lower left block will average data within 9.5 <= (x,y) < 10.5. If the same lattice is given with the -N option, the block array is 5 x 5 and the lower left block will average the data within 10 <= (x,y) < 11. The default registration is normally used for preprocessing and gridding map data. #include "explain_-V.txt"
-W
Weighted modifier[s]. Unweighted input and output has 3 columns x,y,z; Weighted i/o has 4 columns x,y,z,w. Weights can be used in input to construct weighted mean values in blocks. Weight sums can be reported in output for later combining several runs, etc. Use -W for weighted i/o, -Wi for weighted input only, -Wo for weighted output only. [Default uses unweighted i/o] #include "explain_-t.txt"
-b
Selects binary input and output mode. Append i or o to select single precision binary input or output only [Default is ASCII]. Append d to indicate double precision for binary data (if both binary input and output are selected they will have the same precision).
 

EXAMPLES

To find 5 by 5 minute block means from the ASCII data in hawaii.xyg, try

blockmean hawaii.xyg -R198/208/18/25 -I5m > hawaii_5x5.xyg  

SEE ALSO

blockmedian, gmtdefaults, gmt, nearneighbor, surface, triangulate #include "refs.i"


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO

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