• Antelope Release 5.5 Mac OS X 10.8.5 2015-04-21

 

NAME

rtoutage - show data gaps for a database over a time period

SYNOPSIS

rtoutage [-AcCNpStz]
        [-d gap_database]
        [-n netcode]
        [-P maxpts]
        [-s subset]
        [-x deployment-subset]
            db start stop

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

rtoutage writes a summary of data gaps for a database db by channel. The output contains a list of all gaps by station, channel, and time.

The input database may be a view containing the stations and channels of interest, or just a database. In the latter case, the sensor table is opened and subset to the time range from start to stop to provide the list of available channels.

Next, the wfdisc table is opened, and for each channel, the entire waveform available from start to stop is loaded. This waveform is inspected for marked gaps, and all the gaps are printed.

OPTIONS

EXAMPLE


% rtoutage -z /brtt/danq/gsn/db/gsn 4/12/99 4/14/99
CTAO:BHZ         4/12/1999 (102)  0:00:00.000  2 days 0.0 hours
ESK:BHZ          4/12/1999 (102)  4:02:47.645   2:45 hours
ESK:BHZ          4/12/1999 (102)  8:46:59.671   2:00 minutes
ESK:BHZ          4/13/1999 (103) 18:36:35.910   2:12 minutes
KONO:BHZ         4/12/1999 (102)  0:00:00.000  2 days 0.0 hours
NNA:BHZ          4/12/1999 (102) 12:56:14.704  12.000 seconds
NNA:BHZ          4/13/1999 (103)  4:35:50.760  12.000 seconds
SUR:BHZ          4/12/1999 (102) 11:02:10.627  12.000 seconds
SUR:BHZ          4/13/1999 (103)  9:34:10.795  11.950 seconds
TATO:BHZ         4/12/1999 (102)  0:00:00.000  2 days 0.0 hours
ULN:BHZ          4/12/1999 (102)  0:00:00.000  2 days 0.0 hours

% rtoutage -Nz $db '5/17/92 21:55' 0:03 
AAK:BHZ          5/17/1992 (138) 21:55:00.000  10.250 seconds
AAK:BHZ          5/17/1992 (138) 21:57:02.700  57.300 seconds
    AAK:BHZ            1:08 minutes
CHM:BHZ          5/17/1992 (138) 21:55:00.000  15.200 seconds
CHM:BHZ          5/17/1992 (138) 21:57:21.550  38.450 seconds
    CHM:BHZ           53.650 seconds
EKS2:BHZ         5/17/1992 (138) 21:55:00.000   4.700 seconds
EKS2:BHZ         5/17/1992 (138) 21:56:41.600   1:18 minutes
    EKS2:BHZ           1:23 minutes
HIA:BHZ          5/17/1992 (138) 21:55:00.000   3:00 minutes
    HIA:BHZ            3:00 minutes
KBK:BHZ          5/17/1992 (138) 21:55:00.000  14.400 seconds
KBK:BHZ          5/17/1992 (138) 21:57:18.500  41.500 seconds
    KBK:BHZ           55.900 seconds
KIV:BHZ          5/17/1992 (138) 21:55:00.000   3:00 minutes
    KIV:BHZ            3:00 minutes
KMI:BHZ          5/17/1992 (138) 21:55:00.000   3:00 minutes
    KMI:BHZ            3:00 minutes
LSA:BHZ          5/17/1992 (138) 21:55:00.000   3:00 minutes
    LSA:BHZ            3:00 minutes
LZH:BHZ          5/17/1992 (138) 21:55:00.000   3:00 minutes
    LZH:BHZ            3:00 minutes
OBN:BHZ          5/17/1992 (138) 21:55:00.000   3:00 minutes
    OBN:BHZ            3:00 minutes
TKM:BHZ          5/17/1992 (138) 21:55:00.000  19.050 seconds
TKM:BHZ          5/17/1992 (138) 21:57:36.000  24.000 seconds
    TKM:BHZ           43.050 seconds
USP:BHZ          5/17/1992 (138) 21:55:00.000  15.700 seconds
USP:BHZ          5/17/1992 (138) 21:57:23.400  36.600 seconds
    USP:BHZ           52.300 seconds
WUS:BHZ          5/17/1992 (138) 21:55:00.000   3:00 minutes
    WUS:BHZ            3:00 minutes

> Network Performance        180 seconds
% ??   13 sta   13 chan       1616 seconds    30.96%

Stations down:
# HIA
# KIV
# KMI
# LSA
# LZH
# OBN
# WUS

% rtoutage -A -z /brtt/danq/gsn/db/gsn 4/12/99 4/14/99
Report period from 1999/04/12 00:00:00.000 to 1999/04/14 00:00:00.000
Net       Sta  Chan Aux      Start Date Time          End Date Time        Duration Comment
CTBT_AUX  CTAO  BHZ      1999/04/12 00:00:00.000 1999/04/14 00:00:00.000 172800.000
CTBT_AUX  ESK   BHZ      1999/04/12 04:02:47.645 1999/04/12 06:48:23.660   9936.015
CTBT_AUX  ESK   BHZ      1999/04/12 08:46:59.671 1999/04/12 08:48:59.671    120.000
CTBT_AUX  ESK   BHZ      1999/04/13 18:36:35.910 1999/04/13 18:38:47.860    131.950
CTBT_AUX  KONO  BHZ      1999/04/12 00:00:00.000 1999/04/14 00:00:00.000 172800.000
CTBT_AUX  NNA   BHZ      1999/04/12 12:56:14.704 1999/04/12 12:56:26.704     12.000
CTBT_AUX  NNA   BHZ      1999/04/13 04:35:50.760 1999/04/13 04:36:02.760     12.000
CTBT_AUX  SUR   BHZ      1999/04/12 11:02:10.627 1999/04/12 11:02:22.627     12.000
CTBT_AUX  SUR   BHZ      1999/04/13 09:34:10.795 1999/04/13 09:34:22.745     11.950
CTBT_AUX  TATO  BHZ      1999/04/12 00:00:00.000 1999/04/14 00:00:00.000 172800.000
CTBT_AUX  ULN   BHZ      1999/04/12 00:00:00.000 1999/04/14 00:00:00.000 172800.000

% rtoutage -p -z -s "sta=='ESK'" /brtt/danq/gsn/db/gsn 4/12/99 4/14/99
ESK:BHZ          4/12/1999 (102)  4:02:47.645   2:45 hours
ESK:BHZ          4/12/1999 (102)  8:46:59.671   2:00 minutes
ESK:BHZ          4/13/1999 (103) 18:36:35.910   2:12 minutes
Missing   2:49 hours of data from 1 channels
94.10% data recovered over  2 days 0.0 hours

RETURN VALUES

Returns zero if no errors occur, otherwise 1.

DIAGNOSTICS

SEE ALSO

autodrm(1)
gap_report(1)
rtreport(1)

BUGS AND CAVEATS

Because the entire waveform is read into memory, this is fairly expensive, and slow. While only one waveform is read into memory at a time, this could cause problems on a machine with limited memory.

Using the gaps table if it were present could make this a lot faster.

The gaps_database specified for the -d option may not be the same as the input database.

AUTHOR

Daniel Quinlan
Antelope User Group Contributed Software
Printer icon