NAME
vi3din - read velocity flat file formats keyed on XYs and
build tdfn file for vi3d
SYNOPSIS
vi3din [ -Ootap ] [ -vvtap ] [ [ -RC ] [ -diminmindi ] [
-dimaxmaxdi ] [ -liminminli ] [ -limaxmaxli ] ] [ -x1x1 ] [
-y1y1 ] [ -x2x2 ] [ -y2y2 ] [ -x3x3 ] [ -y3y3 ] [ -x4x4 ] [
-y4y4 ] [ -cldmcldm ] [ -ildmildm ] [ -geco ] [ -g2d ] [
-shot ] [ -cdp ] [ -gecom ] [ -bfile ] [ -western ] [ -digi-
con ] [ -virf ] [ -frost ] [ -disco3d ] [ -promax ] [
-promax3d ] [ -f2m ] [ -m2f ] [ -ms ] [ -tmaxtmax ] [ -V ] [
-? ]
DESCRIPTION
vi3din takes a velocity flat file (ascii) containing time
velocity information keyed on XYs in one of several formats
and converts this into a TDFN file suitable for vi3d. The
program inserts a 1MC3D template card at the top of the TDFN
file for vi3d. You will have to edit the output file to fill
in the appropriate entries, i.e. replace the fields denoted
by Maxli, Maxdi, Radus, Cldim, and Ildim respectively with
the maximum LI number, the maximum DI number, the radius of
interpolation (some multiple of the cell dimensions), the
crossline cell dimension, and the inline cell dimension (the
latter three can be decimal values). The fields for the
minimum LI and DI, and the LI and DI increments are already
set to 1 and they can be changed as necessary. Some informa-
tion on the ranges of LIs and DIs are output by vi3din as it
runs.
The DIGICON, FROST formats consist of columns of informa-
tion: inline number, crossline number, bin X and bin Y loca-
tion, time (ms), and velocity (ft,m/s). The GECO, WESTERN,
and BFILE formats consist of two header lines for each func-
tion, the second one containing the XY information, followed
by time-velocity pairs identified by t and v characters in
front of each entry.
vi3din gets both its data and its parameters from command
line arguments. These arguments specify the input and out-
put velocity files, survey corner locations, LI & DI limits,
the format, and verbose printout, if desired.
Command line arguments
-v vtap
Enter the name of the input velocity file. The default
is stdin.
-O otap
Enter the name of the output TDFN file. Default is
stdout.
-x1,-y1,-x2,-y2,-x3,-y3,-x4,-y4 [x1,y1,x2,y2,x3,y3,x4,y4]
Enter the area of interest over the survey with the X-Y
coordinates (ft,m) defining the four corners of a
parallelogram on the ground. Going either clockwise or
counter clockwise from Corner 1 the first move to
Corner 2 should be in the direction of a receiver or
shot line. The direction 1-2 will always define the Y
or DI direction. The DIs will always start from side
1-4 and increase in the 1-2 (Y) direction; the LIs will
always start from side 1-2 and increase in the 1-4 (X)
direction. The values must be the same units as those
given in the source, receiver, and midpoint X-Ys in the
trace headers.
-cldm cldm
Enter the crossline (along X or side 2-3) cell dimen-
sion (ft,m). For most shooting geometries this will be
1/2 the line or group spacing depending on the orienta-
tion of side 2-3 with respect to the receiver lines.
The sides are defined to be X along side 1-4 (roughly
cross-line direction), Y along side 1-2 (roughly in-
line direction). Remember when setting up the coordi-
nate system the line joining Corner (1) to Corner (2)
should be in the direction of a receiver or shot line.
No default.
-ildm ildm
Enter the inline (along Y or side 1-2) cell dimension
(ft,m). For most recording geometries this will be 1/2
the line or group spacing depending on the orientation
of side 1-2 with respect to the receiver lines. The
sides are defined to be X along side 1-4 (roughly
cross-line direction), Y along side 1-2 (roughly in-
line direction). Remember when setting up the coordi-
nate system the line joining Corner (1) to Corner (2)
should be in the direction of a receiver or shot line.
No default.
-RC Enter the command line argument '-RC' to define survey
box using LI & DI corners (see limin, etc, below). This
option is good only for Geco, Digicon, Dosco3d, and
Frost formats)
-limin, limax minli, maxli
XY Corners: Enter the minimum and maximum line indexes
to output. The output survey will have so many bins in
the inline direction and so many bins in the crossline
direction. This is a handy way to start and end output-
ting bins at specified sequential inline numbers.
Default is the first and last inline bin as determined
from the 4 corners of the survey provided on the com-
mand line.. LI/DI Corners: Enter the minimum and
maximum LIs defining the survey box. Note that unlike
XY definition this survey box must be a rectangle.
-dimin, dimax mindi, maxdi
XY Corners: Enter the minimum and maximum crossline
indexes to output. The output survey will have so many
bins in the inline direction and so many bins in the
crossline direction. This is a handy way to start and
end outputting bins at specified sequential crossline
numbers. Default is the first and last crossline bin as
determined from the 4 corners of the survey provided on
the command line.. LI/DI Corners: Enter the minimum
and maximum DIs defining the survey box. Note that
unlike XY definition this survey box must be a rectan-
gle.
-geco
Enter the command line argument '-geco' to specify GECO
stacking format velocity input. This format consists
functions containing first a line starting with the
word 'line' containing text information like country,
etc. Next there is a line starting with the characters
'sp' which coontains the XY location of the function,
then a series of lines of the form t time v velocity
t time v velocity ... in integer format.
-frost
Enter the command line argument '-frost' to specify
FROST velocity format. This is a format invented by
Robert Frost of Amoco as an intermediate step between
OMNIVEL and VI3D. It consistes of a header terminated
by *****'s, follwed by each function separated by blank
lines. Each function consists of a line containing the
line, trace numbers, and the X and Y values. The rest
of the function is 2 column format: time (sec) velocity
(units/sec).
-disco3d
Enter the command line argument '-disco3d' to specify
DISCO3D velocity format. Each velocity function in this
format consists of a line tagged by 'HANDVEL' in cols
1-7, followed by XY and line?trace values. The rest of
each velocity function consists of T-V pairs, 4 pair
per line.
-g2d Enter the command line argument '-g2d' to specify GECO
2D stacking format velocity input. This format consists
functions containing first a line starting with the
word 'line' containing text information like country,
etc. Next there is a line starting with the characters
'sp' which coontains the XY location of the function,
then a series of lines of the form t time v velocity
t time v velocity ... in integer format. The indexing
is dome using either the shot point number or the cdp
number.
-shot
Enter the command line argument '-shot' to index the
-g2d functions on shot point number.
-cdp Enter the command line argument '-cdp' to index the
-g2d functions on cdp number.
-gecom
Enter the command line argument '-gecom' to specify
GECO migration format velocity input. In this format
each function consists of a line starting with the
characters 'vel' containing the XY location of the
function, then a series of lines of the form time
velocity time velocity ... in decimal format.
-bfile
Enter the command line argument '-bfile' to specify
BFILE format velocity input. If neither of these format
flags appear then the input format is assumed to be
DIGICON. In the DIGICON-style format each function con-
sists 6-column lines: line number, trace number, X, Y,
time, velocity. Successive functions come one after the
other with no null or blank lines.
-western
Enter the command line argument '-western' to specify
WESTERN format velocity input. Line 1 of each function
starts with the characters WGC; line 2 has lat, long
(in decimals), X, and Y; lines 3 - n contain the T-V
pairs, 6 per line. If none of these format flags appear
then the input format is assumed to be DIGICON.
-digicon
Enter the command line argument '-digicon' to specify
DIGICON format velocity input. In the DIGICON-style
format each function consists 6-column lines: line
number, trace number, X, Y, time, velocity. Successive
functions come one after the other with no null or
blank lines.
-virf
Enter the command line argument '-virf' to specify
Amoco VDS format velocity input. This format consists
of 1-6VIRF card images and was used to file velocity
functions to the old Amoco VDS data base.
-promax
Enter the command line argument '-promax' to specify
promax 2D format.
-promax3d
Enter the command line argument '-promax3d' to specify
promax 3D format.
-tmax tmax
Enter the maximum time to use from the input functions.
Default = 10000ms.
-f2m Enter the command line argument '-f2m' to convert XY
input information from feet to meters.
-m2f Enter the command line argument '-m2f' to convert XY
input information from meters to feet.
-ms Enter the command line argument '-ms' to convert input
times from seconds to milliseconds (automatically
turned on for Frost format).
-V Enter the command line argument '-V' to get additional
printout.
-? Enter the command line argument '-?' to get online
help. The program terminates after the help screen is
printed.
EXAMPLE
vi3din -vin_vels -Oout_vels -x13000 -y12000 -x20 -y23000 \
-y30 -x43000 -y40 -ildm50 -cldm100
where the the X-axis corresponds to the receiver lines and
we go counter clockwise starting from the upper right
(northeast) corner along a receiver line. The input 6-column
file is in_vels and the output TDFN format file is out_vels.
SEE ALSO
vi3d
AUTHOR
Paul Gutowski (socon 422) 3146
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html