/ 
App-SeismicUnixGui-0.87.2
River stage zero No dependents
/ App::SeismicUnixGui::sunix::shapeNcut::sukill

SYNOPSIS

PERL PROGRAM NAME:

AUTHOR: Juan Lorenzo (Perl module only)

DATE:

DESCRIPTION:

Version: 0.0.2 1.30.23

USE

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

Internal code example $sukill->min('2'); $sukill->Step()

Usage 2: $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.
 A bare file name: '1001' will automatically be given an suffix
 The file name on the disk will be '1001.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