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

 

NAME

baler_wf_proc - writes wfdiscs for Baler 14 and Baler 44 miniseed data and fills gaps using rt data

SYNOPSIS

baler_wf_proc   [-v] [-V] [-n] [-p pf] [-m mail_to] [-f nforks] [-s sta_regex] db

baler_wf_proc   [-v] [-V] [-n] [-p pf] sta wf_start_yearday  wf_end_yearday
                soh_start_YYYYMM soh_end_YYYYMM balerperf_start_yearday
                balerperf_end_yearday allperf_start_yearday allperf_end_yearday

baler_wf_proc   [-v] [-V] [-n] [-p pf] sta wf_start_yearday  wf_end_yearday
                soh_start_YYYYMM soh_end_YYYYMM balerperf_start_yearday
                balerperf_end_yearday allperf_start_yearday allperf_end_yearday
                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 fourth 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. baler_wf_proc is designed make a wfdisc for miniseed data 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 station-channel-month files. Only stations with real time data existing in rt_sta_dir/sta/sta will be processed. baler_wf_proc 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, baler_wf_proc 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. baler_wf_proc will limit itself to use only half the cores available up to 20 total with a minimum of 1. baler_wf_proc creates a wfdisc row in the db archivebase/sta/sta. The miniseed data reside in the parent directory archivebase/sta in files written as follows:

Wfdisc rows for data in the YYYY/DDD directories are only written if:

Wfdisc rows for data in the YYYY/month_files/MM directories are only written if:

For each complete day of data, a gap list is calculated and stored in the db archivebase/sta/sta_baler. Any gaps which can be filled from the rt_sta_dir/sta/sta db, will be filled. Then a final gap list is calculated in the db archivebase/sta/sta_all. A dbdescriptor file is created for the db archivebase/sta/sta with pointers back to the appropriate dbmaster. chanid and calibs are set in the archivebase/sta/sta.wfdisc. Checks are made to verify that a row in archivebase/sta/sta.schanloc exists for every row in archivebase/sta/sta.wfdisc with the exception of specifically excluded channels defined by wfclean in the parameter file.

OPTIONS

ENVIRONMENT

Needs to have sourced $ANTELOPE/setup.csh.

PARAMETER FILE

  • baler_active
    Absolute path name for station baler archive directory base name
  • rt_sta_dir
    Absolute path name for completed stations rt wfdisc directory base name
  • wfclean
    Regex defining which channels to ignore in schanloc tests
  • 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.
  • day_of_week
    Array of sta regex expressions for stations to be processed on a given day. In general this program should be run the day after rt_sta_wfdisc and baler_msd_proc, and the day before baler_active_to_dmc. The -s option overrides this station subsetting function.

EXAMPLE PARAMETER FILE


baler_active    /anf/TA/dbs/wfs/station_active    # absolute path name for active station baler directory base name

rt_sta_dir      /anf/TA/dbs/wfs/rt_stas           # absolute path name for archive station baler directory base name

wfclean         LTW|VCE|VCQ|VFP|VQR|VTW           # remove these wfdisc rows

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

day_of_week     &Arr{
                     Tuesday     ^[A-E].*
                     Wednesday   ^[F-J].*
                     Thursday    ^[K-O].*
                     Friday      ^[P-T].*
                     Saturday    ^[U-Y].*
                     Sunday      ^[Z0-3].*
                     Monday      ^[4-9].*
                }                                 # day of week station regex for routine processing

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
Printer icon