NAME
time_slice_db - Divide seismic database into periodic increments
SYNOPSIS
time_slice_db [-v] [-V] [-s] [-f] [-C]
[-p parameter_file]
[-m mail_to]
[-t start_time]
[-e end_time]
(-B | -E | -W)
dbin
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
time_slice_db is designed to build periodic databases from a larger database.
The allowed periods of division are by month, by year or by day.
time_slice_db will keep all data from the current month (or year or day), and the
previous number of
lag_periods in
dbin.
Older data will be split from
dbin into monthly (or yearly or daily) databases.
time_slice_db will reorganize the seismic database tables into the appropriate database
directory structure -
ARGUMENTS
-
(-B | -E | -W)
program requires one or more of -E -B -W options
-
dbin
database which needs to be sliced.
OPTIONS
-
-v
verbose
-
-V
Extremely verbose. Used for debugging purposes only.
-
-C
Clean up input database and rows which have been moved to the output databases.
Before the cleanup is begun, the input database is saved into the last_saved_db directory using
dbcp -s dbin last_saved_db. Previous versions of the last_saved_db are overwritten.
-
-s
Don't attempt to keep external file references correct; just copy the tables,
and don't update dir/dfile fields. See dbcp(1).
-
-f
Actually copies waveforms instead of referencing original waveforms. See dbcp(1).
-
-B
Only slices big tables listed in pf file. Can be used with -E and/or -W options.
-
-E
Only slices events. Can be used with -B and/or -W options.
-
-W
Only slices waveforms. Can be used with -E and/or -B options.
-
-p parameter_file
Name of parameter file to use. $PFPATH is searched to find parameter file.
The default parameter file is time_slice_db.
-
-t start_time
Start time for processing data.
The default start time is 1 January 1970.
-
-e end_time
End time for processing data.
The default end time is now().
-
-m mail_to
email address list to send results.
ENVIRONMENT
Need environment variable $PFPATH to be set. Can be run under
rtexec(1).
PARAMETER FILE
-
dirbase
directory base name for building the event and big_table databases
-
wfbase
directory base name for building the waveform databases
-
dbbase
base name for building database names
-
period
Period of time for database segmentation. Can be "year", "month", or "day".
-
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.
-
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
-
big_tables
Table list of large database tables which require less strict (ie time consuming) processing
EXAMPLE PARAMETER FILE
dirbase /anf/TA/dbs/events #
wfbase /anf/TA/dbs/wfs # also added to dbpath for event and big_table dbs
dbbase usarray #
period month # allowed values are "year" or "month" or "day"
lag 1 # number of periods of lag of data before processing
dbpath /anf/TA/dbs/dbmaster/{usarray} # default dbpath for event and big_table dbs
dbidserver anfops:2498 # default dbidserver
dblocks nfs # default dblocks
big_tables &Tbl{
latency
wfsrb
specdisc
}
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
dbcp(1)
dbcentral(1)
dbsplit(1)
monthly_wfs(1)
pfecho(1)
pf(3)
rtdbclean(1)
rtexec(1)
rsync(1)
BUGS AND CAVEATS
This program does most the work using perl system calls to the Datascope interface.
This was done because of the memory usage in large databases which could not be really
freed in perl. Using system calls keeps the memory usage at a managable level even for
megarow databases.
AUTHOR
Frank Vernon
IGPP, UCSD
Antelope User Group Contributed Software