NAME
maip2 - 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
distances.
SYNOPSIS
maip2 [ -Nntap ] [ -Ootap ] [ -CABLncabl ] [ -WATRnwatr ]
[ -MOOVnmoov ] [ -FLDHnfldh ] [ -DSTNndstn ] [ -mode ] [ -
noindx ] [ -metric ] [ -pltrev ] [ -nohist ] [ -ibtwn ] [ -
recintrecint ] [ -srcintsrcint ] [ -sp1spnum1 ] [ -
spincspinc ] [ -labincripsrc ] [ -foldifold ] [ -
giintgiint ] [ -diintdiint ] [ -laboffoffset ] [ -
jcstatjcstat ] [ -watvelwatvel ] [ -crewcrew ] [ -
procnmpname ] [ -dateadate ] [ -oaclineOACLine ] [ -
lindirdirect ] [ -dist1dist1 ] [ -dist2dist2 ] [ -
cdep1cdep1 ] [ -cdep2cdpe2 ] [ -saveperm ] [ -V ] [ -? ]
DESCRIPTION
maip2 indexes marine lines. Working from observers' notes,
various aspects of the recording geometry can be described.
From this information, maip2 can set and store needed
entries in the line header and trace header for future
referencing. maip2 also performs auxiliary functions that
can be executed with, or independently of, indexing. These
auxiliary functions are used to correct previous processing
errors or change existing information. Whether indexing is
being performed or not, the information input through the
use of these functions will be stored in the appropriate
headers.
This version of maip2 uses command-line arguments instead of
old SIS format card images to input the needed parameters.
However, because of the possibility of needing data that is
difficult and/or tedious to code in command-line arguments,
this version still allows the user to input certain data via
the old SIS formatted card images (i.e., nCABL, 1WATR,
1MOOV, nDSTN). This version allows the user to input the
first and last distances (-dist1 and -dist2) on the
command-line instead of requiring him to use the card image
format. This version also allows cable depths (-cdep1 and
-cdep2) to be input for the first and last traces. These
command-line arguments therefore must use the same values
for all records in the dataset. If this is not acceptable,
the user then may input the appropriate card image datasets
instead. Be advised, however, if a dataset (-DSTNndstn) is
specified in addition to -dist1 and/or -dist2, the dataset
(-DSTNndstn) will be ignored (same for -CABLncabl and -cdep1
and/or -cdep2). The field history data is input as a
dataset (-FLDHnfldh) which consists of lines containing up
to 35 characters per line. No preceding 1FLDH should be
present on the lines (as was required in the SIS formatted
card images).
NOTE: If indexing, distances are REQUIRED. Distances may
be input either as -dist1 and -dist2 command-line arguments,
or in a flatfile in the old SIS card image format as
-DSTNndstn.
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 maip2). 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 maip2).
-CABL ncabl
File containing old SIS format nCABL card images.
-WATR nwatR
File containing old SIS format nWATR card images.
-MOOV nmoov
File containing old SIS format nMOOV card images.
-DSTN ndstn
File containing old SIS format nDSTN card images.
-FLDH nfldh
File containing lines of up to 35 characters each to
specify the Field History Information to be put into
the output dataset lineheader.
-mode
Override: sign convention=positive tr.dist. ahead of
shot. (default = positive tr.dist. behind shot)
-noindx
Override: do not index the dataset (default=index
dataset)
-metric
Override: Metric units (default=English units)
-pltrev
Override: reverse plot direction (left to right)
(default=normal=right to left)
-nohist
Override: do not display histograms (default = display)
-ibtwn
Override: sources are between groups(default=sources
are on groups)
-recint recint
Group (receiver) spacing (ft or m) (required when
indexing)
-srcint srcint
Normal source moveup (ft or m) (required when indexing)
-sp1 spnum1
First record source ID (default = 1)
-spinc spinc
Source Point increment/decrement (default = 1)
-labinc ripsrc
Record labeling increment (default = 1)
-fold ifold
fold
-giint giint
Group indexing interval (ft or m)
-diint diint
Depth Point indexing interval (ft or m)
-laboff offset
Source labeling offset (ft or m) (default = label is at
the source)
-jdstat jdstat
Job constant static
-watvel watvel
Water velocity (ft/s or m/s) (default = 4850 ft/s or
1480 m/s)
-crew crew
Crew identifier (6 characters, left justified, no
spaces)
-procnm pname
Processor's name (10 characters, left justified, no
spaces)
-date adate
Date of processing (8 characters, left justified, no
spaces) (form of entry should be mm/dd/yy,
i.e.,08/22/94 )
-oacline OACLine
OAC/line number (7 characters, left justified, no
spaces) (form of entry should be OAC (3 chars) followed
by line number (4chars) )
-lindir direct
Line direction (4 characters, left justified, no
spaces) (form of entry should be N or S, line direc-
tion, E or W; i.e.,N45W)
-dist1 dist1
Trace distance (ft or m) for first trace of each record
(default=0)
-dist2 dist2
Trace distance (ft or m) for last trace of each record
(default=0)
-cdep1 cdep1
cable depth (ft or m) for first trace of each record
(default=0)
-cdep2 cdep2
cable depth (ft or m) for last trace of each record
(default=0)
-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 process-
ing parameters is sent to the output listing device.
The parameter cards which may be input to maip2 are:
Card Image: data column entries
Column Variable
*******These cards are OPTIONAL*******
*******Format of card images in dataset
specified by -CABL[ncabl]*******
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. No longer required.
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*******
*******Format of card images in dataset
specified by -WATR[nwatr]*******
Submit as many 1WATR cards as needed to describe
water depths for all output records.
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. No longer required.
Column Variable
*******These cards are OPTIONAL*******
*******Format of card images in dataset
specified by -MOOV[nmoov]*******
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.
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*******
*******Format of card images in dataset
specified by -FLDH[nfldh]*******
Submitted only if field history information is to
be placed in line header of output data set. As
many 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.
1-35 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
unless -dist1 and -dist2 command line
arguments are present*******
*******Format of card images in dataset
specified by -DSTN[ndstn]*******
Submit as many sets of DSTN cards as necessary to
adequately describe trace distances for all output
records.
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. No longer required.
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.
-? Query mode. With this flag, maip2 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 be separated by whitespace.
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.
NOTE 2:
This note is intended to explain how the USP program maip2
uses the input parameters for group and source spacing, and
for group indexing and depth point indexing intervals, to
define the gi's and di's that are stored in the trace
headers. Because several users have been having problems in
indexing their datasets, we have looked at the problem, and
offer the following guide in setting these parameters.
Each user will need to look at the layout of their data, and
determine the proper indexing intervals to use, as well as
the spacing parameters that are used in the recording.
In the first example, the source interval (normal source
moveup) is equal to 1.5 times the group (receiver) spacing.
For each shot, the depth points are equal to .5 of the group
interval (as we have always known). But, because the source
moveup is not a multiple of the group spacing, then every
even source line has the group indexes offset from the odd
sources. In order to account for every group index in both
the odd and even sources, we have to specify the group
indexing interval differently than what we are used to
thinking about: the group indexing interval now becomes .5
of the group spacing.
*...@...@...@...@...@...@...@ 1st src/7 rec
x x x x x x x depth pts
*...@...@...@...@...@...@...@ 2nd src/7 rec
x x x x x x x depth pts
*...@...@...@...@...@...@...@ 3rd src/7 rec
x x x x x x x depth pts
*...@...@...@...@...@...@...@ 4th src
x x x x x x x depth pts
Example 1:
group spacing: 25 m
source spacing: 37.5 m
group indexing interval: 12.5 m
depth point indexing interval: 12.5 m
Using these intervals allows us to line up the depth points
from all the sources and groups in their proper places, as
well as allow for all groups to have a proper index.
Another example: the source interval (normal source moveup)
is equal to .75 times the group (receiver) spacing. For
each shot, the depth points are equal to .5 of the group
interval. But, as you can see from the diagram below, the
depth points from the second source fall in between the
depth points for the first and third sources. Thus, the
effective depth point indexing interval, in order to account
for all the depth points for all the sources in the dataset,
becomes .25 of the group interval. In order to index the
groups (receivers) correctly as well, the group indexing
interval also becomes .25 of the group interval.
*...@...@...@...@...@...@...@ 1st src/7 rec
x x x x x x x depth pts
*...@...@...@...@...@...@...@ 2nd src/7 rec
x x x x x x x depth pts
*...@...@...@...@...@...@...@ 3rd src/7rec
x x x x x x x depth pts
*...@...@...@...@...@...@...@ 4th src/7rec
x x x x x x x depth pts
Example 2:
group spacing: 25 m
source spacing: 18.75 m
group indexing interval: 6.25 m
depth point indexing interval: 6.25 m
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