NAME
sta_final_to_dmc - combines final station baler data with data collected on the rt system and sends to orb
SYNOPSIS
sta_final_to_dmc [-v] [-V] [-n]
[-c orbclient] [-p pf] [-m mail_to]
mseed_orb sta [sta_1 sta_2 ...]
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
sta_final_to_dmc is designed to take final station baler data prepared by
sta_final_prep and combine these data with rt station data prepared by
sta_final_wfdisc
to build the most complete data set possible throughout the operation of the station. The sta
database can contain seismic data, as well as state-of-health and status data. All waveform data
in the database are sent to an orb using the program
obsip2orb: the content of the original
miniseed blocketts is unaltered. If a gap table exists for the baler data, then an attempt is made
to fill these gaps with data that exists in the rt database. In addition, miniseed data from the
non-waveform
non_wf_chan channels are also sent using the program
miniseed2orb.
sta_final_to_dmc works best if the
mseed_orb is sized to be bigger than one complete
station of data. If this is the case, then the data are sent to the orb unthrottled. Once a station
is completely sent to the
mseed_orb, then a wait is enforced until the
orbclient has
extracted all that station data from the orb. Once completed a sync file generated by
db2sync
is also sent to the orb using
orbxfer2.
After the sync file is sent, the next station in the input list is processed.
The assumptions of the program are that:
-
css 3.0 extension tables (deployment and dmcfiles) are expected in dbops
-
the baler data for station sta are kept in a database named archivebase/sta/sta
-
the wfdisc for the station rt data is kept in a database named rt_sta_dir/sta
-
the VH, UH, and SOH data are only found in the database named archivebase/sta/sta
-
sta_final_to_dmc is only run once per station. If a station needs re-running, then the
original baler database needs to be reconstructed, dmcfiles table needs editing, and the old sync
file needs to be removed.
OPTIONS
-
-v
Verbose
-
-V
Extremely verbose. Used for debugging purposes only.
-
-n
Test mode. Does not execute commands.
-
-c orbclient
Name of orbclient reader to track.
The default orbclient is orbmsd2days.
-
-p parameter_file
Name of parameter file to use. $PFPATH is searched to find parameter file.
The default parameter file is sta_final_to_dmc.
-
-m mail_to
Email address list to send results. Multiple email addresses should be comma delimited without
white space.
ENVIRONMENT
Needs to have sourced $ANTELOPE/setup.csh.
PARAMETER FILE
-
archivebase
Absolute path name for directory containing station directories with station database
-
dbops
Path to dbops database which includes dmcfiles and deployment tables
-
non_wf_chan_proxy
Channel code of waveform file which is in the same directory as non-waveform miniseed files.
-
non_wf_chan
List of non-waveform miniseed channel codes to be processed.
-
rt_sta_dir
Absolute path name for directory containing real-time station database wfdiscs
-
sync_dir
Absolute path name for directory to store sync files
-
deploy_mail
Email addresses to send notification of deployment table checks
EXAMPLE PARAMETER FILE
archivebase /anf/TA/wf/station_final # absolute path name for station baler archive name
dbops /anf/TA/dbs/dbops/usarray # path to dbops database which includes dmcfiles
# and deployment tables
non_wf_chan_proxy LCQ # channel code with of waveform file which is in the
# same directory as non-waveform miniseed files.
non_wf_chan &Tbl{
ACE
LOG
OCF
} # list of non-waveform miniseed channel codes to be
# processed.
rt_sta_dir /anf/TA/wf/rt_stas # Absolute path name for directory containing
# real-time station database wfdiscs
sync_dir /anf/TA/products/sync/sta_final # Absolute path name for directory to store sync files
deploy_mail flvernon@ucsd.edu,jeakins@ucsd.edu # email addresses to send notification of
# deployment table checks
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
db2sync(1)
miniseed2orb(1)
obsip2orb(1)
orbxfer2(1)
rt_daily_return(1)
rtmail(1)
sta_final_prep(1)
sta_final_wfdisc(1)
BUGS AND CAVEATS
AUTHOR
Frank Vernon
Antelope User Group Contributed Software