NAME

     fix4sc3d  - reads a 3D  database  file  created  by  program
     dbvec.   It performs the job of getting a USP format dataset
     into the form needed by USP program sc3d.  It assigns PrRcNm
     based  upon shot station information stored in the database.
     These new values range from 1 to n, where n is the count  of
     different  shot  station  numbers  read  from  the database.
     RecInd is based upon receiver  station  information  in  the
     database,  with  new  values ranging from 1 to n, where n is
     the count of different receiver station  numbers  read  from
     the database.  These values are used in USP program sc3d for
     indexing.

SYNOPSIS

     fix4sc3d [ -Nntap ] [ -Ootap ] [ -DBdbnam ] [ -picker ] [ -V
     ] [ -? ]

DESCRIPTION

     fix4sc3d reads a database of vectors on disk created by pro-
     gram dbvec.

     fix4sc3d gets both its data and its parameters from  command
     line  arguments.  These arguments specify the input and out-
     put, and optionally flags the input USP format dataset as  a
     picker event file (-picker).  If this is an event file, then
     the program outputs the same number of samples per trace  as
     are  input.   If  this is not flagged as an event file, this
     program only outputs 1 data sample per  trace,  to  conserve
     space.  Then the user needs to run hdrswap to attach the new
     headers to the data before running  sc3d.   The  PrRcNm  and
     RecInd  generated  in this program are intended only for use
     in USP program sc3d, providing indexing in that program.

  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 '/b/vsp'.  Note that you  may
          have  multiple  files  as  input, up to 100 partitions;
          just input them in order on the command line using mul-
          tiple -Ndata entries (i.e., -Ndata1 -Ndata2 -Ndata3 ...
          ).  This must be the same file(s), in the  same  order,
          as  input  to  program  dbvec, because the retrieval is
          based on the order of input to dbvec.

     -O otap
          Enter the output data file name immediately after  typ-
          ing  -O.  This  may be a piped dataset; if so, omit the
          -Ootap parameter from the command line.

     -DB dbnam
          Enter the database file name immediately  after  typing
          -DB.  This is the file created by the program dbvec.

     -picker
          Enter the command line argument '-picker' to output the
          same  number  of  data  samples per trace as are input.
          Default is to only  output  1  dummy  data  sample  per
          trace.

     -V   Enter the command line argument '-V' to output  verbose
          information  to  the output print file.  Default is not
          to output verbosely.

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

EXAMPLE

     fix4sc3d -Ndata1 -Ndata2 -DBdata_base -picker | .....

     This example should produce a piped dataset  containing  the
     same number of data samples per trace as the input data.

     Another example:

     fix4sc3d -Ndata1 -Ndata2 -DBdata_base -Odata.out -V

     This example should produce a dataset containing only 1 data
     sample  per  trace,  and  verbose  information in the output
     print file.

BUGS

     unknown, but sure to be there

SEE ALSO

     dbvec

AUTHOR

     Geoscientist: Don Wagner  Programmer: Marilyn Miller

COPYRIGHT

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