NAME
dmcgap2db - convert DMC gap file into gap db table
SYNOPSIS
dmcgap2db [-v] [-V] [-p [-D | -Y]]
[-I idserver]
[-P dbpath]
[-d directory_base]
[-t start_time]
[-e end_time]
sync_file
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
dmcgap2db take gap file generated by the IRIS DMC and convert this data
into a gap db table. It's default mode is to write the data into the local directory
or else with the -p option can write data into the monthly_dbs directory in a
similar form as
time_slice_db(1).
With the -p option data will be split from
dbin into monthly ( or yearly or daily) databases.
dmcgap2db will reorganize the seismic database tables into the appropriate database
directory structure -
-
directory_base/YYYY_MM/dbbase_name_YYYY_MM.
-
directory_base/YYYY/dbbase_name_YYYY.
-
directory_base/YYYY_DDD/dbbase_name_YYYY_DDD.
The decision for which db to include data is decided by the gap.time after all gaps
being split along day boundaries.
This program was written to address specific issues at the ANF for the USArray TA.
OPTIONS
-
-v
verbose
-
-V
Extremely verbose. Used for debugging purposes only.
-
-p
split into periods, useful when input files have random start and endtimes
-
-Y
split database into years. Files stored as daily_dbs/YYYY/dbbase_name_YYYY.
Only valid with -p option.
-
-D
split database into days. Files stored as yearly_dbs/YYYY_DDD/dbbase_name_YYYY_DDD.
Only valid with -p option.
-
-I idserver
Name of idserver to be written into descriptor file for output database to use.
The default parameter idserver is none.
-
-P dbpath
dbpath to be written into descriptor file for output database to use.
The default parameter dbpath is none.
-
-d directory_base
directory base name for building the monthly databases
The default is ./monthly_dbs
Only valid with -p option.
-
-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().
ENVIRONMENT
Need environment variable $PFPATH to be set.
PARAMETER FILE
None.
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
time_slice_db(1)
BUGS AND CAVEATS
none.
AUTHOR
Frank Vernon
Antelope User Group Contributed Software