bscl

NAME
SYNOPSIS
DESCRIPTION
FILES
SEE ALSO
BUGS
COPYRIGHT
AUTHOR

NAME

bscl - BSU program which scales a data set by one of 4 possible ways

SYNOPSIS

bscl [ -h | infile | itr1 | itrn | isw1 | scalar | ampfil ]

DESCRIPTION

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).

FILES

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

SEE ALSO

bhelp(1)

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>