genbimg

NAME
SYNOPSIS
DESCRIPTION
FILES
SEE ALSO
BUGS
COPYRIGHT
AUTHOR

NAME

genbimg - BSU helper program that generates a BASH script, "gobimg". Script calls "bimg".

SYNOPSIS

genbimg [infile tstart tend tstep tgate tlagmx trace1 traceN jnear jfar]

DESCRIPTION

Basic Seismic Utilities (BSU) Generates a bash script that selects a time interval to process. A sliding time window and a range of traces are defined. User specifies a window length (tgate) and time shift forward. The maximum 2 sided cross correlation lag is also required on the command line. Program "bimg" is intended to process passive sourced data. It is assumed that the sources are in line with the geophone array (no azimuth corrections to correct for apparent velocities). C-Language Version.

Options

infile

Input file name

tstart

Start time of total processing window (float, seconds). Example: 0.0

tend

End time of total processing window (float, seconds). Example: 120.0

tstep

The time shift forward (float, seconds, if less than tgate, then overlap). Example 5.0

tgate

Length of sliding window (float, seconds, if less than tgate, then overlap). Example 10.0

tlagmx

Maximum lag time (2 sides) of cross correlation. Example, if tlagmx=4.0 seconds, then 0 to 2.0 seconds is acausal side, 2.0 to 4.0 seconds is causal side of output.

trace1

First trace to include in infile for processing (int). Example 1

traceN

Last trace number to include in infile for processing (int). Example 66

jnear

The nearest trace separation on output (int, traces). If set to 1, then the cross correlation is for 1 channel interval.

jfar

The farthest trace separation on output (int, traces). If set to the maximum number of available traces, the far offset output trace will be single fold. The highest fold stack of cross correlations is at the nearest offset output. See bimg(1) man pages for more.

NOTE:
If invoked with no options, will give user a "USAGE" statement and exit. Will exit if not all arguments given on command line. An echo check is provided as comment lines at the top of the output bash script, "gobimg".

EXAMPLE:
genbimg DATA.seg 0. 120. 5. 10. 4. 1 66 5 33

Running the output script from this program will process a file DATA.seg. Program "bimg" will be called by the bash script "gobimg" when it is run. In this example, file DATA.seg data are processed from 0 to 120 seconds in time, and traces 1 to 66 are included in the cross-correlations. Each cross-correlation set will be for a sub-window of 10 seconds, and the sub-window will move up in 5 second increments. The maximum 2 sided cross-correlation will be 4 seconds (output file bimgDATA.seg) and the one sided mix of causal and acausal sides will be 2.0 seconds (output file BIMGDATA.seg). The output traces will have offsets corresponding to 5 traces as the nearest offset, and 33 traces as the furthest offset.

FILES

gobimg

Executable output BASH script that calls "bimg" to process passive source data.

SEE ALSO

bhelp(1), bimg(1), xcor(3), bcor(1)

BUGS

no known bugs

COPYRIGHT

Copyright © 2021 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>