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

 

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

OPTIONS

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