bscl - BSU program which scales a data set by one of 4 possible ways
bscl [ -h | infile | itr1 | itrn | isw1 | scalar | ampfil ]
Basic Seismic Utilities (BSU) for scaling data. The program can scale a data set by a user provided value, 1/L2 norm, (trace,amplitude) pairs in a file, ampfil, or by the maximum absolute value in the file. The scale factor is found by scanning a limited number of traces defined by itr1 and itrn. For example, if itr1=3 and itrn=4, then traces 3,4,5,6 would be scanned for the maximum absolute value, if isw1=3.
Options
|
-h |
Online help giving details on command line arguments | ||
|
infile |
Input file name | ||
|
itr1 |
First trace in the window to be examined (must specify, even if not used) | ||
|
itrn |
Number of traces in the window to be examined (must specify, even if not used) | ||
|
isw1 |
Switch which selects scaling option |
0=user supplied scale factor
1=scale factor from 1/L2 norm
2=(trace,amp) pairs supplied in a file, ampfil.
3=scale factor from maximum absolute value
|
scalar |
Scalar value to apply ONLY if isw1 = 0 (output=traceValue*scalar) | ||
|
ampfil |
File name with (trace,amplitude) ONLY if isw1 = 2 |
NOTE:
If invoked with no options, will prompt user for input
parameters.
EXAMPLE:
bscl w001.seg 1 4 0 4.0978E-8
File w001.seg is scaled by the factor (1/4.0978E-8). Note that the user specifies the reciprocal of the number which will be multiplied with the sample values on the traces. In this case, the trace window does not matter, (the second and third arguments (1 4) are ignored, and just provide dummy values when isw1=0).
bsclxxxx.seg
Named according to convention (first 4char bscl, the next 4char are the first 4char of the input file name, suffix .seg)
standard output
produces a progress bar
bsclxxxx.lst
echo check of input parameters
bhelp(1)
No known bugs
Copyright © 2017 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. <pm@cgiss.boisestate.edu>