SYNOPSIS

PERL PROGRAM NAME:

AUTHOR: Juan Lorenzo (Perl module only)

DATE:

DESCRIPTION:

Version: 0.0.2 1.30.23

USE

Usage 1: To kill an array of trace numbers

Example: $sukill->tracl(\@array); $sukill->Steps()

Usage 2: To kill a single of trace number count=1 (default if omitted)

Example: $sukill->min('2'); $sukill->Step()

If you read the file directly into sukill then also us sukill->file('name')

Usage 3: $sukill->list(list_of_traces_to_kill) $sukill->su_base_file_name(file_in_seismic_unix_format)

NOTES

Examples

SYNOPSIS

SEISMIC UNIX NOTES SUKILL - zero out traces

 sukill <stdin >stdout [optional parameters]                    

 Optional parameters:                                           

        key=trid        header name to select traces to kill    

        a=2             header value identifying traces to kill

 or

        min=            first trace to kill (one-based)         

        count=1         number of traces to kill                


 Notes:                                                 

        If min= is set it overrides selecting traces by header. 


 Credits:

        CWP: Chris Liner, Jack K. Cohen

        header-based trace selection: Florian Bleibinhaus


 Trace header fields accessed: ns

CHANGES and their DATES

 JML V0.0.2, 1.30.23

 Normally, sukill can kill contiguous traces.
 To kill while skipping traces requires an
 iteration (i.e., logical for loop) over the same file.
 
 In V0.0.2 I wrap an extension to process an arbitrary
 list of trace numbers. I automate the iteration by including
 two additional parameters: list and su_base_file_name
 
 The parameter "list" is the name of a text file.
 The file is automatically bound to the SEIMICS_DATA_TXT 
 directory path.
 
 "list" is the name of a file containing a numeric list
 of trace numbers of type "key" that are to be deleted:
 
 An example list
 file contains values, one per line.
    1 
    3 
    5

  "list" = a file name (in directory path: DATA_SEISMICS_TXT)
  
  su_base_file_name =   e.g., 1001, which by defaults lies
  in directory path: DATA_SEISMIC_SU
  
  Notes:
  If list is used then su_base_file_name and key MUST be used
  If list is used ONLY su_base_file_name and key CAN be used

  Within code, the imported "list" includes path and name;
  hence its name: _inbound_list. User enters a list name in 
  GUI using the mouse <MB3>.

Import packages

instantiation of packages

Encapsulated hash of private variables

sub Step

collects switches and assembles bash instructions by adding the program name

sub note

collects switches and assembles bash instructions by adding the program name

sub clear

_check4inbound_listNkey

sub _get_inbound

sub _get_trace_numbers

sub _set_inbound_list

sub a

sub count

sub key

sub list

 list array

sub min

sub su_base_file_name

 su_base_file_name

sub get_max_index

max index = number of input variables -1

cpanm App::SeismicUnixGui

perl -MCPAN -e shell
install App::SeismicUnixGui