NAME

     xyz2head  - module to store flat file  information  in  user
     defined trace header mnemonic.

SYNOPSIS

     xyz2head [ -Nntap ] [ -Ootap ] [ -Fffile ] [ -hwmnemonic]  [
     -nsnstr  ] [ -nenetr ] [ -rsnrst ] [ -renred ] [ -geometry ]
     [ -hw1mnemonicX] [ -hw2mnemonicY] [ -hw3mnemonicZ] [ -R ]  [
     -map ] [ -V ] [ -? ]

DESCRIPTION

     xyz2head read in a dataset and an associated x,y,z flatfile.
     The  z value is stored in a user defined trace header entry.
     The trace ehader entry  TVPT01 is the default.

INPUT

     xyz2head gets both its data and parameters from command line
     arguments.   These arguments specify the input, output, flat
     file, start and end traces, start and end  record.   Verbose
     printout is available.

  Command line arguments
     -N ntap
          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
          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).

     -F ffile   [default: none]
          Enter the input flat file name immediately after typing
          -F.   The  input  file name also requires the full path
          name  (see  above).   The  flat  file  indexing  should
          correspond  to  sequential record and trace. If this is
          not true unpredictable results are sure to follow.

     -hw mnemonic   [default: TVPT01]
          Enter the trace header mnemonic in which to  store  the
          flat file  z  value.

     -ns nstr    [default: first trace]
          Enter start trace.

     -ne netr    [default: last trace]
          Enter end trace.

     -rs nrst    [default: first record]
          Enter start record.

     -re nred    [default: last record]
          Enter end record.

     -geometry
          Enter the command line argument '-geometry' to indicate
          that  the  attached flat file contains [index,X,Y] data
          where the index is referenced to  -hw   above  and  the
          X,Y  coordinate  data  will  be  stored  in  the header
          mnemonics referenced by  -hw1  and  -hw2  below.   This
          allows the user to install [X,Y] coordinate information
          from a flat file.

     -hw1 mnemonicX    [default: none]
          Enter the trace header mnemonic in which to store the X
          co-ordinate information from the attached flat file.

     -hw2 mnemonicY    [default: none]
          Enter the trace header mnemonic in which to store the Y
          co-ordinate information from the attached flat file.

     -hw3 mnemonicZ    [default: not used]
          This is an optional trace header mnemonic.  It  can  be
          used  to get a little more information out of your data
          header structure.  It cannot be used for input  to  the
          data header structure.  To date it is used to get X, Y,
          LI, DI listings from 3D data.

     -R   Enter the command line argument '-R'  to  produce  [hw,
          hw1, hw2] ASCII flat file output.

     -map Enter the command line argument '-map' to cause program
          to  run in record constant mode.  If -R is also flagged
          on the command line xyz2head will produce an [hw,  hw1,
          hw2] ASCII flat file output for the first live trace in
          a record where both [hw1] and [hw2] are non-zero.  This
          is  good for shot point maps for data QC.  If -R is NOT
          on the command line then xyz2head will assume an  input
          flat file format of x,y,value and install the value for
          all traces of the record.  In this case it is  expected
          that  there is a single entry in the flat file for each
          record in your dataset.  The  default  for  -hw1[]  and
          -hw2[]  in this case will be LinInd and DphInd although
          you can override these on the command line.   The  flat
          file value will be stored at the header location speci-
          fied by -hw[].  This is useful for entering things like
          water bottom depth at the shot.

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

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

BUGS

     none reported

AUTHOR

     Paul G.A. Garossino APR:3932

COPYRIGHT

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