NAME

     aps_usp - module to  stuff  aquisition  geometry  data  from
     aps-format  point  and  relation  geometry  files  into  USP
     headers

SYNOPSIS

     aps_usp [ -Saps_source-file  ]  [  -Rsps_receiver-file  ]  [
     -Xsps_relation-file ] [ -Nntap ] [ -Ootap ]
     [ -sp ] OR [ -sl ]
     [ -ALL ] [ -V ] [ -? ]

DESCRIPTION

     aps_usp: This routine stuffs aquisition geometry data, espe-
     cially  multi-component  information, from aps-format point-
     record and relation geometry files into USP headers.

     aps_usp gets both its data and its parameters  from  command
     line  arguments.   These  arguments  specify the aps source,
     receiver, and relation filenames, as  well  as  the  seismic
     data input and output filenames, and an "override" and  ver-
     bose printout flags. You may use sticky or non-sticky  argu-
     ments as you wish.

     asp_ups assumes that the trace  header  words  SoPtNm  (Shot
     Point  Number) or SrcLoc (Source Location) (user choice) and
     RecInd (Receiver number) are already supplied in the  trace-
     headers.   IT ALSO ASSUMES THAT THE DIFFERENT COMPONENTS ARE
     SEPARATED EITHER BY:

     * DIFFERENT  CHANNEL  NUMBERS  (TrcNum's),  consistent  with
     information supplied in the aps relation file; or
     * CONSECUTIVE (shot/receiver) GATHERS (MCTrSp=2), consistent
     with information supplied in the aps relation file.  If this
     file has been  prepared  using  sps_aps,  this  sequence  is
     specified by the -MCL parameter.

     In this implementation (4/9/95), aps_usp reads from the  aps
     files,  and  writes in the seismic line headers data for the
     following keywords:
     NumCmp, MCTrSp, MCELnn, nn=1,...NumCmp
     If the override flag -ALL is specified, it also writes:
     CrwNam, PrcNam, JobNum, UnitFl
     It writes in the seismic trace headers:
     SrComp, SrPtXC, SrPtYC, SrXAzm
     RcComp, RcPtXC, RcPtYC, RcXAzm


  Command line arguments
     -Saps_source-file
          Enter  the  filename  for  the   seismic-source   input
          dataset,  in  aps format.  This filename should include
          the complete path, if the file resides in  a  different
          directory.

     -Raps_receiver-file
          Enter the filename for the receiver input  dataset,  in
          aps  format.  This filename should include the complete
          path, if the file resides in a different directory.

     -Xaps_relation-file
          Enter the filename for the "relation" input dataset, in
          aps  format.  This filename should include the complete
          path, if the file resides in a different directory.

     -N ntap
          Enter the filename for the input seismic dataset.

     -O otap
          Enter the filename for the output seismic dataset.

     -sp  Enter thsi command line argument if the source location
          indices  are to be found in the traceheader word SoPtNm
          (this is the default).

     -sl  Enter this command line argument if the source location
          indices are to be found in the traceheader word SrcLoc.
          If both -sl and -sp are specified, then the default  is
          restored.

     -V   Enter this command  line  argument  to  get  additional
          printout.

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

DISCUSSION

     This routine simply records what was done in the field,  and
     reformats it for later use; it does NOT correct for anything
     done wrong.

BUGS

     None known.

SEE ALSO

     regsys(1)  sps_aps(1)   aqplot(1)   gthrplot(1)   usp_aqp(1)
     usp_sps(1)

AUTHOR

      Leon Thomsen (APR x 3920; zlat02)

COPYRIGHT

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