genbimg - BSU helper program that generates a BASH script, "gobimg". Script calls "bimg".
genbimg [infile tstart tend tstep tgate tlagmx trace1 traceN jnear jfar]
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.
gobimg |
Executable output BASH script that calls "bimg" to process passive source data. |
bhelp(1), bimg(1), xcor(3), bcor(1)
no known bugs
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.
P. Michaels, PE. <paulmichaels@boisestate.edu>