NAME
rt_sta_wfdisc - writes wfdiscs for real time miniseed data and identifies gaps
SYNOPSIS
rt_sta_wfdisc [-v] [-V] [-n] [-p pf] [-m mail_to] [-f nforks] [-s sta_regex] db
rt_sta_wfdisc [-v] [-V] [-n] [-p pf] sta yearday_start yearday_end
rt_sta_wfdisc [-v] [-V] [-n] [-p pf] sta yearday_start yearday_end parent_pid
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 is the first in a series of 5 programs for processing baler 44 miniseed data. The programs are
rt_sta_wfdisc,
rsync_baler,
baler_msd_proc,
baler_wf_proc, and
baler_active_to_dmc.
rt_sta_wfdisc is designed make a wfdisc for miniseed data acquired through the rt system and organized
in station-channel-day files for BH and LH seismic data and BD and LD infrasound/pressure data. All other SOH (state-of-health)
channels as well as VH and UH seismic data are ignored.
rt_sta_wfdisc can be operated in three modes. In normal usage top command line is used. In this
mode the program opens the
db.deployment table to determine which stations need to be processed.
To process multiple stations simultaneously on multi-processor machines,
rt_sta_wfdisc will fork
itself for each station using the second or the third command line. This is done because the Mac OSX requires a forked
process to be exec'ed internally to work properly. This construction also works on other Unix platforms.
The second or third command lines are only used in debugging.
rt_sta_wfdisc will limit itself to use only half the cores available up to 20 total with a minimum of 1.
rt_sta_wfdisc creates a wfdisc row in the db
rt_sta_dir/sta/sta. The miniseed data
reside in the parent directory
wfbase in files written as follows:
-
[BL][HD] station-channel-day files are written in YYYY/DDD directories
-
For each complete day of data, a gap list is calculated and stored in the db rt_sta_dir/sta/sta.
No gapes are filled by this program. The assumption is that these data are used to fill any gaps in the
baler data by later routines.
A dbdescriptor file is created for the db rt_sta_dir/sta/sta with pointers back to the appropriate
dbmaster. chanid and calibs are set in the rt_sta_dir/sta/sta.wfdisc.
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 rt_sta_wfdisc.
-
-m mail_to
Email address list to send results. Multiple email addresses should be comma delimited without
white space.
-
-f nforks
Limit the number of forked processes.
-
-s sta_regex
Regular expression of stations to process.
ENVIRONMENT
Needs to have sourced $ANTELOPE/setup.csh.
PARAMETER FILE
-
wfbase
Absolute path name for waveform directory base name
-
rt_sta_dir
Absolute path name for rt wfdisc directory base name
-
days_delay
Number of days to delay processing for missing data to show up
-
net
Net code to process
-
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
-
success_mail
Email addresses to send notification of station success. Multiple email addresses should be comma delimited without
white space.
-
prob_mail
Email addresses to send notification of problems. Multiple email addresses should be comma delimited without
white space.
EXAMPLE PARAMETER FILE
wfbase /anf/TA/dbs/wfs/certified # absolute path name for waveform directory base name
rt_sta_dir /anf/TA/dbs/wfs/rt_stas # absolute path name for rt wfdisc directory base name
days_delay 7 # Number of days for data to reside on disk before processing
net TA # Network Code
dbpath /anf/TA/dbs/dbmaster/{usarray}:/anf/TA/dbs/dbops/{usarray} # default dbpath
dbidserver # default dbidserver
dblocks none # default dblocks
success_mail your@email.edu # email addresses to send notification of station success
prob_mail your@email.edu # email addresses to send notification of problems
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
rt_sta_wfdisc(1)
rsync_baler(1)
baler_msd_proc(1)
baler_active_to_dmc(1)
miniseed2db(1)
rt_daily_return(1)
dbfixchanids(1)
dbjoin(1)
dbsubset(1)
dbselect(1)
trexcerpt(1)
rtmail(1)
BUGS AND CAVEATS
AUTHOR
Frank Vernon
Antelope User Group Contributed Software