NAME
dbevents_aeic - Display seismic events and waveforms incorporating AEIC extensions to dbevents
SYNOPSIS
dbevents_aeic [-max_age max_age] [-show_detections] [-title
title] [-pf pf] dbname [start [end]]
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
dbevents_aeic incorporates all of the functionality of dbevents (type "man dbevents" for more information).
Its command line arguments are exactly the same as dbevents. But there are numerous additional parameters possible
in the parameter file. These control various additional features such as: (i) electronic voice announcement of new events,
(ii) display of pop-up maps (generated by dbrecenteqs), (iii) display of AEIC Shakemaps, (iv) launching of dbloc2 to review events,
(v) deletion of bad or mislocated events from QDDS, the AEIC Shakemap system and Emergency Operations Centres.
dbevents_aeic
has one crucial parameter "use_aeic_extensions". If this is not defined and set to 1, the behaviour of dbevents_aeic
reverts to the BRTT version of dbevents, regardless of what other parameters are set. This is deliberate and may make it practical for BRTT to adopt and maintain dbevents_aeic, and base any future developments on it.
The basis for dbevents_aeic
is BRTT's 4.9 release of dbevents, written by Danny Harvey. Earlier versions of dbevents had been modified by AEIC staff including Josh Stachnik and Mitch Robinson and tailored for specific purposes. What I have attempted to do is merge these changes into the latest release of dbevents, fix any bugs, such that we only have one version of the source code to maintain and any variations can be controlled simply by setting different parameters. Numerous other features have since been added.
OPTIONS
These are identical to dbevents. The most useful ones are:
-
-max_age max_age
If this is specified, then it is a time duration,
given as [[[dd:]hh:]mm:]ss, that is used to
determine the earliest origin data that will be displayed
relative to the current time. This option overrides the
start and end options.
-
-pf pf
Specify alternate parameter file.
-
-title title
Specify window title.
-
-show_detections
Show detections as well as arrivals.
-
dbname
This is the name of the database that contains the event, origin,
assoc and arrival data. This option is required.
PARAMETER FILE
Program parameters are specified in the
dbevents_aeic parameter file. Parameters in this file have been grouped according to function and substantially
documented. All other parameter files will probably have a subset of these parameters.
Parameters native to dbevents are not explained here (type "man dbevents" for more information). Instead, only additional parameters added by AEIC are described here.
-
use_aeic_extensions
If this is not defined and set to 1, all aeic extensions to dbevents will be ignored.
Audible announcements:
-
announce_enabled
Enable voice announcement of new events by setting this to 1.
audioplayer, soundpath and soundfile also need to be defined.
-
usemysrn_mag
If set to 0, all events will be announced.
If set to 1, only events within mysrn (my seismic region number) are announced.
-
mysrn
My seismic number region. Set this to 1 for Alaska.
-
mag_thresh
If specified, only events with a magnitude larger than mag_thresh will be announced.
-
audioplayer
There must be a command line executable sound file player to enabled events to be announced. The path must be specified here.
-
soundpath
The path to the directory containing the sound files.
-
soundfile
The filename of a sound file which should be played prior to announcement of each event (e.g. machgun.au).
-
list_font
Specifies the font to use for the earthquake list. If omitted, default is 8pt font.
-
magnitude_preference_order
An optional table in the form:
magnitude_preference_order &Tbl{
ml
ms
mb
}
Nearest Places:
-
placedb
If this is specified, the origin list will include the distances to the nearest places defined in this database.
-
neardist
Places further than neardist km from the origin will not be listed.
-
nplacemax
This is the maximum number of places that will be listed.
-
always_include
If this parameter is defined, followed by the name of a place that appears in placedb (e.g. Fairbanks)
that place will always appear in the origin list, even if it is greater than neardist km away.
Delete event from database + delete downstream from QDDS, EOC and Shakemap systems:
-
delete_script
If this is set, and review_event_enabled is also set as 1, then dbevents_aeic will give the option for the user to delete an event
from QDDS, EOC, recenteqs and ShakeMap systems. This script will be invoked to take care of all deletion operations.
-
delete_pf
The parameter file to use for the delete_script
-
delete_options
The options to give for the delete_script, e.g. aes (see its man page)
-
test_mode
If test_mode is set to 1 (on) then delete_script never gets called.
Review events:
-
review_events_enabled
If this is set to 1, the user will be able to right click on an event symbol and review it with dbloc2. Generally, this will only
be desirable for staff while on beeper duty.
Shakemaps:
The following are parameters useed for displaying AEIC Shakemaps
-
shakemapsdir
The path to the directory containing the Shakemap jpeg files.
-
shakemaps_script
The script used to parse Shakemap archive html files.
-
shakemaps_geometry
The geometry of the pop-up window for displaying the webmap on the screen, e.g. 612X740+0+0
-
station_colours
A table which specifies table colours.
Webmaps:
The following are parameters used for displaying webmaps generated by dbrecenteqs.
-
webmapsdb
If the user wants to be able to see webmaps generated by dbrecenteqs, at least one of webmapsdb and webmapsdir must be set.
webmapsdb is the path to the database monitoring by dbrecenteqs, containing a webmaps table.
The reference should be to the database, not the webmaps table itself.
-
webmapsdir
If the user wants to be able to see webmaps generated by dbrecenteqs, at least one of webmapsdb and webmapsdir must be set.
webmapsdir is the path to a directory containing gif files created by 'rename_recenteq_gifs.pl'
These are named by origin time rather than evid.
-
webmaps_geometry
The geometry of the pop-up window for displaying the webmap on the screen, e.g. 400x400+0+0
BUGS AND CAVEATS
Like dbevents,
dbevents_aeic sometimes hangs, and its possible that additional bugs may have been introduced
AUTHOR
Glenn Thompson
Alaska Earthquake Information Center
Antelope User Group Contributed Software