view release on metacpan or  search on metacpan

lib/App/SeismicUnixGui/sunix/shapeNcut/sumute.pm  view on Meta::CPAN

	CWP: Jack K. Cohen, Dave Hale, John Stockwell

	DELPHI: Alexander Koek added airwave mute.

      CWP: John Stockwell added modes 3 and 4

	USBG: Florian Bleibinhaus added hmute + some range checks on mute times

 Trace header fields accessed: ns, dt, delrt, key=keyword, trid, d1

 Trace header fields modified: muts or mute



=head2 User's notes (Juan Lorenzo)

V 0.0.2

Normally, sumute can only apply one set muting coordinates to one gather
at a time.

In this manner you would use a 
"par_file" e.g.,

tmute=0.128544,0.245747

xmute=73.2464,95.6714

In this particular case, the mute pick coordinates
in the "x" direction are tracr values.

sumute sp_fldr4.su par=par_file key=tracr mode=0 | 
sugain agc=1 wagc=0.1 | suxwigb clip=1.5 &


Now, we have added some options to allow the user to mute a file
that contains many gathers at one time. You will need to supply 
a "multi-gather", mute-type parameter file. That is, sumute.pm 
can use a concatenated  collection of the contents of these individual 
parfiles. The name of this file is called the "multi_gather_par_file"".

Generate the "parfiles" (x,t values in SUnix "par" format) 
using the iTopMute Tool. iTopMute saves the picked values 
into individual "parfiles" named according to
their corresponding gather.

To create a multi-gather parameter file 
this composite "parfile" can be concatenated from individual parfiles
using the Tool: Sucat

We now have added the following options
to sumute:

gather_type           = ep (shotpoint),cdp (cdp gathers),fldr(field data gathers)

multi_gather_par_file = a concatenated file of the individual parfiles

multi_gather_su_file  = the su file which was muted interactively to 
create each of the parfiles, while using the Tool: iTop_Mute 

A multi-parameter-file looks as follows:

cdp=1,2

tmute=0.141777,0.251418
xmute=73,96

tmute=0.131777,0.241418
xmute=85,96


Internally, sumute uses "susplit" to break a large multi-gather file into individual
shotpoint gathers (ep), or cdp gathers or fldr (gathers) according to Segy
key header words. 

An example:

Data consists of a single CDP gather, digitized in iTopMute as a function
of tracr (x-co-ordinate)

The parameter values in sumute are:
gather_type=cdp

header-word=tracr

multi_gather_par_file=list

multi_gather_su_file=sp_fldr4


the file "list" is as follows:

cdp=1

tmute=0.141777,0.251418

xmute=73,96


Note, DO NOT include a separate
"data_in" file in the flow. The "data_in" is not necessary
because the new option in 
sumute reads multi_gather_su_file automatically.

=cut

=head2 CHANGES and their DATES

Nov. 2022, V 0.0.2
June 2023, split files are read from DATA_SEISMIC_SU directory
March, 2024, V 0.0.3
		corrected error in removal of extra ".su" in output muted file name

=cut

use Moose;
our $VERSION = '0.0.3';

=head2 Import packages

=cut