NAME

     scale  - globally scale / reciprocate a data set

SYNOPSIS

     scale [ -Nntap ] [ -Ootap ] [  -ampamp  ]  [  -expbeta  ]  [
     -biasbias  ]  [  -ddist ] [ -sist ] [ -eiend ] [ -nsnstr ] [
     -nenetr ] [ -rsnrst ] [ -np ] [ -I ] [ -L  ]  [  -norm  ]  [
     -llower ] [ -uupper ] [ -ccrit ] [ -V ] [ -? ]

DESCRIPTION

     scale applies a single scale factor to an entire data set

     Scale gets both its data and  its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the start and end times, the start and end traces, start and
     end  records,  and  verbose  printout,  if  desired.   Scale
     applies a job constant scaler to the data with the following
     equation:

              Y =  ( sign( X ) * ( amp * ( | X | **  exp  )  )  +
     bias
              where :
              amp, exp, bias are command line argument variables
              X = Input data amplitude
              Y = Output data amplitude

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing -N.  This input file should include the complete
          path name if the file resides in a different directory.
          Example  -N/b/vsp/dummy  tells  the program to look for
          file 'dummy' in directory 'vsp' stored on the 'b' disk.

     -O otap
          Enter the output data  set  name  or  file  immediately
          after typing -O.  This output file is not required when
          piping the output to another process.  The output  data
          set also requires the full path name (see above).

     -amp amp
          Enter the multiplying scale factor.  Default = 1.0

     -exp beta
          Enter the  exponent  scale  factor.   For  instance  to
          reciprocate a dataset use and exponent of -1. Default =
          1.0

     -bias bias
          Enter the additive bias.  Default = 0.0


     -s ist
          Enter the process start time in ms.  Times before  this
          value  will  be  passed  unscaled.   The default is the
          beginning of the trace.

     -e iend
          Enter the process end time in ms.   Times  beyond  this
          value  will be passed unscaled.  The default is the end
          of the trace.

     -ns nstr
          Enter the process start trace  number.   Trace  numbers
          below  this  value  will  be  passed  unprocessed.  The
          default is 1.

     -ne netr
          Enter the process  end  trace  number.   Trace  numbers
          above  this  value  will  be  passed  unprocessed.  The
          default is the last trace number on the input data set.

     -rs nrst
          Enter process start record number.  Records below  this
          value  will be passed unprocessed. Default value is the
          first record.

     -re nred
          Enter process end record number.   Records  above  this
          value will be passed unprocessed. Default value is last
          record.

     -np  Enter the command line argument '-np' to  not  preserve
          the  original polarity of the sample. The scaling equa-
          tion then becomes:

              Y = ( amp * ( abs(X) ** exp ) ) + bias

     -d dist
          Application distance (ft or  m).   Distance  to  either
          begin  scaling  data  or stop scaling data (see -L flag
          below).  Default is start of  the  record,  i.e.  scale
          whole record.

     -I   Enter the command line argument '-I' take  the  inverse
          of amp and apply that value as the scale factor

     -L   Enter the command line argument  '-L'  do  scaling  for
          ranges  less  than  or  equal to dist above.  Otherwise
          scale ranges greater than or equal to dist.

     -M   Enter the command line argument '-M' to remove the mean
          from each trace prior to any other operations.

     -norm
          Enter the command line argument  '-norm'  to  normalize
          each  trace  between  0.0  and 1.0.  NOTE:  Use of this
          option supercedes all other options in this option list
          except for '-l and -u' below.

     -l   Enter a lower amplitude  bound  for  the  scaled  data.
          Output  data  will  be  normalized and scaled such that
          normalized amplitudes of 0.0 will become '-l'.  Normal-
          ized  amplitudes of 1.0 will become '-u' and all inter-
          vening  amplitudes  will  be   redistributed   linearly
          between '-l' and '-u'.

     -u   Enter an upper amplitude bound  for  the  scaled  data.
          Output  data  will  be  normalized and scaled such that
          normalized amplitudes of 0.0 will become '-l'.  Normal-
          ized  amplitudes of 1.0 will become '-u' and all inter-
          vening  amplitudes  will  be   redistributed   linearly
          between '-l' and '-u'.

     -c   Enter a ceiling value of the absolute  trace  amplitude
          to be permitted. If this is other than zero then if any
          trace amplitude exceeds this the program will shut down
          leaving  a  message  in the printout file. This is very
          useful when scaling to some critical value such  as  +1
          128 or +1 32767. Default = 0

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter the command line  argument  '-?'  to  get  online
          help.   The program terminates after the help screen is
          printed.

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.