NAME
scan - module to scan traces
SYNOPSIS
scan [ -Nntap ] [ -V ] [ -v ] [ -c ] [ -t ] [ -V ] [ -H
] [ -S ] [ -nsns ] [ -nene ] [ -rsirs ] [ -reire ] [ -npnp
] [ -iidec ] [ -bnbin ] [ -wihdrwd ] [ -Wword ] [ -R ] [
-Bbyte ] [ -Llength ] [ -M ] [ -mt ] [ -Ffmt ] [ -? ]
DESCRIPTION
scan allows a scan of the contents of the SIS data file,
providing all sorts of information concerning its various
contents including the historical line header. This infor-
mation under certain conditions takes the form of mnemonic
references to header values. A list of the line and trace
header mnemonics is proovided at the end of this manual
page.
scan gets processing controls from the command line. Reason-
able defaults are set up. In addition, if no file name is
given, the binary trace data are expected to be on the stan-
dard input.
Command line arguments
-N ntap
Enter the full path of the file containing the data
set. If not specified, input is expected on the stan-
dard input. If standard input is not specified, and
there is no input, e.g., program run in background,
expect a very ungracious crash. (default standard
input)
-rs irs
(integer) First record to process (default = 1)
-re ire
(integer) last record to process (default = all)
-ns ns
First trace in record to process (default = 1)
-ne ne
Last trace in record to process (default = all)
-np np
List the values of the first np samples in each trace
(default = 0)
-w ihdrwd
User specified trace header word locations to display.
Default = trace number. OR, ...
-W word
User specified trace header word mnemonics to display.
Default = trace number. Note: the user may specify as
many -W[] entries or -w[] entries as desired. In the
printout scan will display them one after another.
-R For the optional header word above this specifies a
real value is to be unpacked starting at the above
header position mnemonic.
-i idec
Output sample increment of the above np samples
(default = 1)
-t Printout of selected trace indices in column format
(this is the default)
-c Printout of selected trace indices for multicomponent
data in column format.
-v Verbose mode lists the "terse" indices, the minmum and
maximum amplitudes of each trace and where they occur,
and a histogram distribution of the trace amplitudes.
-V Very verbose mode. List line and trace headers. Use
the line and trace header code descriptions attached to
this manual page.
-H List historical line header. This goes out on standard
error so to capture it in a file for casual viewing one
would use >&hist.file at the end of the command line:
scan -Ndata -V -H >&hist.file
One would then use more or pg to view the file.
-S Summary mode. With this flag
-M If present output a formatted stream of trace ampli-
tudes to stdout. Each trace stream will be separated
by a null line.
-mt If present output a formatted stream of record number,
trace number, maximum amplitude, time of maximum ampli-
tude to stdout, one line per trace.
-F fmt
Input string of characters defining the format of the
output stream. Default format is (1E15.4). The number
of trace values is given by the np cmd line entry. If
this is missing then all the trace values will be
printed. Example of a typical format: -F'(10f8.2)'
which will result in the output formatted into rows of
10 floating point numbers each of total length 8 char-
acters (including sign + decimal point) and 2 decimal
places.
-B byte
Yet another optional method of specifying a trace
header word: enter the byte offset to display, e.g.
255. Then see the command line entry below. If a real
value is to be displayed the byte offset must
correspond to the header 1/2 word position in bytes,
e.g. if the real value occupies 1/2 words 91 & 92 then
bytes must be 182 (91 x 2).
-L length
For the byte offset above enter the length in bytes of
the integer you wish to display, e.g. 2 (which is the
standard 2-byte short integer prevalent in SIS and SEGY
headers. If length=3 then a REAL or floating point
value will be assumed. If If length=4 then a standard
length integer will be assumed. These are the only
legal values. scan will report the minimum and maximum
record amplitudes plus a histogram distribution of
amplitudes for that record.
-? Query mode. With this flag, scan will give a descrip-
tion of the command line arguments and stop the pro-
gram.
BUGS
unknown
AUTHOR
P. Gutowski, 1985. R. B. Herrmann, Saint Louis University,
July 1985. (minor change)
expand tab(%) ; c s s c c c l l c . LINE HEADER MASTER
(code)%(description)%(type)
9 EqpCod%Equipment code%( C*1 ) CrwNam%Crew Six Characters%(
C*6 ) Crew01%Crew First Character%( C*1 ) Crew02%Crew
Second Character%( C*1 ) Crew03%Crew Third Character%( C*1
) Crew04%Crew Fourth Character%( C*1 ) Crew05%Crew Fifth
Character%( C*1 ) Crew06%Crew Sixth Character%( C*1 )
DatTyp%Data Type%( C*1 ) DgTrkS%Digital Truck System%( C*2
) DgTrk1%Digital Truck System (1st char)%( C*1 )
DgTrk2%Digital Truck System (2nd char)%( C*1 )
PrcNam%Processor Name%( C*10 ) PrNm01%Processor Name (1st
char)%( C*1 ) PrNm02%Processor Name (2nd char)%( C*1 )
PrNm03%Processor Name (3rd char)%( C*1 ) PrNm04%Processor
Name (4th char)%( C*1 ) PrNm05%Processor Name (5th char)%(
C*1 ) PrNm06%Processor Name (6th char)%( C*1 )
PrNm07%Processor Name (7th char)%( C*1 ) PrNm08%Processor
Name (8th char)%( C*1 ) PrNm09%Processor Name (9th char)%(
C*1 ) PrNm10%Processor Name (10th char)%( C*1 )
PrcDat%Processing Date%( C*8 ) Date01%Processing Date (1st
char)%( C*1 ) Date02%Processing Date (2nd char)%( C*1 )
Date03%Processing Date (3rd char)%( C*1 ) Date04%Processing
Date (4th char)%( C*1 ) Date05%Processing Date (5th char)%(
C*1 ) Date06%Processing Date (6th char)%( C*1 )
Date07%Processing Date (7th char)%( C*1 ) Date08%Processing
Date (8th char)%( C*1 ) OACLin%OAC Line 8 char right just%(
C*8 ) OACL01%OAC Line (1st char)%( C*1 ) OACL02%OAC Line
(2nd char)%( C*1 ) OACL03%OAC Line (3rd char)%( C*1 )
OACL04%OAC Line (4th char)%( C*1 ) OACL05%OAC Line (5th
char)%( C*1 ) OACL06%OAC Line (6th char)%( C*1 ) OACL07%OAC
Line (7th char)%( C*1 ) OACL08%OAC Line (8th char)%( C*1 )
JobNum%JOB Number%( C*8 ) JOBN01%JOB Number (1st char)%(
C*1 ) JOBN02%JOB Number (2nd char)%( C*1 ) JOBN03%JOB
Number (3rd char)%( C*1 ) JOBN04%JOB Number (4th char)%(
C*1 ) JOBN05%JOB Number (5th char)%( C*1 ) JOBN06%JOB
Number (6th char)%( C*1 ) JOBN07%JOB Number (7th char)%(
C*1 ) JOBN08%JOB Number (8th char)%( C*1 ) NumTrc%number
traces per record%( I*4 ) NumRec%number records per line%(
I*4 ) SmpInt%sample interval ms%( I*4 ) NumSmp%number sam-
ples per trace%( I*4 ) Format%format code%( I*2 )
IndAdj%index adjustment%( I*2 ) OpGrFl%Opposite/Between
Group Flag%( I*2 ) SrtTyp%Sort Type 00=FIFO%( C*2 ) SrTy01%
01=LgArrow%( C*1 ) SrTy02% 02=max to min%( C*1 )
CDPFld%CDP Fold%( I*2 ) GrpInt%Group Interval%( C*4 )
GrpIn0%Group Inverval (1st char)%( C*1 ) GrpIn1%Group
Inverval (2nd char)%( C*1 ) GrpIn2%Group Inverval (3rd
char)%( C*1 ) GrpIn3%Group Inverval (4th char)%( C*1 )
DtInFl%Data Indicator Flag%( I*4 ) Dy1000%Record Interval *
1000 (MBS)%( I*4 ) MxSPEl%Max Source Point Elevation%( I*2
Surface Elevation%( I*2 ) MnRSEL%Min Ref Surface Eleva-
tion%( I*2 ) MxGrEl%Maximum group Elevation%( I*2 )
MnGrEl%Minimum group Elevation%( I*2 ) MxTrSt%Maximum trace
Static%( I*2 ) MnTrSt%Minimum trace Static%( I*2 )
LinDir%Line Direction e.g., N45E%( C*4 ) LnDi01%Line Direc-
tion (1st char)%( C*1 ) LnDi02%Line Direction (2nd char)%(
C*1 ) LnDi03%Line Direction (3rd char)%( C*1 ) LnDi04%Line
Direction (4th char)%( C*1 ) AERcPr%Accumulative Est Rec
Proc%( I*4 ) OrNTRC%Original traces Per Record%( I*2 )
OrNREC%Original Number records%( I*2 ) MutVel%Muting Velo-
city%( R*4 ) ZDMuTm%Zero Distance Mutine Time%( I*2 )
IntInc%interpolation increment%( I*2 ) WatVel%Water Velo-
city%( I*4 ) RefVel%SLNT Reference Velocity (MBS)%( I*4 )
MxShDp%Maximum Shot Depth%( I*2 ) MnShDp%Minimum Shot
Depth%( I*2 ) MxUHTm%Maximum Uphole Time%( I*2 )
MnUHTm%Minimum Uphole Time%( I*2 ) MxTrOf%Maximum traverse
Offset%( I*2 ) MnTrOf%Minimum traverse Offset%( I*2 )
RATTrc%RATS Traces per Record Entry%( I*2 ) AnglSt%SLNT
Starting Angle (MBS)%( I*2 ) RATFld%RATS Fold Entry%( I*2 )
AngInc%SLNT Angle Increment (MBS)%( I*2 ) UnitFl%Units Flag
0=ft 1=m%( I*2 ) FrstSP%1st SP Number on Line%( I*2 )
DpN1SP%Dep Pt Num Below 1st Src Pt%( I*2 ) NmDpIn%Num Dep
Pt Int per Unit Inc%( I*2 ) StWdFl%Static Wd Flag 0=old >=1
new%( I*2 ) DptInt%Depth Point interval%( I*2 ) TmMsSl%Time
in ms of First Slice%( I*4 ) Dx1000%Trace Interval * 1000
(MBS)%( I*4 ) TmSlIn%Time Slice increment in ms%( I*4 )
Dz1000%Depth Interval * 1000 (MBS)%( I*4 ) TmMsFS%Time in
ms of First Sample%( R*4 ) NTrLnS%Number Traces/Line Sorted
In%( I*4 ) PltDir%Plot Direction%( I*2 ) LgRfEl%Log Refer-
ence Elevation%( I*2 ) MnLnIn%Minimum line Index%( I*2 )
MxLnIn%Maximum line Index%( I*2 ) MnDpIn%Minimum depth
Index%( I*2 ) MxDpIn%Maximum depth Index%( I*2 ) ILClIn%In
Line Cell Increment%( R*4 ) CLClIn%Cross Line Cell Incre-
ment%( R*4 ) ReSpFm%Reserved Special Format%( I*2 )
VlFnRF%Vel Func Ref Flag 0=RI 1=DI%( I*2 ) OACUsr%OAC USER
Field%( C*4 ) OACUF0%OAC USER Field (1st char)%( C*1 )
OACUF1%OAC USER Field (2nd char)%( C*1 ) OACUF2%OAC USER
Field (3rd char)%( C*1 ) OACUF3%OAC USER Field (4th char)%(
C*1 ) LinNam%Line Name%( C*8 ) LnNm00%Line Name (1st
char)%( C*1 ) LnNm01%Line Name (2nd char)%( C*1 )
LnNm02%Line Name (3rd char)%( C*1 ) LnNm03%Line Name (4th
char)%( C*1 ) LnNm04%Line Name (5th char)%( C*1 )
LnNm05%Line Name (6th char)%( C*1 ) LnNm06%Line Name (7th
char)%( C*1 ) LnNm07%Line Name (8th char)%( C*1 )
MutFlg%Mute Flag 0=yes 1=no%( I*2 ) SPBias%Shot point
Bias%( C*2 ) SPBi00%Shot point Bias (1st char)%( C*1 )
SPBi01%Shot point Bias (2nd char)%( C*1 ) SpBiFl%Shot Point
Bias Flag%( I*2 ) APIWNo%API Well Number%( C*12 )
APIWN0%API Well Number (1st char)%( C*1 ) APIWN1%API Well
Number (2nd char)%( C*1 ) APIWN2%API Well Number (3rd
char)%( C*1 ) APIWN3%API Well Number (4th char)%( C*1 )
Number (6th char)%( C*1 ) APIWN6%API Well Number (7th
char)%( C*1 ) APIWN7%API Well Number (8th char)%( C*1 )
APIWN8%API Well Number (9th char)%( C*1 ) APIWN9%API Well
Number (10th char)%( C*1 ) APIWNA%API Well Number (11th
char)%( C*1 ) APIWNB%API Well Number (12th char)%( C*1 )
NmSpMi%Number Shot points per Mile%( R*4 ) MinVel%Minimum
Velocity ( MBS )%( I*2 ) MaxVel%Maximum Velocity ( MBS )%(
I*2 ) HlhEnt%Number of Entries in HLH%( I*2 ) HlhByt%Number
of Bytes in HLH%( I*2 )
(code)%(description)%(type)
9 SGRNum%SGR number%( I*2 ) SGRAmp%SGR PreAmp Gain, Filter%(
I*2 ) SGRDat%SGR Julian Date Recorded%( I*4 ) FlReFN%Field
Record File Number%( I*2 ) FlStNm%Field Station Number%(
I*2 ) PREPIn%PREP Initiation Static .25ms%( I*2 )
InStUn%Initiation Static Unapplied%( I*2 )
InStAp%Initiation Static Applied%( I*2 ) PREPRc%PREP
Reception Static .25ms%( I*2 ) RcStUn%Reception Static
Unapplied%( I*2 ) RcStAp%Reception Static Applied%( I*2 )
ToStAp%Total Static Applied%( I*2 ) ToTmAA%Total Timing
Adjust Applied%( I*2 ) ToStUn%Total Static Unapplied%( I*2
) ToTmAU%Total Timing Adjust Unapplied%( I*2 ) %all ten
above are .25ms units%( I*2 ) SrRcAz%Source-to-Receiver
Azimuth%( I*2 ) SrPtXC%Src Point X-Coordinate 3D%( I*4 )
SrPtYC%Src Point Y-Coordinate 3D%( I*4 ) RcPtXC%Rec Point
X-Coordinate 3D%( I*4 ) RcPtYC%Rec Point Y-Coordinate 3D%(
I*4 ) SrRcMX%Src Rec Midpoint X 3D%( I*4 ) SrRcMY%Src Rec
Midpoint Y 3D%( I*4 ) CDPBCX%CDP Bin Center X Coordinate%(
I*4 ) CDPBCY%CDP Bin Center Y Coordinate%( I*4 )
InTrCn%Incremental Trace Counter%( I*2 ) FlDtEl%Floating
Datum Elev this CDP%( I*2 ) MulSkw%Multiplex Skew
(ms*1000)%( I*2 ) PerSPO%Perpendicular Src Pt Off y%( I*2
) InlSPO%Inline Src Pt Off x%( I*2 ) TiLiI1%Tie Line Indi-
cator 1%( I*2 ) TiLiI2%Tie Line Indicator 2%( I*2 )
TiLiI3%Tie Line Indicator 3%( I*2 ) TiLiI4%Tie Line Indi-
cator 4%( I*2 ) TiLiI5%Tie Line Indicator 5%( I*2 )
TiLiI6%Tie Line Indicator 6%( I*2 ) TVPT01%Time of Time-
Velocity Pair%( I*2 ) TVPV01%Velocity of Time-Velocity
Pair%( I*2 ) TVPT02%Time of Time-Velocity Pair%( I*2 )
TVPV02%Velocity of Time-Velocity Pair%( I*2 ) TVPT03%Time
of Time-Velocity Pair%( I*2 ) TVPV03%Velocity of Time-
Velocity Pair%( I*2 ) TVPT04%Time of Time-Velocity Pair%(
I*2 ) TVPV04%Velocity of Time-Velocity Pair%( I*2 )
TVPT05%Time of Time-Velocity Pair%( I*2 ) TVPV05%Velocity
of Time-Velocity Pair%( I*2 ) TVPT06%Time of Time-Velocity
Pair%( I*2 ) TVPV06%Velocity of Time-Velocity Pair%( I*2 )
TVPT07%Time of Time-Velocity Pair%( I*2 ) TVPV07%Velocity
of Time-Velocity Pair%( I*2 ) TVPT08%Time of Time-Velocity
Pair%( I*2 ) TVPV08%Velocity of Time-Velocity Pair%( I*2 )
TVPT09%Time of Time-Velocity Pair%( I*2 ) TVPV09%Velocity
of Time-Velocity Pair%( I*2 ) TVPT10%Time of Time-Velocity
Pair%( I*2 ) TVPV10%Velocity of Time-Velocity Pair%( I*2 )
TVPT11%Time of Time-Velocity Pair%( I*2 ) TVPV11%Velocity
of Time-Velocity Pair%( I*2 ) TVPT12%Time of Time-Velocity
Pair%( I*2 ) TVPV12%Velocity of Time-Velocity Pair%( I*2 )
TVPT13%Time of Time-Velocity Pair%( I*2 ) TVPV13%Velocity
of Time-Velocity Pair%( I*2 ) TVPT14%Time of Time-Velocity
of Time-Velocity Pair%( I*2 ) TVPT16%Time of Time-Velocity
Pair%( I*2 ) TVPV16%Velocity of Time-Velocity Pair%( I*2 )
TVPT17%Time of Time-Velocity Pair%( I*2 ) TVPV17%Velocity
of Time-Velocity Pair%( I*2 ) TVPT18%Time of Time-Velocity
Pair%( I*2 ) TVPV18%Velocity of Time-Velocity Pair%( I*2 )
TVPT19%Time of Time-Velocity Pair%( I*2 ) TVPV19%Velocity
of Time-Velocity Pair%( I*2 ) TVPT20%Time of Time-Velocity
Pair%( I*2 ) TVPV20%Velocity of Time-Velocity Pair%( I*2 )
TVPT21%Time of Time-Velocity Pair%( I*2 ) TVPV21%Velocity
of Time-Velocity Pair%( I*2 ) RedVel%Reduction Velocity
for vred%( I*2 ) RedTim%Time of first sample for vred%(
I*2 ) VPick1%Auto Static Pick 1%( I*2 ) VPick2%Auto Static
Pick 2%( I*2 ) LRcCDP%Last Record CDP%( I*2 ) CabDep%Cable
Depth%( I*2 ) WDepDP%Water Depth Above Depth Point%( I*2 )
DPOPer%Depth Point Offset Perpendic%( I*2 ) ShtDep%shot
depth%( I*2 ) UphlTm%uphole time in ms%( I*2 )
DpPtLt%depth pt lat (deg* 10^5)%( I*4 ) DpPtLn%depth pt
lon (deg* 10^5)%( I*4 ) FoldNm%fold%( I*2 ) RecNum%record
number%( I*2 ) TrcNum%trace number%( I*2 ) SrcPnt%src
point above this depth pt%( I*2 ) SrcLoc%src location ind
mult by 10%( I*2 ) PrRcNm%permanent record number PRI%(
I*2 ) PrTrNm%permanent trace number PTI%( I*2 )
SrPtEl%source point elevation%( I*2 ) SrPrLt%source point
lat (deg* 10^5)%( I*4 ) SrPrLn%source point lon (deg*
10^5)%( I*4 ) DstUsg%unsigned trace distance%( I*2 )
RecInd%rec location index GI%( I*2 ) DstSgn%signed
trace distance%( I*2 ) GrpElv%group elevation%( I*2 )
LinInd%line index 3D%( I*2 ) DphInd%depth index%( I*2 )
DePtEl%depth point elevation%( I*2 ) RfSrEl%reference sur-
face elevation%( I*2 ) StaCor%correction%( I*2 )
DatShf%datum shift%( I*2 ) SoPtNm%source point number%(
I*2 ) SoPtAl%source point alphabetic sufix%( C*1 )
SoPtBi%source point bias /10000%( C*1 )
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html