NAME
vaplot - module to plot traces
SYNOPSIS
vaplot [ -Nntap ] [ -ATatap ] [ -tmsctmscl ] [ -
trsctrscl ] [ -ampfullsc ] [ -Wwidth ] [ -tministrt ] [
-tmaxistop ] [ -nsns ] [ -nene ] [ -rsrs ] [ -rere ] [
-spispace ] [ -tdtd ] [ -Sshde ] [ -T ] [ -V ] [ -AMXatmax ]
[ -AMNatmin ] [ -AR ] [ -R ] [ -G ] [ -? ]
DESCRIPTION
vaplot takes a set of traces and plots them in a record sec-
tion. This plot program is useful when displaying single
records where large wiggle trace are desired (e.g. wavelet
comparisons). By default, all plotted traces are normalized
according to maximum amplitude within each plotted trace
time window.
Note: the output of vaplot must be redirected to a file
for use with xplots or piped directly into xplots. Either
way you should check the manual page for xplots
Note: when using xplots you must be running in either X-
windows, Xview, or Motif
vaplot gets processing controls from the command line. Rea-
sonable defaults are set up. In addition, if no file name is
given, the binary trace data are expected to be on the stan-
dard input. The output on the standard output is a plot
stream for use with calplot(1). Diagnostic messages are
placed on the error output.
Command line arguments
-N ntap
(string) Enter the full path of the file continuing the
data set. If not specified, input is expected on the
standard input. If standard input is not specified, and
there is no input, e.g., program run in background,
expect a very ungracious crash. (default standard
input)
-AT atap
(string) Full path of an optional attribute file. This
file agrees with the binary data file, trace for trace,
record for record, header for header, except the infor-
mation is not a direct seismic trace, but rather some
attribute, such as instantaneous frequency, polarity,
envelope, polarization, etc. The information in this
file controls the gray area/color background shading.
-tmsc tmscl
(real) Inches per second along the time scale (default
= 2.5)
-trsc trscl
(real) Number of traces per inch in the plot. (default
= 12)
-amp fullsc
(real) Maximum amplitude of each plotted trace in units
of trace separation (default = 1.33)
-W width
(real) Width of plotting medium in inches (default =
7.5). This is required to define the top of the page in
order to display the trace since the plotting system
places its origin at the bottom left corner for the
display medium. The default value is suitable for Tek-
tronix compatible displays.
-tmin istrt
(integer) Starting sample time in ms (default = 0,
beginning of trace)
-tmax istop
(integer) Ending sample time in ms (default, end of
trace) (default = end of trace)
-ns ns
(integer) First trace in each record for processing
(default = 1).
-ne ne
(integer) Last trace in each record for processing
(default = last). The use of the ns and ne pair are
useful to be able to skip dead traces or to select just
a portion of the data set for analysis
-rs irs
(integer) First record for processing (default = 1)
-re ire
(integer) Last record for processing (default = last)
-sp ispace
(integer) Introduce a gap in the plotted traces after
each ispace traces (default is no gap)
-td td
(integer) Width of gap in trace spacing units (default
= 5).
-S shde
Enter -S0 for positive fill shading; -S1 for negative
fill; or no -S for no fill.
-T Control plotted trace scaling. If not invoked the
default action is to search each trace between tmin and
tmax for the trace maximum, and then to normalize the
trace by this quantity. The actual plotted peak ampli-
tude is fullsc times the trace-to-trace spacing
(1./trscl inches).
If the -T flag is invoked, then the plotted amplitude
is the trace value times fullsc times the trace-to-
trace spacing (1./trscl) divided by 2047. This then
permits a plot of absolute amplitude of the original
traces have not been independently normalized.
-V Flag for verbose output on the standard output. This
lists salient trace header information as well as all
command values used for processing, the default ones
given if not overridden.
-AMX atmax
(real) (default= 99999.)
-AMN atmin
(real) (default = -99999.)
The purpose of these two parameters is to control the
gray level/color of the background. These values form a
two sided clipping of the attribute information in the
atap file. By default an attribute >= atmax plots as
the darkest/reddest while an attribute <= atmin plots
as the lightest/bluest.
-AR If set, the sense of mapping of the attribute value
into the gray level/color background is inverted, e.g.,
darkest/reddest is the lowest value and lightest/bluest
is the highest value.
-R By default the traces are plotted left to right, with
time increasing from top to bottom. If this flag is
set, the traces are plotted left to right with time
increasing from bottom to top.
-G By default, when an attribute is used in vaplot, an
attribute legend is plotted showing the relation
between the degree of shading/color and the attribute
value. The use of this flag turns this option off.
-? Query mode. With this flag, vaplot will send a
description of the command line arguments to the stan-
dard error output and stop. If the program is run
under csh rather than sh, this flag must be invoked as
'-?' rather than -? because -? has special meaning to
csh.
BUGS
???
SEE ALSO
xplots
AUTHOR
Original code R. B. Herrmann, Saint Louis University, June
1987.
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html