NAME
maip - indexes marine lines and optionally performs several
auxiliary functions (with, or independently of, indexing).
These auxiliary functions include storing field history
information, storing water depths, and storing trace dis-
tances.
SYNOPSIS
maip [ -Nntap ] [ -Ootap ] [ -Ccardin ] [ -saveperm ] [ -V ]
[ -? ]
DESCRIPTION
maip indexes marine lines. Working from observers' notes,
various aspects of the recording geometry can be described.
From this information, maip can set and store needed entries
in the line header and trace header for future referencing.
maip also performs auxiliary functions that can be executed
with, or independently of, indexing. These auxiliary func-
tions are used to correct previous processing errors or
change existing information. Whether indexing is being per-
formed or not, the information input through the use of
these functions will be stored in the appropriate headers.
NOTE: If indexing, nDSTN cards are REQUIRED. IF nDSTN
cards are present, they MUST be the last cards in the deck.
Any cards submitted after nDSTN cards WILL BE IGNORED!
Command line arguments
-N ntap
Enter the full path name of the file containing the
input data set. If not specified, input is expected to
be on the standard input (a pipe into maip). If no
input file is given, and there is no standard input,
the program will abend.
-O otap
Enter the full path name for the output file to receive
the output data. If no output file is specified, the
program will write the output data to the standard out-
put (a pipe out of maip).
-C cardin
File from which processing parameters necessary for
executing maip are specified in card image format. An
error message will be issued if cardin does not exist.
The parameter cards required for maip are:
Card Image: data column entries
Column Variable
*******This card is REQUIRED*******
Only one 1MAIP card allowed per execution.
******* MUST be the first parameter card input.******
1-5 1MAIP (required)
6 sign convention for trace distances
blank or 0=positive tr.dist are behind the shot
(i.e., away from direction of line progression)
1 = positive tr. distances are ahead of the shot
(i.e., in direction of line progression)
7 perform indexing?
blank or 0 = yes
1 = no
8 type of units (will be stored in line header)
blank or 0 = English
1 = Metric
9 plot direction to store in line header
blank or 0 = normal (plot L to R)
1 = reverse (plot R to L)
10 output error histograms?
blank or 0=yes
11-20 normal in-line cable distance (ft or mtr) between
successive recording groups in a single shot.
Required when indexing requested. If decimal
entered, fractional value carried through all
calculations of group indexes but rounded to
nearest integer before storing in line header.
21-30 Distance (ft or mtr) the source is normally advanced
from record to record. Required if indexing is
requested. Decimal may be entered.
31-35 Numeric source point identifier for first output record.
Must be positive.
blank or 0 = 1
38-40 Increment/decrement source point numbers ofoutput records
in steps of this value. Positive entry = increment;
negative entry = decrement.
blank or 0 = 1
44-45 Increment for record-variable source point numbers.
blank or 0 = 1
69-75 Job number. Should agree with job no. of
input data set.
Column Variable
*******This card is OPTIONAL*******
Only one 2MAIP card allowed per execution.
MUST follow 1MAIP.
******* MUST precede nDSTN cards(if present) ******
1-5 2MAIP (required when 2MAIP card is input)
7-10 Fold
11-20 Group Indexing Interval
ft or mtr; decimal may be entered.
blank or 0 = minimum of the following:
1) group (receiver) spacing (cc11-20 1MAIP);
2) normal source moveup (cc21-30 1MAIP); or
3) absolute value [group (receiver) spacing -
normal source moveup]
21-30 Depth Point Indexing Interval
ft or mtr; decimal may be entered; fractional
value carried through all calculations of depth
point indexes, but rounded to nearest integer
before storing in line header.
blank or 0 = minimum of the following:
1) group indexing interval (cc11-20 2MAIP); or
2) group (receiver) spacing / 2.
31-40 Source Labeling Offset
ft or mtr; decimal may be entered; may be positive
or negative. Positive distance is ahead of shot
location.
blank or 0 = label is at the source
41-50 Job-constant Static
entry is added to trace header static words; no
application. Decimal may be entered, but is
rounded to nearest integer before storage.
65 Source Location
defines the source location; entry is only stored
in line header, not used in any computations.
blank or 0 = source on groups
1 = source between groups
69-75 Job number. Should agree with job number
on input data set.
77-80 Water Velocity
ft or mtr per second. Entry is stored in line
header only when indexing requested (cc7 2MAIP =
blank or 0). Default depends on type of input
units defined in cc8 of 1MAIP card.
blank = 4850 ft/sec for English units; and
1480 mtr/sec for metric units.
Column Variable
*******This card is OPTIONAL*******
Only one 3MAIP card allowed per execution.
Non-blank entries are stored in line hdr.
******* MUST precede nDSTN cards(if present) ******
1-5 3MAIP (required when 3MAIP card is input)
15-20 Crew Identifier
21-30 Processor's Name
Enter name of the processor, scheduler,
interpreter, party chief, etc.
33-40 Date
Date to be filed in line header; must be numeric.
It may be input as either MM/DD/YY or DD/MM/YY where
MM = month
DD = day
YY = year
44-46 OAC (Operations Activity Code identifier)
47-50 Line Number
52-55 Line Direction
Enter bearing of line. Line direction is measured
from the last location on the line toward the first
location and is expressed in whole degree East or
West of North or South.
Enter "N" or "S" in cc52; the angle from North or
South (0 degrees to 90 degrees) in cc53-54; and "E"
or "W" in cc55.
Column Variable
*******These cards are OPTIONAL*******
All nCABL card sets must be input in succession.
******* MUST precede nDSTN cards(if present). ******
1-5 nCABL (required when nCABL cards are input)
"n" ranges from 1-9. If more than 9 nCABL cards are
needed for a given set, repeat the 1-9 numbering
sequence.
7-20 Trace Number/Depth pairs
22-35 Each 14-col field contains a trace number in the
37-50 first 4 columns, and a depth (ft or mtr) for that
52-65 trace in the next 10 columns. A pair is required
for the first and last traces in the record.
Cable depths are linearly interpolated between listed
values. Cable depths are spatially interpolated
between the record numbers if more than one set of
nCABL cards are input. Decimals may be entered;
fractional values carried through all calculations
of statics, but rounded to nearest integer before
storing in trace headers.
69-75 Job Number. Should agree with input data set.
76-80 Record Number to which this set of nCABL cards apply.
NOTE: the parameters defined on the first set of nCABL
card(s) apply to all records that precede the first
specified record. The values on last set of
nCABL cards apply through the last record on line.
Column Variable
*******These cards are OPTIONAL*******
Submit as many 1WATR cards as needed to describe
water depths for all output records.
******* MUST precede nDSTN cards(if present). ******
1-5 1WATR (required when 1WATR cards are input)
6-20 Source Point/Water Bottom Depth pairs
21-35 Each 15-column field conatins a source point
36-50 number in the first 5 columns, and the water
51-65 bottom depth (ft or mtr) for that source point
in the next 10 columns. Water bottom depths are
linearly interpolated between specified values for
source points not listed. Water depths for source
points before the first pair input are set to the
first pair's depth, and water depths after the
last pair input are set tot he last pair's depth.
Source points and associated water depths may be
input in any order. Decimal values may be input,
but are rounded to nearest integer for storing in
trace headers. Negative or zero source point
numbers and assoc. water depths are ignored.
69-75 Job Number. Should agree with input data set.
Column Variable
*******These cards are OPTIONAL*******
Used to describe additional source information. If
any 1MOOV cards are submitted, any input records not
included on them are dropped. Maximum of 500 cards
allowed.
These cards are used to:
-describe shot moveups that deviate from normal;
-provide a way to drop test records;
-compensate for varying boat speed; and
-provide source depth for computation of
trace-variable statics.
******* MUST precede nDSTN cards(if present).******
1-5 1MOOV (required when 1MOOV cards are input)
6-10 First record number to which this card applies. REQUIRED
when 1MOOV cards are input.
11-15 Last record number to which this card applies. REQUIRED
when 1MOOV cards are input.
If parameters on this card apply to only one record,
that record number must appear in both these fields.
16-20 First record source ID.
Source point identifier for record in cc6-10. Must
be a positive value. This entry guarantees the
first record will have this source label and
position.
blank or 0 = on first card, cc31-35 on 1MAIP.
otherwise, previous labeled source point plus
source point increment/decrement. The labeled
source point is determined from the "Normal Source
Moveup" (1MAIP cc21-30) and the "Record Labeling
Increment" (1MAIP cc44-45).
21-30 Source Moveup (ft or mtr)
blank = normal source moveup (1MAIP cc21-30)
0 = do not advance indicated record(s)
31-40 Source Depth (ft or mtr)
Entry is stored in trace headers of the appropriate
record(s). Decimal may be entered.
NOTE: this entry, along with cable depths input
on nCABL cards, is used to compute trace-
variable statics.
Column Variable
*******These cards are OPTIONAL*******
Submitted only if field history information is to
be placed in line header of output data set. As
many 1FLDH cards as necessary may be input.
NOTE: if field history information already exists
in input data set line header, it will be
replaced by this information.
******* MUST precede nDSTN cards(if present). ******
1-5 1FLDH (required when 1FLDH cards are input)
11-45 Field History Information
This entry is a free-form field and may be completed
as necessary to enter field history information.
Blank entries appear as blank lines on the plot
label.
Column Variable
*******These cards are REQUIRED when indexing*******
Submit as many sets of DSTN cards as necessary to
adequately describe trace distances for all output
records.
*******If submitted, MUST be the last card(s) input.*******
1-5 nDSTN (required when nDSTN cards are input)
"n" ranges from 1-9. If more than 9 nDSTN cards are
needed for a given set, repeat the 1-9 numbering
sequence.
7-20 Trace Number/Distance pairs
22-35 Each 14-column field contains a trace number in the
37-50 first 4 columns, and the distance (ft or mtr) for
52-65 that trace in the next 10 columns. Pairs of values
are required for the first and last traces in the
record. Distances for traces not listed are
linearly interpolated between the listed values.
Decimals may be entered for the distances;
fractional distances used in the assignment of all
indexes, but are rounded to the nearest integer for
storing in trace headers.
69-75 Job number. Should agree with the input data set.
76-80 Last Record Number to which this set of cards applies.
Required (except on last set of DSTN cards).
No spatial interpolation of parameters is performed.
blank or 0 = 99999 on last set of DSTN card;
otherwise invalid.
-saveperm
Flag to not reset Permanent Record Index and Permanent Trace Index to
calculated record and trace numbers.
-V Verbose mode.
Detailed information about the processing parameters is sent to the
output listing device.
-? Query mode. With this flag, maip will
send a description of the command line arguments to the
standard error output and stop.
If operating under the Berkeley shell (csh), the -? must be quoted
with single quotes, i.e., '-?'.
BUGS
No trap for running program without an input file and noth-
ing in the standard input.
A command line option letter and its corresponding argument
may not be separated by whitespace.
***If nDSTN cards are submitted, they MUST be the last cards
in the deck. Any cards submitted AFTER nDSTN cards WILL BE
IGNORED.***
NOTE 1:
The trace header word SrcLoc (source location index *10)
may exceed the maximum integer*2 value of 32767. In order to
allow program prepmig and sisort to proceed, the source
location index *10 value is also stored in integer*4 header
word SGRDat.
AUTHOR
Paul Gutowski (1992) Marilyn Miller (1992)
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html