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)
LINE HEADER MASTER
(code) (description) (type)
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 samples 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 )
MnSPEl Min Source Point Elevation ( I*2 )
MxRSEL Max Ref Surface Elevation ( I*2 )
MnRSEL Min Ref Surface Elevation ( 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 Direction (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 Velocity ( R*4 )
ZDMuTm Zero Distance Mutine Time ( I*2 )
IntInc interpolation increment ( I*2 )
WatVel Water Velocity ( 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 Reference 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 Increment ( 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 )
APIWN4 API Well Number (5th char) ( C*1 )
APIWN5 API Well 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 )
TRACE HEADER MASTER
(code) (description) (type)
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 Indicator 1 ( I*2 )
TiLiI2 Tie Line Indicator 2 ( I*2 )
TiLiI3 Tie Line Indicator 3 ( I*2 )
TiLiI4 Tie Line Indicator 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 )
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 Pair ( I*2 )
TVPV14 Velocity of Time-Velocity Pair ( I*2 )
TVPT15 Time of Time-Velocity Pair ( I*2 )
TVPV15 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 surface 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 )
Man(1) output converted with
man2html