• Antelope Release 5.5 Linux 2.6.32-220.el6.x86_64 2015-04-21

 

NAME

baler_msd_proc - reformats mulitplexed Baler 14 and Baler 44 miniseed data into sta-chan files

SYNOPSIS

baler_msd_proc   [-v] [-V] [-n] [-c] [-d] [-F] [-B] [-E] [-G] [-X] [-p pf] [-m mail_to] [-f nforks] [-s sta_regex] db

baler_msd_proc   [-v] [-V] [-n] [-F] [-B] [-E] [-G] [-X] [-p pf] sta 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 third 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_msd_proc is designed to take raw miniseed data and reorganize the miniseed blocketts into 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 written into station-channel-month files. In either case, the content of the original miniseed blocketts is unaltered, with two exceptions,

baler_msd_proc can be operated in two 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_msd_proc will fork itself for each station using the second 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 command line is only used in debugging. baler_msd_proc will limit itself to use only half the cores available up to 20 total with a minimum of 1. baler_msd_proc creates an output directory archivebase/sta. In this directory miniseed files are written as follows:

The assumptions of the program are that:

Baler 14 data will be moved to the directory baler14procbase/sta and not processed again. Baler 44 data will have the appropriate row in the db table baler44dirbase/sta/sta.rsyncbaler updated by setting the msdtime field to the time when the file was converted. Only files with the field status of "downloaded" and msdtime set to NULL will be processed.

OPTIONS

ENVIRONMENT

Needs to have sourced $ANTELOPE/setup.csh.

PARAMETER FILE

  • baler14dirbase
    Absolute path name for station baler 14 miniseed directory base name
  • baler14procbase
    Absolute path name for processed baler 14 miniseed directory base name
  • baler44dirbase
    Absolute path name for processed baler 44 miniseed directory base name
  • archivebase
    Absolute path name for station baler directory base name for data to be written to
  • rt_sta_dir
    Absolute path name for rt wfdisc directory base name
  • bhdata_dir
    Subdirectory name for BH and LH data
  • sohdata_dir
    Subdirectory name for VH, UH, and SOH data
  • 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.
  • net_sta_chan_loc
    Table of net_sta_chan_loc changes for fixminiseed
  • sta
    Table of sta changes for fixminiseed
  • 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 same day as rt_sta_wfdisc and the day before baler_wf_proc. The -s option overrides this station subsetting function.

EXAMPLE PARAMETER FILE


baler14dirbase    /anf/TA/baler/station_aof_dumps/hold_for_station_closure    # absolute path name for station baler 14 miniseed directory base name

baler14procbase   /anf/TA/baler/station_aof_dumps/processed_44                # absolute path name for processed baler 14 miniseed directory base name

baler44dirbase    /anf/TA/baler/work                 # absolute path name for station baler 44 miniseed directory base name

rt_sta_dir         /anf/TA/dbs/wfs/rt_stas           # absolute path name for rt wfdisc directory base name

archivebase       /anf/TA/dbs/wfs/station_active     # absolute path name for station baler directory base name for data to be written to

bhdata_dir        BVLAOU                             # subdirectory name for BH and LH data
sohdata_dir       VLAOU                              # subdirectory name for VH, UH, and SOH data

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

net_sta_chan_loc        &Tbl{                        # for fix_miniseed parameter file, see fix_miniseed man page
TA_([A-Z0-9]+)_(L[DIK]M)_      TA_\$1_\$2_EP
TA_([A-Z0-9]+)_([BL]D[FO])_EP  TA_\$1_\$2_
}

sta        &Tbl{                                     # for fix_miniseed parameter file, see fix_miniseed man page
EXMP       CURRENT_STATION
}

day_of_week    &Arr{
    Monday      ^[A-E].*
    Tuesday     ^[F-J].*
    Wednesday   ^[K-O].*
    Thursday    ^[P-T].*
    Friday      ^[U-Y].*
    Saturday    ^[Z0-3].*
    Sunday      ^[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_wf_proc(1)
baler_active_to_dmc(1)
msdd(1)
miniseed2days(1)
fix_miniseed(1)
rtmail(1)

BUGS AND CAVEATS

AUTHOR

Frank Vernon

Antelope User Group Contributed Software
Printer icon