NAME

     smute  - apply a windowed surgical mute with cosine taper

SYNOPSIS

     smute [ -Nntap ] [ -Ootap ] [ -rsirs ] [ -reire ] [ -nsns  ]
     [  -nene  ] [ -winwin ] [ -tapertaper ] [ -expexp ] [ -H ] [
     -xminmindis ] [ -xmaxmaxdis ] [ -tminmintim ] [  -tmaxmaxtim
     ] [ -t0tm ] [ -vvm ] [ -tmultmul ] [ -dmuldmul ] [ -V ] [ -?
     -h -help ]

DESCRIPTION

     smute

     is used to perform a surgical mute  within  a  record.   The
     mute  shape  is controlled by the relationship between trace
     distance and a user defined command line parameters  govern-
     ing  mute  start and stop times and distances.  You may mute
     at a specified start time and velocity over a window length.
     A  cosine taper is applied over a user defined percentage of
     the window both at the onset and offset of the  mute.   This
     might  be  good for removing an airwave without removing all
     the data at earlier and later times than the airwave.  It is
     also useful in concert with the  USP  routine  stft  to per-
     form  localized  muting  of  induvidual  frequency  sub-band
     records.

  Command line arguments
     -N ntap  [stdin]
          Enter the full path of the  file  containing  the  data
          set.   If  not specified, input is expected to be stan-
          dard input.  If standard input  is  not  specified  and
          there  is  no  input,  e.g., program run in background,
          expect a termination.

     -O otap  [stdout]
          Enter the full path of the output file.  If not  speci-
          fied, output is expected to be standard output.

     -rs irs  [default = 1]
          First  record to process, all other records in the data
          set will be passed unmuted

     -re ire  [default = all]
          Last  record to process all other records in  the  data
          set will be passed unmuted

     -ns ns  [default = 1]
          First trace in record to process all  other  traces  in
          the record will be passed unmuted

     -ne ne  [default = all]
          Last trace in  record to process all  other  traces  in
          the record will be passed unmuted

     -win window  [default = 48]
          temporal size of the mute window to be hung  below  the
          mute start time.

     -tapertaper  [default = 25]
          Describes the percent of the muting window  over  which
          to  taper  the data.  The taper is applied at the onset
          and offset of the mute within the bounds of the window.

     -expexp  [default = 2]
          Window  weighting  exponent.  Powering  up  the  window
          weights makes the cosine taper more severe.

      -H   [default = linear]
          if present on the command line the mute start time will
          be calculated using an hyperbola.  The hyperbolic velo-
          city and zero offset time will come from the  -v    and
          -t0  command line entries [see below].

      -xmin mindis  [default = 0]
          minimum distance to mute (ft or m).

      -xmax maxdis  [default = all]
          maximum distance to mute (ft or m).

      -tmin mintim  [default = 0]
          minimum time to mute.

      -tmax maxtim  [default = all]
          maximum time to mute.

     -t0 t0  [default = 0]
          muting start time at zero offset

     -v vm  [default = 100000.0]
          muting start velocity in units/s

     -tmul tmul  [default = 1.0]
          temporal sample interval multiplier.

     -dmul dmul  [default = 1.0]
          spatial distance multiplier.   This  parameter  affects
          both  the  trace  distances  [as  read  from  the trace
          header] and the distance parameters entered on the com-
          mand  line.   If  you  use this parameter remember that
          whatever you enter for  -xmin  and  -xmax   above  will
          be multiplied inside the program by this value.

     -V   Verbose printout mode.

     -?  or -h or -help
          Query mode.  With this flag, smute will give a descrip-
          tion of the command line arguments and terminate.  pro-
          gram.

BUGS

     unknown

SEE ALSO

     mute(1), bdmute(1), polymute(1)

AUTHOR

     Wagner and Gridley 1995; Guto Nov 11/95; Garo Dec 15/95

COPYRIGHT

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