NAME
edit3d - reads a 3D database file created by program dbvec,
and retrieves desired data from the original input
dataset(s). This selected data is written to an output
dataset, or piped into another program.
SYNOPSIS
edit3d [ -Nntap ] [ -Ootap ] [ -DBdbnam ] [ -U ] [ -lislis ]
[ -lielie ] [ -disdis ] [ -diedie ] [ -dlidli ] [ -ddiddi ]
[ -nlinli ] [ -ndindi ] [ -ncellncell ] [ -xline ] [ -sect ]
[ -Rrfile ] [ -rcst1irc1 ] [ -rcst2irc2 ] [ -rcincirci ] [
-Ssfile ] [ -shst1ish1 ] [ -shst2ish2 ] [ -shincishi ] [
-sopt ] [ -liveonly ] [ -? ]
DESCRIPTION
edit3d reads a database of vectors on disk created by pro-
gram dbvec.
edit3d gets both its data and its parameters from command
line arguments. These arguments specify the input, output,
and the section (inline or crossline, or by receiver
stations(RecInd) or shot stations(SoPtNm)) to retrieve.
Command line arguments
-N ntap
Enter the input data set name or file immediately after
typing -N. This input file should include the complete
path name if the file resides in a different directory.
Example -N/b/vsp/dummy tells the program to look for
file 'dummy' in directory '/b/vsp'. Note that you may
have multiple files as input, up to 100 partitions;
just input them in order on the command line using mul-
tiple -Ndata entries (i.e., -Ndata1 -Ndata2 -Ndata3 ...
). This must be the same file(s), in the same order,
as input to program dbvec, because the retrieval is
based on the order of input to dbvec.
-O otap
Enter the output data file name immediately after typ-
ing -O. This may be a piped dataset; if so, omit the
-Ootap parameter from the command line.
-DB dbnam
Enter the database file name immediately after typing
-DB. This is the file created by the program dbvec.
-U Enter -U on the command line if you DO NOT want the
computed LI and DI values written into the trace
headers on the output dataset. Default is to write the
values in the headers.
Parameters to retrieve inline or crossline sections:
-lis lis
Enter the first LI of the first group to retrieve.
Default = 1.
-lie lis
Enter the first LI of the last group to retrieve.
Default = 1.
-dis dis
Enter the first DI of the first group to retrieve.
Default = 1.
-die die
Enter the first DI of the last group to retrieve.
Default = 1.
-dli dli
Enter the increment between groups of LI's. Default =
0.
-ddi ddi
Enter the increment between groups of DI's. Default =
0.
-nli nli
Enter the number of LI's in a group. Default = 1.
-ndi ndi
Enter the number of DI's in a group. Default = 1.
-ncell ncell
Enter the number of traces to retrieve per cell.
Default is the maximum number of traces in any cell,
taken from the database.
-xline
Enter the command line argument '-xline' to retrieve
traces in the crossline direction(DI). Default is to
retrieve in the inline direction(LI).
-sect
Enter the command line argument '-sect' to retrieve
traces by pieces of adjacent cells, rather than lines
or crosslines. The pieces will be organized in a line
or crossline direction (depending on whether -xline is
specified) within each piece.
Parameters to retrieve by Receiver Stations:
-R rfile
Enter the input file name immediately after typing -R.
This may NOT be a piped dataset; each line of the file
contains a receiver station number to retrieve -- they
will be retrieved in the order submitted. This is an
optional dataset, and cannot be used with the following
3 parameters, but is used instead of them.
-rcst1 irc1
Enter the first Receiver Station Number (RecInd) to
retrieve. Default = 1.
-rcst2 irc2
Enter the last Receiver Station Number (RecInd) to
retrieve. Default = 1.
-rcinc irci
Enter the increment between receiver stations to
retrieve. Default = 1.
-sopt
Enter the command line argument '-sopt' to sort each
retrieved Receiver Station number by SoPtNm. Default
is to sort by offset.
-liveonly
Enter the command line argument '-liveonly' to output
only records containing at least one live trace. Dead
or non-existant records [in the case of nonuniform sta-
tion indexing] will be skipped.
Parameters to retrieve by Shot Stations:
-S sfile
Enter the input file name immediately after typing -S.
This may NOT be a piped dataset; each line of the file
contains a shot station number to retrieve -- they will
be retrieved in the order submitted. This is an
optional dataset, and cannot be used with the following
3 parameters, but is used instead of them.
-shst1 ish1
Enter the first Shot Station Number (SoPtNm) to
retrieve. Default = 1.
-shst2 ish2
Enter the last Shot Station Number (SoPtNm) to
retrieve. Default = 1.
-shinc ishi
Enter the increment between shot stations to retrieve.
Default = 1.
-sopt
Enter the command line argument '-sopt' to sort each
retrieved Shot Station number by RecInd. Default is to
sort by offset.
-liveonly
Enter the command line argument '-liveonly' to output
only records containing at least one live trace. Dead
or non-existant records [in the case of nonuniform sta-
tion indexing] will be skipped.
-? Enter the command line argument '-?' to get online
help. The program terminates after the help screen is
printed.
EXAMPLE
(retrieve in the inline direction (LI) ):
edit3d -Ndata1 -Ndata2 -DBdata_base
-lis29 -dli30 -nli3 -lie119
-dis25 -ddi30 -ndi11 -die115 -ncell25 | ...........
This example should produce a piped dataset consisting of:
li 29 (di 25-35, 55-65, 85-95, 115-125)
li 30 (di 25-35, 55-65, 85-95, 115-125)
li 31 (di 25-35, 55-65, 85-95, 115-125)
li 59 (di 25-35, 55-65, 85-95, 115-125)
li 60 (di 25-35, 55-65, 85-95, 115-125)
li 61 (di 25-35, 55-65, 85-95, 115-125)
li 89 (di 25-35, 55-65, 85-95, 115-125)
li 90 (di 25-35, 55-65, 85-95, 115-125)
li 91 (di 25-35, 55-65, 85-95, 115-125)
li 119 (di 25-35, 55-65, 85-95, 115-125)
li 120 (di 25-35, 55-65, 85-95, 115-125)
li 121 (di 25-35, 55-65, 85-95, 115-125)
Each cell, or bin, or (LI,DI) combination output will have
25 traces.
Another example:
(retrieve in the crossline direction (DI) ):
edit3d -Ndata1 -Ndata2 -DBdata_base -lis1 -lie1 -nli155
-dis500 -die800 -ddi100 -ndi1 -ncell20 -xline | ........
This example should produce a piped dataset consisting of:
di 500 (li 1-155)
di 600 (li 1-155)
di 700 (li 1-155)
di 800 (li 1-155)
Each cell, or bin, or (DI,LI) combination output will have
20 traces.
Yet Another example:
(retrieve in the inline direction (LI) in pieces of adjacent
cells):
edit3d -Ndata1 -Ndata2 -DBdata_base -sect
-lis29 -dli30 -nli2 -lie59
-dis25 -ddi30 -ndi11 -die55 -ncell25 | ...........
This example should produce a piped dataset consisting of:
li 29 (di 25-35)
li 30 (di 25-35)
li 29 (di 55-65)
li 30 (di 55-65)
li 59 (di 25-35)
li 60 (di 25-35)
li 59 (di 55-65)
li 60 (di 55-65)
Each cell, or bin, or (LI,DI) combination output will have
25 traces.
Still Another example:
(retrieve by receiver station (RecInd) ):
edit3d -Ndata1 -Ndata2 -DBdata_base -rcst1300 -rcst2310
-rcinc2 -sopt -Odata.out
This example should produce a data file consisting of:
RecInd's 300, 302, 304, 306, 308, and 310
Each record (RecInd) will have the same number of traces as
the maximum number of traces per receiver station found in
the database. Zero traces will be padded at the end of each
record if it is deficient. This example will have each
receiver station sorted by SoPtNm. The default is to sort
by offset (omit the -sopt parameter).
Still Yet Another example:
(retrieve by receiver station (RecInd) using flat file
input):
edit3d -Ndata1 -Ndata2 -DBdata_base -Rrec.file -sopt
-Odata.out
This example should produce a data file consisting of:
RecInd's specified in the flat file rec.file
Each record (RecInd) will have the same number of traces as
the maximum number of traces per receiver station found in
the database. Zero traces will be padded at the end of each
record if it is deficient. This example will have each
receiver station sorted by SoPtNm. The default is to sort
by offset (omit the -sopt parameter).
BUGS
unknown
SEE ALSO
dbvec
AUTHOR
Geoscientist: Don Wagner Programmer: Marilyn Miller
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html