RT_SEIS

Data Utility
5.00 3/26/2013

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

Trimble Navigation Limited 1600 Tenth Street Suite A Plano, Texas 75074 Tel: 214-440-1265 Fax: 972-578-0045 www.reftek.com

5.00

RT_SEIS

3/26/2013

Revision History:
Rev 5.00 4.10 E D C A B 0.1 Date 2013.03.26 2009.06.30 2009.06.05 2007.07.13 2006.07.08 2005.10.27 2003.10.04 2003.09.02 2002.01.12 Reason for change Updated to 5.00 Updated Template Utilities 4.10 Separate docs RT_View 1.4.3 Added RT_COS Update Moved Archive Utilities Converted to separate document Added RT_SEIS(D) Initial release RT_COS Update RT_MSEED Update RT_CM6 Added Pages All All All Section 2 Section 7 Separate Document All Section 6 All Section 7 Section 8 Section 9

Related Documents:
Optional Manuals RTCC Command / Control Users Guide RT_Display Users Guide RT_View Users Guide RTPMonitor Installation and Users Guide RTPD Installation and Users Guide PDF file RTCC.pdf RTDisplay.pdf RTView.pdf RTPM.pdf 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 recipients organization without written permission from Trimble Navigation Limited. Printed in USA.

Page ii

Trimble Navigation Limited

Section 1

5.00

RT_SEIS

3/26/2013

Notation Conventions

The following notation documentation:

Notation ASCII Binary Hex BCD FPn <n> Description

conventions

are

used

throughout

REF

TEK

MSB MSbit LSB LSbit YYYY DDD HH MM SS TTT IIII n, nS u, uS m, mS K, KHz M, MHz G, GHz
Kb, KB Mb, MB Gb, GB

Indicates the entry conforms to the American Standard Code for Information Interchange definition of character (text) information. Indicates the entry is a raw, numeric value. Indicates hexadecimal notation. This is used with both ASCII characters (0 9, A F) and numeric values. Indicates the entry is a numeric value where each four bits represents a decimal digit. Indicates the entry is the ASCII representation of a floating-point number with n places following the decimal point. 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. Most Significant Byte of a multi-byte value. Most Significant Bit of a binary number. Least Significant Byte of a multi-byte value. Least Significant Bit (bit 0) of a binary number. Year as a 4-digit number Day of year Hour of day in 24-hour format Minutes of hour Seconds of minute Thousandths of a second (milliseconds) Unit ID number nano, nanoSecond; 10-9 = 0.000000001 micro, microSecond; 10-6 = 0.000001 milli, milliSecond; 10-3 = 0.001 Kilo, KiloHertz; 103 = 1,000 Mega, MegaHertz; 106 = 1,000,000 Giga, GigaHertz; 109 = 1,000,000,000
Kilobit, KiloByte; 210 = 1,024 Megabit, MegaByte; 220 = 1,048,576 Gigabit, GigaByte; 230 = 1,073,741,824

Trimble Navigation Limited

Page iii

5.00

RT_SEIS

3/26/2013

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 http://support.reftek.com . online registration form at

Once we register your contact we will only send necessary notifications via email. The same notifications will be shown on our websites http://support.reftek.com notifications page. Thanks, Your REF TEK support team

Page iv

Trimble Navigation Limited

Section 1

5.00

RT_SEIS

3/26/2013

Contents
1 General Description ................................................................................ 1 2 Program usage ....................................................................................... 2
2.1 3.1 3.2 4.1 4.2 RT_SEIS Program Switches ............................................................................ 3 RTU.INI Fields .............................................................................................. 6 Sample RTU.INI file: ..................................................................................... 6 RT_SEIS Files ............................................................................................... 7 RT_SEIS Files ............................................................................................... 8

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

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

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

5.1.1 5.1.2 5.1.3 5.1.4 5.1.5 5.1.6 5.1.7 5.1.8 5.1.9 5.1.10 5.1.11 REF TEK SEISAN File Header ................................................................... 10 Line 1: ................................................................................................. 10 Line 2: ................................................................................................. 10 Line 3: ................................................................................................. 11 Line 4: ................................................................................................. 11 Line XX: ............................................................................................... 11 REF TEK SEISAN Trace Header ................................................................ 12 Response Formats.................................................................................. 13 Option 1: .............................................................................................. 14 Option 2: .............................................................................................. 15 REF TEK SEISAN Blocking Behavior .......................................................... 15

Trimble Navigation Limited

Page v

5.00

RT_SEIS

3/26/2013

This page intentionally left blank.

Page vi

Trimble Navigation Limited

Section 1

2013.03.27

RT_SEIS

Status

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.

Trimble Navigation Limited

Page 1

5.00

RT_SEIS

3/26/2013

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. qualified path. The output path defaults to the current directory. available on the file system.

It can include a fullyIt can be any path

The table below describes the available switches. The switches are NOT case sensitive and can appear anywhere on the command line.

Page 2

Trimble Navigation Limited

Section 2

5.00

RT_SEIS

3/26/2013

2.1 RT_SEIS Program Switches

Switch -Dc Name DT log Description Output DT headers in log file Switch command c: Y/+ : output DT header N/ - : do not output DT header c: Y/+ : output logs N/ - : do not output logs c: 0/N/-: auto-select Unit ID/Station 1/I : always use Unit ID 2/S : always use Station Name n: 0: no additional subdirectories 1: one level: IDiiii1 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 c: Y/+ : output file N/ - : do not output file n: constant n: constant n: constant Ex: -D+ Default N/-

-Lc -Nc

Log File Name

Log File Output Control Name options

-Ly -Ns

N/0/N/-

-Pn

Path

DOS output path control

-P0

Non-DOS output path control

-p2

-Qc

Qcc File

Qcc File Output

-Q+

N/-

-Rn -Sn -Tn

Sample Rate Sample Count Trash samples

Default Sample Rate (only used if rate not known) Limit the number of samples in the output file Trash n samples from each event

-R100 -S3000 -T100

200 4,294,967,295 0

1 2

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

Trimble Navigation Limited

Page 3

5.00 Switch -Vc Name Verbose

RT_SEIS Description Verbose message output

3/26/2013 Switch command c: Y/+ : output message N/ - : do not output message Ex: -VY Default Y/+

Page 4

Trimble Navigation Limited

Section 2

5.00

RT_SEIS

3/26/2013

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

Trimble Navigation Limited

Page 5

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 Station Network Latitude Longitude Altitude Description Station Name Network name Station Latitude; degrees North Station Longitude; degrees East Station Altitude; meters up from sea level Channel n Seisan component Type Text Text Float.4 Float.4 Integer Size/Range 5 29 0 90.0 0 180.0 +/- ??? Default 0 0 0 SEISAN FH-3:2 TH-A:1 FH-1:2 TH-A:52 TH-A:61 TH-A:71

CHnSeisComp

Text

Sscx1

FH-3:6 TH-A:6

3.2 Sample RTU.INI file:

[9FE3] Network Station Latitude Longitude Altitude = = = = = Western Norway Network STTA1 44.0235 160.65 180 Z N E Z N E ;vertical ;north ;east ;vertical ;north ;east

;Channel 1 CH1SeisComp = S ;Channel 2 CH2SeisComp = S ;Channel 3 CH3SeisComp = S ;Channel 4 CH4SeisComp = B ;Channel 5 CH5SeisComp = B ;Channel 6 CH6SeisComp = B

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

Page 6

Trimble Navigation Limited

Section 3

5.00

RT_SEIS

3/26/2013

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 PASSCAL Raw Data File Master QCC File Master Log File Unit Log File SEISAN Data File Description Data as collected by a REF TEK DAS. Text file containing quality control calculations; data max, min, std dev (RMS). Text log of the conversion process. Text log of the packets converted for a unit. Data in REF TEK SEISAN data format. File Name Structure inputfilename.RT inputfilename.QCC Example 91C6E011.RT 91C6E011.QCC

inputfilename.LOG IDiiii.RTL1 eeee_s_c.SEI2

91C6E011.RTL ID91C6.RTL 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 2

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

Trimble Navigation Limited

Page 7

5.00

RT_SEIS

3/26/2013

4.2 RT_SEIS Files

File Type PASSCAL RAW Data File Master QCC File Master Log File Unit Log File SEISAN Data File Description Data as collected by a REF TEK DAS. Text file containing quality control calculations; data max, min, std dev (RMS). Text log of the conversion process. Text log of the packets converted for a unit. Data in REF TEK SEISAN data format. File Name Structure inputfilename.RT inputfilename.QCC Example 1999260115841097_0036F0E2_7986_1.RT 1999260115841097_0036F0E2_7986_1.QCC

inputfilename.RTL IDiiii.RTL1 yyyydddhhmmssttt_iiiii_s_c.SEI2

1999260115841097_0036F0E2_7986_1.RTL ID7986.RTL 1999260115841097_07986_1_1.SEI

1 2

iiii uid (serial no.) 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)

Page 8

Trimble Navigation Limited

Section 4

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.

Trimble Navigation Limited

Page 9

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
Byte Number 1 2 30

Line 1:
Field Name Network name Number of Stations Century Year DOY Month SEISAN Waveform Standard format Free Network Name, (could E.G. be Western Norway Network) Number of Stations, MAX 999 0 = 1900, 1 = 2000 Year Space DOY Space Month Space Day Space Hour Space Minute Space Second (Format F6.3) Space Total Time Window (Secs) (Format F9.3) Free SUDSEI Description ASCII space Header for REFTEK REF TEK SEISAN Description ASCII space INI:Network or REFTEK NETWORK Total number of Channels in the file 0 if year > 84, 1 otherwise Year (first sample) ASCII space DOY (first sample) ASCII space Month (first sample) ASCII space Day (first sample) ASCII space Hour (first sample) ASCII space Minute (first sample) ASCII space Second + m-second (first sample) ASCII space (last sample time first sample time) (1000/ (sample rate * 0.001)) ASCII space

31 33 34 35 36 37 38 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 59 60 61 69

Total number of Channels ASCII space Year ASCII space DOY ASCII space Month ASCII space Day ASCII space Hour ASCII space Minute ASCII space Second + m-second ASCII space (last sample time first sample time) (1000/ (sample rate * 0.001)) ASCII space

Day Hour Minute

Second

Total Time Window

70 80

5.1.2
Byte Number 1 80

Line 2:
Field Name SEISAN Waveform Standard format Free SUDSEI Description ASCII spaces REF TEK SEISAN Description ASCII spaces

Page 10

Trimble Navigation Limited

Section 5

5.00

RT_SEIS

3/26/2013

5.1.3
Byte Number 1 25 69

Line 3:
Field Name Station Code Component SEISAN Waveform Standard format Free Station Code (A4) Component (A4) SUDSEI Description ASCII space Station Name + Stream number + Channel number Character S + two spaces + Channel number ASCII space (channel first sample time) (event first sample time) ASCII space (Sample counter) / Sample rate Same as byte 1 26 REF TEK SEISAN Description ASCII space EH:Station name or INI:Station INI:CHnSeisComp or character S + stream + channel + axis EH:Station name or INI:Station (channel first sample time) (event first sample time) ASCII space (Sample counter) / Sample rate Same as byte 1 26

10 11 17

Station Code ext. Start time

18 19 26 27 52

Station Interval Length Second Channel

53 78

Third Channel

79 80

Station Code 5th character (A1) Start Time Relative to Event File Time (Secs) (F7.2) Space Station Data Interval Length (Secs) (F8.2) Second Channel ( 26 bytes for Channel 2; same format as byte 1 26) Third Channel ( 26 bytes for Channel 3; same format as byte 1 26) Blank

Same as byte 1 26 ASCII spaces

Same as byte 1 26 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.

Trimble Navigation Limited

Page 11

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 1-5 6-9 Field Name Station Code Component SEISAN Waveform standard format Station Code (A5) Component (A4) SUDSEI Description Station name + Stream number + Channel number Character S + two spaces + Channel number ASCII space Year ASCII space DOY ASCII space Month ASCII space Day ASCII space Hour ASCII space Minute ASCII space Second ASCII space Sample Rate ASCII space Sample count ASCII space ASCII spaces ASCII space ASCII spaces ASCII space ASCII space ASCII space REF TEK SEISAN Description EH:Station name or INI:Station INI:CHnSeisComp or character S + stream + channel + axis ASCII space Year (first sample) ASCII space DOY (first sample) ASCII space Month (first sample) ASCII space Day (first sample) ASCII space Hour (first sample) ASCII space Minute (first sample) ASCII space Second (first sample time) ASCII space Sample Rate ASCII space Sample count ASCII space EH:Position or INI:Latitude ASCII space EH:Position or INI:Longitude ASCII space EH:Position or INI:Altitude ASCII space

10 11 13 14 17 18 20 21 23 24 26 27 29 30

- 12 16 19 22 25 28 35

Year Day of year Month Day Hour Minute Second

Space Year Space DOY Space Month Space Day Space Hour Space Minute Space Second (F6.3) Space Sample Rate (F7.2) Space Number of Samples Space Latitude (F8.4) Space Longitude (F9.4) Space Elevation (Meters) Gain factor (blank = no gain, G = gain in bytes 148 159) Sample Size ( 2 or 4 for 2 or 4 byte integer, blank is 2 byte)

36 37 43 44 45 50 51 52 59 60 61 - 69 70 71 75 76

Sample Rate Number of Sample Latitude

Longitude

Elevation Gain

77

Sample Size

Page 12

Trimble Navigation Limited

Section 5

5.00 Byte Number 78 Field Name Response Format

RT_SEIS SEISAN Waveform standard 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.) 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.) Free Comment line describing the system response (A80) SUDSEI Description ASCII space

3/26/2013 REF TEK SEISAN Description ASCII space

79

Table Response Format

ASCII space

ASCII space

80 81 160

Comments

ASCII space ASCII spaces

ASCII space 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.

Trimble Navigation Limited

Page 13

5.00

RT_SEIS

3/26/2013

5.2.2
Byte Number

Option 1:
Field Name SEISAN Waveform standard format REF TEK RT_SEIS(D) Description SEISAN SUDSEI Description

161 168 169 176 177 184

185 192 193 200 201 208 209 216 217 224 225 320 321 1040 Filter 1 Cuttoff Filter 1 Poles Filter 2 - 6 Response Curves

Seismometer Period Fraction of Critical Damping Seismometer Generator Constant (V/m/s) or Seismometer Sensitivity (V/G) Amplifier Gain Recording media gain (i.e. 2048 counts/volt) Gain at 1 Hz, units: counts/meter Filter 1 Cutoff frequency (Hz) Filter 1 # poles (neg for highpass) Additional filters (10G8.3) Response Curves FREQ., AMPL. (REL. 1.0 Hz) and Phase, Written in Groups of 10 Frequencies, 10 Amplitudes and 10 Phases. (9(10G8.3)

9 ASCII spaces ASCII spaces

9 ASCII spaces ASCII spaces

ASCII spaces ASCII spaces ASCII spaces ASCII spaces ASCII spaces ASCII spaces ASCII spaces

ASCII spaces ASCII spaces ASCII spaces ASCII spaces ASCII spaces ASCII spaces ASCII spaces

Page 14

Trimble Navigation Limited

Section 5

5.00

RT_SEIS

3/26/2013

5.2.3
Byte Number

Option 2:
Field Name SEISAN Waveform standard format REF TEK RT_SEIS(D) Description SEISAN SUDSEI Description

161 182

Response Definition

183 240 241 1040

Poles Pairs

Remaining Poles and Zeros

Number of Poles Number of Zeros Normalization Constant, Counts/ M (1X, 2I5, G11.4) 2 Poles in pairs of real and imaginary parts (5G11.4) Remaining Poles and Zeros. 7 values are written and then 3 spaces are left blank.

ASCII spaces

ASCII spaces

ASCII spaces

ASCII spaces

ASCII spaces

ASCII spaces

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.

Trimble Navigation Limited

Page 15

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