Convert Seismological Data and Analyze Waveforms

IASPEI Software Shareware Library
CONVSEIS
Version 4.8
CONVERSION PROGRAM PACKAGE FOR

SEISMOLOGICAL DATA ON PCs
Users Guide
July 1997
The programs are on :

server = 129.13.133.59, user = anonymous, pw = guest
directory = /pub/geoappl/ibmpc/convseis/
Lani Oncescu
Karlsruhe, Germany
Tel. +49-721-608 4507
Fax +49-721-71173
E-mail: lani@gpiwap1.physik.uni-karlsruhe.de
Mihaela Rizescu
Bucharest, Romania
Tel. +40-1-780 3890
Fax +40-1-789 7620
E-mail: mike@infp.ifa.ro
CONVSEIS
by L. Oncescu & M. Rizescu
CONVSEIS
CONVSEIS
CONTENTS
Introduction
5
...........................................................................................................
Converters
ASAC2EQ ........................................................................................................ 9
ASC2V1 ........................................................................................................... 11
EQ2ASC ........................................................................................................... 12
EQ2GSE ........................................................................................................... 14
EQ2SEGY ........................................................................................................ 16
EQ2SEIS .......................................................................................................... 18
EQ2SG ............................................................................................................. 20
EQ2SUDS ........................................................................................................ 22
GSE2SG ........................................................................................................... 24
GSE2SUDS ...................................................................................................... 25
K22SUDS ......................................................................................................... 26
SDP2EQ ........................................................................................................... 29
SEGY2ASC ...................................................................................................... 30
SG2EQ ............................................................................................................. 31
SGA2EQ .......................................................................................................... 32
SGA2ASC ........................................................................................................ 33
SG2SUDS ........................................................................................................ 34
SUDS2EQ ........................................................................................................ 35
SUDS2GSE ...................................................................................................... 36
SUDS2SGA ...................................................................................................... 38
V12SGA ........................................................................................................... 40
V22EQ ............................................................................................................. 42
WV2ASC ......................................................................................................... 43
WV2EQ ........................................................................................................... 44
WV2GSE ......................................................................................................... 45
Utilities
EVL2SUDS ...................................................................................................... 47
FILLEQ ............................................................................................................ 48
FILTSUDS ....................................................................................................... 49
GSE2GSE ........................................................................................................ 51
HYPO2GSE ..................................................................................................... 52
RFEQ ............................................................................................................... 53
SG2SG ............................................................................................................. 54
SGA2SGA ....................................................................................................... 56
SGY2SGY ....................................................................................................... 57
SORTEQ .......................................................................................................... 58
SUDSINST ....................................................................................................... 59
SUDSRW ......................................................................................................... 60
SUDSTOOL ..................................................................................................... 61
SUDXTR .......................................................................................................... 62
SUMEQ ........................................................................................................... 63
TIM2SEGY ...................................................................................................... 64
V22V2 ............................................................................................................. 65
References ............................................................................................................. 66
4
CONVSEIS
CONVSEIS
INTRODUCTION
CONVSEIS is a conversion and utility program package for handling various
seismological digital data formats on PCs. It consists of 25 conversion programs and 17
utility programs. The purpose of these programs is to make access to old seismological
data bases easier by converting those formats into widely used and IASPEIrecommended formats, and to make the switching between different applications a simple
task by offering conversions between input formats used by several processing, analysis
ans plotting programs. A first version of this program package is described by Oncescu
and Rizescu (1994).
The 14 formats supported by this package and their default extensions are:
- IASPEI used or recommended formats: PC-Quake (.WVM), PCEQ (.EQ),
SeisGram-binary (.BIN), SeisGram-ASCII (.ASC), RecSec-PC-SEGY (.SGY), PCSUDS (.DMX);
- other formats: SEIS89/90 (no default extension, see Baumbach (1990)), GSE1.0
and GSE2.0 (.GSE and .TXT), K2-ASCII (.00n) and K2-header (.HDR) ) of
KINEMETRICS, VOL1 (.V1) and VOL2 (.V2) of KINEMETRICS, SDP of Teledyne
Geotech (EVENT.DAT, ARRIV.DAT and WAVEFORM.DAT), GRAPHER data
format (.DAT) of Golden Software and ASCII-SAC format (no default extension).
The names of the conversion programs are usually consisting of the two default
extensions with a 2 (meaning to) inbetween. The conversions supported are:
ASAC2EQ : from ASCII-SAC into PCEQ format;
ASC2V1
: from a general ASCII format into KINEMETRICS - VOL1 format;
EQ2ASC
: from PCEQ into a general ASCII format (with option for GRAPHER
or GMT plotting program);
EQ2GSE
: from PCEQ into GSE1.0 (uncompressed) format;
EQ2SEGY : from PCEQ into PC-SEGY format (used by RecSec program);
EQ2SEIS : from PCEQ into SEIS89 input format;
EQ2SG
: from PCEQ into SeisGram-binary format;
EQ2SUDS : from PCEQ into PC-SUDS demultiplexed format;
GSE2SG
: from GSE1.0 (uncompressed) into SeisGram-binary format;
GSE2SUDS : from GSE1.0 (uncompressed) into PC-SUDS demultiplexed format;
K22SUDS : from K2-ASCII and K2-header formats (output of KINEMETRICSKW2ASC) into PC-SUDS format;
SDP2EQ
: from Teledyne Geotech SDP (on PDP minicomputers) into PCEQ
format;
SEGY2ASC : from PC-SEGY into a general ASCII format (with option for
GRAPHER plotting program);
SG2EQ
: from SeisGram-binary into PCEQ format;
SGA2EQ
: from SeisGram-ASCII into PCEQ format;
SGA2ASC : from SeisGram-ASCII into a general ASCII format (with option for
GRAPHER plotting program);
SG2SUDS : from SeisGram format into PC-SUDS format;
SUDS2EQ : from demultiplexed PC-SUDS format into PCEQ format;
SUDS2GSE : from demultiplexed PC-SUDS into GSE1.0 (uncompressed) format;
SUDS2SGA : from demultiplexed PC-SUDS into SeisGram-ASCII format;
V12SGA
: from KINEMETRICS -VOL1 into SeisGram-ASCII format;
V22EQ
: from KINEMETRICS -VOL2 into PCEQ format;
6
CONVSEIS
WV2ASC
WV2EQ
WV2GSE

: from IASPEI-MDETECT or XDETECT into a general ASCII
format (with option for GRAPHER plotting program);
: from IASPEI-MDETECT or XDETEXT into PCEQ format;
: from IASPEI-MDETECT or XDETECT into GSE1.0 (uncompressed)
format.
The utility programs are:

EVL2SUDS : writing results of location program HYPOPLUS into the
SUDS_ORIGIN structure of a PC-SUDS file;
FILLEQ
: filling one missing component with zeroes and reentering header
information (on PCEQ format);
FILTSUDS : filtering, decimating and skipping channels (on PC-SUDS format).
GSE2GSE : compressing or decompressing GSE1.0 format, converting from
GSE1.0 to GSE2.0 and vice-versa;
HYPO2GSE : writing phase data or HYPOPLUS location results in GSE2.0 format;
RFEQ
: filtering and resampling (on PCEQ format);
SG2SG
: flipping one component, rotating horizontal components and
computing the product between vertical and radial components
(on SeisGram-binary format);
SGA2SGA : summing up SeisGram-ASCII files;
SGY2SGY : summing up PC-SEGY files;
SORTEQ : sorting out given channels (on PCEQ format);
SUDSINST : extracting the instrument related information from a PC-SUDS file;
SUDSRW : extracting data from a PC-SUDS file;
SUDSTOOL: listing and interactive changing of channel name, starting time and
sampling rate on a PC-SUDS file; it also list sensor type, motion type,
data units and content of the SUDS_COMMENT structure;
SUDXTR : extracting phase information (P, S, coda, amplitude and period) from a
PC-SUDS file;
SUMEQ
: summing up PCEQ files;
V22V2
: extracting a portion of a KINEMETRICS - VOL2 file;
TIM2SEGY : generating travel time curves for an arbitrarily layered structure, with
the output in PC-SEGY format.
The programs can be run in three modes: INTERACTIVE mode, COMMAND-line
mode and BATCH mode. All programs support the INTERACTIVE mode. In this mode
the programs ask for each argument and option. By argument it is understood the input,
output or any control file name; by option it is understood a switch or a parameter. Most
of the programs support also the COMMAND-line mode, in which all necessary
arguments and options are entered from the command line; the command line is
maximum 120 characters long. Some programs support also the BATCH mode, by
which it is understood that a group of files is processed using the default values for the
options or parameters. The files to be processed (maximum 2,000) should be listed in a
file called DIRFIL using the DOS dir command. The batch mode is always started with
the program name followed by a blank, then by the string 'ALL' and then by return.
CONVSEIS
Help may be requested from all programs by starting them with a ? on the command
line, followed by return. The help message of the programs is printed in Courier font
and both program names and file names in CAPITALS. Default values are written in
square brackets ([]). Excepting in the PC-SUDS and SeisGram files, a general
convention was used to designate the component (e.g. Z, N, E) as the fourth character of
the station code.
The programs can handle a minimum of 32,512 samples (a limitation only for some
PCEQ, PC-SEGY or GSE format conversions). They can be run on any IBM-compatible
PC with at least 500 KB of free RAM under MS-DOS or IBM PC-DOS operating
systems version 3.3 or higher. No special installation is required.
Trade names and company names are used for descriptive purposes only.
CONVSEIS
CONVSEIS
CONVERTERS
ASAC2EQ
ASAC2EQ converts ASCII-SAC format (Tapley and Tull, 1991) into PCEQ format
(see IASPEI Software Library Volume 1). In addition, it performs the despiking of the
input data for a maximum of 15 consecutive spikes, replacing those values by linear
interpolated ones. The spikes are recognized by testing against a given threshold value.
The program uses dynamic memory allocation and in case of insufficient memory to
handle the input data it creates a logfile with the same name as the output file and the
extension .LOG; this file contains the names of the truncated channels, the initial and the
final number of samples for those channels.
Command line syntax

Like most of the CONVSEIS components, it can be controlled from the DOS
command line. Typing ASAC2EQ ? followed by return, the following help message will
be displayed:
ASAC2EQ v4.0
ASCII-SAC to PCEQ conversion program
INTERACTIVE MODE:
Call : ASAC2EQ
COMMAND MODE:
Call : ASAC2EQ InFile1 ... InFileN /Options
Where:
InFile1 ... InFileN : names of N (max. 20) input files
Options : /O_OutFile /Jn /Ln /Fn /Dn /Mn /Nn /Sn /Cx..x /R
Outfile : output file name [InFile1[.eq]]
Jn
: jump n seconds from file begin [0]
Ln
: retain n seconds as total file length [999]
Fn
: use sensitivity factor n [1]
Dn : use decimation factor n [1]
Mn : maximum admitted value [2047] (after correcting for
sensitivity factor, cannot exceed 9999999)
Nn : number of loops to repeat despiking procedure [1]. In case
that despiking fails, waveforms are cut and a log file is
created.
Sn : first field to read channel code in input file [1]
Cx..x: component for each input file [Z[N[E]]]
R
: command DC offset removal [off]
Arguments and switches

The input ASCII-SAC files (one per component) will all be stored in the same PCEQ
file (one file per event). The maximum number of input files is 20. The output file name
is optional; by default, it will be the name of the first input file with the standard
extension .EQ.
/Jn Jump length
This switch is used to skip n seconds from the beginning of file. Default value is zero.
10
CONVSEIS
/Ln Trace length

This switch is used to fix the output file length to n seconds. Default value is 999
seconds.
/Fn Sensitivity factor
This switch is used to control the conversion from a 32-bit floating-point format to a 16bit integer format: the final values should be between +32,767 and -32,768. This switch
can be used to divide the input data by the factor n. Default value is one.
/Dn Decimation factor
This switch is used to command a decimation with a factor n. Default value is one.
/Mn Maximum value accepted
This switch is used for despiking purposes: if the input data exceeds the value n, they are
interpreted as spikes. These values are removed and replaced by linear interpolated
values. Default value is 2047 (as for 12-bit A/D converters).
/Nn Maximum number of loops to despike
This switch is used to fix at n the maximum number of loops to repeat the despiking
procedure. If in the input data there are more than 15 times n consecutive spikes, the
waveforms are cut at that place and a log file is created with the same name as the output
file and the extension .LOG; this file contains the names of the truncated channels, the
initial and the final number of samples for those channels. Default value is one.
/Sn Field number where station code starts
This switch is used to tell the program at which column n the station code in the SAC file
begins. In the SAC format it is allowed the station code to begin at the 2nd or 3rd
column in the corresponding 6-character field. Default value is one (1st column).
/Cx..x Component for each input file
This switch is used to tell the program what component each input file represents.
Permitted values are: 'Z', 'N', 'E', 'V', 'L', 'R', 'T' and blank. In the output file, the 4th
character of the station code is replaced by that value. If there is only one input file, the
default value is 'Z'; if there are two input files, the default value is 'ZN'; if there are three
input files, the default value is 'ZNE'. If there are more input files, the default value is
blank.
/R Offset removal
This switch is used to command DC offset removal. Default value is off.
11
CONVSEIS
ASC2V1
ASC2V1 converts a general ASCII format into KINEMETRICS VOL1 format. In
command and in interactive modes, the program asks the user to enter earthquake name,
date and origin time, as well as the number of header lines to be skipped in the input file,
the sampling interval, the data units in fractions of g (1g = 981 cm/s2), the station name,
the components and the number of samples for each component. There is also a question
whether or not to create output files that do not require instrument and baseline
correction during processing with certain versions of VOL2 program of
KINEMETRICS.
The maximum number of samples the program can handle is 60,000.
Command line syntax

command line. Typing ASC2V1 ? followed by return, the following help message will be
displayed:
ASC2V1 v4.1
ASCII to VOL1 conversion program
INTERACTIVE MODE:
Call : ASC2V1
COMMAND MODE:
Call : ASC2V1 InFile OutFile1 .. . OutFileN
Where:
InFile : name of input ASCII file
OutFile1...N : names of output VOL1 files [.V1]

The input file can have any extension. There may be several output files (maximum
19), one for each component and each one with the default extension .V1. There is no
switch.
12
CONVSEIS
EQ2ASC
EQ2ASC converts PCEQ format (see IASPEI Software Library Volume 1) into a
general ASCII format with a small header giving event location. For each channel, a
separate header gives channel code and gain, time of the first sample, number of samples
and sampling rate. Optionally, the output file can be without header, containing in the
first column the time values, so that a plotting program like GRAPHER from Golden
Software can read directly the data. Other options command channel selection, DC offset
removal and gain correction.
Command line syntax

command line. Typing EQ2ASC ? followed by return, the following help message will be
displayed:
EQ2ASC v4.0
PCEQ to ASCII conversion program
INTERACTIVE MODE:
Call : EQ2ASC
COMMAND MODE:
Call
: EQ2ASC InFile OutFile /Options
Where:
InFile : name of input PCEQ file [.EQ]
OutFile : name of output ASCII file [InFile[.ASC]]
Options : /G /O /D /CChn1 ... /CChnN
G : command output format as for GRAPHER program [off]
O : command DC offset removal [off]
D : correct for gain (divide amplitude values by channel
gain factor) [off]
CChnI : name of channel to process is ChnI (I=1,N) [none]
Output ASCII file header gives event location and, for
each channel -the code, gain factor, initial sample time,
no. of samples and sampling rate as read from PCEQ file.
Option /G produces an ASCII file without header, time in
the first column, to be read by GRAPHER program; different
data channels are separated by a blank line.

The input file has the default extension .EQ. The output file has the default name
identical with the input file and with the default extension .ASC.
/G GRAPHER-like output file
This switch is used to command that the output file has no header and contains the time
values in the first column. Different channels are separated by a blank line. After manual
separation of each channel, this files can be directly read by the GRAPHER plotting
program. Default value is off.
/O Offset removal
13
CONVSEIS
/D Gain correction
This swith is used to command the division of input data by the gain factor. Default value
is off.
/CChnI Channels to process
These switches are used to indicate which channels are to be converted. Default value is
none. If this switch is omitted from the command line, the program asks the user for the
channel selection.
14
CONVSEIS
EQ2GSE
EQ2GSE converts PCEQ format (see IASPEI Software Library Volume 1) into
GSE1.0 format (see GSETT-2, 1990). There is an option for DC offset removal and also
to indicate which channels are to be processed. The output file is written in integer I6
format, uncompressed. The utility GSE2GSE can be used to compress the GSE files.
The station coordinates and gains can be read from a file named LIST.DAT if it exists
in the working directory. This file should have the following format (beginning with 1st
column):
CODEmmNnn.nn pppEqq.qq
zzzz
gggg
where: CODE is the station code (maximum 4 characters)

mm is the degree part of station latitude (followed by N or S)
nn.nn is the minute part of the station latitude
ppp is the degree part of station longitude (followed by E or W)
qq.qq is the minute part of the station longitude
zzzz is the station elevation in meters
gggg is the gain in counts/ground motion (typically milimicron/second)
In interactive mode, if the file LIST.DAT is not found in the working directory, the
program asks the user to enter the motion type (displacement, velocity or acceleration),
station gain and calibration period for each selected channel.
The data are corrected for the channel gain read from the input file.
Command line syntax

command line. Typing EQ2GSE ? followed by return, the following help message will be
displayed:
EQ2GSE v4.0
PCEQ to GSE conversion program
INTERACTIVE MODE:
Call : EQ2GSE
COMMAND MODE:
Call : EQ2GSE InFile OutFile /Options
BATCH MODE:
Call : EQ2GSE ALL
Where:
OutFile : name of output GSE file [InFile[.GSE]]
Options : /O /CChn1 ... /CChnN
O
CChnI : name of selected channel is ChnI (I=1,N) [all]
ALL
: convert all the PCEQ files listed in file dirfil
Station coordinates & gain (counts/ground motion) can be
read from file LIST.DAT. The amplitude values (counts)
are written in uncompressed INT6 format, corrected for
channel gain as read from the input file.
15
CONVSEIS

This input file has the default extension .EQ. The output file has the default name
identical with the input file and with the default extension .GSE.
/O Offset removal
all.
16
CONVSEIS
EQ2SEGY
EQ2SEGY converts PCEQ format (see IASPEI Software Library Volume 1) into PCSEGY format (see IASPEI Software Library Volume 2).
The station coordinates needed to compute epicentral distances are read from a file
named LIST.DAT which has to exist in the working directory. This file should have the
following format (beginning with 1st column):
zzzz
gggg

The data are not corrected for gain.
Command line syntax

command line. Typing EQ2SEGY ? followed by return, the following help message will
be displayed:
EQ2SEGY v4.0
PCEQ to SEGY conversion program
INTERACTIVE MODE:
Call : EQ2SEGY
COMMAND MODE:
Call : EQ2SEGY InFile OutFile /Options
Where:
OutFile : name of output SEGY file [InFile[.SGY]]
Options : /N /Cx
N : enter new epicenter coordinates [off]
Cx : process only channels on component x (last character
in the channel name, including blank) [all]
Station coordinates are read from file LIST.DAT in order
to compute epicentral distances. Epicentral coordinates
can be read from the input PCEQ file or re-entered,
with an option to overwrite the PCEQ file header.

The input file has the default extension .EQ. The output file has the default name
identical with the input file and with the default extension .SGY.
17
CONVSEIS
/N New epicenter coordinates

This switch is used to command the program to ask for new epicentral coordinates. In
this case the program asks also whether or not to overwrite the header of the input
PCEQ file. Default value is off.
/Cx Convert only one component
This switch is used to command the program to convert only component x, as given by
the fourth character of the station code. A blank is also accepted. Default value is all
components.
18
CONVSEIS
EQ2SEIS
EQ2SEIS converts PCEQ format (see IASPEI Software Library Volume 1) into
SEIS89 format (Baumbach, 1989).
column):
zzzz
gggg

In interactive mode, the program asks to enter the station gain if this one is missing in
the LIST.DAT file. The data are corrected for channel gain read from the input.
Command line syntax

command line. Typing EQ2SEIS ? followed by return, the following help message will
be displayed:
EQ2SEIS v4.0
PCEQ to SEIS conversion program
INTERACTIVE MODE:
Call : EQ2SEIS
COMMAND MODE:
Call : EQ2SEIS InFile /Options
Where:
InFile
Options
S
:
E
:
CChnI :
Nn
:
: name of input PCEQ file [.EQ]

: /S /E /Nn /CChn1 ... /CChnN
use S13 instrument response curve [off]
change event hypocentral parameters [off]
name of selected channel is ChnI (I=1,N) [all]
Set event ID number n as output filenames
extension (n range: 1-999) [111]
are written one file per channel, corrected for channel
gain as read from the input file.
19
CONVSEIS
The input file has the default extension .EQ. As output, there will be one file per
component with the default extension .111. The data in the output file are corrected
for channel gain.
20
CONVSEIS
/S S13 transfer function

This switch is used to write in the output file the amplitude-phase transfer function of the
S13 seismometer. Default value is off.
/E New hypocentral coordinates
This switch is used to command the program to ask for new hypocentral coordinates.
Default value is off.
all.
/Nn Event ID number
This switch is used to enter an event ID number n to be used as output file extension.
This should be an integer number in the range 1-999. Default value is 111.
21
CONVSEIS
EQ2SG
EQ2SG converts PCEQ format (see IASPEI Software Library Volume 1) into
SeisGram-binary format (see IASPEI Software Library Volume 3).
Command line syntax

Like most of the
CONVSEIS components, it can be controlled from the DOS
command line. Typing EQ2SG ? followed by return, the following help message will be
displayed:
EQ2SG v4.0
PCEQ to SeisGram-Binary conversion program
INTERACTIVE MODE:
Call : EQ2SG
COMMAND MODE:
Call : EQ2SG InFile /Options
Where:
Options : /O /CChn1 ... /CChnN /Yn /R /Dn
O
Yn
: set to n the angle of Y horizontal component
clockwise from N [0]
R
: for 3-comp. recordings reverse the normal convention which
is NS (L) -> Y and EW (T) -> X [off]
Dn
: decimate using factor n
[off]
CChnI : name of selected channel is ChnI(I=1,N) [all]
There will be one [.BIN] output file per station (1 or 3
component). Data decimation is possible.

The input file has the default extension .EQ. There will be one output file per station
(1 or 3 components) with the name YYDDSTAC.BIN, where YY is year-1900, DD is th
day of the month and STAC is the station code (three or four characters).
/Yn Horizontal component orientation
This switch is used to command the program to set to n degrees the angle between the Y
component ('N', 'R' or 'L') and North measured clockwise from North. Default value is
zero.
/R Reverse normal notation convention
This switch is used to command the program to reverse the normal horizontal
component designation in case of 3-component recordings. The normal notation is NS
(or L) Y and EW (or T) X. Default value is off.
/O Offset removal
22
CONVSEIS

all.
23
CONVSEIS
EQ2SUDS
EQ2SUDS converts PCEQ format (see IASPEI Software Library Volume 1) into PCSUDS format (Ward, 1989; Banfill, 1995). Optionally, the station coordinates and gains
can be read from a file entered as the third one on the command line. Its default name is
LIST.DAT. This file should have the following format (beginning with 1st column):
zzzz
gggg

Command line syntax

command line. Typing EQ2SUDS ? followed by return, the following help message will
be displayed:
EQ2SUDS v4.0 - PCEQ to SUDS conversion program
INTERACTIVE MODE:
Call : EQ2SUDS
COMMAND MODE:
Call : EQ2SUDS InFile OutFile (ListFile) /Options
Where:
OutFile : name of output SUDS file [InFile[.DMX]]
ListFile: name of file containing station coordinates,
elevation and gain (optional) [LIST.DAT]
Options : /O /D /Jn /Ln /CChn1 ... /CChnN
D : correct for gain (divide amplitude values by channel
gain factor as read from PCEQ file) [off]
Jn : jump n seconds from file begin [0]
Ln : retain n seconds as total file length [999]
CChnI : names of channels to select are ChnI (I=1,N) [all]
24
CONVSEIS

The input file has the default extension .EQ. The output file has the default name of the
input file and the default extension .DMX.
/O Offset removal
/D Gain correction
This switch is used to command the program to apply gain correction by dividing the
amplitude values by the channel gain value as found in the input file. Default value is off.
/Jn Jump length
/Ln Trace length
seconds.
all.
25
CONVSEIS
GSE2SG
GSE2SG converts uncompressed GSE1.0 format (see GSETT-2, 1990) into
SeisGram-binary format (see IASPEI Software Library Volume 3). A utility called
GSE2GSE can uncompress compressed GSE1.0 or convert to GSE2.0 files.
Command line syntax

command line. Typing GSE2SG ? followed by return, the following help message will be
displayed:
GSE2SG v4.0
GSE to SeisGram binary conversion program
INTERACTIVE MODE:
Call : GSE2SG
COMMAND MODE:
Call : GSE2SG InFile
Where:
InFile : name of input uncompressed GSE file [.GSE]
Possible input formats are (0, 1 or 2 differences):
INTn
n=3,...,9
INTV
free format integers
FLTn
n=3,...,9
FLTV
free format reals
Output files will be named YYDDSTAC.BIN, where:
YY=year-1900, DD=day of month, STAC=station code
Three component recordings will be merged to one file.
The amplitude values are corrected for gain read from
the input file.

The input file has the default extension .GSE. There will be one output file per station
(1 or 3 components) with the name YYDDSTAC.BIN, where YY is year-1900, DD is th
day of the month and STAC is the station code (three or four characters). There is no
switch.
26
CONVSEIS
GSE2SUDS
GSE2SUDS converts from uncompressed GSE1.0 format (see GSETT-2, 1990) into
PC-SUDS format (Ward, 1989; Banfill, 1995). A utility called GSE2GSE uncompress
compressed GSE1.0 files.
Depending on the input format in the GSE1.0 file (integer or floating point) and on
the range of output data values, the datatype in the output SUDS file is set to i (signed
short integers), l (signed long integers) or f (float reals).
Command line syntax

command line. Typing GSE2SUDS ? followed by return, the following help message will
be displayed:
GSE2SUDS v4.0
GSE to SUDS conversion program
INTERACTIVE MODE:
Call : GSE2SUDS
COMMAND MODE:
Call : GSE2SUDS InFile OutFile /Options
Where:
InFile : name of input uncompressed GSE file [.GSE]
OutFile : name of output SUDS file [InFile[.DMX]]
Options: /G
G : correct for gain (multiply data read from GSE file
with gain) [off]
Possible input formats are (0, 1 or 2 differences):
INTn
n=3,...,9
INTV
free format integers
FLTn
n=3,...,9
FLTV
free format reals

The input file has the default extension .GSE. The output file has the default name of
the input file and the default extension .DMX.
/G Gain correction
This switch is used to command the program to apply gain correction by multiplying the
amplitude values with the gain read from the input file. Default value is off.
27
CONVSEIS
K22SUDS
K22SUDS converts K2-ASCII and K2-header files (output of the program KW2ASC
of KINEMETRICS with option -H) into PC-SUDS format (Ward, 1989; Banfill,
1995). The program reverses the sign of the FBA vertical component (to get the
standard seismological convention), converts to acceleration (m/sec2) or velocity
(nm/sec) units, corrects for the group delay, changes the channel names and components,
changes the file starting time when the GPS synchronization did not function and
associates groups of three components to a set. The new channel names have the first
two characters of the station name, then the stream designator (1, 2, ..., 6 according to
the groups of three channels) and the component. The components are changed from
(L,V,T) to (N,Z,E). For these and the other possibilities see the switches below. The
program also writes a SUDS_COMMENT structure and creates a processing logfile
named K22SUDS.LOG. A batch file K2SUDS.BAT combines the use of KW2ASC and
K22SUDS.
The datatype in the output SUDS file is set to 2 (24-bit signed integers stored as
long).
Command line syntax

command line. Typing K22SUDS ? followed by return, the following help message will
be displayed:
K22SUDS v2.1
K2 ASCII to SUDS conversion program
INTERACTIVE MODE CALL: K22SUDS

COMMAND MODE CALL: K22suds InFile /Options
InFile : name of input K2 ASCII files, no extension
Options: /Sn /Tx /D /I /Ff
/CSnnx /CDnnx /CFnnx /CAnnx /CMnnx
Sn : n=1/0 reverse sign on FBA/all vertical chan(s) [off]
Tx : correct time by adding x seconds (floating point
format, max. 9 fields) to the initial sample time [off]
D : output data in digital counts [output in GMU]
I : keep initial name of the channels [rename channels]
CSnnx: set sensitivity on nn-th channel to x volts per g
(accel. chan.) or per m/s (vel. chan.) (floating point
format, max. 6 fields) [use value from header]
CDnnx: set damping on nn-th channel to x (floating point
format, max. 5 fields) [use value from header]
CFnnx: set natural freq. on nn-th channel to x (floating
point format, max. 5 fields) [use value from header]
CAnnx: set azimuth angle on nn-th channel to x (floating
point format, max. 5 fields) [use value from header]
CMnnx: multiply nn-th channel sensitivity (as read from
header) by x (floating point format, max. 6 fields) [off]
The program will correct IST for group delay, change the
designation (L,V,T) in (N,Z,E), associate channels into
28
CONVSEIS

sets, transform data units to GMU (nm/sec or um/sec**2)
or counts. The output filename is YYMDDSTA.DMX (YY=year,
M=month,DD=day,STA=station) if f=Y [default], if f=H
HMMssSTA.DMX (H=hour,MM=minute,ss=sec), MDDHmmNN.DMX if
f=M and InFile.DMX if f=I. A processing log is written in
file K22SUDS.LOG and in the SUDS_COMMENT structure.

The input files have the default extension .00n and .HDR. The output file has the
default name YYMDDSTA, where YY is the year-1900, M is the hexadecimal month
number, DD is the day of month, and STA are the first three characters of the station
code. The default extension .DMX. If there are more events in the same day, the
extension will be changed from .DMX to .DMn, then to .Dnn and finally to .nnn, where n
varies from 0 to 9, allowing thus for a maximum of 1000 events per day.
/Sn Sign reversal
This switch is used to command the program to apply sign reversal on the vertical FBA
components if n=1 or on all vertical channels of n=0. Default value is off.
/Tx Time correction
This switch is used to command the program to apply time correction by writing the x
seconds value (maximum 9 digits in floating point format) in the corresponding SUDS
variable. Default value is off.
/D Digital counts
This switch is used to command the program to write the output file in digital counts.
Default value is in ground motion units (m/sec2 for acceleration and nm/sec for
velocity).
/I Initial channel names
This switch is used to command the program to keep the initial channel names. Default
value is to rename channels.
/CSnnx Channel sensitivity
This switch is used to command the program to change the sensitivity of nn-th channel to
x volts/g for acceleration data and to x m/sec for velocity data. x is maximum 6 digits in
floating point format. Default is to use values as read from the header.
/CDnnx Channel damping
This switch is used to command the program to change the damping of nn-th channel to
x, expressed as fraction of the critical damping. x is maximum 5 digits in floating point
format. Default is to use values as read from the header.
/CFnnx Channel natural frequency
This switch is used to command the program to change the natural frequency of the
senzor of nn-th channel to x Hz. x is maximum 5 digits in floating point format. Default
is to use values as read from the header.
/CAnnx Channel azimuth
29
CONVSEIS
This switch is used to command the program to change the azimuth of nn-th channel to
x. Default is to use values as read from the header.
/CMnnx Channel sensitivity factor
This switch is used to command the program to multiply by x the sensitivity of the nn-th
channel. Default is to keep the value as read from the header.
/Ff Output file format
This switch is used to command the program what output format to use: The output
filename is YYMDDSTA.DMX (YY=year, M=month (alpha), DD=day, STA=station) if
f=Y, if f=H is HMMssSTA.DMX (H=hour (alpha), MM=minute, ss=sec),
MDDHmmNN.DMX if f=M and InFile.DMX if f=I. A processing log is written in file
K22SUDS.LOG and in the SUDS_COMMENT structure. Default is f=Y.
30
CONVSEIS
SDP2EQ
SDP2EQ converts Teledyne Geotechs Seismological Data Processing (SDP) format
on DEC-PDP minicomputers into PCEQ format (see IASPEI Software Library Volume
1). The SDP format stores three files per event with the names: EVENT.DAT,
ARRIV.DAT and WAVEFORM.DAT; it is supposed that all these files are already
transfered from the minicomputer to the PC via a network or a serial link. SDP2EQ is a
batch file calling two programs: the first one (SDP1) converts the internal PDP
representation of integers and floating point numbers into the Intel one, while the second
program (SDP2) writes one output file in the PCEQ format.
There is no upper limit on the number of samples that the program can handle.
Command line syntax

The program is simply started by typing SDP2EQ and then it enters the interactive
mode. There are no arguments or switches on the command line. The input files have the
obligatory names EVENT.DAT, ARRIV.DAT and WAVEFORM.DAT and have to be
already in the working directrory. The output file name will be YYMMDDnn.EQ, where
YY = year-1900, MM is the month number, DD is the day number and nn are current
number between 1 and 99.
Typing SDP2EQ ? followed by return, the following help message will be displayed:
SDP2EQ v4.0
SDP to PCEQ converter
INTERACTIVE MODE:
Call : SDP2EQ
The input files in SDP Teledyne Geotech format are:
EVENT.DAT, ARRIV.DAT & WAVEFORM.DAT

There are no arguments and switches.
31
CONVSEIS
SEGY2ASC
SEGY2ASC converts from PC-SEGY format format (see IASPEI Software Library
Volume 2) into a general ASCII format with a small header giving event location. Then,
for each channel, a separate header gives channel code and gain, time of the first sample,
number of samles and sampling rate for that channel. Optionally, the output file can be
without header, containing in the first column the time values, so that a plotting program
like GRAPHER from Golden Software can read directly the data.
Command line syntax

command line. Typing SEGY2ASC ? followed by return, the following help message will
be displayed:
SEGY2ASC v4.0
SEGY to ASCII conversion program
INTERACTIVE MODE:
Call : SEGY2ASC
COMMAND MODE:
Call : SEGY2ASC InFile OutFile /Options
Where:
InFile : name of input SEGY file [.SGY]
OutFile : name of output ASCII file [InFile[.ASC]]
Options : /G /CChn1 ... /CChnN
CChnI : name of channel to process is ChnI (I=1,N) [none]
Output ASCII file header gives event location and, for
each channel, the code, gain factor, initial sample time,
no. of samples and sampling rate as read from SEGY file.
Option /G produces an ASCII file without header, time in
the first column, to be read by GRAPHER program; different
data channels are separated by a blank line.
If option /G is on, amplitude values are corrected for
gain (divided by channel gain).

The input file has the default extension .SGY. The output file has the default name of
the input file and the default extension .ASC.
This switch is used to command that the output file has no header and contains the time
values in the first column. Different channels are separated by a blank line. After manual
separation of each channel, this files can be directly read by the GRAPHER plotting
program. The output amplitudes are corrected for gain (divided by channel gain). Default
value is off.
32
CONVSEIS
none. If this option is omitted the user is prompted for channel selection.
33
CONVSEIS
SG2EQ
SG2EQ converts SeisGram-binary format (see IASPEI Software Library Volume 3)
into PCEQ format (see IASPEI Software Library Volume 1).
Command line syntax

command line. Typing SG2EQ ? followed by return, the following help message will be
displayed:
SG2EQ v4.0
SeisGram Binary to PCEQ conversion program
INTERACTIVE MODE:
Call : SG2EQ
COMMAND MODE:
Call : SG2EQ InFile OutFile
Where:
InFile : name of input SG file [.BIN]
OutFile : name of output PCEQ file [InFile[.EQ]]

The input file has the default extension .BIN. The output file has the default name of
the input file and the default extension .EQ. There is no switch.
34
CONVSEIS
SGA2EQ
SGA2EQ converts SeisGram-ASCII format (see IASPEI Software Library Volume 3)
into PCEQ format (see IASPEI Software Library Volume 1).
Command line syntax

command line. Typing SGA2EQ ? followed by return, the following help message will be
displayed:
SGA2EQ v4.0
SeisGram ASCII to PCEQ conversion program
INTERACTIVE MODE:
Call : SGA2EQ
COMMAND MODE:
Call : SGA2EQ InFile OutFile
Where:
InFile : name of input SG file [.ASC]
OutFile : name of output PCEQ file [InFile[.EQ]]

The input file has the default extension .ASC. The output file has the default name of
the input file and the default extension .EQ. There is no switch.
35
CONVSEIS
SGA2ASC
SGA2ASC converts SeisGram-ASCII format (see IASPEI Software Library Volume
3) into a general ASCII format with a small header giving event location. Then, for each
channel, a separate header gives channel code and gain, time of the first sample, number
of samles and sampling rate for that channel. Optionally, the output file can be without
header, containing in the first column the time values, so that a plotting program like
GRAPHER from Golden Software can read directly the data.
If the input file has 3 components the program asks the user for component selection.
Each component is then written in a different column, without gain correction.
There is no upper limit on the number of samples that the program can handle.
Command line syntax

command line. Typing SGA2ASC ? followed by return, the following help message will
be displayed:
SGA2ASC v4.1 - SeisGram ASCII to ASCII conversion program
INTERACTIVE MODE:
Call : SGA2ASC
COMMAND MODE:
Call : SGA2ASC InFile OutFile /Options
Where:
InFile : name of input SeisGram ASCII file [.ASC]
OutFile : name of output ASCII file [EQ.[ASC]]
Options : /G
Output ASCII file header gives for each channel the code,
gain factor, initial sample time, no. of samples and
sampling rate as read from input file. Option /G produces
an ASCII file without header, but with time samples to be
read by GRAPHER program.

The input file has the default extension .ASC. The output file has the default name EQ
and the default extension .ASC.
This switch is used to command the output file to contain the time values in the first
column. Different channels are separated by a blank line. After manual separation of each
channel, this files can be directly read by the GRAPHER plotting program. Default value
is off. If option G is on, the clipping level and the scale factor to multiply data values can
be set.
36
CONVSEIS
SG2SUDS
SG2SUDS converts 3-component or 1-component input files in binary or ASCII
SeisGram format (see IASPEI Software Library Volume 3) into PC-SUDS format
(Ward, 1989; Banfill, 1995). If three components are present, they will be associated
together into a single data stream (using a SUDS_CHANSET structure).
handle the input data it truncates the data vector and writes a warning message on the
screen.
Command line syntax

command line. Typing SG2SUDS ? followed by return, the following help message will
be displayed:
SG2SUDS v1.1 - SeisGram to SUDS conversion program
COMMAND MODE:
Call : SG2SUDS InFile OutFile /Ff
Where:
InFile : name of the input SeisGram file [.BIN or .ASC]
OutFile : name of output PC-SUDS file [.DMX]
Ff
: f=B/A input format is Binary/ASCII [B]
The program handles a 3-component or 1-component input
file in SeisGram binary or ASCII format and converts it
to PC-SUDS format. If three components are present, they
will be associated together into a single data stream
(using a SUDS_CHANSET structure).

The input file has the default extension .BIN or .ASC. The output file has the default
name of the input file and the default extension .DMX.
/Ff Offset removal
This switch is used to instruct the program on the format of the input file: f = B means
binary and f = A means ASCII. Default value is B.
37
CONVSEIS
SUDS2EQ
SUDS2EQ converts PC-SUDS format (Ward, 1989; Banfill, 1995) into PCEQ format
(see IASPEI Software Library Volume 1).
In interactive mode, the program asks the user for channel selection. The DC offset is
always removed.
Command line syntax

command line. Typing SUDS2EQ ? followed by return, the following help message will
be displayed:
SUDS2EQ v2.0
SUDS to PCEQ conversion program
INTERACTIVE MODE:
Call : SUDS2EQ
COMMAND MODE:
Call : SUDS2EQ InFile OutFile /Options
BATCH MODE:
Call : SUDS2EQ ALL
Where:
InFile : Name of the input SUDS file [.DMX]
OutFile : Name of the output PCEQ file [InFile[.EQ]]
Options : /Jn /Ln
ALL: convert all SUDS files listed in file dirfil
In INTERACTIVE MODE the channel selection is possible.
DC offset is removed.

The input file has the default extension .DMX. The output file has the default name of
the input file and the default extension .EQ.
/Jn Jump length
/Ln Trace length
seconds.
38
CONVSEIS
SUDS2GSE
SUDS2GSE converts PC-SUDS format (Ward, 1989; Banfill, 1995) into
uncompressed GSE1.0 format (see GSETT-2, 1990). A utility called GSE2GSE can
compress the GSE1.0 files or convert to GSE2.0 files.
The data types supported in the input SUDS file are s, q, i, u, 2, l and f (see Banfill,
1995). Depending on the data type in the input SUDS file, the output format is
automatically chosen either as integer INT6 or float FLT8, both uncompressed and with
0 differences.
In command mode, a third argument in the command line is a file containing a list of
channels to be processed (maximum 128). An option is provided to convert only one
channel. In interactive mode, the program asks the user to select channels to convert.
If a file named SUDS2GSE.INI is present in the working directory, the instrument
characteristics are read from it and written into the GSE file. The format of the file
SUDS2GSE.INI is as follows (last line should be blank):
- Col. 1: any non-blank character other than * means channel skipped;
- Col. 3-7: channel code;
- Col. 53-55: calibration period, in seconds;
- Col. 57-62: gain in digital count per ground motion in m/... at calibration period;
- Col. 65-70: instrument type (identification string);
- Col. 73: motion type (0=displacement, 1=velocity, 2=acceleration).
Command line syntax

command line. Typing SUDS2GSE ? followed by return, the following help message will
be displayed:
SUDS2GSE v4.53
SUDS to GSE conversion program
INTERACTIVE MODE:
Call : SUDS2GSE
COMMAND MODE:
Call : SUDS2GSE InFile OutFile (LstFile) /Options
BATCH MODE:
Call : SUDS2GSE ALL
Where:
OutFile : Name of the output GSE file [InFile[.GSE]]
LstFile : Optional, name of file containing channels list
(one per line, starting in col.3) and each channel gain,
calibration period, instrument type, motion type.
A non-blank character in the first column (other than *)
means channel skipped [all active channels]
Options : /Jn /Ln /O /R /CChnx
: use the corrected sampling rate [off]

39
CONVSEIS

CChnx : activate channel Chnx, override LstFile selection
ALL: convert all SUDS files listed in file dirfil
Output format is uncompressed 0 differences, INT6, INT8
or FLT8. No gain correction is applied.
In INTERACTIVE MODE the channel selection is possible.

The input file has the default extension .DMX. The output file has the default name of
the input file and the default extension .GSE.
/Jn Jump length
/Ln Trace length
seconds.
/O Offset removal
/R Sampling rate
This switch is used to command the use of the corrected sampling rate, if present.
/CChnx Channel selection
This switch is used to command selection of one channel only. Default is to use all
channels from SUDS2GSE.INI file.
40
CONVSEIS
SUDS2SGA
SUDS2SGA converts PC-SUDS format (Ward, 1989; Banfill, 1995) into SeisGramASCII format (see IASPEI Software Library Volume 3). The program creates for each
channel in the PC-SUDS file a different output file. A utility called SGA2SGA can then
combine single-channel files into three-component files. Another utility SG2SG can
convert SeisGram-ASCII files into SeisGram binary files.
handle the input data it creates a logfile with the same name as the input file and the
extension .LOG.
Command line syntax

command line. Typing SUDS2SGA ? followed by return, the following help message will
be displayed:
SUDS2SGA v2.31
SUDS to SGA conversion program
INTERACTIVE MODE:
Call : SUDS2SGA
COMMAND MODE:
Call : SUDS2SGA InFile /Options
Where:
Options : /Jn /Ln /O /G /F
G : if input data are in digital counts, convert to GMU
(dividing data vector by sensitivity [count/GMU] as
read from the INSTRUMENT structure of InFile) [off]
F : if present, forces the output filename to have the same
name as input file (components are simply numbered
in the extension); otherwise, for each
channel there will be an output file named YYDDSTAC.ASC
(YY=year, DD=day of month, STA =station, C=component).

The input file has the default extension .DMX. The output file has the name
YYDDSTAC, where YY is the year-1900, DD is the day of month, STA are the first
three characters of the station code and C is the component (Z, N or E). The default
extension .ASC.
/Jn Jump length
/Ln Trace length
seconds.
/O Offset removal
41
CONVSEIS
42
CONVSEIS
/G Ground motion units

This switch is used to command the program to output the data in ground motion units if
the input data are in digital counts, by dividing the data by the sensitivity. Default is to
keep output data in digital counts.
/F Output filename equals input filename
This switch is used to command the program to give the output file the same name as the
input file. The extension begins with an A, followed by an ordered combination of the
numbers 0 through 9. Default is to change the output filename.
43
CONVSEIS
V12SGA
V12SGA converts KINEMETRICS VOL1 format into SeisGram-ASCII format (see
IASPEI Software Library Volume 3). For each component in the input file, a different
output file will be created. If the input file has 3 components, one single output file is
created.
Command line syntax

command line. Typing V12SGA ? followed by return, the following help message will be
displayed:
V12SGA v4.0
VOL1 to SeisGram-ASCII conversion program
INTERACTIVE MODE:
Call : V12SGA
COMMAND MODE:
Call : V12SGA InFile /Options
Where:
InFile : name of input VOL1 file [STAYYMDD.V1], with:
STA = station code, YYMDD = event date (month in HEX).
Options: /R /O /Sn /Pn /Yn
R : reverse normal notation convention [off]
Sn : set new sampling rate to n [off]
Yn : set to n angle of Y horiz.comp. clockw. from N [off]
One output file [.ASC] per station (1 or 3-component) is
produced. Horizontal comp. direction must be specified in
the .V1 file as NS,EW or XnY (X,Y=N,S,E or W; n=its angle
measured from X towards Y direction). In case of 3-comp.,
normal convention for horiz.comp.is: NS (L)->Y, EW (T)->X

The input file name has the default name STAYYMDD.V1, where STA is a 3character station code, YY is year-1900, M is month in HEX (i.e. January=1,
February=2, October=A, November=B, December=C). The output file has the default
extension .ASC.
/R Reverse normal notation convention
This switch is used to command the program to reverse the normal horizontal
component designation in case of 3-component recordings. The normal notation is NS
(or L) Y and EW (or T) X. Default value is off.
/O Offset removal
44
CONVSEIS
/Yn Horizontal component orientation

This switch is used to command the program to set to n degrees the angle between the Y
component and North measured clockwise from North. If this option is omitted, the
default value is that one read from input .V1 file.
/Sn Resampling rate
This switch is used to enter the new sampling rate. The data will be decimated or
interpolated without filtering. Default value is off.
45
CONVSEIS
V22EQ
V22EQ converts KINEMETRICS VOL2 format into PCEQ format (see IASPEI
Software Library Volume 1). The program runs only in interactive mode and asks the
user to enter component ('Z', 'N', 'E' or 'ALL'), datatype (displacement, velocity or
acceleration) and whether or not to remove the offset. The gain in the output file is set to
100 for velocity or acceleration data and to 1000 for displacement data.
The maximum number of samples that the program can handle is 32,512.
Command line syntax

command line. Typing V22EQ ? followed by return, the following help message will be
displayed:
V22EQ v4.0
VOL2 to PCEQ conversion program
BATCH MODE:
Call : V22EQ
The program convert all VOL2 files previously listed
(using the DOS dir command) in file dirfil.
The name of each input file must be STAYYMDD.V2, where:
STA=station code, YY=year-1900, M=month (in HEX), DD= day
of month. There will be one output file, having the name
of the first input file and the extension .EQ.
The program asks the user for component selection (N, E,
Z or all), for the type of data to process (acceleration,
velocity or displacement) and whether or not to remove
offset. The gain in the output file is 100 for velocity
or acceleration data and 1000 for displacement data.

The input files have the default extension .V2 and their names have to be read from a
file named DIRFIL. This file should be obtained with the DOS dir command. The file
names should have the special names STAYYMDD.V2, where STA is the station code,
YY=year-1900, M is the month number in HEX, DD is the day number. There will be
one output file with the default name of the first input file in the list and the default
extension .EQ. There is no switch.
46
CONVSEIS
WV2ASC
WV2ASC converts IASPEI MDETECT or XDETECT data acquisition formats (see
IASPEI Software Library Volume 1) into a general ASCII format with a small header
giving event location. Then, for each channel, a separate header gives channel code and
gain, time of the first sample, number of samles and sampling rate for that channel.
Optionally, the output can be without header containing in the first column the time
values, so that a plotting program like GRAPHER from Golden Software can read
directly the data.
This converter is an example of a 2-step conversion, first from PC-Quake to PCEQ
and then from PCEQ to ASCII. It consists from a batch file which calls the two
corresponding programs in command mode.
The maximum number of samples that the program can handle is 32,512.
Command line syntax

command line. Typing WV2ASC ? followed by return, the following help message will
be displayed:
WV2ASC v4.0
PC-Quake to ASCII (2-step) converter
COMMAND MODE:
Call : WV2ASC InFile /Options
Where:
InFile : input file name without extension;
extension of the input file should be .WVM
Options : /CChn1.../CChnN
CChnI
: name of the selected channel is ChnI (I=1,8) [none]
The output file name is InFile.ASC

The input file has the default extension .WVM. The output file has the default name
of the input file and the default extension .ASC.
none. If this option is omitted the user is prompted for channel selection.
47
CONVSEIS
WV2EQ
WV2EQ converts IASPEI MDETECT or XDETECT data acquisition formats (see
IASPEI Software Library Volume 1) into PCEQ format (see IASPEI Software Library
Volume 1). In interactive mode, the program asks for channel selection and whether or
not to change the time of the initial sample. The program performs always DC offset
removal and the conversion from local time to UT. The gain of the A/D board at
acquisition time is written as channel gain.
Command line syntax

command line. Typing WV2EQ ? followed by return, the following help message will be
displayed:
WV2EQ v4.0
PC-Quake to PCEQ conversion program
INTERACTIVE MODE:
Call : WV2EQ
COMMAND MODE:
Call : WV2EQ InFile OutFile /Options
BATCH MODE:
Call : WV2EQ ALL
Where:
InFile : name of input PC-Quake (M/XDETECT) file [.WVM]
OutFile : name of output PCEQ file [InFile[.EQ]
Options : /T /CChn1 ... /CChnN
T
: change event initial sample time [off]
ALL
: convert all PC-Quake files listed in file dirfil
Station gain in PCEQ file channel header equals channel
gain as read from the input PC-Quake file. DC offset
removal is performed.

The input file has the default extension .WVM. The output file has the default name
of the input file and the default extension .EQ. If instead of the input file the name ALL
is used, the program converts all files in the working directory already listed in the file
DIRFIL. DC offset removal is always performed.
/T Initial time is changed
This switch is used to command the program to ask for a new time of the firstsample in
the file. Default value is off.
all.
48
CONVSEIS
WV2GSE
WV2GSE converts IASPEI MDETECT or XDETECT data acquisition formats (see
IASPEI Software Library Volume 1) into uncompressed GSE1.0 format (see GSETT-2,
1990). A utility called GSE2GSE can compress the uncompressed GSE1.0 files. The
output amplitudes are corrected for channel gain (of the A/D board) and written in
integer INT6 format. There is a second output file containing hypocenter parameters if
automatic location was performed; its default name is also the name of the input file with
the default extension .PAR.
column):
zzzz
gggg

In interactive mode, the program asks the user for channel selection and whether or
not to change the time of the initial sample. If the file LIST.DAT is not present in the
working directory, the program asks the user to enter the motion type (displacement,
velocity or acceleration), station gain in counts per units of ground motion and
calibration period.
Command line syntax

command line. Typing WV2GSE ? followed by return, the following help message will
be displayed:
WV2GSE v4.0
PC-Quake to GSE conversion program
INTERACTIVE MODE:
Call : WV2GSE
COMMAND MODE:
Call : WV2GSE InFile OutFile1 OutFile2 /Options
BATCH MODE:
Call : WV2GSE ALL
Where:
InFile
: name of input PC-Quake (M/XDETECT) file [.WVM]
OutFile1 : name of output GSE file [InFile[.GSE]
OutFile2 : name of parameter file [InFile[.PAR], created
only for XDETECT files with hypocenter location info.
Options : /T /CChn1 ... /CChnN
T
: change event initial sample time [off]
49
CONVSEIS

ALL
: convert all PC-Quake files listed in file dirfil
are written with uncompressed INT6 format, corrected for
channel gain as read from the input file.

The input file has the default extension .WVM. The output file has the default name of
/T Initial time is changed
This switch is used to command the program to ask for a new time of the firstsample in
the file. Default value is off.
all.
50
CONVSEIS
UTILITIES
EVL2SUDS
EVL2SUDS reads a .EVL file as output of the location program HYPOPLUS
(Oncescu et al., 1996) and writes the SUDS_ORIGIN structure in a PC-SUDS file.
Command line syntax

command line. Typing EVL2SUDS ? followed by return, the following help message will
be displayed:
EVL2SUDS v1.1
SUDS utility program
COMMAND MODE:
Call : EVL2SUDS EvlFile SudsFile
INTERACTIVE MODE:
Call : EVL2SUDS
Where:
EvlFile : Name of the HYPOPLUS-EVL file [.EVL] containing
the event location information.
SudsFile: Name of SUDS file [.DMX] containing waveforms.
The event location information will be written
to the SudsFile into the SUDS_ORIGIN structure.

The input file has the default extension .EVL. The PC-SUDS file has the default
extension .DMX. There is no switch.
51
CONVSEIS
FILLEQ
FILLEQ detects and then fills with zeroes one missing component for 3-component
same station data. Moreover, it accepts new hypocenter parameters. It acts on PCEQ
format (see IASPEI Software Library Volume 1), overwriting the input file.
In interactive mode, the program asks the user whether or not to add or change
hypocenter parameters, to fill or not one missing component (out of three) with zeros
and to change or not channel gain on selected channels.
There is no upper limit on the number of samples the program can handle.
Command line syntax

command line. Typing FILLEQ ? followed by return, the following help message will be
displayed:
FILLEQ v4.0
PCEQ utility program
INTERACTIVE MODE:
Call : FILLEQ
COMMAND MODE:
Call : FILLEQ InFile /Options
Where:
InFile
Options
H
:
F
:
: name of input PCEQ file [.EQ]

: /H /F /Gn /CChn1 ... /ChnN
add or change hypocenter parameters [off]
fill one missing component (of 3, same station)
with zeroes [off]
Gn
: change channel gain to new value n [off]
CChnI : change gain on selected channel ChnI(I=1,N) [all]
The input PCEQ file will be modified according to these options.

The input file has the default extension .EQ. The output file replaces the input file.
/H New hypocenter parameters
This switch is used to command the program to ask for new hypocenter parameters.
/F Fill one missing component with zeroes
This switch is used to command detection and filling of one missing component (out of
three) with zeroes. Default value is off.
/Gn Change channel gain
This switch is used to change the channel gain to value n. Default value is off.
/CChnI Channels gain
These switches are used to indicate to which channels gains are to be changed. Default
value is all, if /G switch is on.
52
CONVSEIS
FILTSUDS
FILTSUDS performs filtering, decimation, scaling and channel skipping on PC-SUDS
files (Ward, 1989; Banfill, 1995). It allows for different cut-off frequencies for different
channels. Channel skipping may be used for those channels containing time code
information. The filter is a 4-poles Buttherworth band-pass filter applied in the time
domain in the forward direction. There is no posibility to apply only high-pass or only
low-pass filtering, but very high or very low cut-off frequencies may be specified. DC
offset removal is done on all channels on maximum 4000 samples. This program is part
of the seismological acquisition and processing system SAPS (Oncescu et al., 1996).
The cut-off frequencies Flow and Fhigh are read from the file FILTSUDS.INI
(beginning with the 1st column):
cfCODE
lllllll
hhhhhhh
where: c is: '*' to exclude that channel from filtering

'-' to skip that channel from being passed to the output file
't' to exclude that channel from filtering and decimating (only copied)
';' meaning a comment
' ' meaning channel filterred and decimated if the respective switches are
on
f is: '-' to flip (multiply by -1) that channel
' ' otherwise
CODE is the channel name (maximum 4 characters)
lllllll is Flow in floating point format
hhhhhhh is Fhigh in floating point format.
The list of stations should end with a blank line. Next and last line contains the
maximum number of samples to be handled by the program.
In interactive mode, the program asks the user to enter the decimation factor, the
number of seconds to skip and the number of seconds to keep.
The supported datatypes are s, q, i, u and f (see Banfill, 1995).
Command line syntax

command line. Typing FILTSUDS ? followed by return, the following help message will
be displayed:
53
CONVSEIS
FILTSUDS v5.5 -
SUDS band-pass filtering program
INTERACTIVE MODE:
Call : FILTSUDS
COMMAND MODE:
Call : FILTSUDS InFile OutFile /Options
BATCH MODE:
Call : FILTSUDS ALL
Where:
OutFile : Name of the output SUDS file [InFile[.DMF]]
Options : /Dn /Jn /Ln /Tn
Dn
: use decimation factor n [1]
Jn
: jump n seconds from file begin [0]
Ln
: retain n seconds as total file length [999]
Tn
: taper n points at beginning and end of trace [0]
ALL: filter all SUDS files listed in file dirfil.
A 4-poles Butterworth filter is applied. For each channel
different cutoff frequencies are set in file filtsuds.ini
DC offset removal is done on all channels on (max.) 4000
samples from file begin.

The input file has the default extension .DMX. The output file has the same name as
the input file and the default extension .DMF.
/Jn Jump length
/Ln Trace length
seconds.
/Tn Taper
This switch is used to command cosine tapering of n points at the beginning and at the
end of each trace. Default is no tapering.
54
CONVSEIS
GSE2GSE
GSE2GSE is a utility program to compress and uncompress GSE1.0 (see GSETT-2,
1990) or GSE2.0 (GSETT-3, 1995) files and to convert from GSE1.0 into GSE2.0 or
vice-versa. It is based on a collection of routines written by Urs Kradolfer for other
platforms and ported now on a PC. The GSE2.0 support originates from Karl Koch.
The maximum number of samples the program can handle is 33,000. A version named
GSE2GSE_ to handle up to 99,000 samples is provided.
Command line syntax

command line. Typing GSE2GSE ? followed by return, the following help message will
be displayed:
GSE2GSE v5.5
GSE to GSE conversion program
INTERACTIVE MODE:
Call : GSE2GSE
COMMAND MODE:
Call : GSE2GSE InFile OutFile /Dn /Fform
Where:
InFile : name of input GSE file [.TXT]
OutFile : name of output GSE file [InFile[.GSE]]
Dn
: no. of differences = n (0, 1 or 2) [0]
Fform : output format = form [ CMP6 ]
Possible output formats are:
INTn
n=3,...,9
INTV
free-format integers
INT
GSE2.0 integer format
CMPn
n=6, or 8-bit compression
CMn
n=6, or 8-bit compression in GSE2.0 format

The input file has the default extension .TXT. The output file has the same name as
/Dn Number of differences
This switch is used to specify the number of differences n between consecutive samples
to be computed and stored in place of actual values in the output file. If the signal does
not contain very high frequencies, the differences are smaller than values and thus need
fewer characters to be stored. Default values is zero (actual values are written).
/Fform Output format
This switch is used to specify the output format. Permitted formats are: INTn, equivalent
to the FORTRANs 'I(n-1),1x' format, INTV, (free-format integers) and CMP6 or
CMP8, (6-bit or 8-bit compressed). CM6 or CM8 specifies the same compression, but
commands the output file in GSE2.0 format. The format of the input file is automatically
recognized. Default value is CMP6.
55
CONVSEIS
HYPO2GSE
HYPO2GSE reads an .EVL or .EVT file as output of the location program HYPOPLUS
(Oncescu et al., 1996), or a .PHA file in HYPO71 phase format, and writes a GSE 2.0
message file (see GSETT-3, 1995).
If the input file contains event locations (in .EVL or .EVT format), the GSE file will
contain bulletin data (both origins and arrivals), while if the input file contains only phases
without event locations (.EVT format or .PHA format), the GSE file will contain arrival
data. The output filename is MESSAGE. If there is a MESSAGE file already present in the
working directory, HYPO2GSE will append the latest events locations or phases groups to
the existing file.
A unique identification number will be assigned by the program to each event or group
of arrivals; optionally, the ID number of the first event or phases group to be converted can
be input in the program command line.
Command line syntax

Like most of the CONVSEIS components, it can be controlled from the DOS command
line. Typing HYPO2GSE ? followed by return, the following help message will be
displayed:
HYPO2GSE v1.1 - HYPO to GSE conversion program
COMMAND MODE:
Call : HYPO2GSE Filename /Nnnn
Where:
Filename = name of the input file which can be:
location file in HYPOPLUS-EVL format
or location file in HYPOPLUS-EVT format
or phase file in HYPO71-PHA format
/Nnnn (optional) = event or arrivals group id number
Output file (in GSE2.0 format) is named MESSAGE .
The output file will contain bulletin data if the input
file has HYPOPLUS-EVL or HYPOPLUS-EVT location format, or
arrival data if the input file has HYPO71-PHA format or
HYPOPLUS-EVT format without any location.

The input filename may include the file path and has no default extension.
/Nn Event ID
This switch, if present, is used to fix the ID number for the first event or phases group from
the input file to n.
56
CONVSEIS
RFEQ
RFEQ is a utility program to resample and band-pass filter PCEQ files (see IASPEI
Software Library Volume 1). The filter is a 4-poles Buttherworth band-pass filter applied
in the time domain in the forward direction. The same cut-off frequencies is used for all
channels. In case of down sampling, the data are filtered with a cut-off frequency 4 times
less than the sampling frequency to avoid aliasing problems. There is no posibility to
apply only high-pass or only low-pass filtering, but very high or very low cut-off
frequencies may be specified.
In interactive mode, the program asks the user to enter the resampling frequency and
the high and low cut-off frequencies for band-pass filtering.
Command line syntax

command line. Typing RFEQ ? followed by return, the following help message will be
displayed:
RFEQ v4.0
Band-pass filtering and resampling program
INTERACTIVE MODE:
Call : RFEQ
COMMAND MODE:
Call : RFEQ InFile OutFile /Options
Where:
OutFile : name of output PCEQ file [InFile[.EQF]]
Options : /Rn /Ln /Hn
Rn: resample data using new sampling frequency n [off]
Ln: filter using low cut-off frequency n [off]
Hn: filter using high cut-off frequency n [off]
The filter is a 4-pole Butterworth filter.
If down-sampled, the traces are filtered with the same
filter with cut-off frequency four times less than the
sampling frequency to avoid aliasing problems.

The input file has the default extension .EQ. The output file has the same name as the
input file and the default extension .EQF. Both low and high frequency cut-off should be
specified.
/Rn Resampling
This switch is used to specify the new resampling frequency n (in Hz). Default is no
resampling.
/Ln Low frequency cut-off
This switch is used to specify the low frequency cut-off n (in Hz). Default is no filtering.
/Hn High frequency cut-off
57
CONVSEIS
This switch is used to specify the high frequency cut-off n (in Hz). Default is no filtering.
58
CONVSEIS
SG2SG
SG2SG performs the following operations on SeisGram-binary or -ASCII files (see
IASPEI Software Library Volume 3): flipping one component, rotating horizontal
components, decimating without filtering or computing the product between vertical and
radial component. Because the input and output files (as controlled by the file
SG2SG.INP) can be independently binary or ASCII, SG2SG may be also used to
convert SeisGram-binary in SeisGram-ASCII and vice-versa. A second output file
contains in the first column the time values, so that a plotting program like GRAPHER
from Golden Software can read directly the data.
Command line syntax

command line. Typing SG2SG ? followed by return, the following help message will be
displayed:
SG2SG v4.1
SeisGram Binary&ASCII utility program
INTERACTIVE MODE:
Call : SG2SG
COMMAND MODE:
Call : SG2SG InFile OutFile
Where:
InFile : name of input SG file ([.BIN] or [.ASC] added)
OutFile : name of output SG file ([.BIN],[.ASC] or [.DAT]
added)
Input file must be in SeisGram binary or ASCII format;
if there are three components the program can rotate
horizontal comp. along radial and transversal direction,
can calculate the product between radial and vertical
components and can resample the time series (without
filtering!). Output can be in SeisGram -binary or ASCIIand plain ASCII file (with time samples) as for GRAPHER
program. The control file of the program is SG2SG.INP.

The input file has the default extensions .BIN or .ASC, depending on the switches in
SG2SG.INP. The output file has the same name as the input file and the default
extensions .BIN or .ASC, again depending on the switches in SG2SG.INP. In addition, a
second output file is also created, with the same name, but with the extension .DAT,
with the time values in the first column. There is no switch on the command line.
59
CONVSEIS
The data in the control file SG2SG.INP are read in free format. They are written as
follows:
Line 1: ipvr
Line 2: rotang
Line 3: irot
Line 4: iprod
Line 5: inpmot ioutmod
Line 6: idecim
Line 7: facz facy facx
where: ipvr multiplies the product between the vertical and radial component; if it is
zero, the product calculation is skipped
rotang is the rotation angle for the horizontal components (in degree)
irot is 1 if the rototation angle is the backazimuth, -1 if it is the azimuth; if
it is zero, the rotation is skipped
iprod commands the way the product is calculated:
is 1 if Prod = Sign[(Ver*Ver+Rad*Rad),Ver*Rad]
is 2 if Prod = Ver*Rad
is 3 if Prod = Sign[Sqrt(|Ver*Rad|),Ver*Rad]
inpmod is 1 for input SeisGram-ASCII file
is 0 for input SeisGram-binary file
ioutmod is 1 for output SeisGram-ASCII file
is 0 for output SeisGram-binary file
idecim is the factor for decimation
facz, facy, facx are floating point factors to multiply Z, Y or X component,
respectively.
60
CONVSEIS
SGA2SGA
SGA2SGA combines three 1- or 3-component SeisGram-ASCII files (see IASPEI
Software Library Volume 3) into one 3-component SeisGram-ASCII file.
In interactive mode, the program asks the user to enter the input file names and the
cooresponding components to be kept.
Command line syntax

command line. Typing SGA2SGA ? followed by return, the following help message will
be displayed:
SGA2SGA v4.0
SeisGram ASCII utility program
INTERACTIVE MODE:
Call : SGA2SGA
COMMAND MODE:
Call : SGA2SGA InFile1 Infile2 Infile3 OutFile /Options
Where:
InFile1...3 : name of 3 input SGA files [.ASC]
OutFile : name of output SGA file [SGA[.ASC]]
Options : /Cklm
Cklm
: components (1,2 or 3) to extract from the three
input files [111]
The input files may be 1- or 3- comp ASCII SeisGram files
and the output file is a 3-comp SeisGram ASCII file.

The three input files have the default extension .ASC. The output file has the default
name SGA and the default extension .ASC.
/Cklm Components
This switch is used to specify which components from the input files (k from the first
input file, l from the second one and m from the third one) will be merged in the output
file. Default is k=l=m=1.
61
CONVSEIS
SGY2SGY
SGY2SGY combines two PC-SEGY files (see IASPEI Software Library Volume 2)
into one PC-SEGY file, with possible shifting of the epicentral distances from the second
file with respect to the first one. This feature is useful when computing synthetic
seismograms to be plotted together with the observed ones, slightly shifted.
In interactive mode, the program asks the user to enter the distance in meters used to
shift the epicentral distances from the second file. This option is useful when having
observed seismograms in one file and synthetics in the other one. When displaying the
output file (normally directly with RecSec program from IASPEI Software Library
Volume 2), each synthetic seismogram will be drawn close to the observed one.
Command line syntax

command line. Typing SGY2SGY ? followed by return, the following help message will
be displayed:
SGY2SGY v4.0
SEGY utility program
INTERACTIVE MODE:
Call : SGY2SGY
COMMAND MODE:
Call : SGY2SGY InFile1 InFile2 OutFile /Options
Where:
InFile1 : name of 1st input SEGY file [.SGY]
InFile2 : name of 2nd input SEGY file [.SGY]
OutFile : name of output SEGY file
[.SGY]
Options : /Sn
Sn : set to n the interval to shift distances from 2nd
file with respect to the first [0].
The program combines two SEGY files (possibly shifting
distances) into one to be read by program RecSec.

The two input files have the default extension .SGY. The output file has the default
extension .SGY.
/Sn Shift epicentral distances
This switch is used to specify the interval n (in meters) which will be used to shift the
epicentral distances of the second file (normally equal to those in the first file). Default
value is zero.
62
CONVSEIS
SORTEQ
SORTEQ performs sorting out of channels on PCEQ files (see IASPEI Software
Library Volume 1).
In interactive mode, the program asks the user to enter what channels to sort out.
Command line syntax

command line. Typing SORTEQ ? followed by return, the following help message will be
displayed:
SORTEQ v4.0
INTERACTIVE MODE:
Call : SORTEQ
COMMAND MODE:
Call : SORTEQ InFile OutFile /Options
Where:
InFile
OutFile
Options
CChnI
:
:
:
:
name of input PCEQ file [.EQ]

name of output PCEQ file [.EQ]
/CChn1 ... /CChnN
name of channel to sort out is ChnI (I=1,N)[none]

The input file has the default extension .EQ. The output file has the default
extension .EQ.
These switches are used to indicate which channels are to be sorted out. Default value is
none.
63
CONVSEIS
SUDSINST
SUDSINST extracts instrument information from a PC-SUDS file and writes it in an
ASCII file. The instrument information consists of channel name, instrument
identification, motion type (1 = displacement, 2 = velocity, 3 = acceleration), year and
Julian Day of the event, natural period in seconds, fraction of the critical damping,
number of poles in the anti-aliasing filter (set to 20), lowpass corner frequency in the
anti-aliasing filter (in Hz), and the sensitivity in counts per ground motion units
corresponding to the sensor type: counts/m for displacement, counts/(m/sec) for
velocity and counts/(m/sec2) for acceleration.
In interactive mode, the program asks the user to enter the input and the output file
names.
Command line syntax

command line. Typing SUDSINST ? followed by return, the following help message will
be displayed:
SUDSINST v1.1
INTERACTIVE MODE:
Call : SUDSINST
COMMAND MODE:
Call : SUDSINST InFile OutFile
Where:
OutFile : Name of the output ASCII file [InFile[.INS]]
containing the instrument characteristics as read from
the InFile: for each channel its name, instrument ID, the
date, motion type (1=displ., 2=vel., 3=acc.), natural
period, damping, number of poles & the low-pass corner
frequency of the anti-aliasing filter, and sensitivity
(in [counts/um] for displ.resp., [counts*sec/um] for
vel. resp., [counts*(sec**2)/um for acc.resp.).

The input file have the default extension .DMX. The output file has the same name as
the input file and the default extension .INS. There are no switches.
64
CONVSEIS
SUDSRW
SUDSRW extracts selected data from a PC-SUDS file. Either time windows or
channel names can be used to select data to be output. Optionally, the output data can be
multiplied by a factor and the datatype can be forced to be long integer or real. Only the
data structures will be written to the output file.
Command line syntax

command line. Typing SUDSRW ? followed by return, the following help message will
be displayed:
SUDSRW
v3.0
COMMAND MODE:
Call : SUDSRW InFile OutFile /Options
Where:
OutFile : Name of the output file [InFile[.DMY]]
Options : /Jn /Ln /On /Sn /CChn1 ... /CChnN
Jn : set jump length to n seconds [0.]
Ln : set window length to n seconds [ALL]
Sn : multiply output data by a scaling factor of n [1.]
On : n=1/0 force integers/reals as output data [1]
CChnI : names of channels to select are ChnI (I=1,N) [all]
The program reads the input SUDS file and writes out to
a SUDS file the data in the selected window. Only data
structures will be output.

The input file have the default extension .DMX. The output filename is the same as
the input filename, but with the default extension .DMY.
/Jn Jump length
/Ln Trace length
seconds.
/Sn Scaling factor
This switch is used to command the program to multiply output data by the factor n.
Default value is one.
/On Output format
This switch is used to command the program to output the data as long integers (n = 1)
or reals (n = 0). Default value is integers.
/CChnI Channel to process
65
CONVSEIS
This switch is used to command the program to select channels ChnI. Default value is all
channels.
66
CONVSEIS
SUDSTOOL
SUDSTOOL lists and interactively changes the channel names and components, the
channel starting times and the sampling rates in a PC-SUDS file. It also lists the record
duration, sensor type (a = accelerometer, v = geophone or d = displacement-meter),
motion type (a = acceleration, v = velocity or d = displacement), data units (m=microns
[/sec or /sec2], n = nanometers [/sec or /sec2], d = digital counts or v = milivolts), and the
content of the SUDS_COMMENT structure.
Command line syntax

command line. Typing SUDSTOOL ? followed by return, the following help message
will be displayed:
SUDSTOOL v5.1
SUDS Utility Program
INTERACTIVE MODE:
Call : SUDSTOOL
COMMAND MODE:
Call : SUDSTOOL InFile /Options
BATCH MODE:
Call : SUDSTOOL ALL
Where:
Options : /En /C
E : commands interactive change of channel name,
component name,IST and sample rate [off]
E0 : IST second is set to zero [off]
C : output comments from SUDS_COMMENT structure
ALL: process all SUDS files listed in file dirfil.
Without any options, the program lists the channels names
and components; for each channel, the waveform initial sample
time, the time length, the sampling rate, the sensor type,
the motion type and the data units.

The input file have the default extension .DMX. The output file is the same as the
input file.
/E Change channel names, components, starting times and sampling rates
This switch is used to command the program to interactively change channel names,
component names, starting times and sampling rates. Default value is off.
/E0 Set starting times to zero
This switch is used to command the program to automatically set the all channel starting
times to zero. Default value is off.
/C Output comments
This switch is used to command the program to output the content of the
SUDS_COMMENT structure. Default value is off.
67
CONVSEIS
SUDXTR
SUDXTR extracts phase information from a PC-SUDS file and writes it in an ASCII
file readable by the HYPO71 program (Lee and Lahr, 1975). The phase information
consists of arrival time, P or S identification, onset descriptor, first motion and quality.
For P phases, the peak-to-peak amplitude (divided by gain) and its corresponding period
are also writtento the HYPO71 file, as well as the coda duration. This program is part of
the seismological acquisition and processing system SAPS (Oncescu et al., 1996).
In interactive mode, the program asks the user to enter the input and the output file
names.
Command line syntax

command line. Typing SUDXTR ? followed by return, the following help message will
be displayed:
SUDXTR
v2.1
COMMAND MODE:
Call : SUDXTR InFile[.DMX] (OutFile[.PHA]) (/D)
INTERACTIVE MODE:
Call : SUDXTR
Where:
InFile: : Name of input SUDS file [.DMX]
OutFile : Name of output phase file [InFile[.PHA]]
D
: If present, deletes output file, if empty.
The program extract P and S arrival times with signs and
peak-to-peak amplitudes with corresponding periods from
the input SUDS file and writes them in HYPO71 format.

The input file have the default extension .DMX. The output file has the same name as
the input file, if not explicitely specified, and the default extension .PHA.
/D Delete output file
This switch is used to command the program to delete the output file, if empty (this
happens when the input file contains no phase data). Default value is to keep the output
file.
68
CONVSEIS
SUMEQ
SUMEQ sums up PCEQ files (see IASPEI Software Library Volume 1) resulting one
output PCEQ file.
In interactive mode, the program asks the user whether or not to enter new
hypocentral parameter. In this mode, a maximum number of 100 input files is allowed
(in batch mode, this number is limited by the length of the input command line).
Command line syntax

command line. Typing SUMEQ ? followed by return, the following help message will be
displayed:
SUMEQ v4.0
INTERACTIVE MODE:
Call : SUMEQ
COMMAND MODE:
Call : SUMEQ InFile1 ... InFileN OutFile /Options
Where:
InFile1...N : names of N input PCEQ files [.EQ]
OutFile : name of output PCEQ file [.EQ]
Options : /P
P
: enter new hypocentral parameters [off]

The input files have the default extension .EQ. The output file has the default
extension .EQ.
/P New hypocentral parameters
This switch is used to command the program to ask for new hypocentral parameters.
69
CONVSEIS
V22V2
V22V2 extracts a portion of a KINEMETRICS VOL2 file (corrected acceleration,
velocity and displacement for three components) and writes it in the same format. It is
useful when wanting to eliminate filtering artifacts at the beginning and at the end of the
file after processing with the VOL2 program of KINEMETRICS. It is also useful when
the number of data to be plotted exceeds 16,000 (maximum number plotted by the
V2PLOT program of KINEMETRICS). The program redetermines the maximum and
the corresponding occurence time and writes these values in the output file.
In interactive mode, the program asks the user to enter the number of seconds to
jump (default zero) and the number of seconds to keep (default 999).
Command line syntax

command line. Typing V22V2 ? followed by return, the following help message will be
displayed:
V22V2 v1.0
VOL2 to VOL2 utility program
COMMAND LINE MODE

Call : V22V2 InFile OutFile /Jn /Lm
where: InFile is a VOL2 file [.V2]
OutFile is a VOL2 file [.V2]
Options: /Jn, where n is the number of
seconds to jump from file begin [0]
/Ln, where m is the number of seconds
to retain [999]

The input file has the default extension .V2. The output file has the default
extension .V2.
/Jn Jump length
/Ln Trace length
seconds.
70
CONVSEIS
TIM2SEGY
TIM2SEGY generates travel times in an arbitrarily layered structure, having the
output in PC-SEGY format (see IASPEI Software Library Volume 2). The program
works only in interactive mode, asking firstly for the minimum, maximum and number of
epicentral distances of interest. Secondly, it asks for the focus depth. The program reads
the velocity model from file MODEL.DAT in the following format (beginning with 1st
column):
hhhhhhh
vvvvvvv
where: hhhhhhh is the layer thickness in floating point format (in km);
vvvvvvv is the layer velocity in floating point format (in km/second).
Next, the program displays for each interface beneath the focus the question whether
to compute the direct wave (D), the head-wave along it (H), the reflected wave at it (R)
or all three wave branches from above (A). The letters in brackets should be used as
answers and followed by return.
71
CONVSEIS
REFERENCES
Banfill, R., 1995. PC-SUDS Utilities Version 2.4. Small Systems Support, Big Water, Utah,
141p.
Baumbach, M., 1990. SEIS89 - A PC application for interactive seismogram analysis and
processing, in Garcia-Fernandez, M., Roca, A. and Poupinet, G., eds., Applications of
Personal Computers in Seismology, Servei Geologic de Catalunya, p.9-12, Barcelona,
Spain.
Lee, W.H.K. and Lahr, J.C., 1975. HYPO71 (REVISED): a computer program for
determining hypocenter, magnitude, and first motion pattern of local earthquakes. USGS
Open-File Report 75-311, Denver, Colorado.
Oncescu, M.C. and Rizescu, M., 1994. Conversion program package for seismological digital
data on PCs. Computer & Geosciences, 20, p.193-196.
Oncescu, M.C., Rizescu, M. and Bonjer, K.P., 1996. SAPS - A completely automated and
networked seismological acquisition and processing system. Computer & Geosciences,
22, p.89-97.
GSETT-2, 1990. Ad hoc group of scientific experts to consider international cooperative
measures to detect and identify seismic events - Conference Room Paper 190/Rev.4,
Instructions for the conduct of the preparatory test of phase 3 of GSETT-2, Sept.
1990, Geneva, Switzerland.
GSETT-3, 1995. GSETT-3 Documentation, Conference Room Paper/243, Conference on
Disarmament, United Nations, 1995, Geneva, Switzerland.
Tapley, W.C. and Tull, J.E., 1991. SAC - Seismic Analysis Code: Users manual, Rev.3,
Lawrence Livermore National Laboratory, Livermore, California.
Ward, P., 1989. SUDS - Seismic Unified Data System. USGS Open-File Report 89-188,
Denver, Colorado.
72

Convert Seismological Data and Analyze Waveforms

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Convert Seismological Data and Analyze Waveforms

Uploaded by

Copyright:

Available Formats

IASPEI Software Shareware Library

CONVERSION PROGRAM PACKAGE FOR

The programs are on :

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

The utility programs are:

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

Command line syntax

ASCII-SAC to PCEQ conversion program

Arguments and switches

by L. Oncescu & M. Rizescu

/Ln Trace length

by L. Oncescu & M. Rizescu

Command line syntax

ASCII to VOL1 conversion program

Arguments and switches

by L. Oncescu & M. Rizescu

Command line syntax

PCEQ to ASCII conversion program

Arguments and switches

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

where: CODE is the station code (maximum 4 characters)

Command line syntax

PCEQ to GSE conversion program

by L. Oncescu & M. Rizescu

Arguments and switches

by L. Oncescu & M. Rizescu

where: CODE is the station code (maximum 4 characters)

Command line syntax

PCEQ to SEGY conversion program

Arguments and switches

by L. Oncescu & M. Rizescu

/N New epicenter coordinates

by L. Oncescu & M. Rizescu

where: CODE is the station code (maximum 4 characters)

Command line syntax

PCEQ to SEIS conversion program

: name of input PCEQ file [.EQ]

Arguments and switches

by L. Oncescu & M. Rizescu

by L. Oncescu & M. Rizescu

/S S13 transfer function

by L. Oncescu & M. Rizescu

Command line syntax

CONVSEIS components, it can be controlled from the DOS

PCEQ to SeisGram-Binary conversion program

Arguments and switches

by L. Oncescu & M. Rizescu

/Dn Decimation factor

by L. Oncescu & M. Rizescu

where: CODE is the station code (maximum 4 characters)

Command line syntax

by L. Oncescu & M. Rizescu

Arguments and switches

by L. Oncescu & M. Rizescu

Command line syntax