NAME
ttds3d - Transpose & transform a USP formatted dataset from
one set of coordinates to another
SYNOPSIS
ttds3d [ -Nntape ] [ -Ootape ] [ -Ttfile ] [ -Mmaxmem ] [
-NDndomain ] [ -ODodomain ] [ -BRirec1 ] [ -ERirec2 ] [
-PRnrpad ] [ -IRincrec ] [ -BTitrc1 ] [ -ETitrc2 ] [
-PTntpad ] [ -BSismp1 ] [ -ESismp2 ] [ -PSnspad ] [ -OSnsoff
] [ -DTidt ] [ -ff1 ] [ -fcf2 ] [ -FCf3 ] [ -Ff4 ] [ -DWdw ]
[ -W0w0 ] [ -NTnt ] [ -ITit ] [ -NTOUTntout ] [ -MF ] [ -V ]
[ -? ] [ -h ]
DESCRIPTION
ttds3d reads a USP formatted dataset and transposes or
transforms and transposes it from one set of coordinates to
a different set of coordinates. See the explanation below
for command line arguments of ndomain and odomain for the
types of coordinate systems handled by the program. ttds3d
gets both its dataset names and its parameters from command
line arguments.
Command line arguments
-Nntape
Enter the input dataset name or file after typing -N.
Entering nothing specifies a stdin pipe. However,
using a stdin pipe will fail in this program when skip-
ping records. This input file should include the com-
plete 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 'vsp' stored on the
'b' disk.
-Ootape
Enter the output dataset name or file after typing -O.
This output file is not required when piping the output
to another process. The output data set also requires
the full path name (see above).
-Ttfile
ttds3d requires a temporary dataset for work space.
Enter the name of this dataset after typing -T. This
temporary dataset also requires the full path name (see
above).
-Mmaxmem
Enter the maximum memory in megabytes after typing -M.
Default for the Sun is 16 megabytes. The default for
other architectures is 64 megabytes. There will be an
upper limit of 128 megabytes for the Convex.
-NDndomain
Enter the domain of the input dataset after typing -ND.
The input domain is a sequence of any two or three sym-
bols. The default is txy which represents the standard
3D stacked dataset.
-ODodomain
Enter the domain of the output dataset. Default is
txy. The output domain is a sequence of any two or
three symbols that conform to the following rules:
1. No transform - The symbols used for output domain must
be the same as those used for the input domain, however,
they may be in any arbitrary order. Examples:
a. -NDabc -ODcab
b. -ND123 -OD132
c. -NDtx -ODxt
2. Forward FFT - The first symbol of the input domain must
be either "t" or "T" and the last symbol of the output
must be either "w" or "W". In addition, the first and
second symbols of the output domain must equal the
second and third symbols of the input domain, respectively.
Examples:
a. -NDtxy -ODxyw
b. -NDTab -ODabW
3. Inverse FFT - The first symbol of the output domain must
be either "t" or "T" and the last symbol of the input
must be either "w" or "W". In addition, the first and
second symbols of the input domain must equal the
second and third symbols of the output domain,
respectively. Examples:
a. -NDxyw -ODtxy
b. -NDabW -ODTab
-BRirec1
Enter the beginning record to use from the input.
Default is 1.
-ERirec2
Enter the ending record to use from the input. Default
is all records.
-PRnrpad
Enter the number of zero records to pad at the end of
the dataset. Default is none.
-IRincrec
Enter the record increment. Default is 1. NOTE: This
parameter is ignored in the case of transposing and
transforming from xyw to txy.
-BTitrc1
Enter the beginning trace number. Default is 1.
-ETitrc2
Enter the ending trace number. Default is last trace
of the record.
-PTntpad
Enter the number of zero traces to pad at the end of
each record. Default is none.
-BSismp1
Enter the index of the beginning sample to use from the
input. Default is 1.
-ESismp2
Enter the index of the ending sample to use from the
input. Default is last sample of each trace.
-PSnspad
Enter the number of zero samples to pad at the end of
each trace. Default is none.
-OSnsoff
This parameter allows the user to insert a number of
zero samples before the beginning sample number as
specified by ismp1 above. Enter the number of zero sam-
ples to insert after typing -OS. NOTE: This parameter
is ignored in the case of transposing and transforming
from xyw to txy.
-DTidt
Enter the sample interval. Default is the sample
interval from the line header.
THE NEXT 4 ARGUMENTS ARE FOR txy -> xyw AND xyw -> txy
ONLY.
-ff1 Enter the low cutoff frequency in hz. Default is 0.
-fcf2
Enter the low corner frequency in hz. Default is f1.
-FCf3
Enter the high corner frequency in hz. Default is f4.
-Ff4 Enter the high cutoff frequency in hz. Default is
nyquist-dw, where dw is the spacing in frequency.
THE NEXT 6 ARGUMENTS ARE FOR xyw -> txy ONLY.
-DWdw
Enter the delta-omega which is the sample rate in fre-
quency. No default.
-W0w0
Enter the omega origin. Default is 0.
-NTnt
Enter the number of time samples to be output. This
will be the FFT length. The default is the smallest
FFT number which is greater than or equal to twice the
highest frequency.
-ITit
Enter the index of the first time sample to output.
Default is 1.
-NTOUTntout
Enter the number of time samples to output. Default is
nt-it+1.
-MF If this flag is present on the command line, ttds3d
will multiply by the trapezoidal filter as specified
above with flags f, fc, FC, and F.
-V Enter the command line argument '-V' to get additional
printout.
-? Enter this (or '-?' if you are running in c-shell) to
get online help. The program will terminate after
printing this.
-h Enter this option to get online help. The program will
terminate after printing this.
BUGS
None known.
AUTHOR
Ron Coleman, CETech
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html