NAME
dbassociate - takes arrival db and an external catalog and tries to associate all unassociated arrival
SYNOPSIS
dbassociate [-v] [-n] [-e] [-i] arrival_db] catalog_db
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
Program takes
arrival_db.arrival table, does a dbnojoin with the assoc table, and tests
to see if any of the no-joined arrivals match to
arrival_db.origin.
All new associations are incorportated into
arrival_db. Then
arrival_db is closed.
In the second step, the
arrival_db.arrival table is reopened, and again does a dbnojoin with the assoc table.
This time the no-joined arrives match to
catalog_db.origin.
catalog_db.origin is subsetted
to provide only the last lddate for near duplicate origins by calling
last_origin_lddate(1).
All new associations, origins, netmags, are incorportated into
arrival_db. Then
arrival_db is closed.
This programs calls
dbloc_assoc(1) to generate the assoc, origin, netmag and proper phase entries in assoc.
dbassociate has a similar function to the older
dbassoc_arrival(1). Differences are that
dbassociate compares both internal and external origin tables, handles netmag entries properly,
and using dbloc_assoc to generate proper phase from the travel time calculator instead of just copying
iphase from the arrival table into phase in the assoc table.
Associations are defined by P waves having ( abs( $timeres ) < 3.0 ) and S waves having ( abs( $timeres ) < 10.0 ).
This program is designed to be used during the verification stage of an analyst review.
OPTIONS
-
-v
Verbose
-
-n
No operation. Examine dbs and get counts. arrival_db not updated.
-
-e
Only compare no-joined arrivals to catalog_db.origin
-
-i
Only compare no-joined arrivals to arrival_db.origin]
ENVIRONMENT
Needs to have sourced $ANTELOPE/setup.csh.
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
dbassoc_arrival(1)
dbloc_assoc(1)
last_origin_lddate(1)
BUGS AND CAVEATS
If using the -n option then the count of the unassociated arrivals will be the same for both
origin tables, since
the real associations to the
arrival_db.origin did not occur.
AUTHOR
Frank Vernon
Antelope User Group Contributed Software