• Antelope Release 5.5 Linux 2.6.32-220.el6.x86_64 2015-04-21

 

NAME

reftek_dbtiming - builds timing table for reftek data loggers

SYNOPSIS

reftek_dbtiming db [-rampout]

SUPPORT


Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.

FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.

DESCRIPTION

This program builds a css3.0 extension table called timing used to deal with data logger timing problems. It uses a table of drift rates determined by the PASSCAL instrument center for Reftek 72A series data loggers. That is, the constant used is 0.5 ppm or about 40 ms/day. The program builds a series of entries in the timing table based on the SEED quality fields. That is, an entry is made in the timing table at time intervals from the last lock time as defined by SEED quality fields: 1 hr, 2 hr, 4 hr, 8 hr, 1 day, 7 days, and greater. The timing table can be used by other programs, but the original design intent was for automated handling of timing problems in the genloc library of event location routines. That is, genloc will now look at the timing table (if it exists) and automatically switch to S-P mode when the timing accuracy of a station drops below a specified threshold.

OPTIONS

rampout controls what happens when the program reaches the end of timing information from the pcf file. The default sets the last entry in the timing table at the last clock lock time listed in the pcf file. If the -rampout flag is used the program goes into a time rampout mode when it reaches the end of an entry for a given das. It first checks for an offdate time in the site table and uses this as an absolute end time. If there is a time gap between offdate and the last pcf file entry it will add timing entries as if the last pcf file time was the last lock time. If offdate is not defined, it will add entries to the timing table until it reaches the maximum error field in the timing table (currently 30 days).

FILES

Reads PASSCAL pcf files from stdin. These are assumed to be in time order for a given data logger. Multiple pcf files from different data loggers can be combined in one input stream to allow the use of a unix pipe as in the following:
   cat NRN.pcf ACA.pcf KZN.pcf | reftek_dbtiming ghengis

DIAGNOSTICS

The program will die if the extension table timing is not defined in the schema. Otherwise it dies only on malloc errors. It will exit on out of sequence time jumps (i.e. lock times jumping backward in time) and for a range of potential data problems. The later will likely evolve based on past experience with anything from refteks.

AUTHOR

Gary L. Pavlis
Antelope User Group Contributed Software
Printer icon