NAME

     mute  - apply muting


SYNOPSIS

     mute [ -Nntap ] [ -Ootap ] [ -nsns ] [ -nene ] [ -rsirs ]  [
     -reire ] [ -tmtm ] [ -vmvm ] [ -mdmindis ] [ -nrampnramp ] [
     -tmultmulfR ] [ -dmuldmulfR ] [ -A ] [ -Mmfile ] [ -F ] [ -D
     ]  [  -Kkeywrd  ]  [  -R  ] [ -off ] [ -hw1m1 ] [ -hw2m2 ] [
     -float ] [ -hwsms ] [ -H ] [ -V ] [ -? ]


DESCRIPTION

     mute removes the high_energy near_surface arrivals by  zero-
     ing  the  traces before an arbitrary time and greater than a
     given distance.

     Two options are available: (1)  velocity  driven  mute;  (2)
     time-offset  pair functions (essentially TDFN-type cards) or
     offset-time pairs (essentially DISCO mute card format), both
     keyed to a trace header value.

     mute gets processing controls from the command line. Reason-
     able defaults are setup.  In addition, if no input file name
     is given, the binary trace data are expected to  be  on  the
     standard input.

     This same program can be used to restore previous mutes per-
     formed  by  either  mute  or bdmute.  This is useful after a
     number of processing flows have been run after  a  mute  and
     you wish to restore the previous mute.

  Command line arguments
     -N ntap
          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. (default standard input )

     -O otap
          Enter the full path of the output file.  If not  speci-
          fied,   output  is  expected  to  be  standard  output.
          (default standard output )

     -tm tm
          Velocity mute option: Muting time  at  zero  offset  in
          milliseconds (default = 0.0 ms)

     -vm vm
          Velocity mute option: Muting velocity in  ft/s  or  m/s
          (default = 100000.


     -md mindis
          Velocity mute option: Minimum distance to mute in ft or
          m (default = mute option.  The header word accessed for
          distance is DstSgn (signed trace distance).

     -A   If present use the absolute trace distances,  otherwise
          use the signed trace distances

     -M mfile
          Time-offset mute option:  file  name  containing  time-
          offset  pairs. The header word accessed for distance is
          DstSgn (signed trace distance).  There are 3  permissi-
          ble  formats:  the default format is almost the same as
          that for TDFN functions cards except instead  of  velo-
          city  put offset with a format of nTDFN,7(F4.0,F6.0),I5
          (i.e. the only differences between  this  and  the  old
          TDFN  format  is  that  each  offset  takes up one more
          column), there is no job number, and the record  number
          follows  immediately  after  the time-offset pairs.  1-
          9TOFN cards are supported with the final one  for  each
          function  being  a  9TOFN.  On each 9TOFN card the last
          offset must be 99999. This tells the program that  this
          function is ended. The other formats are flat file for-
          mat and disco format described below.

     -F   If present, time offset cards are  in  flat  file  mute
          format. This is exactly the same format as for velocity
          functions described in the  man  pages  for  velin  and
          vomit:  each  function  consists of lines of entries, 3
          entries per line in free format. The  first  column  is
          the  2-way  time  of the mute; the second column is the
          offset; the third is the last record to which the func-
          tion  applies.  Any negative time terminates a function
          (you must put this  on  the  last  function  as  well).
          Linear  interpolation  of  the  times  is  made between
          offsets and the mute functions  are  linearly  interpo-
          lated between control records.

     -D   If present, time offset cards are in DISCO mute format.
          Basically  card  pairs:  card1 - ON   (recnum); card2 -
          (offset  time)  (offset  time)  (offset  time)  (offset
          time).   The format for card1 requires at least 1 space
          after the "ON" and before the header value. The 4 pairs
          of numbers on card2 are in format I8
           and are read as left justified integers (i.e.  numbers
          are  in  positioned  in  far right side of each field).
          card2 is repeated until  the  full  function  for  that
          (recnum) is complete.  A new function will begin with a
          new card1 followed by a card2 sequence.

     -K keywrd
          Time-offset mute option: this is the  mnemonic  of  the
          trace  header  word to key the functions on.  Default =
          RecNum.  Examples of some others: DphInd (depth index),
          SrcLoc (source index x 10), RecInd (group index)

     -ns ns
          First trace in record to process (default = 1  ).   All
          other traces in the record will be passed unmuted

     -ne ne
          Last trace in  record to process (default = all ).  All
          other traces in the record will be passed unmuted

     -rs irs
          First  record to process (default =  1  ).   All  other
          records in the data set will be passed unmuted

     -re ire
          Last  record to process (default = all  ).   All  other
          records in the data set will be passed unmuted

     -nramp nramp
          Number of milliseconds for linear ramp  between  zeroed
          trace and unmodified trace (default = 10 ms)

     -tmul tmul
          Time multiplier. This can be used to fake ms  into  say
          microsecs. Default = 1

     -dmul dmul
          Distance multiplier. This can be used  to  fake  inches
          into say feet. Default = 1

     -R   If present restore a previous mute/bdmute  run.   These
          programs  when  run  without  the  -R command line flag
          write the ON mute time into the  default  trace  header
          value  VPick1   and  the OFF mute time into the default
          trace header  entry   VPick2.   These  times  are  then
          accessed with the -R flag and other command line param-
          eters with the exception of  -nramp  are ignored.   Any
          trace  with 30000 in the StaCor entry will be zeroed at
          this time as well.

     -off If present mute is in OFF mode, i.e. mute is done  from
          the time computed to the end of the trace with the ramp
          starting at the mute start time.  Default is ON mute.

     -hw1 m1
          Trace header mnemonic in which to  store  the  ON  mute
          times.  Default = VPick1

     -hw2 m2
          Trace header mnemonic in which to store  the  OFF  mute
          times.  Default = VPick2

     -float
          If present the trace header words  are  floating  point
          values  (4 bytes). In this case do not choose two words
          that are adjacent (e.g. VPick1 VPick2) but rather those
          words  specifically  set aside for floats, e.g. Horz01,
          etc

     -hws ms
          Trace header mnemonic in which a mute start  time  (ms)
          is  stored.  This  is useful for varying the mute start
          times. The usual application would be to store the same
          mute  start time in every trace of a record. Default is
          to ignore.

     -H   If present then the mute line is hyperbolic,  otherwise
          it  is linear. In both cases the mute is driven by vm &
          tm (plus any mute start times stored in  the  headers).
          In    the    hyperbolic    case   the   mute   time   =
          sqrt[t**2+x**2/vm**2], where t = tm + header  times,  x
          is  the  offset,  and  vm  is the mute velocity. In the
          linear case mute start time = t + x / vm.

     -V   Verbose mode. List command line  and  lineheader  input
          parameters.

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


BUGS

     Currently every time-offset  function  must  have  the  same
     number of pairs.


SEE ALSO

     anmo, scan


AUTHOR

     R. B. Herrmann and M. R. Samiezade' Yazd (April,1986).


COPYRIGHT

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







Man(1) output converted with man2html