NAME
monthly_wfs - build wfdiscs for monthly event databases and append to year waveform databases
SYNOPSIS
monthly_wfs [-v] [-V] [-n]
[-p pf] [-m mail_to]
YYYY [ MM ] || all || recent
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
monthly_wfs builds a list of year/day waveform directories and then runs
miniseed2db to
build wfdiscs. The assumption is that there is a waveform repository which contains
all waveforms for the TA. Wfdiscs are created for each year in the repository by
monthly_wfs,
one month at a time. There is also a one month long event database which needs wfdiscs built off the
same repository to minimize disk usage.
Time windows to be operated on are specified by arguement values of YYYY, MM, or "all", or "recent" (preferred and faster).
The programs or functions executed by
monthly_wfs are:
-
miniseed2db
builds evdirbase/YYYY_MM/dbbase_YYYY_MM wfdisc of data collected from wfdirbase.
In the process the wfdisc dir field is set to its absolute path, and the
lastid,snetsta,schanloc tables are removed.
-
abspath
converts dir field from relative path generated by miniseed2db to absolute path
-
dbfixchanids
fix chanids in db
-
dbset
sets calib, calper, and segtype
-
rt_daily_return
builds evdirbase/YYYY_MM/dbbase_YYYY_MM gap, netperf, and chanperf tables. Also a
rtdirbase/YYYY_MM/dbbase_YYYY_MM descriptor file is created immediately before this step.
OPTIONS
-
-v
verbose
-
-V
Extremely verbose. Used for debugging purposes only.
-
-n
Test mode. Does not execute commands.
-
-p parameter_file
Name of parameter file to use. $PFPATH is searched to find parameter file.
The default parameter file is monthly_wfs.
-
-m mail_to
email address list to send results.
ENVIRONMENT
needs to have sourced $ANTELOPE/setup.csh.
PARAMETER FILE
-
dbbase
db basename
-
ev_period
allowed values are "year" or "month"
-
wf_period
allowed values are "year" or "month"
-
ev_lag
Number of complete periods before present to allow to be processed.
If lag is 1 in arrears, time_slice_db skips the current and immediately previous periods.
-
evdirbase
Path name for directory base for wfdiscs of monthly waveform data.
-
wfdirbase
Path name for directory base original realtime waveform data.
-
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
ev_period month # allowed values are "year" or "month"
wf_period year # allowed values are "year" or "month"
ev_lag 1 # Number of complete periods before present to allow to be processed.
# If lag is 1 in arrears, time_slice_db skips the current and immediately previous periods.
evdirbase /anf/TA/dbs/event_dbs #
wfdirbase /anf/TA/dbs/wfs/certified #
dbpath /anf/TA/dbs/dbmaster/{usarray}:/anf/TA/dbs/dbops/{usarray} # default dbpath
dbidserver anfops.ucsd.edu:2498 # default dbidserver
dblocks nfs # default dblocks
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
miniseed2db(1)
dbfixchanids(1)
dbjoin(1)
dbset(1)
rt_daily_return(1)
BUGS AND CAVEATS
none
AUTHOR
Frank Vernon
Antelope User Group Contributed Software