NAME
aqplot - Make a plot of acquisition geometry using vplot
SYNOPSIS
aqplot [ -a arrow_length] [ -t text_size] [ -l label_size] [
-d label_density] [ -S plot_width,plot_height] [ -c
xcenter,ycenter] [ -X xspan] [ -Y yspan] [ -s scale] [ -x
xmin,xmax] [ -y ymin,ymax] [ -? ] | (tube or xtpen or pspen)
DESCRIPTION
The program sps_aps reads in a modified form of Shell's SPS
format, and writes out a file that aqplot can read. aqplot
then produces a plot showing the source and receiver lines
and orientations graphically. The output of aqplot is in
Stanford's ``vplot'' format; this can be rendered into
postscript or X via the programs ``pspen'' and ``xtpen'',
respectively.
By default, aqplot plots at the largest scale it can that
shows the entire plot (plus 8%) within the plotting window.
COMMAND-LINE OPTIONS
-a arrow_length (default 3.0)
-t text_size (default 1.0)
These are in units of percent of the plot height
(assuming a typical 4-wide by 3-tall plot aspect
ratio). The text_size controls the size of the annota-
tion accompanying selected shot and receiver locations.
Labels for source locations have an ``s'' prepended,
are plotted in yellow, and are displaced upwards rela-
tive to the line direction (as specified in the input
file). Labels for receiver locations have an ``r''
prepended, are plotted in cyan, and are displaced down-
wards. Arrows indicating source locations are half
again longer than arrows indicating receiver locations.
Vertical sources are indicated by a ``+'', vertical
receivers by an ``X''. Arrows indicating source loca-
tions have their ``hook'' on the clockwise side;
receiver arrows have their ``hook'' on the counter-
clockwise side.
-l label_size (default 2.0)
The label_size is also in units of percent of the plot
height. Label text and orientation are specified in
the input file.
-d label_density (default 1.0)
The label density is automatically adjusted according
to the plot scale; by default, about 3 labels per line
are plotted. Setting the label_density will let you
increase or decrease the label density away from the
default.
-S plot_width,plot_height (default 13.65,10.24)
Vplot defines a ``virtual screen'' with the dimensions
13.65 by 10.24 inches. This screen is isotropically
scaled to fit within whatever plotting surface is
available. If you specify a plot_width,plot_height,
then aqplot will fit its plot within that size plotting
area instead, and pspen or xtpen will NOT scale that
plotting area: they will instead attempt to plot at
true size, with 1 inch plotted as a true 1 inch on the
output plotting device.
Note the corresponding option on pspen is
paper=(plot_height)x(plot_width)i, with the dimensions
the other way around.
-c xcoor,ycoor
-X xspan -Y yspan
xcoor,ycoor specify the survey coordinates of the
center of the plot. xspan and yspan specify the survey
dimensions of a box centered on xcoor,ycoor; the larg-
est scale will be chosen that fits all of this box
within the display area. Note you do not need to
specify both xspan and yspan. (If neither xspan nor
yspan are specified, the default plot scale will be
used as if xcoor,ycoor had not been specified.)
-s scale
scale lets you specify a specific map scale to use, in
survey units per inch.
-x xmin,xmax
-y ymin,ymax
xmin,xmax and ymin,ymax let you specify a survey bound-
ing box; anything much outside this box will not be
plotted. (Note you do not need to specify both
xmin,xmax and ymin,ymax.)
-? If the option -? is given or if aqplot is run without
input or output, then aqplot will self-document.
INPUT FILE FORMAT
Input to aqplot is free format, with one command per line.
Spaces and tabs serve as field delimiters and are otherwise
ignored (unless they occur inside double quotes). Case is
ignored in command names and command keyword arguments.
Anything after a hash (``#'') is treated as a comment
(unless the hash is inside double quotes as part of a
label). Blank lines are treated as comments.
Global bounding box
The first non-comment line in the file must be an
``INIT'' line, of the form
INIT xmin xmax ymin ymax +x_azimuth
xmin, xmax, ymin, and ymax provide a bounding box for
the survey, in survey coordinates. The +x_azimuth
gives the azimuth (degrees East of North) of the
survey's positive X axis. (You may prefer to set this
to zero so the plot lines up with the survey axes.)
Anything before the INIT line will be echoed to stan-
dard error (usually the user's terminal). There should
only be one INIT line in the input file.
Source and Receiver
After the INIT line, there are three possible commands.
The first two define source or receiver points; instead
of ``Source'' and ``Receiver'', ``S'' and ``R'' are
also recognized:
Source index xp yp az_+y Draw Print label_az
Receiver index xp yp az_+y Draw Print label_az
The command line may be terminated at any point after
the ``yp'' field and still be valid.
index is a string to label the shot or receiver point
(usually an integer indicating shot or receiver
number). Do not use a quoted string for the index.
xp, yp specify the coordinates of this shot or receiver
point.
az_+y specifies the azimuth of the shot or receiver
component in degrees clockwise from the positive y
axis. Thus, a ``0'' indicates a cross-line source or
receiver. Vertical sources or receivers use ``Z''
instead of a number; this is also the default if noth-
ing is specified.
Draw indicates whether a line should be drawn to this
location from the previous shot or receiver location.
``d'', ``y'', or ``1'' means yes; ``m'', ``n'', or
``0'' means no. The default is yes.
Print indicates whether a label should be annotated at
this shot or receiver point. ``0'' or ``n'' (the
default) means no. ``1'' or ``y'' means yes, always.
An integer greater than 1 means that the label should
only sometimes be plotted, depending on the plot scale.
The larger the number, the less important the label.
Generally, labels that occur at the end of a line
should be ``1''. The very midpoint of a line should be
``2''. The points 1/4 and 3/4 of the way through a
line should be ``4''. Etcetera.
label_az specifies the azimuth of the annotation, again
measured in degrees clockwise from the positive y axis.
Usually you will want the label text to run parallel to
the line direction; this is 90, the default.
Line annotation
There is one last type of line recognized, a ``label''
line (``L'' is also recognized):
Label xp yp label_az "text string" just
xp, yp, and label_az are as defined above.
"text string" is a text string to use for the label; if
it contains spaces then delimit it with double (not
single) quotes.
just specifies how to justify this label and is
optional. The possibilities are ``L'' or ``Left'' for
left justification, ``R'' or ``Right'' for right jus-
tification, or ``C'' or ``Center'' for centered justif-
ication (the default).
RUNTIME COMMENTS
aqplot outputs several comments at runtime to aid the user
in choosing a new plot scale, plot limits, plot center, etc.
This line simply echoes the limits found on the INIT line in
the input file:
INIT limits: 0,1000 ; 0,2000
This line shows the plot scale that will be used if the INIT
limits as given in the input file are used to bound the plot
(no command-line overrides):
Index scale = 198.075 units per inch
This line shows the plot scale that aqplot chooses taking
all the command line options except -s into account:
automatic scale = 198.075 units per inch
If the -s option is specified, however, that overrides all
these:
user overrides scale = 175 units per inch
The ``index scale'' and ``automatic scale'' are provided to
guide you in choosing an appropriate scale. The ratio
between the ``index scale'' and the actual scale also deter-
mines the zoom factor, which is used to appropriately scale
the label density.
This line gives the survey coordinates of the center of the
plot:
Center: 500,1000
Note the four corners of the plot are also annotated with
their corresponding survey (input) coordinates.
If any line in the file attempts to plot outside the limits
given in the INIT line, this message will point you to the
offending line:
Warning, line 37 out of bounds.
SEPlib PATHS
To access pspen and xtpen, you will need to have
/explprod/phase2/sep/bin in your PATH. This directory con-
tains the ``Amoco released" subset of SEPlib programs. To
access the corresponding SEPlib man pages, add
/explprod/phase2/sep/man to your MANPATH.
A much more extensive set of SEPlib binaries and source may
be found under ``~trcgp/sep'' at the Tulsa Technology
Center.
BUGS
None known of in aqplot.
Some postscript plotters cannot handle plots that contain
too many vectors.
If the output plot appears too cluttered, it may help to
specify ``fatmult=0.'' on the pspen or xtpen or tube com-
mand line. This will cause all vectors to plot as thin as
possible.
SEE ALSO
pen(1) pspen(1) xtpen(1) sps_aps(1)
AUTHOR
Joe Dellinger and Leon Thomsen
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html