NAME

     usp2segy  - Conversion routine to convert USP format data to
     SEGY format using dynamic header mapping for flexibility.

SYNOPSIS

     usp2segy  [  -Nntap  ]  [  -Ootap  ]  [   -Mmap_file   ]   [
     -mapmap_specification ] [ -Vverbosity ] [ -?  or  -h ]

DESCRIPTION

     usp2segy : This routine is designed to simplify the  conver-
     sion  of  USP data into SEGY format. A three-level system of
     header mapping input is used to determine the source of  the
     output  datasets  header information. First off, the startup
     script sets a USP2SEGY_DEFAULT_MAPPING variable which speci-
     fies  where  to  get  a standard set of default mappings for
     common output information. These values are used if no other
     is specified for each particular mnemonic via the -M or -map
     specifications which are controlled by the  user.  Any  file
     containing  a  set  of  mappings  input by specifying the -M
     argument is read in next and entries which have a  destinam-
     tion  field  (ie. before the '=' character) matching an ear-
     lier entry in the defaults will now take  precedence.  Simi-
     larly,  mappings specified on the command line with the -map
     argument take the highest precedence of all. See the section
     on  MAPPINGS  below for a discussion of the format for these
     specifications.

     usp2segy gets both its data and its parameters from  command
     line  arguments.  These arguments specify the input, output,
     trace header mappings, and verbose printout, if desired.

  Command line arguments
     -N ntap  [default: stdin]
          Enter the input data set name or file immediately after
          typing -N unless the input is from a pipe in which case
          the -N entry must be omitted. 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'.

     -O otap  [default: stdout]
          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).

     -M mapping_file  [default: none]
          File containing a set of  header  mappings.  Format  is
          discussed below.

     -map map_specification  [default: none]
          Specifies source out output header information.  Format
          is  discussed  below.  Multiple  instances  of the -map
          argument may be specified.

     -V verbosity
          Enter the command line argument '-V' to get  additional
          printout.  A  more verbose printout may be specified by
          entering a verbosity value of 2. [default: off]

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

MAPPINGS

     Entries in both the mapping_file specified via the -M  argu-
     ment  or  map_specification  given by one or more -map argu-
     ments should be of the form:

     segy_header_mnemonic=[usp_header_mnemonic|constant]

     For instance, to set the SEGY field record and trace numbers
     with values retrieved from the USP record and trace numbers,
     the definitions would look like:

     FieldRecNum=RecNum
     FieldTrcNum=TrcNum

     and to specify that the dataset should  be  marked  as  reel
     number 5, a similar definition

     ReelNum=5

     would be used.

     The mnemonic values used for both USP and SEGY data  formats
     may  be  obtained by running the program hdrdesc. A complete
     description of the formats, including the mnemonics used and
     a brief description of each field will be produced.

BUGS

     No extensive testing has been done  yet,  so  bugs  probably
     abound.  Verification  of specified values is nil, except in
     the case of constants, which are checked for validity.

SEE ALSO

     segy2usp(1), hdresc(1), utop(1), scan(1), sis_verify(1)

AUTHOR

     Joe M. Wade

COPYRIGHT

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