File: pswiggle.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 (290 lines) | stat: -rw-r--r-- 11,536 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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
<HTML>
<HEAD>
<TITLE>pswiggle</TITLE>
</HEAD>
<BODY>
<H1>pswiggle</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
       pswiggle - Plot anomaly along track on a map


</PRE>
<H2>SYNOPSIS</H2><PRE>
       <B>pswiggle</B> <I>xyz</I><B>_</B><I>files</I> <B>-J</B><I>parameters</I> <B>-R</B><I>west/east/south/north</I>[<B>r</B>]
       <B>-Z</B><I>scale</I> [ <B>-A</B><I>azimuth</I> ] [ <B>-B</B><I>tickinfo</I> ] [ <B>-C</B><I>center</I> ] [  <B>-D</B><I>gap</I>
       ]  [  <B>-E</B><I>azimuth/elevation</I>  ]  [ <B>-G</B><I>fillrgb</I> ] [ <B>-H</B>[<I>nrec</I>] ] [
       <B>-I</B><I>fix</I><B>_</B><I>az</I> ] [ <B>-K</B> ] [ <B>-M</B>[<I>flag</I>] ] [ <B>-N</B> ] [ <B>-O</B>  ]  [  <B>-P</B>  ]  [
       <B>-S</B>[<B>x</B>]<I>lon0/lat0/length</I>[<I>units</I>]   ]   [   <B>-T</B><I>track</I><B>_</B><I>pen</I>   ]   [
       <B>-U</B>[<I>/dx/dy/</I>][<I>label</I>] ] [ <B>-V</B>  ] [ <B>-W</B><I>wiggle</I><B>_</B><I>pen</I> ] [  <B>-X</B><I>x-shift</I>
       ] [ <B>-Y</B><I>y-shift</I> ] [ <B>-c</B><I>copies</I> ] [ <B>-:</B> ] [ <B>-bi</B>[<B>s</B>][<I>n</I>] ]


</PRE>
<H2>DESCRIPTION</H2><PRE>
       <B>pswiggle</B>  reads  (x,y,z)  triplets from files [or standard
       input] and plots z as a function of distance along  track.
       This  means  that  two consecutive (x,y) points define the
       local distance axis, and the local z axis is then  perpen
       dicular to the distance axis. The user may set a preferred
       positive anomaly plot direction, and if the positive  nor
       mal  is outside the plus/minus 90 degree window around the
       preferred direction, then 180 degrees  are  added  to  the
       direction.  Either the positive or the negative wiggle may
       be shaded. The resulting <I>PostScript</I>  code  is  written  to
       standard output.

       <I>files</I>  List one or more file-names. If no files are given,
              <B>pswiggle</B> will read standard input.

       <B>-J</B>     Selects the map projection. Scale  is  UNIT/degree,
              1:xxxxx,  or  width  in UNIT (upper case modifier).
              UNIT is cm, inch,  or  m,  depending  on  the  MEA
              SURE_UNIT  setting in .<A HREF="gmtdefaults.html">gmtdefaults</A>, but this can be
              overridden on the command line by appending the  c,
              i, or m to the scale/width value.

              <B>CYLINDRICAL</B> <B>PROJECTIONS:</B>

              <B>-Jc</B><I>lon0/lat0/scale</I> (Cassini)
              <B>-Jj</B><I>lon0/scale</I> (Miller)
              <B>-Jm</B><I>scale</I>  (Mercator - Greenwich and Equator as ori
              gin)
              <B>-Jm</B><I>lon0/lat0/scale</I> (Mercator -  Give  meridian  and
              standard parallel)
              <B>-Joa</B><I>lon0/lat0/azimuth/scale</I>   (Oblique  Mercator  -
              point and azimuth)
              <B>-Job</B><I>lon0/lat0/lon1/lat1/scale</I> (Oblique  Mercator  -
              two points)
              <B>-Joc</B><I>lon0/lat0/lonp/latp/scale</I>  (Oblique  Mercator -
              point and pole)
              <B>-Jq</B><I>lon0/scale</I> (Equidistant  Cylindrical  Projection
              (Plate Carree))
              <B>-Jt</B><I>lon0/scale</I> (TM - Transverse Mercator, with Equa
              tor as y = 0)
              <B>-Ju</B><I>zone/scale</I> (UTM - Universal Transverse Mercator)
              <B>-Jy</B><I>lon0/lats/scale</I> (Basic Cylindrical Projection)

              <B>AZIMUTHAL</B> <B>PROJECTIONS:</B>

              <B>-Ja</B><I>lon0/lat0/scale</I> (Lambert).
              <B>-Je</B><I>lon0/lat0/scale</I> (Equidistant).
              <B>-Jf</B><I>lon0/lat0/horizon/scale</I> (Gnomonic).
              <B>-Jg</B><I>lon0/lat0/scale</I> (Orthographic).
              <B>-Js</B><I>lon0/lat0/</I>[<I>slat/</I>]<I>scale</I> (General Stereographic)

              <B>CONIC</B> <B>PROJECTIONS:</B>

              <B>-Jb</B><I>lon0/lat0/lat1/lat2/scale</I> (Albers)
              <B>-Jd</B><I>lon0/lat0/lat1/lat2/scale</I> (Equidistant)
              <B>-Jl</B><I>lon0/lat0/lat1/lat2/scale</I> (Lambert)

              <B>MISCELLANEOUS</B> <B>PROJECTIONS:</B>

              <B>-Jh</B><I>lon0/scale</I> (Hammer)
              <B>-Ji</B><I>lon0/scale</I> (Sinusoidal)
              <B>-Jk</B>[<B>f|s</B>]<I>lon0/scale</I> (Eckert IV (f) and VI (s))
              <B>-Jn</B><I>lon0/scale</I> (Robinson)
              <B>-Jr</B><I>lon0/scale</I> (Winkel Tripel)
              <B>-Jv</B><I>lon0/scale</I> (Van der Grinten)
              <B>-Jw</B><I>lon0/scale</I> (Mollweide)

              <B>NON-GEOGRAPHICAL</B> <B>PROJECTIONS:</B>

              <B>-Jp</B>[<B>a</B>]<I>scale</I>[<I>/origin</I>] (polar (theta,r)  coordinates,
              optional <B>a</B> for azimuths and offset theta [0])
              <B>-Jx</B><I>x-scale</I>[<B>l|p</B><I>pow</I>][<I>/y-scale</I>[<B>l|p</B><I>pow</I>]]  (Linear, log,
              and power scaling)
              More details can be found  in  the  <B><A HREF="psbasemap.html">psbasemap</A></B>  man
              pages.

       <B>-R</B>     <I>west,</I>  <I>east,</I> <I>south,</I> and <I>north</I> specify the Region of
              interest. To specify boundaries in degrees and min
              utes  [and  seconds],  use  the  dd:mm[:ss] format.
              Append <B>r</B> if lower left and upper right map  coordi
              nates are given instead of wesn.

       <B>-Z</B>     Gives anomaly scale in data-units/distance-unit.


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

       <B>-A</B>     Sets the preferred positive azimuth. Positive  wig
              gles will "gravitate" towards that direction.

       <B>-B</B>     Sets map boundary tickmark intervals. See <B><A HREF="psbasemap.html">psbasemap</A></B>
              [0].

       <B>-D</B>     Means  there  is a data gap if 2 consecutive points
              are more than <I>gap</I> distance units apart. For  longi
              tude/latitude  data <I>gap</I> is in km, else it is in the
              user's units.'

       <B>-E</B>     Sets  the   viewpoint's   azimuth   and   elevation
              [180/90]'

       <B>-G</B>     Set  fill  of  positive wiggles. [Default is black]
              Specify the shade  (0-255)  or  color  (r/g/b),  or
              <B>-Gp</B><I>dpi/pattern</I>,  where  <I>pattern</I> gives the number of
              the built-in pattern (1-90) OR the name  of  a  Sun
              1-,  8-, or 24-bit raster file.  <I>dpi</I> sets the reso
              lution of the image. For 1-bit rasters: use <B>-GP</B> for
              inverse video, or append <B>:F</B><I>r/g/b</I>[<B>B</B>[<I>r/g/b</I>]] to spec
              ify fore- and background colors (use <I>r/g/b</I> = -  for
              transparency).  See <B><A HREF="GMT.html">GMT</A></B> Cookbook &amp; Technical Refer
              ence Appendix E for information on individual  pat
              terns.

       <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>     Set a fixed azimuth projection for wiggles [Default
              uses track azimuth, but see <B>-A</B>].

       <B>-K</B>     More   <I>PostScript</I>   code  will  be  appended  later
              [Default terminates the plot system].

       <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>     Paint  negative   wiggles   instead   of   positive
              [Default].

       <B>-O</B>     Selects  Overlay  plot  mode [Default initializes a
              new plot system].

       <B>-P</B>     Selects Portrait  plotting  mode  [<B><A HREF="GMT.html">GMT</A></B>  Default  is
              Landscape, see gmtdefaults to change this].

       <B>-S</B>     Draws   a   simple   vertical   scale  centered  on
              <I>lon0/lat0</I>. Use <B>-Sx</B> to specify cartesian coordinates
              instead.   <I>length</I>  is  in z units, append unit name
              for labeling

       <B>-T</B>     Draw  track  [Default  is  no  track].  Append  pen

       <B>-U</B>     Draw Unix System time stamp on plot. User may spec
              ify where the lower left corner of the stamp should
              fall on the page relative to lower left  corner  of
              plot.  Optionally, append a label, or <B>c</B> (which will
              plot  the  command  string.).  The  GMT  parameters
              UNIX_TIME  and UNIX_TIME_POS can affect the appear
              ance; see the <B><A HREF="gmtdefaults.html">gmtdefaults</A></B> man page for details.

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

       <B>-W</B>     Draw wiggle outline [Default is no outline]. Append
              pen attributes to use [Defaults: width = 1, color =
              0/0/0, texture = solid].

       <B>-X</B> <B>-Y</B>  Shift origin of plot by (<I>x-shift,y-shift</I>).  Prepend
              <B>a</B> for absolute coordinates; the  default  (<B>r</B>)  will
              reset plot origin.

       <B>-:</B>     Toggles  between  (longitude,latitude)  and  (lati
              tude,longitude) input/output. [Default  is  (longi
              tude,latitude)].  Applies to geographic coordinates
              only.

       <B>-c</B>     Specifies the number of plot copies. [Default is 1]

       <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 3 input
              columns].


</PRE>
<H2>EXAMPLES</H2><PRE>
       To plot the magnetic anomaly stored in the file  track.xym
       along  track @ 1000 nTesla/cm (after removing a mean value
       of 32000 Tesla), using a  15-cm-wide  Polar  Stereographic
       map ticked every 5 degrees in Portrait mode, with positive
       anomalies in red on a blue track of width 0.25 points, try

       pswiggle track.xym <B>-R</B>-20/10/-80/-60 <B>-JS</B>0/90/15<B>c</B> <B>-Z</B>1000 <B>-B</B>5
       <B>-P</B> <B>-G</B>255/0/0 <B>-T</B>0.25<B>p</B>/0/0/255 <B>-S</B>1000 <B>-V</B> &gt; track_xym.ps


</PRE>
<H2>BUGS</H2><PRE>
       Sometimes the  (x,y)  coordinates  are  not  printed  with
       enough  significant  digits, so the local perpendicular to
       the track swings around a lot. To see if this is the prob
       lem, you should do this:

       awk '{ if (NR &gt; 1) print atan2(y-$1, x-$2); y=$1; x=$2; }'
       yourdata.xyz | more

       (note that output is in radians; on some machines you need

       gmtset D_FORMAT %.12lg
       awk '{ print NR, $0 }' yourdata.xyz | filter1d <B>-Fb</B>5  <B>-N</B>4/0
       &gt; smoothed.xyz

       and plot this data set instead.


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