NAME

     hdr2vghrz  - create voxel geo horizon file from data  stored
     in  user  defined  entries in USP trace header with optional
     horizon colour and name assignment.

SYNOPSIS

     hdr2vghrz [ -Nntap ] [ -rsnrst ] [ -renred ] [ -nsnstr  ]  [
     -nenetr  ]  [ -nullnull ] [ -hwhwd ] [ -hchwc ] [ -hnhwn ] [
     -V ] [ -?  or  -h or  -help ]

DESCRIPTION

     hdr2vghrz : allows the user to specify up to 100  valid  USP
     trace  header mnemonics from which to generate vghrz horizon
     files for display  in  voxel  geo.   Each  horizon  will  be
     displayed  as a different surface on the input dataset.  You
     may select from a list of valid horizon colours a colour  to
     associate  with  your  horizon data.  You may also specify a
     name for each horizon.  There will be as many  output  vghrz
     files created as horizons requested, each named according to
     the vghrz horizon name  requested.   Each  horizon  will  be
     stored  in  a  unique output file.  At the moment the output
     files will be dropped in the directory from which the job is
     initiated.

     hdr2vghrz gets both its data and its parameters from command
     line  arguments.   These  arguments  specify  the input, the
     start and end traces, start and  end  records,  the  horizon
     null  value,  horizon  mnemonics,  horizon  colours, horizon
     names 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: not used]
          Enter the rootname to use for the output vghrz  horizon
          files.  This allows you to point the output files to an
          arbitrary directory.  The default is to drop the  files
          in the directory where the job was run.

     -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.

     -null null  [default: -30000.0]
          Enter the horizon null value used to flag that the hor-
          izon  does  not  exist  at any point in the volume.  No
          pick will be output at locations whose header  contains
          this value.

     -hw horizon  [default: no default, entry required]
          Enter the trace header mnemonic associate with the hor-
          izon  that you wish to convert to a vghrz horizon file.
          If you have more than a single horizon to convert  sim-
          ply  put as many [up to 100] -hw entries on the command
          line as you  require.   When  associating  colours  and
          names  with these horizons they will be assigned in the
          order that  they  appear  on  the  command  line.   For
          instance the first colour and name entries will go with
          the first horizon entry and so on.

     -hcw colour  [default: yellow]
          Enter the colour that you wish to associate  with  your
          input  horizon  pick  in the output vghrz horizon file.
          If you have more than a single horizon to convert  sim-
          ply  put as many [up to 100] -hw entries on the command
          line as you require.   When  associating  colours  with
          these  horizons  simply  put  an  equal  number  of -hc
          entries.  The colors will be assigned in the order that
          they  appear  on  the  command  line.  For instance the
          first colour entry will go with the first horizon entry
          and so on.  Valid colours are

       black
       white
       red
       blue
       green
       magenta
       purple
       yellow
       cyan
       orange


     -hn name  [default: USP Mnemonic ]
          Enter the name that you wish  to  associate  with  your
          input  horizon  pick  in the output vghrz horizon file.
          If you have more than a single horizon to convert  sim-
          ply  put as many [up to 100] -hn entries on the command
          line as you require.  When associating names with these
          horizons  simply  put  an  equal number of -hn entries.
          The names will be  assigned  in  the  order  that  they
          appear  on  the  command  line.  For instance the first
          name entry will go with the first horizon entry and  so
          on.

     -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.

DISCUSSION

     This routine assumes that the TmMsFs [ time in  milliseconds
     of first sample] entry in your input dataset is correct.  If
     not you may find your horizons do not match  your  horizons.
     Also  in USP [as in DISCO and ProMax] sample 1 is assumed to
     be time zero  unless  otherwise  indicated,  i.e.  TmMsFS  =
     nonzero.  If you notice that your horizons are off by a sam-
     ple you may have a problem in this area.  Make sure you know
     the  assumptions  made in timing your input dataset.  If you
     have any trouble with the association feel free to call  the
     USP help line and thrash out your problem.

BUGS

      Unknown  but sure to exist.

SEE ALSO

      lm3dvtosis(1) lm3dhrztosis(1) lmhorizon(1)

AUTHOR

     [Paul G. A. Garossino: socon 422-3932]

COPYRIGHT

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