NAME

     usp2hdr  - install USP format horizon data to a user defined
     trace header mnemonic.

SYNOPSIS

     usp2hdr [ -Nntap ] [ -Ootap ] [  -Mmtap  ]  [  -rsnrst  ]  [
     -renred  ] [ -nsnstr ] [ -nenetr ] [ -hwhw ] [ -hwrechwrec ]
     [ -hwtrchwtrc ] [ -offset_recoffrec ] [ -offset_trcofftrc  ]
     [ -nullnull ] [ -V ] [ -?  or  -h or  -help ]

DESCRIPTION

     usp2hdr : reads in a horizon dataset into memory, for  exam-
     ple  a record of N traces x M samples containing a processed
     water bottom image for your survey.  The trace  dimension  N
     corresponds  to  the  record indexing of the image while the
     sample direction M corresponds to trace indexing.  The  pro-
     gram  then  starts reading the -N[] input dataset.  For each
     trace it extracts indexing, extracts  a  horizon  value  for
     that  location,  stores  that  value in a user defined trace
     header location and exports the trace.  The  index  of  each
     input  trace  can come from a user defined trace header pair
     or simply be treated as sequential.  If the two datasets fit
     exactly, that is you have an input dataset of N records of M
     traces, then sequential is adequate.  If not  [for  instance
     you  are  installing  a  water  bottom  time  in  a prestack
     dataset] then the indexing should come from a  trace  header
     value.   Offsets  to the indexing may be entered on the com-
     mand line if required.  If the horizon dataset is  a  subset
     of the input data then a null value should be entered on the
     command line that will be  installed  in  the  output  trace
     header whenever the horizon does not exist.

     usp2hdr gets both its data and its parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the horizon dataset, the start and end traces, start and end
     records,  the  output  trace header mnemonic, the record and
     trace indexing trace header mnemonics, the record and  trace
     indexing  offsets,  the  null value 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 mtap  [default: none]
          Enter the  dataset  name  of  the  USP  format  horizon
          dataset.   This  dataset may be a single record of many
          traces or many single trace  records.   The  number  of
          traces  defines  the  number  of  records in the record
          index.  The number of samples controls  the  number  of
          traces in the trace index of the horizon.

     -rs nrst  [default: 1]
          Enter start record number.

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

     -ns nstr  [default: 1]
          Enter the start trace number.

     -ne netr  [default: last trace of record]
          Enter the end trace number.

     -hw hw  [default: none]
          Enter the mnemonic of the trace header entry into which
          to  store  the  horizon  value.  You may use integer or
          floating point entries as you like.  The  program  will
          adjust based on the format assigned to the mnemonic you
          are using.

     -hwrec hwrec  [default: sequential]
          Enter the mnemonic of the trace header entry from which
          the record indexing will be taken. [i.e.LinInd]

     -hwtrc hwtrc  [default: sequential]
          Enter the mnemonic of the trace header entry from which
          the record indexing will be taken.  [i.e.DphInd]

     -offset_rec offrec  [default: 1]
          Enter the record index associated  with  the  trace  1,
          sample 1 location of your horizon file.

     -offset_trc offtrc  [default: 1]
          Enter the trace index associated with the trace 1, sam-
          ple 1 location of your horizon file.

     -null null  [default: 0.0]
          Enter a value to be installed in the line header  when-
          ever  the horizon does not exist.  This may be the case
          if your horizon dataset is a subset of the area you are
          processing.

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

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

BUGS

     unknown

SEE ALSO

     xyz2head(1) xyzin(1) lmhorizon(1) hdr2xsdpick(1) hdrfil(1)

AUTHOR

     P.G.A. Garossino: 3615

COPYRIGHT

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