bplt

NAME
SYNOPSIS
DESCRIPTION
FILES
SEE ALSO
BUGS
COPYRIGHT
AUTHOR
ADDITIONAL

NAME

bplt - BSU program plots seismic traces. Formats: XWIN/WXT PS, XFIG, JPEG, PDF

SYNOPSIS

bplt [ -h |infile|idev|iorient|itype|1tr|Ltr|tmin|tmax|istyl|amp|. . .
percnt|xaxis|yaxis]

DESCRIPTION

Basic Seismic Utilities (BSU) plots seismic traces. This program uses either
the PLPLOT library or GNUPLOT, depending on how it is compiled. Web sites are
http://plplot.sourceforge.net or http://www.gnuplot.info
Output devices include X-window (interactive only with gnuplot), Post Script (PS),
Xfig CAD file, JPEG bitmap, and Portable Document Format (PDF).
Traces may be displayed as simple wiggle, variable area
(peak filled black, white trough), or variable area (peak filled black, grey
trough). Both PostScript and Xfig output can be scaled to desired axis lengths
in inches with the xaxis and yaxis parameters. JPEG images are specified in
100’s of pixels, so xaxis=5 yaxis=6 will produce a 500 x 600 pixel image if compiled
with gnuplot.
C-Language Version
.

Options

-h

-h= Online help giving details on command line arguments

infile

Input file name

idev

output device

0=X window (interactive if compiled with GNUPLOT)

1=PostScript

2=Xfig

3=JPEG

4=PDF
iorient
orientation

0=landscape

1=portrait

itype

select non-time axis type

0=trace number

1=offset

2=geophone z-coordinate

3=geophone x-coordinate

4=geophone y-coordinate

5=shot z-coordinate

6=shot x-coordinate

7=shot y-coordinate

1tr

First trace number to plot 1<1tr<number of traces

Ltr

Last trace number to plot

tmin

minimum trace time to plot

tmax

maximum trace time to plot

istyl

style of plot

0=wiggle trace

1=variable area (black peaks filled)

2=variable area (black peaks, grey troughs)

amp

Sample amplitude to plot which will deflect 1 trace spacing

percnt

percent overtrace to plot. 200% clips plot at +/- 1 trace spacing.

xaxis

length of x-axis in inches (or 100’s of pixels) (non-time axis)

yaxis

length of y-axis in inches (or 100’s of pixels) (time axis)

NOTE:
If invoked with no options, will prompt user for input parameters (except xaxis
and yaxis).

EXAMPLE:
bplt w001.seg 1 0 1 1 50 0 .1 1 100. 200. 5. 2.5

File w001.seg traces are plotted. The output will be a PostScript file,
landscape orientation, traces plotted by source-receiver offset, traces 1 to 50
plotted, traces plotted from 0 to 0.100 seconds, a value of 100 on a trace will
plot one trace spacing, traces clipped at +/- 1 trace, non-time axis plotted 5
inches long, time axis plotted 2.5 inches long.

FILES

[ bplt.ps | bplt.fig | bplt.jpg | bplt.pdf ]

This is the image. To view it, use one of these programs, or your favorite alternative:
gv, xfig, gimp, xpdf or acroread
, or perhaps ImageMagik’s display .

bplt.gp

Gnuplot script that generated the image when compiled with GNUPLOT

standard output

produces a progress bar

bpltyyyy.lst

Echo check of input parameters in listing file.

SEE ALSO

bhelp(1), PLPLOT Documentation GNUPLOT Documentation

BUGS

no known bugs

COPYRIGHT

Copyright © 2024 by Paul Michaels

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version. This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details. You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.

AUTHOR

P. Michaels, PE. <paulmichaels@.boisestate.edu>

ADDITIONAL

PLPLOT is distributed under the LGPL license and includes the following
additional copyright statements:
Additional Copyrights
---------------------
The octave front end which links to the PLplot library (but not vice versa),
and which is otherwise independent of PLplot is copyright under the GPL
license (see COPYING).
The startup code used in argument handling (utils/plrender.c and
src/plargs.c) is partially derived from "xterm.c" of the X11R5
distribution, and its copyright is reproduced here:
---------------------
Copyright 1987, 1988 by Digital Equipment Corporation, Maynard, Massachusetts,
and the Massachusetts Institute of Technology, Cambridge, Massachusetts.