File: grdfilter.html

package info (click to toggle)
gmt-doc 3.4-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 4,756 kB
  • ctags: 1,800
  • sloc: makefile: 30
file content (132 lines) | stat: -rw-r--r-- 4,546 bytes parent folder | download | duplicates (2)
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
<HTML>
<HEAD>
<TITLE>grdfilter</TITLE>
</HEAD>
<BODY>
<H1>grdfilter</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
       grdfilter - Filter a <I>.grd</I> file in the Time domain


</PRE>
<H2>SYNOPSIS</H2><PRE>
       <B>grdfilter</B>  <I>input</I><B>_</B><I>file.grd</I>  <B>-D</B><I>flag</I>  <B>-F</B><I>&lt;type&gt;&lt;width&gt;</I>  <B>-G</B><I>out</I>
       <I>put</I><B>_</B><I>file.grd</I>    [    <B>-I</B><I>x</I><B>_</B><I>inc</I>[<B>m|c</B>][/<I>y</I><B>_</B><I>inc</I>[<B>m|c</B>]]     ]     [
       <B>-R</B><I>west/east/south/north</I>[<I>r</I>] ] [ <B>-T</B> ] [ <B>-V</B> ]


</PRE>
<H2>DESCRIPTION</H2><PRE>
       <B>grdfilter</B> will filter a <I>.grd</I> file in the time domain using
       a boxcar, cosine arch, gaussian, median,  or  mode  filter
       and  computing  distances  using  Cartesian  or  Spherical
       geometries.  The output <I>.grd</I> file can optionally be gener
       ated  as  a  sub<B>-R</B>egion  of  the  input  and/or with a new
       <B>-I</B>ncrement. In this way, one may have "extra space" in the
       input data so that the edges will not be used and the out
       put can be within one-half- width of the input  edges.  If
       the  filter  is low-pass, then the output may be less fre
       quently sampled than the input.

       <I>input</I><B>_</B><I>file.grd</I>
              The file of points to be filtered.

       <B>-D</B>     Distance <I>flag</I> tells how grid (x,y) relates to  fil
              ter <I>width</I> as follows:

              <I>flag</I> = 0: grid (x,y) same units as <I>width</I>, Cartesian
              distances.
              <I>flag</I> = 1: grid (x,y) in degrees, <I>width</I>  in  kilome
              ters, Cartesian distances.
              <I>flag</I>  =  2:  grid (x,y) in degrees, <I>width</I> in km, dx
              scaled by cos(middle y), Cartesian distances.

              The above options are fastest  because  they  allow
              weight  matrix  to be computed only once.  The next
              two  options  are  slower  because  they  recompute
              weights for each East-West scan line.

              <I>flag</I>  =  3:  grid (x,y) in degrees, <I>width</I> in km, dx
              scaled by cosine(y),  Cartesian  distance  calcula
              tion.
              <I>flag</I>  =  4:  grid  (x,y)  in  degrees, <I>width</I> in km,
              Spherical distance calculation.

       <B>-F</B>     Choose one only of  <B>bcgmp</B>  for  (<B>b</B>)oxcar,  (<B>c</B>)osine
              Arch,  (<B>g</B>)aussian,  (<B>m</B>)edian, or maximum likelihood
              (<B>p</B>)robability (a mode estimator) filter and specify
              full <I>width</I>.

       <B>-G</B>     <I>output</I><B>_</B><I>file.grd</I> is the output of the filter.


</PRE>
<H2>OPTIONS</H2><PRE>
       <B>-I</B>     <I>x</I><B>_</B><I>inc</I>  [and  optionally <I>y</I><B>_</B><I>inc</I>] is the output Incre
              integer multiples of the old  ones  (in  the  input
              data),   filtering  will  be  considerably  slower.
              [Default: Same as input.]

       <B>-R</B>     <I>west,</I> <I>east,</I> <I>south,</I> and <I>north</I> defines the Region  of
              the output points. [Default: Same as input.]

       <B>-T</B>     Toggle the node registration for the output grid so
              as  to  become  the  opposite  of  the  input  grid
              [Default  gives  the same registration as the input
              grid].

       <B>-V</B>     Selects verbose  mode,  which  will  send  progress
              reports to stderr [Default runs "silently"].


</PRE>
<H2>EXAMPLES</H2><PRE>
       Suppose that north_pacific_dbdb5.grd is a file of 5 minute
       bathymetry from 140E to 260E and 0N to 50N, and  you  want
       to find the medians of values within a 300km radius (600km
       full width) of the output points, which you choose  to  be
       from  150E to 250E and 10N to 40N, and you want the output
       values every 0.5 degree. Using spherical distance calcula
       tions, you need:

       grdfilter  north_pacific_dbdb5.grd  <B>-G</B>filtered_pacific.grd
       <B>-Fm</B>600 <B>-D</B>4 <B>-R</B>150/250/10/40 <B>-I</B>0.5 <B>-V</B>


</PRE>
<H2>SEE ALSO</H2><PRE>
       <I>gmt</I>(l), <I><A HREF="grdfft.html">grdfft</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">