1PSSEGYZ(1)                   Generic Mapping Tools                  PSSEGYZ(1)
2
3
4

NAME

6       pssegyz - Create imagemasked postscript from SEGY file
7

SYNOPSIS

9       pssegyz          SEGYfile          -Jparameters         -Jz|Zparameters
10       -Rwest/east/south/north[/zmin/zmax][r]  -Ddeviation  -F[rgb|gray]|-W  [
11       -Bbias ] [ -Cclip ] [ -Eazim/elev[+wlon/lat[/z]][+vx0/y0] ] [ -I ] [ -K
12       ] [ -Lnsamp ] [ -Mntrace ] [ -N ] [ -O ] [ -P ] [ -Sheader_x/header_y ]
13       [ -Uredvel ] [ -V ] [ -Xscale ] [ -Ysample_int ] [ -Z ]
14

DESCRIPTION

16       pssegyz  reads  a  native  (IEEE) format SEGY file and produces a Post‐
17       Script image of the seismic data. The imagemask  operator  is  used  so
18       that  the  seismic  data are plotted as a 1-bit deep bitmap in a single
19       (user-specified) color or gray shade, with  a  transparent  background.
20       The  bitmap  resolution  is  taken  from the current GMT defaults.  The
21       seismic traces may be plotted at their true locations using information
22       in  the trace headers (in which case order of the traces in the file is
23       not significant).  Standard GMT geometry routines are used so  that  in
24       principle any map projection may be used, however it is likely that the
25       geographic projections will lead to  unexpected  results.  Beware  also
26       that  some  parameters  have non-standard meanings, and a couple of the
27       options for pssegy are not available in pssegyz.  Note that  the  order
28       of   operations   before   the  seismic  data  are  plotted  is  devia‐
29       tion*[clip]([bias]+[normalize](sample value)). Deviation determines how
30       far  in  the  plot  coordinates  a [normalized][biased][clipped] sample
31       value of 1 plots from the trace location.  The SEGY file  should  be  a
32       disk  image  of  the  tape  format  (ie 3200 byte text header, which is
33       ignored, 400 byte binary reel header, and  240  byte  header  for  each
34       trace) with samples as native real*4 (IEEE real on all the platforms to
35       which I have access)
36
37       SEGYfile
38              Seismic data set to be imaged
39
40       -J     Selects the map projection. Scale is  UNIT/degree,  1:xxxxx,  or
41              width  in  UNIT  (upper case modifier).  UNIT is cm, inch, or m,
42              depending on the MEASURE_UNIT setting in .gmtdefaults4, but this
43              can be overridden on the command line by appending c, i, or m to
44              the scale/width  value.   When  central  meridian  is  optional,
45              default  is  center  of  longitude  range on -R option.  Default
46              standard parallel is the equator.  For map  height,  max  dimen‐
47              sion,  or min dimension, append h, +, or - to the width, respec‐
48              tively.
49              More details can be found in the psbasemap man pages.
50
51              CYLINDRICAL PROJECTIONS:
52
53              -Jclon0/lat0/scale (Cassini)
54              -Jcyl_stere/[lon0/[lat0/]]scale (Cylindrical Stereographic)
55              -Jj[lon0/]scale (Miller)
56              -Jm[lon0/[lat0/]]scale (Mercator)
57              -Jmlon0/lat0/scale (Mercator - Give meridian and standard paral‐
58              lel)
59              -Jo[a]lon0/lat0/azimuth/scale  (Oblique  Mercator  -  point  and
60              azimuth)
61              -Jo[b]lon0/lat0/lon1/lat1/scale (Oblique Mercator - two points)
62              -Joclon0/lat0/lonp/latp/scale  (Oblique  Mercator  -  point  and
63              pole)
64              -Jq[lon0/[lat0/]]scale (Cylindrical Equidistant)
65              -Jtlon0/[lat0/]scale (TM - Transverse Mercator)
66              -Juzone/scale (UTM - Universal Transverse Mercator)
67              -Jy[lon0/[lat0/]]scale (Cylindrical Equal-Area)
68
69              CONIC PROJECTIONS:
70
71              -Jblon0/lat0/lat1/lat2/scale (Albers)
72              -Jdlon0/lat0/lat1/lat2/scale (Conic Equidistant)
73              -Jllon0/lat0/lat1/lat2/scale (Lambert Conic Conformal)
74              -Jpoly/[lon0/[lat0/]]scale ((American) Polyconic)
75
76              AZIMUTHAL PROJECTIONS:
77
78              -Jalon0/lat0[/horizon]/scale (Lambert Azimuthal Equal-Area)
79              -Jelon0/lat0[/horizon]/scale (Azimuthal Equidistant)
80              -Jflon0/lat0[/horizon]/scale (Gnomonic)
81              -Jglon0/lat0[/horizon]/scale (Orthographic)
82              -Jglon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale
83              (General Perspective).
84              -Jslon0/lat0[/horizon]/scale (General Stereographic)
85
86              MISCELLANEOUS PROJECTIONS:
87
88              -Jh[lon0/]scale (Hammer)
89              -Ji[lon0/]scale (Sinusoidal)
90              -Jkf[lon0/]scale (Eckert IV)
91              -Jk[s][lon0/]scale (Eckert VI)
92              -Jn[lon0/]scale (Robinson)
93              -Jr[lon0/]scale (Winkel Tripel)
94              -Jv[lon0/]scale (Van der Grinten)
95              -Jw[lon0/]scale (Mollweide)
96
97              NON-GEOGRAPHICAL PROJECTIONS:
98
99              -Jp[a]scale[/origin][r|z] (Polar coordinates (theta,r))
100              -Jxx-scale[d|l|ppow|t|T][/y-scale[d|l|ppow|t|T]]  (Linear,  log,
101              and power scaling)
102
103       -R     west, east, south, and north specify the Region of interest, and
104              you   may   specify   them   in   decimal    degrees    or    in
105              [+-]dd:mm[:ss.xxx][W|E|S|N]  format.  Append r if lower left and
106              upper right map coordinates are given instead of  w/e/s/n.   The
107              two  shorthands  -Rg  and -Rd stand for global domain (0/360 and
108              -180/+180 in longitude respectively, with -90/+90 in  latitude).
109              Alternatively, specify the name of an existing grid file and the
110              -R settings (and grid spacing, if applicable)  are  copied  from
111              the grid.
112
113       -D     gives the deviation in X units of the plot for 1.0 on the scaled
114              trace, This may be a single number (applied equally in X  and  Y
115              directions) or devX/devY
116
117       -E     Sets  the  viewpoint's  azimuth  and  elevation (for perspective
118              view) [180/90].  For frames used for animation, you may want  to
119              append  +  to  fix  the center of your data domain (or specify a
120              particular world coordinate  point  with  +wlon0/lat[/z])  which
121              will  project  to  the  center of your page size (or specify the
122              coordinates of the projected veiw point with +vx0/y0).
123
124       -F[rgb|gray]
125              Fill trace (variable area, defaults to filling positive). rgb or
126              gray gives the color with which the imagemask is filled.
127
128       -W     Draw wiggle trace.
129
130       You must specify at least one of -W and -F.
131

OPTIONS

133       No space between the option flag and the associated arguments.
134
135       -B     Bias to apply to data (added to sample values).
136
137       -C     Sample  value at which to clip data (clipping is applied to both
138              positive and negative values).
139
140       -I     Fill negative rather than positive excursions.
141
142       -K     More PostScript code will be appended later [Default  terminates
143              the plot system].
144
145       -L     Override  number  of  samples  per trace in reel header (program
146              attempts to determine number of samples from each  trace  header
147              if possible to allow for variable length traces).
148
149       -M     Override  number  of  traces  specified  in reel header. Program
150              detects end of file (relatively) gracefully, but this  parameter
151              limits number of traces that the program attempts to read.
152
153       -N     Normalize  trace  by  dividing  by rms amplitude over full trace
154              length.
155
156       -O     Selects Overlay plot mode [Default initializes a new  plot  sys‐
157              tem].
158
159       -P     Selects Portrait plotting mode [Default is Landscape, see gmtde‐
160              faults to change this].
161
162       -S     Read trace locations from trace headers: header is either c  for
163              CDP,  o for offset, b<num> to read a long starting at byte <num>
164              in the header (first byte corresponds to num=0), or a number  to
165              fix the location.
166               First  parameter for x, second for y. Default has X and Y given
167              by trace number.
168
169       -U     Apply reduction velocity by  shifting  traces  upwards  by  red‐
170              vel/|offset|.   Negative  velocity  removes  existing reduction.
171              Units should be consistent with offset in trace header and  sam‐
172              ple interval.
173
174       -V     Selects verbose mode, which will send progress reports to stderr
175              [Default runs "silently"].
176
177       -X     Multiply trace locations by scale before plotting.
178
179       -Y     Override sample interval in reel header.
180
181       -Z     Do not plot traces with zero rms amplitude.
182
183

EXAMPLES

185       To plot the SEGY file wa1.segy with normalized traces plotted  at  true
186       offset  locations,  clipped  at  +-3 and with wiggle trace and positive
187       variable area shading in black, use
188
189       pssegyz wa1.segy -JX5/-5 -D1 -Jz0.05 -E180/5 -R0/100/0/10/0/10  -C3  -N
190       -So -W -Fblack > segy.ps
191

BUGS

193       Variable area involves filling four-sided figures of distressing gener‐
194       ality.  I know that some of the more complex degenerate cases  are  not
195       dealt  with  correctly or at all; the incidence of such cases increases
196       as viewing angles become more oblique, and particularly as the  viewing
197       elevation increases. Wiggle-trace plotting is not affected.
198

SEE ALSO

200       GMT(1), pssegy(1)
201
202
203
204GMT 4.5.6                         10 Mar 2011                       PSSEGYZ(1)
Impressum