tplt

NAME
SYNOPSIS
DESCRIPTION
FILES
SEE ALSO
BUGS
COPYRIGHT
AUTHOR

NAME

tplt - BSU program converts plots a trace (BSEGY file) piping to GNUPLOT (C-Language Version)

SYNOPSIS

tplt [ -h | infile | trace # | tmin | tmax ]

DESCRIPTION

Basic Seismic Utilities (BSU) which plots a single trace in a BSEGY file. If all command line arguments are given on the command line, the plot will be interactive (right click for blowing up image). "q" quits image when given with mouse focus in image. And/Or Press enter in the terminal window to terminate the execution. This must be done even if the "q" option is used. Also outputs a gnuplot file which can be run within gnuplot shell, or as an argument in a command line execution of gnuplot. This file can be edited to change the terminal, for example to PostScript. If "gnuplot -p graph.gp" is run from a terminal, it will not be interactive. If you start gnuplot, and enter: load "graph.gp" (within the gnuplot shell), the image will be interactive. TRUE AMPLITUDE PLOT. C-Language Version.

Options

-h

Online help giving details on command line arguments

infile

First argument is the input file name

trace # (int)

Trace number to plot. Trace number 1 is first trace.

tmin (int)

Minumum time to plot.

tmax (int)

Maximum time to plot.

NOTE:
If invoked with no options, will prompt user for input parameters (BUT WILL NOT BE AN INTERACTIVE PLOT).

EXAMPLE:
tplt 0001.seg 1 0 .4

File 0001.seg trace 1 (first trace) is plotted from time 0 to time .4 seconds.

FILES

tpltxxxx.lst

where xxxx is the base name of input file, (ie. tplt0001.lst) Echo check of input parameters in listing file and some measurements in amplitude.

standard output

produces a progress bar

graph.gp

GNUPLOT formated file which can be run or edited and run to reproduce the plot using GNUPLOT shell or from GNUPLOT command line.
EXAMPLE: start gnuplot and from a gnuplot shell: load "graph.gp"
EXAMPLE: from a bash shell: gnuplot -p graph.gp

SEE ALSO

bhelp(1)

BUGS

no known bugs, but care needs taken when compiling. The problem is that the transition from GNUPLOT 4 to GNUPLOT 5 has introduced a bug that is evident as follows: Compliation using default "configure" will result in an executable that works in GNUPLOT 4. If run with GNUPLOT 5, the negative values will not plot. If you have GNUPLOT 5 on your system, then should compile with "configure --with-gnuplot5 ". If compiled with the --with-gnuplot5 option, will run in either GNUPLOT 4 or 5, but files and stream will be twice as big because each trace is plotted twice, once for positive and once for negative values.

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. <[email protected]>