NAME

     instfr  - module to compute instantaneous frequency/polarity

SYNOPSIS

     instfr [ -Nntap ] [ -OFotap1 ] [ -OPotap2 ] [  -nsnstr  ]  [
     -nenetr ] [ -rsnrst ] [ -renred ] [ -flfl ] [ -fhfh ] [ -V ]
     [ -? ]

DESCRIPTION

     instfr computes both the instantaneous frequency vs time and
     the instantaneous polarity vs time for standard or multicom-
     ponent seismic data.  The outputs are standard sis format  3
     data.

     instfr gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the start and end traces, and verbose printout, if  desired.
     The algorithms are lifted from Rene' et al, Geophysics, June
     1986, pp 1235-1251.

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing  -N.   If piping in this command line entry will
          be omitted.  If the input data is 2 component  it  must
          be in multiplexed form, i.e. each seismic record should
          have traces which alternate components. 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

     -OF otap1
          Enter the output data set name or file for the  instan-
          taneous  frequency  data  immediately after typing -OF.
          The default output is stdout.  The output data set also
          requires the full path name (see above).

     -OP otap2
          Enter the optional output data set name or file for the
          instantaneous  polarity  data  immediately after typing
          -OP.  This output cannot be piped.  The output data set
          also requires the full path name (see above).

     -ns nstr
          Enter the start trace number.  Trace numbers below this
          value will not be processed.  The default is 1.

     -ne netr
          Enter the end trace number.  Trace numbers  above  this
          value  will  not be processed.  The default is the last
          trace number on the input data set.

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

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

     -fl, -fh fl, fh
          Enter low and high cut hard frequency limits.  The out-
          put  data  will be zeroed below and above these limits.
          Default values are fl = 10 hz, fh = 40 hz.

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

COPYRIGHT

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