NAME
replay_gaps - combine realtime with baler data and send to replay orb
SYNOPSIS
replay_gaps [-v] [-V] [-n] [-f]
[-p pf] [-m mail_to]
replay_orb YYYY MM
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
replay_gaps uses a collection of scripts build the best estimate of missing real-time
data which has
been recovered from the balers. The real-time data and retrieved baler data are combined into one
database which is then sent to the
replay_orb using dbreplay. Since dbreplay and trexcerpt
are used, various miniseed flags will be unavailable in the miniseed data received at the DMC.
replay_gaps requires an active
replay_orb to ship data to the DMC. The other
required inputs are the year and month of data to process input in the form of
YYYY MM.
The sequence of scripts executed by
replay_gaps for each
YYYY MM processed are:
-
build_baler_data
builds cleanbalerdirbase/YYYY_MM/baler database combining all approrpiate data
under balerdb_central.
-
fill_gaps
build final waveform database combining rt data with baler data to fill gaps.
-
gap_status
Evaluate whether TA and DMC gaps have been filled by baler recoveries
-
replay_data
replays final waveform database into replay_orb
OPTIONS
-
-v
verbose
-
-V
Extremely verbose. Used for debugging purposes only.
-
-n
Test mode. Does not execute commands.
-
-f
Fast mode. Does not execute build_baler_data command. This option can be used if proc_gaps
has been run since the last baler data recovery.
-
-p parameter_file
Name of parameter file to use. $PFPATH is searched to find parameter file.
The default parameter file is proc_gaps.
-
-m mail_to
email address list to send results.
ENVIRONMENT
needs to have sourced $ANTELOPE/setup.csh.
PARAMETER FILE
-
dbbase
db dbbasename
-
dmcgapbase
dmc gap dbbasename
-
period
allowed values are "year" or "month"
-
clustername
dbcentral cluster name
-
rtdirbase
Path name for directory base for wfdiscs of monthly realtime waveform data.
-
cleanbalerdirbase
Path name for directory base for databases containing cleaned monthly baler waveform data.
-
wfdirbase
Path name for directory base original realtime waveform data.
-
requestdir
path name for baler request directory
-
balerdb_central
dbcentral for baler data recoveries
-
balerwfdisc
path name for complete baler wfdisc db
-
archivebase
Absolute path name for output directory containing station directories with station database
-
dbidserver
Name of idserver to be written into descriptor file for output database to use.
-
dbpath
dbpath to be written into descriptor file for output database to use.
-
dblocks
dblocking type for database
EXAMPLE PARAMETER FILE
dbbase usarray # db dbbasename
dmcgapbase dmc # dmc gap dbbasename
period month # allowed values are "year" or "month"
clustername baler_data # dbcentral cluster name
rtdirbase /anf/TA/dbs/event_dbs # should be on a different disk than the rtdb
cleanbalerdirbase /anf/TA/build/baler # should be on a different disk than the rtdb
wfdirbase /anf/TA/dbs/certified # should be on a different disk than the rtdb
requestdir /anf/TA/baler/requests # baler request directory
balerdb_central /anf/TA/baler/all_ta_data # dbcentral for baler data recoveries
balerwfdisc /anf/TA/baler/db/all # complete baler wfdisc db
archivebase /anf/TA/wf/archive # should be on a different disk than the rtdb
dbpath /anf/TA/dbs/dbmaster/{usarray}:/anf/TA/dbs/dbops/{usarray} # default dbpath
dbidserver anfanalyst.ucsd.edu:2498 # default dbidserver
dblocks nfs # default dblocks
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
build_baler_data(1)
gap_status(1)
dbcentral(1)
fill_gaps(1)
replay_gaps(1)
proc_gaps(1)
BUGS AND CAVEATS
replay_gaps should only be run after baler data are collected and installed
into
balerdb_central using
baler2db.
AUTHOR
Frank Vernon
Antelope User Group Contributed Software