File: sample1d.html

package info (click to toggle)
gmt-doc 3.4-1.1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 4,756 kB
  • ctags: 1,800
  • sloc: makefile: 30
file content (132 lines) | stat: -rw-r--r-- 4,326 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>sample1d</TITLE>
</HEAD>
<BODY>
<H1>sample1d</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
       sample1d - Resampling of 1-D data sets


</PRE>
<H2>SYNOPSIS</H2><PRE>
       <B>sample1d</B>  <I>infile</I>  [  <B>-Fl|a|c</B>  ]  [ <B>-H</B>[<I>nrec</I>] ] [ <B>-I</B><I>xinc</I> ] [
       <B>-M</B>[<I>flag</I>] ] [ <B>-N</B><I>knotfile</I> ] [ <B>-S</B><I>xstart</I> ] [ <B>-T</B><I>x-col</I>] [ <B>-V</B> <B>]</B> <B>[</B>
       <B>-bi[s][</B><I>n</I><B>]</B> <B>]</B> <B>[</B> <B>-bo[s]</B> <B>]</B>


</PRE>
<H2>DESCRIPTION</H2><PRE>
       <B>sample1d</B>  reads  a multi-column ASCII [or binary] data set
       from file [or standard  input]  and  resamples  the  time
       series/profile  at locations where the user needs the val
       ues. The user must provide the column number of the  inde
       pendent (monotonically increasing <B>or</B> decreasing) variable.
       Equidistant or arbitrary sampling  can  be  selected.  All
       columns  are resampled based on the new sampling interval.
       Several interpolation schemes are available.

       <I>infile</I> This is a multi-column ASCII [of  binary,  see  <B>-b</B>]
              file  with  one  column  containing the independent
              variable (which must be monotonically  in/de-creas
              ing)  and  the remaining columns holding misc. data
              values.  If no file  is  provided,  sample1d  reads
              from standard input.


</PRE>
<H2>OPTIONS</H2><PRE>
       No  space between the option flag and the associated argu
       ments.

       <B>-F</B>     Choose from <B>l</B> (Linear), <B>a</B>  (Akima  spline),  and  <B>c</B>
              (natural  cubic  spline) [Default is <B>-Fa</B>].  You may
              change the default interpolant; see INTERPOLANT  in
              your .gmtdefaults file.

       <B>-H</B>     Input  file(s)  has  Header  record(s).  Number  of
              header records can be changed by editing your .gmt
              defaults  file.  If  used,  <B><A HREF="GMT.html">GMT</A></B> default is 1 header
              record.

       <B>-I</B>     <I>xinc</I> defines the sampling interval. [Default is the
              separation  between  the  first  and second abcissa
              point in the <I>infile</I>]

       <B>-M</B>     Multiple segment file. Segments are separated by  a
              record  whose first character is <I>flag</I>.  [Default is
              '&gt;'].

       <B>-N</B>     <I>knotfile</I> is an optional ASCII file with the x loca
              tions  where  the data set will be resampled in the
              first column

       <B>-S</B>     For  equidistant  sampling,  <I>xstart</I>  indicates  the
              location of the first output value. [Default is the

       <B>-T</B>     Sets  the column number of the independent variable
              [Default is 0 (first)].

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

       <B>-bi</B>    Selects binary input. Append <B>s</B> for single precision
              [Default is double].  Append <I>n</I> for  the  number  of
              columns  in  the binary file(s).  [Default is 2 (or
              at least the number of columns implied by <B>-T</B>].

       <B>-bo</B>    Selects binary output. Append <B>s</B> for  single  preci
              sion [Default is double].


</PRE>
<H2>EXAMPLES</H2><PRE>
       To   resample  the  file  profiles.tdgmb,  which  contains
       (time,distance,gravity,magnetics,bathymetry)  records,  at
       1km equidistant intervals using Akima's spline, try'

       sample1d    profiles.tdgmb    <B>-I</B>1    <B>-Fa</B>    <B>-T</B>1   &gt;   pro
       files_equi_d.tdgmb

       To resample the file depths.dt at positions listed in  the
       file  grav_pos.dg, using a cubic spline for the interpola
       tion, try

       sample1d depths.dt <B>-N</B>grav_pos.dg <B>-Fc</B> &gt; new_depths.dt


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