NAME

     gqhorizon  - module to load GeoQuest ASCII horizon files  to
     USP headers.

SYNOPSIS

     gqhorizon [ -Nntap ] [ -Ootap ] [ -Lhtap ]  [  -rsnrst  ]  [
     -renred  ] [ -nsnstr ] [ -nenetr ] [ -Hwword ] [ -Dwword ] [
     -Lwword ] [ -lstartli ] [ -dstartdi ] [ -linclinc ] [ -dinc-
     dinc  ]  [ -padpad ] [ -nullnval ] [ -reprnval ] [ -grid ] [
     -V ] [ -? ] [ -h ]

DESCRIPTION

     gqhorizon loads horizon times from a GeoQuest default format
     ASCII  3D horizon export file to a user defined trace header
     word.

     gqhorizon gets both its data and its parameters from command
     line  arguments.  These arguments specify the input, output,
     the horizon file, the start and end records, the  start  and
     end traces, the trace header mneumonic to associate with the
     line index, trace index and Horizon Time entries in the Hor-
     izon  file,  the  line  and trace offsets and increments and
     verbose printout, if desired.

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

     -rs nrst
          Enter start record number.  Default value is the  first
          record.

     -re nred
          Enter end record number.  Default value is last record.

     -ns nstr
          Enter the start trace number.  The default is the first
          trace of the record.

     -ne netr
          Enter the end trace number. The  default  is  the  last
          trace of the record.

     -Hw hword
          Enter USP trace header mneumonic in which to store hor-
          izon time. There is no default for this entry.

     -Dw dword
          Enter USP trace header mneumonic from which  to  refer-
          ence  the  secondary  index  in  the  horizon file. The
          default is TrcNum.

     -Lw lword
          Enter USP trace header mneumonic from which  to  refer-
          ence the primary index in the horizon file. The default
          is RecNum.

     -lstart lstart
          Enter the GeoQuest  Areal  Extent  line  minimum.   The
          default is 1

     -dstart dstart
          Enter the GeoQuest Areal  Extent  trace  minimum.   The
          default is 1

     -linc linc
          Enter the line increment used to generate the  GeoQuest
          horizon file.  The default is 1.0

     -dinc dinc
          Enter the trace increment used to generate the GeoQuest
          horizon file.  The default is 1.0

     -pad pad
          Enter pad size in milliseconds added to the top of  the
          3D data volume to handle excessive squeeze.

     -null nval
          Enter null value amplitude to be replace with  replace-
          ment amplitude below.

     -rep rnval
          Enter null replacement amplitude to use to replace null
          values in GeoQuest grid files.

     -grid
          Enter the command line argument  '-grid'   if the input
          attached to  '-L'  is a GeoQuest Grid File.

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


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

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

DISCUSSION

     If you do not enter the correct values for -lstart, -dstart,
     -linc   and  -dinc  the  horizon  information  will  not  be
     correctly mapped to the data headers.  As  an  example  con-
     sider  a  3D  dataset  which exists in the GeoQuest database
     from line 202 to line 516 and from trace 1 to 490.   If  one
     was  to  generate  an  horizon  output every second line and
     every trace the command line to load the  horizon  times  to
     the  dataset (having sequential (starting from 1) TrcNum and
     RecNum entries ) would look like:

      gqhorizon -Ninput -Ooutput -Lhorizon  -HwTVPT01  -lstart202
     -linc2

BUGS

     The GeoQuest ASCII horizon file must  be  a  default  output
     file.   If  you  start  flagging  anything  other  than  the
     defaults for a given horizon I can't predict what will  hap-
     pen.   If you find this too cumbersome give be a call.  This
     was written from the lmhorizon routine in about 20  minutes.
     The nomenclature with respect to areal extent parameters may
     be in error.  I am not a geoquest guy.  I have only seen the
     one  ASCII  file  that I used to build this routine.  If you
     have trouble with the defaults then give me a call and  edu-
     cate me.....Garossino

SEE ALSO

     psdm3d(1) lmhorizon(1)

AUTHOR

     Paul.     G.     A.     Garossino      ,      Feb      1994,
     [APR:3932:zpgg07@trc.amoco.com]

COPYRIGHT

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