view release on metacpan or  search on metacpan

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

 If data are spatial, such as the (z-x) output of a migration, then    

 depth values are used in place of times in tmute and tfile. The value 

 of the depth sampling interval is given by the d1 header field	

 You must use the option key=tracl in sumute in this case.		



 Caveat: if data are seismic time sections, then tr.dt must be set. If 

 data are seismic depth sections, then tr.trid must be set to the value

 of TRID_DEPTH and the tr.d1 header field must be set.			

 To find the value of TRID_DEPTH:  					

 type: 								

     sukeyword trid							

	and look for the entry for "Depth-Range (z-x) traces





 Credits:



	SEP: Shuki Ronen

	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

use aliased 'App::SeismicUnixGui::misc::L_SU_global_constants';
use App::SeismicUnixGui::misc::SeismicUnix
  qw($go $in $itop_mute_par_ $ibot_mute_par_ $off $on $out $ps $to $suffix_ascii $suffix_bin
  $suffix_ps $suffix_segy $suffix_su $tmute $xmute);
use aliased 'App::SeismicUnixGui::configs::big_streams::Project_config';
use aliased 'App::SeismicUnixGui::misc::manage_files_by2';