RT_SEIS

RT_SEIS

Data Utility

5.00

3/26/2013

Trimble Navigation Limited

1600 Tenth Street

Suite A

Plano, Texas 75074

Tel: 214-440-1265

Fax: 972-578-0045

www.reftek.com

This REF TEK manual describes a utility program for converting PASSCAL data recorded with a REF TEK DAS to SEISAN format.

5.00 RT_SEIS 3/26/2013

Page ii Trimble Navigation Limited Section 1

Revision History:

Rev Date Reason for change Pages

5.00 2013.03.26 Updated to 5.00 All

2009.06.30 Updated Template All

4.10 2009.06.05 Utilities 4.10 – Separate docs All

E 2007.07.13 RT_View 1.4.3 Section 2

D 2006.07.08 Added RT_COS Update Section 7

C 2005.10.27 Moved Archive Utilities Separate Document

A 2003.10.04 Converted to separate document All

B 2003.09.02 Added RT_SEIS(D) Section 6

0.1 2002.01.12 Initial release All

RT_COS Update Section 7

RT_MSEED Update Section 8

RT_CM6 Added Section 9

Related Documents:

Optional Manuals PDF file

RTCC Command / Control Users Guide RTCC.pdf

RT_Display Users Guide RTDisplay.pdf

RT_View Users Guide RTView.pdf

RTPMonitor Installation and Users Guide RTPM.pdf

RTPD Installation and Users Guide RTPD.pdf

Copyright© 2013 Trimble Navigation Limited

All rights reserved. No part of this manual may be reproduced,

copied or transmitted in any form outside the approved recipient’s organization without written permission from Trimble Navigation

Limited.

Printed in USA.

5.00 RT_SEIS 3/26/2013

Trimble Navigation Limited Page iii

Notation Conventions

The following notation conventions are used throughout REF TEK documentation:

Notation Description

ASCII Indicates the entry conforms to the American Standard Code for Information

Interchange definition of character (text) information.

Binary Indicates the entry is a raw, numeric value.

Hex Indicates hexadecimal notation. This is used with both ASCII characters (0 –

9, A – F) and numeric values.

BCD Indicates the entry is a numeric value where each four bits represents a

decimal digit.

FPn Indicates the entry is the ASCII representation of a floating-point number with

n places following the decimal point.

<n> Indicates a single 8-bit byte. When the contents are numeric, it indicates a

hexadecimal numeric value; i.e. <84> represents hexadecimal 84 (132

decimal). When the contents are capital letters, it represents a named ASCII

control character; i.e. <SP> represents a space character, <CR> represents a

carriage return character and <LF> represents a line feed character.

MSB Most Significant Byte of a multi-byte value.

MSbit Most Significant Bit of a binary number.

LSB Least Significant Byte of a multi-byte value.

LSbit Least Significant Bit (bit 0) of a binary number.

YYYY Year as a 4-digit number

DDD Day of year

HH Hour of day in 24-hour format

MM Minutes of hour

SS Seconds of minute

TTT Thousandths of a second (milliseconds)

IIII Unit ID number

n, nS nano, nanoSecond; 10-9 = 0.000000001

u, uS micro, microSecond; 10-6 = 0.000001

m, mS milli, milliSecond; 10-3 = 0.001

K, KHz Kilo, KiloHertz; 103 = 1,000

M, MHz Mega, MegaHertz; 106 = 1,000,000

G, GHz Giga, GigaHertz; 109 = 1,000,000,000

Kb, KB Kilobit, KiloByte; 210 = 1,024

Mb, MB Megabit, MegaByte; 220 = 1,048,576

Gb, GB Gigabit, GigaByte; 230 = 1,073,741,824

5.00 RT_SEIS 3/26/2013

Page iv Trimble Navigation Limited Section 1

REF TEK Support and update notifications

As a valued user of REF TEK equipment we would like to provide the best support possible by keeping you up to date with our product updates.

If you would like to be notified of any REF TEK product updates please spend a couple of minutes to register with the REF TEK customer support team.

To register, fill out our online registration form at http://support.reftek.com .

Once we register your contact we will only send necessary notifications via email. The same notifications will be shown on our website’s http://support.reftek.com

notifications page.

Thanks,

Your REF TEK support team

5.00 RT_SEIS 3/26/2013

Trimble Navigation Limited Page v

Contents

1 General Description ................................................................................ 1

2 Program usage ....................................................................................... 2

2.1 RT_SEIS Program Switches ............................................................................ 3

3 INI Settings ............................................................................................ 5

3.1 RTU.INI Fields .............................................................................................. 6

3.2 Sample RTU.INI file: ..................................................................................... 6

4 RT_SEIS Output Files.............................................................................. 7

4.1 RT_SEIS Files ............................................................................................... 7

4.2 RT_SEIS Files ............................................................................................... 8

5 REF TEK SEISAN Data File Format .......................................................... 9

5.1.1 REF TEK SEISAN File Header ................................................................... 10

5.1.2 Line 1: ................................................................................................. 10

5.1.3 Line 2: ................................................................................................. 10

5.1.4 Line 3: ................................................................................................. 11

5.1.5 Line 4: ................................................................................................. 11

5.1.6 Line XX: ............................................................................................... 11

5.1.7 REF TEK SEISAN Trace Header ................................................................ 12

5.1.8 Response Formats.................................................................................. 13

5.1.9 Option 1: .............................................................................................. 14

5.1.10 Option 2: .............................................................................................. 15

5.1.11 REF TEK SEISAN Blocking Behavior .......................................................... 15

5.00 RT_SEIS 3/26/2013

Page vi Trimble Navigation Limited Section 1

This page intentionally left blank.

2013.03.27 RT_SEIS Status

Trimble Navigation Limited Page 1

RT_SEIS

1 General Description

The REF TEK RT_SEIS program converts a REF TEK PASSCAL raw data file into SEISAN data files.

Note: RT_SEISD.EXE is the DOS version, rt_seis.exe is the Win32 version

and rt_seis is the name of the UNIX versions.

If present, the RT_SEIS program uses an INI file to set values that it cannot find in the raw data file. The RT_SEIS program first looks at the RTU

environment variable. If the file specified by the environment variable is not

found, it then looks for RTU.INI in the current directory. If not found, it then it looks for RTU.INI in the directory where the program is located. If not

found, the RT_SEIS program uses default values.

5.00 RT_SEIS 3/26/2013

Page 2 Trimble Navigation Limited Section 2

2 Program usage

The RT_SEIS program is invoked using the following command:

rt_seis [switches] input_file [output_path] [switches]

The input file is a REF TEK PASSCAL raw data file. It can include a fully-

qualified path.

The output path defaults to the current directory. It can be any path available on the file system.

The table below describes the available switches. The switches are NOT

case sensitive and can appear anywhere on the command line.

5.00 RT_SEIS 3/26/2013


2.1 RT_SEIS Program Switches

Switch Name Description Switch command Ex: Default

-Dc DT log Output DT headers in log file c:

Y/+ : output DT header

N/ - : do not output DT header

-D+ N / -

-Lc Log File Log File Output c:

Y/+ : output logs

N/ - : do not output logs

-Ly N / -

-Nc Name Control Name options c:

0/N/-: auto-select Unit ID/Station

1/I : always use Unit ID

2/S : always use Station Name

-Ns 0 / N / -

-Pn Path DOS output path control n:

0 : no additional subdirectories

1 : one level: IDiiii1

-P0 1

Non-DOS output path control n:

0 : no additional subdirectories

1 : one level : yyyy_ddd2

2 : two levels: yyyy_ddd, then hh

3 : two levels: yyyy_ddd, then hh_mm

4 : two levels: yyyy_ddd, then hh_mm_ss

-p2 0

-Qc Qcc File Qcc File Output c:

Y/+ : output file

N/ - : do not output file

-Q+ N / -

-Rn Sample

Rate

Default Sample Rate (only used

if rate not known)

n: constant -R100 200

-Sn Sample

Count

Limit the number of samples in

the output file

n: constant -S3000 4,294,967,295

-Tn Trash

samples

Trash n samples from each event n: constant -T100 0

1 iiii = uid (serial no.) 2 yyyy = year, ddd = day of year, hh = hour, mm = minute, ss = second

5.00 RT_SEIS 3/26/2013


Switch Name Description Switch command Ex: Default

-Vc Verbose Verbose message output c:

Y/+ : output message

N/ - : do not output message

-VY Y/+

5.00 RT_SEIS 3/26/2013


3 INI Settings

The RT_SEIS program uses the first INI file it finds. It searches for the INI

file in the following locations: The fully-qualified file specified by the RTU environment variable.

RTU.INI in the current working directory.

RTU.INI in the directory where the RT_SEIS program is located. If the INI file is not found, the RT_SEIS program uses default values.

Each time the RT_SEIS program encounters a new event in the input file,

initializes all settings to default values. It then opens the INI file, if one can be found, and overwrites only those settings it finds in the INI file. As it

continues processing the input file, it overwrites any settings with the information from the recording packets.

The INI file is broken into separate sections for each REF TEK recorder.

Each section is named using the 4-hexadecimal digit Unit ID (serial) number of the recorder.

Ex: [90A5]

Each section is broken into fields. Each field is on a separate line with an

equal sign (=) between the field name and the field.

Ex: Station=STAP2

All sections and fields must be at the beginning of a line. Only one section

marker or field may be on a line.

Comments begin with a semicolon (;). Comments may be on a line by themselves or at the end of a line containing a section marker or field. Lines

that begin with white space are also treated as comments.

Ex: ;This is a comment.

Ex: Station=STAP2 ;This is another comment

Ex: Yet another comment

5.00 RT_SEIS 3/26/2013


3.1 RTU.INI Fields

The following table lists the fields used by the RT_SEIS program and how it

uses a particular field. In this table, EH refers to values read from the Event Header packet for an event and FH and TH refer to the File Header, and

Trace Header, respectively, of the SEISAN format. These are explained more fully in the section titled REF TEK SEISAN File Format.

Field Description Type Size/Range Default SEISAN

Station Station Name Text 5 - FH-3:2

TH-A:1

Network Network name Text 29 - FH-1:2

Latitude Station Latitude;

degrees North

Float.4 0 – 90.0 0 TH-A:52

Longitude Station Longitude;

degrees East

Float.4 0 – 180.0 0 TH-A:61

Altitude Station Altitude;

meters up from sea

level

Integer +/- ??? 0 TH-A:71

CHnSeisComp Channel n Seisan

component

Text 4 Sscx1 FH-3:6

TH-A:6

3.2 Sample RTU.INI file:

[9FE3]

Network = Western Norway Network

Station = STTA1

Latitude = 44.0235

Longitude = 160.65

Altitude = 180

;Channel 1

CH1SeisComp = S Z ;vertical

;Channel 2

CH2SeisComp = S N ;north

;Channel 3

CH3SeisComp = S E ;east

;Channel 4

CH4SeisComp = B Z ;vertical

;Channel 5

CH5SeisComp = B N ;north

;Channel 6

CH6SeisComp = B E ;east

1 Character ‘S’, Stream number, channel number and x=axis (channel 1 = Z, 2 = N, 3 = E)

5.00 RT_SEIS 3/26/2013


4 RT_SEIS Output Files

All output file specifications adhere to the ISO-9660 level 2 standard. This

limits file names to 32 characters including a three-character extension. Only letters, numbers and the underscore character can be used. The file

name and file extension are separated by a period. Only one period is

permitted. Path components have the same limitations as file names.

The RT_SEISD program is further limited to DOS file names of 8 characters with a three-character extension. By default, files are stored in a

subdirectory named IDiiii, where iiii represents the DAS Unit ID.

4.1 RT_SEIS Files

File Type Description File Name

Structure

Example

PASSCAL Raw

Data File

Data as collected by a REF TEK

DAS.

inputfilename.RT 91C6E011.RT

Master QCC

File

Text file containing quality

control calculations; data max,

min, std dev (RMS).

inputfilename.QCC 91C6E011.QCC

Master Log File Text log of the conversion

process.

inputfilename.LOG 91C6E011.RTL

Unit Log File Text log of the packets

converted for a unit.

IDiiii.RTL1 ID91C6.RTL

SEISAN Data

File

Data in REF TEK SEISAN data

format.

eeee_s_c.SEI2 1234_1_1.SEI

The RT_SEIS program creates output file names using the first sample time of the trace and either the Station Name or the Unit ID (serial) number of

the REF TEK DAS that collected the data.

1 iiii = uid (serial no.) 2 Eeee = event number, s = data stream number, c = channel number

5.00 RT_SEIS 3/26/2013


4.2 RT_SEIS Files

File Type Description File Name Structure Example

PASSCAL RAW

Data File

Data as collected by a REF TEK DAS. inputfilename.RT 1999260115841097_0036F0E2_7986_1.RT

Master QCC

File

Text file containing quality control

calculations; data max, min, std dev

(RMS).

inputfilename.QCC 1999260115841097_0036F0E2_7986_1.QCC

Master Log

File

Text log of the conversion process. inputfilename.RTL 1999260115841097_0036F0E2_7986_1.RTL

Unit Log File Text log of the packets converted for a

unit.

IDiiii.RTL1 ID7986.RTL

SEISAN Data

File

Data in REF TEK SEISAN data format. yyyydddhhmmssttt_iiiii_s_c.SEI2 1999260115841097_07986_1_1.SEI

1 iiii – uid (serial no.) 2 Yyyy = year, ddd = Julian day, hh = hour, mm = minute, ss = second, ttt = msecond, iiii = uid (serial no.) or station name, s = stream, c = channel (1-9, A-W)

5.00 RT_SEIS 3/26/2013


5 REF TEK SEISAN Data File Format

SEISAN data (waveform) files contain a 960-byte file header followed by at least one trace. Each trace contains a 1040-byte trace header followed by

the trace data.

SEISAN is written in FORTRAN. It originally wrote files by opening them as “unformatted”. This caused FORTRAN to break the output into blocks and

insert bytes between the blocks. However, this blocking behavior is compiler dependent. Prior to SEISAN version 7.0, data files created by SEISAN under

Solaris or Linux were not identical to data files created by SEISAN on a PC, even though the format specification is the same. Furthermore, the byte

order is different between Sparc processors and Intel processors. Beginning

with version 7.0, the authors of SEISAN began using a different compiler on the PC that has the same blocking behavior as those under Solaris and

Linux.

The current version of SEISAN for any platform can read data files created on any platform by any earlier version of SEISAN. However, data files

created by the PC version of SEISAN 7.0 or later cannot be read by most earlier versions of SEISAN.

All versions of RT_SEIS create SEISAN data files that are consistent with

those created by SEISAN under Solaris. This means that RT_SEIS outputs the bytes in ‘big-endian’ order, even when running on a PC. It also uses the

Unix blocking behavior, even under DOS and Windows. Therefore, the data files produced by RT_SEIS should be readable by any version of SEISAN on

any platform. Although the SEISAN format can contain more than one

trace, RT_SEIS generates a separate SEISAN data file for each trace.

5.00 RT_SEIS 3/26/2013


5.1 REF TEK SEISAN File Header

Each SEISAN file header contains at least 960 bytes of information in at least

12 blocks of 80 bytes. The first 80-byte block (line 1) contains header information that applies to all included traces. The second 80-byte block

(line 2) contains spaces and is unused, but must be present. Blocks (lines) 3 – 12 contain header information for each channel (trace) in the file. Some

of these blocks may also be blank, but must be present.

5.1.1 Line 1:

Byte

Number

Field

Name

SEISAN Waveform

Standard format

SUDSEI

Description

REF TEK SEISAN

Description

1 Free ASCII space ASCII space

2 – 30 Network

name

Network Name,

(could E.G. be

Western Norway

Network)

Header for REFTEK INI:Network or

REFTEK NETWORK

31 – 33 Number of

Stations

Number of Stations,

MAX 999

Total number of

Channels

Total number of

Channels in the file

34 Century 0 = 1900, 1 = 2000 ASCII space 0 if year > 84,

1 otherwise

35 – 36 Year Year Year Year (first sample)

37 Space ASCII space ASCII space

38 – 40 DOY DOY DOY DOY (first sample)


42 – 43 Month Month Month Month (first

sample)


45 – 46 Day Day Day Day (first sample)


48 – 49 Hour Hour Hour Hour (first sample)


51 – 52 Minute Minute Minute Minute (first

sample)


54 – 59 Second Second (Format

F6.3)

Second + m-second Second + m-second

(first sample)


61 – 69 Total Time

Window

Total Time Window

(Secs)

(Format F9.3)

(last sample time –

first sample time) –

(1000/ (sample

rate * 0.001))

(last sample time –

first sample time) –

(1000/ (sample

rate * 0.001))

70 – 80 Free ASCII space ASCII space

5.1.2 Line 2:

Byte

Number

Field

Name

SEISAN Waveform

Standard format

SUDSEI

Description

REF TEK SEISAN

Description

1 – 80 Free ASCII spaces ASCII spaces

5.00 RT_SEIS 3/26/2013


5.1.3 Line 3:

Byte

Number

Field

Name

SEISAN Waveform

Standard format

SUDSEI

Description

REF TEK SEISAN

Description


2 – 5 Station Code Station Code (A4) Station Name +

Stream number +

Channel number

EH:Station name or

INI:Station

6 – 9 Component Component (A4) Character ‘S’ + two

spaces + Channel

number

INI:CHnSeisComp

or character ‘S’ +

stream + channel +

axis

10 Station Code

ext.

Station Code 5th

character (A1)

ASCII space EH:Station name or

INI:Station

11 – 17 Start time Start Time Relative

to Event File Time

(Secs)

(F7.2)

(channel first

sample time) –

(event first sample

time)

(channel first

sample time) –

(event first sample

time)


19 – 26 Station

Interval

Length

Station Data Interval

Length (Secs)

(F8.2)

(Sample counter) /

Sample rate

(Sample counter) /

Sample rate

27 – 52 Second

Channel

Second Channel ( 26

bytes for Channel 2;

same format as byte

1 – 26)

Same as byte

1 – 26

Same as byte 1 -

26

53 – 78 Third Channel Third Channel ( 26

bytes for Channel 3;

same format as byte

1 – 26)

Same as byte

1 – 26

Same as byte 1 -

26

79 – 80 Blank ASCII spaces ASCII spaces

5.1.4 Line 4:

.

.

.

5.1.5 Line XX:

Note: Lines 4 – XX have the same format as line 3; XX depends on the

number of channels. However, XX is at least 12 so there might be some blank lines.

5.00 RT_SEIS 3/26/2013


5.2 REF TEK SEISAN Trace Header

Each SEISAN trace header contains 1040 bytes of information in two

sections; a 160-byte standard ASCII section and an 880-byte configurable ASCII section whose format depends on character (byte) 78.

Byte

Number

Field

Name

SEISAN Waveform

standard format

SUDSEI

Description

REF TEK SEISAN

Description

1 - 5 Station Code Station Code (A5) Station name +

Stream number +

Channel number

EH:Station name or

INI:Station

6 - 9 Component Component (A4) Character “S” +

two spaces +

Channel number

INI:CHnSeisComp or

character ‘S’ +

stream + channel +

axis


11 - 12 Year Year Year Year (first sample)


14 – 16 Day of year DOY DOY DOY (first sample)


18 – 19 Month Month Month Month (first sample)


21 – 22 Day Day Day Day (first sample)


24 – 25 Hour Hour Hour Hour (first sample)


27 –28 Minute Minute Minute Minute (first sample)


30 – 35 Second Second (F6.3) Second Second (first sample

time)


37 – 43 Sample Rate Sample Rate (F7.2) Sample Rate Sample Rate


45 – 50 Number of

Sample

Number of Samples Sample count Sample count


52 – 59 Latitude Latitude (F8.4) ASCII spaces EH:Position or

INI:Latitude


61 - 69 Longitude Longitude (F9.4) ASCII spaces EH:Position or

INI:Longitude


71 – 75 Elevation Elevation (Meters) ASCII space EH:Position or

INI:Altitude

76 Gain Gain factor (blank =

no gain, G = gain in

bytes 148 – 159)

ASCII space ASCII space

77 Sample Size Sample Size ( 2 or 4

for 2 or 4 byte

integer, blank is 2

byte)

4 4

5.00 RT_SEIS 3/26/2013


Byte

Number

Field

Name

SEISAN Waveform

standard format

SUDSEI

Description

REF TEK SEISAN

Description

78 Response

Format

Response

Information.

(space = option 1, P

= option 2: Poles

and zeros used for

response info. See

optional structure

for details.

T = Use the 30

tabulated values

irrespective of what

is given above.)


79 Table

Response

Format

Table Response

Format.

(only used if byte 78

is T: C = a

combination of

table, poles and

zeros or instrument

constants have been

used, for information

only; F = force use

of header response,

e.g. generated by

MULPLT, only gain at

1Hz is correct.)



81 – 160 Comments Comment line

describing the

system response

(A80)

ASCII spaces ASCII spaces

5.2.1 Response Formats

Option 1 is used when byte 78 is a space. Option 2 is used when byte 78 is ‘P’.

5.00 RT_SEIS 3/26/2013


5.2.2 Option 1:

Byte

Number

Field

Name

SEISAN Waveform

standard format

REF TEK

RT_SEIS(D)

Description

SEISAN

SUDSEI

Description

161 – 168

Seismometer Period

9 9

169 – 176

Fraction of Critical Damping


177 – 184

Seismometer Generator

Constant (V/m/s) or Seismometer

Sensitivity (V/G)


185 –

192

Amplifier Gain ASCII spaces ASCII spaces

193 - 200

Recording media gain (i.e. 2048

counts/volt)


201 –

208

Gain at 1 Hz,

units: counts/meter


209 – 216

Filter 1 Cuttoff

Filter 1 Cutoff frequency (Hz)


217 - 224

Filter 1 Poles

Filter 1 # poles (neg for high-

pass)


225 -

320

Filter 2 - 6 Additional filters

(10G8.3)


321 -

1040

Response

Curves

Response Curves

FREQ., AMPL. (REL. 1.0 Hz) and Phase, Written in

Groups of 10 Frequencies, 10

Amplitudes and 10 Phases. (9(10G8.3)


5.00 RT_SEIS 3/26/2013


5.2.3 Option 2:

Byte

Number

Field

Name

SEISAN Waveform

standard format

REF TEK

RT_SEIS(D)

Description

SEISAN

SUDSEI

Description

161 – 182

Response Definition

Number of Poles Number of Zeros

Normalization Constant, Counts/

M (1X, 2I5, G11.4)


183 – 240

Poles Pairs 2 Poles in pairs of real and imaginary parts

(5G11.4)


241 -

1040

Remaining

Poles and Zeros

Remaining Poles

and Zeros. 7 values are written

and then 3 spaces are left blank.


5.2.4 REF TEK SEISAN Blocking Behavior

In the file header section, the RT_SEIS program breaks the 960 bytes into blocks containing 80 byte. This directly corresponds to the blocks of the

SEISAN format specification. In each trace section, the RT_SEIS program breaks the 1040 byte trace header into 8 blocks of 128 bytes and 1 block of

16 bytes. It breaks the data into blocks of 128 bytes, although the last block may be shorter. One byte containing the block length is stored before

and after each block.

5.00 RT_SEIS 3/26/2013

Trimble Navigation Limited

1600 Tenth Street

Suite A

Plano, Texas 75074

Tel: 214-440-1265

Fax: 972-578-0045

www.reftek.com

RT_SEIS

Documents

Transcript of RT_SEIS