NAME

     farr  - build a farr-type display using input GI data

SYNOPSIS

     farr [ -Nntap ] [ -Ootap ] [ -sist ] [ -eiend ] [ -pvel ]  [
     -V ] [ -? ]

DESCRIPTION

     farr ordinarily takes input GI data, windows each record  in
     time,  and the arranges several of these windowed records on
     each output record.  The window obviously should be a  frac-
     tion (< 1/2) of the input trace length.

     Preprocessing  should  include  sorting  to  common   groups
     (although the farr type display can be used on any data):

          presort -Nindata -Otable

          sisort -Nindata -ntable -G | vred -vred10000 |

          farr -Oodata -s100 -e200

     where indata might be shot data, tabel is  the  sort  table,
     and a linear velocity moveout has been applied to the data.

     It is assumed that to take in the events of interest  within
     the  input  record the appropriate red or anmo has been run.
     The mini farr records can be separated from one  another  in
     time by a user specified pad.

     farr gets both its data and its parameters from command line
     arguments.  These  arguments  specify the input, output, the
     design window, 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).

     -s ist
          Enter the start time (ms) of the  design  window.   The
          default is the beginning of the trace.

     -e iend
          Enter the end time (ms) of the design window.  There is
          no default.

     -p pad
          Enter the time in ms  to  separate  in  time  the  farr
          records (on each output) record.  This time is in addi-
          tion to that specified by  the  window  start  and  end
          times.  Default = 40ms

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

BUGS

     unknown

SEE ALSO

     vred, anmo, bdnmo

AUTHOR

     P. R. Gutowski (at request of Don Wagner, Calgary)

COPYRIGHT

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