NAME

     agca  - apply a previously determined automatic gain control
     (AGC)  curve  to seismic trace data or to remove the effects
     of a previously applied AGC curve from the data


SYNOPSIS

     agca  [ -N1ntap1 ]  [ -N2ntap2 ]  [ -Ootap ]  [ -Cparmfile ]
     [ -modemode ] [ -typetype ] [ -numnum ] [ -V ] [ -H ] [ -? ]


DESCRIPTION

     agca applies or removes a previously determined  AGC  curve.
     Input consists of two SIS format 3 datasets:  ntap1 contains
     the operand traces; ntap2 contains the operator traces.  The
     output  is  an SIS format 3 dataset. The input datasets must
     meet the constraints as defined for the type of  application
     method requested.

  Command line arguments
     -N1 ntap1
          Enter the full path name of  the  file  containing  the
          input  operand traces dataset.  If not specified, input
          is expected to be on the standard input  (a  pipe  into
          agca).   If  no  input  file  is given, and there is no
          standard input, the program will abend.

     -N2 ntap2
          Enter the full path name of  the  file  containing  the
          input  operator  traces  dataset.   If no input file is
          given, the program will abend.

     -O otap
          Enter the full path name for the output file to receive
          the  output  data.  If no output file is specified, the
          program will write the output data to the standard out-
          put (a pipe out of agca).

     -C parmfile
          File from which  processing  parameters  necessary  for
          executing  agca are specified. An error message will be
          issued if parmfile does not exist.  If -C is present on
          the  command  line  with  no  argument,  parameters are
          assumed to be in-line in the job script marked with the
          flag -agca.crd.  By using this method (described in the
          startjob section of this manual), the user  is  allowed
          to  specify  the  agca parameters in-line with the pro-
          cessing sequence.  This  option  is  also  achieved  by
          omitting  the  -C flag from the command line and coding
          the -agca.crd flag, followed by the  in-line  parameter
          card images enclosed in double quotes.  NOTE: with this
          option, startjob must be used to run the  script,  with
          the  pipe symbol "|" placed right after the second dou-
          ble quote if output is piped into another process.   To
          make  it  simple  to run application types 0 and 1, the
          following parameters may be input on the  command  line
          rather  than on a card image.  This eliminates the need
          for input cards except when running application type 2.

     -mode mode
          (This parameter may instead be specified on  the  first
          card  image  in  cc6.)   Enter  the  mode of operation.
          Valid modes are blank or 0, 1, 2 or 3.  Blank  or  0  =
          Operand * Operator; 1 = Operand / Operator; 2 = Operand
          + Operator; 3 = Operand - Operator.

     -type type
          (This parameter may instead be specified on  the  first
          card image in cc10.)  Enter type of application.  Valid
          types are blank or 0, 1 or 2.  Blank or 0  =  trace-by-
          trace operation; each operand trace is operated on by a
          new operator trace.  1 = constant panel operation; each
          operator  trace  is  used  for  "num"  adjacent operand
          traces.  2 = variable panel  operation;  non-sequential
          operation  where  the operator trace that is to be used
          for a set of operand traces (thru Last RI specified  in
          cc77-80) is specified on input card images in cc11-17.

     -num num
          (This parameter may instead be specified on  the  first
          card  image  in cc18-21.)  (Only applicable to applica-
          tion type 1.)  Enter the number of operand  traces  per
          operator trace.  No default.









          The parameters cards for agca are:

          Card Image:  data column entries

          Column          Variable
            1-5      card number and name (1AGCA)  (not required)

            6        Mode of application (first card only)

                    0 = Operand * Operator

                    1 = Operand / Operator

                    2 = Operand + Operator
                    3 = Operand - Operator

                    (blank defaults to 0)


           10        Type of application (first card only)

                    0 = trace-to-trace; both input data sets must have
                        the same number of traces per record and records
                        per trace.

                    1 = constant panel; number of traces on ntap1 divided
                        by num(cc18-21) must be less than or equal to the
                        number of records on ntap2; ntap2(Operator) must
                        have one-trace records and may be stacked data.

                    2 = variable panel

                    (blank defaults to 0)


           11-14     Record number of operator trace (type 2 only)
                         (no default)
           15-17     Trace number of operator trace (type 2 only)
                         (no default)

                    cc11-17 specify the record and trace numbers of the
                    operator trace that is to be used for a set of operand
                    traces.

           18-21     Number of operand traces per operator trace (type 1 only)
                    (no default)

           77-80     Last record number on operand dataset to which this card
                    applies (type 2 only;  blank invalid)





     -V   Verbose mode.
          Detailed information about the processing parameters is sent to the
          output listing device.

     -?  or -H
          Query mode.  With this flag, agca will
          send a description of the command line arguments to the
          standard error output and stop.
          If operating under the Berkeley shell (csh), the -? must be quoted
          with single quotes, i.e., '-?'.



AUTHOR

     M. A. Miller (1990)


SEE ALSO

     startjob(1), Amoco Seismic Information System User Manual


BUGS

     A command line option letter and its corresponding  argument
     may not be separated by whitespace.


COPYRIGHT

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







































Man(1) output converted with man2html