RTITAN2

rtitan2 − manual page for rtitan2 version 2.2.31

rtitan2 [action] [channels] [timespec] input

rtitan2 converts titan2 data files, directories, or disks to various formats. rtitan2 can also extract all the other information frames multiplexed in the titan2 data files (GPS position, battery state etc.).

General options.

−q

quiet mode: print warning only

−v

print some messages during work

−V

print lots of messages during work

Titan disk specific actions (no input data):

These options are to be used with data directly obtained

from a TITAN digitizer, and should be applied on the original medium or a complete copy of the original medium.

−size file

read the size.siz file (must be specified before −data)

−index,opt file

read the ndx file

opt is a comma separated list of options:

cache: generate a cache based on the index

tl: generate an event list based on the index

−data file

select and read the data.ndx file

−nooffset

ignore offset frames (processed by default)

Status analysis (no input data):

This is mainly for internal use in OMNI

−oif,options file.oif

read the Osiris status files and dump a HTML page, optionnally create the tile (GD needed) and the sattelite map oif options must be coma−separated, the following are defined:

h=0|1* dump the html page

v=0*|1 process also the debug parameters

g=0*|1 create the gps map

t=0*|1 build the station tile

tbn=StationName* overwrite tile basename

oaf=file ouptut the alert state in this file

oef=file read the error list in this file

Example: −oif,t=1,v=0,g=1,oef=680001.oef,oaf=680001.oaf 680001.oif > 680001.html

Time processing specific actions:

−tcorr

do not correct from internal time shift, check info files. Only the A/D converter delay and filter delays are corrected

−pulsefilter file

read ’file’ as a time shift file (.dt), automatically remove the outliers and dump a .flt file

Osiris disk specific actions:

−te file

read ’file’ as a TriggerEvent file and dump the content in a human−readable form

General options:

−o

overwrite output files

−daydir

output data filesin the JJJ/ directory. JJJ is the julian day

−O filename

force the output name

−n

use the channel number, not the channel name for file names

−0

warn if more than 10 zeros are detected in the data. Implies −nodata −nocache −noinfo −sac. Do not expect data to be written !

−sta STANAME

force station name, ignore the information

−scanall

force to scan all the input data, do not try to seek (use with −f)

−localcache

force the use of file .LocalCacheFile (for corrupted input)

−nocache

do not create nor use the cache

−nodata

do not save the data files (for test only)

−noinfo

do not create the .info files when extracting data

−minsamples N do not process data frames shorter than N samples

−tdb database use database to overwrite header information. See −tdbdoc (WIP)

−tag TAG

extract only the data matching the give tag; by default, no filter is applied; select AUTO to extract general data only (exclusion of non AUTO tags)

Action:

General actions and behaviour.

−howto

display the complete documentation

−copy

display copyright information

−help

display help message

−logdoc

display the log file description (see −log)

−tdbdoc

display the titan database (TDB) documentation

−version

display version string

−event def

event definition (for sac): YYYY.MM.DD.hh.mm.ss.sss,lat,lon,dep

−clearcache

remove all the cache entries

−tit

select titan frames according to timespec

−sac

convert to SAC

−sis[,rm]

convert to Sismalp, remove mean

−asc

convert to ASC (text file)

−segy

convert to SEGY (SU, PASSCAL taste)

−seg2

convert to SEG−2 (not tested!)

−mseed,opts

convert to Mini−Seed

MiniSeed options must be coma−separated, the following is defined:

b=blocklen (3) defines the block length (0:512b, 1:1K, 2:2K, 3:4K)

f=format (3) data format (3: 32bits integer, 10: Steim1)

−wav

convert to WAV

−trig,options perform a sta/lta based trigger

Trigger options must be coma−separated, the following are defined:

s=sta (1.0) sta window length (s)

l=lta (60.0) lta window length (s)

t=theshold (2.0) threshold

hp=high pass cut off freq (0.05Hz)

lp=low pass cut off freq (20Hz)

m=duration: minimum duration

o=filename: append to filename

e=filename: append to filename (event list format)

−gif,options

build one GIF file for each time segment

Image options must be coma−separated, the following are defined:

s=0|1*: school mode (color plot for events)

r=0*|1: reverse colors

d=0*|1: day (drum) mode

y=0|1*: add y−scale on each trace

n=0*|1: alternative normalization

m=Ymax: force scaling at Ymax, not the data max

o=offset: use this offset and not the average of the data

u=filename: update the existing gif file (use with d=1)

t=’title string’: force title

Example: −gif,s=1,r=1,t=’a nice plot’

−nodisc

allow time discontinuity up to 60 seconds (for gif only)

−log

extract the station log from the data (gps info, battery etc.)

−time

extract the time pulses

−onedt

try to create only one dt file (use with −time)

−nopulsefilter

do not automatically reject time pulses out of spec. (use with −time)

Channel selection:

By default all the analogicl chanels are processed. If

aux is selected, then auxiliary channels are also processed.

−chan list

process only the channel list given as a,b−c default is all channels

−stream str

process only the channels that match the list, default is all channels (see howto)

−aux

select the auxiliary channels

Timespec:

If timespec is not set, all the data will be processed. Otherwise, the time must be specified according to this syntax:

−tl[,preevent[,postevent] file

list of time windows. Format: YYYY.MM.DD−hh.mm.ss duration(s)

If preevent is provided, the start time is shifted by the given delay: the time window becomes T−preevent to T+duration. If postevent is provided, the duration from the file is ignored: the time window becomes T−preevent to T+postevent.

−ts length

time segments of fixed length, starting at 00:00

A window can be defined in command line using −s, −S, or −F as start and −l, −p, −P, or −T as stop time.

−s YYYY:JJJ:HH:MM:SS.SSS

absolute start time (JJJ: day index since 01/01)

−S YYYY:MM:DD:HH:MM:SS.SSS

absolute start time

−F <epoch time>

absolute start time (seconds since 1970.01.01)

−l length

total length of the processed file

−p YYYY:JJJ:HH:MM:SS.SSS

absolute stop time (JJJ: day index since 01/01)

−P YYYY:MM:DD:HH:MM:SS.SSS

absolute stop time

−T <epoch time>

absolute stop time (seconds since 1970.01.01)

Input:

The input selection is mandatory. Please provide a disk,

a day directory, or a list of files.

−disk path

process en entire disk (data/ entry)

−day path

process a day directory (data/YYYY.MM.DD entry)

−f files...

process a list of files

−bof N

skip the N first bytes (applies on each file given by −f)

−eof N

stop after absolute position N (applies on each file given by −f)

rtitan2 −sac −f file.tit

reads the file file.tit and converts the stream for all the channels in SAC format.

rtitan2 −sac −aux −chan none −f file.tit

reads the file file.tit and extracts the auxiliary channels only in SAC format.

rtitan2 −log −disk /mount/usb/data > station.log

extracts all the information from the disk mounted on /mount/usb/data. The standard output is sent to station.log, all the information frames are decoded.

rtitan2 −ts 1200 −sac −log −disk /mount/usb/data > station.log same as above but also extract 20minutes long SAC files

To build a day−plot for a given date, use the following command: rtitan2 −gif,d=1 −S 2006.08.01 −l 86400 −disk /mount/usb/data

Written by Sébastien Judenherc <Sebastien.Judenherc@agecodagis.com> (Agecodagis SARL: http://www.agecodagis.com <agecodagis@agecodagis.com>). Some parts are maintained by people mentionned in the header of the source file.

Report bugs to Sébastien Judenherc <Sebastien.Judenherc@agecodagis.com>

Copyright © 2006 Sébastien Judenherc, Agecodagis SARL.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See -copy option.