finger_quake [-v] [-g] [-o] [-p pf] [-d days | -e events] [-a alternate_home_dir] [-t magnitude_threshhold] [-s origin_subset] [-l place_subset] [-i update_interval] [-y 2 | 4] database
A unique introduction to your bulletin can be written and applied through a parameter file (see PARAMETER FILE section below). Separate accounts must be used for each real-time network bulletin. The standard user name is "quake".
The script will run indefinitely, checking the input database for modifications and updating the bulletin as needed. The length of time between checks to the update table can be adjusted on the command line.
The default output ~/.plan will list events in the following format:
The most recent events are at the top of the list. Any unreviewed events are marked with a "*" after the magnitude type. Local events can be given more specific locations than teleseismic events if you have a "place" table (see places1.2 schema). If there is no place table, or at a distance greater than the dist_gregion value specified in the parameter file, the gregion command is used to determine a general location name for the event.DATE TIME-UTC LAT. LON. DEPTH MAG Q REGION yy/mm/dd hh:mm:ss deg. deg. km +++++++++++++++++ ++++++ +++++++ +++++ ++++++ + +++++++++++++++++++++++++++++++++ 00/24/08 04:57:36 34.01N 116.70W 5.0 1.2ml* 8.7 km SE of Bonnie Bell 00/24/08 04:12:47 33.49N 116.46W 16.0 0.4ml* 9.4 km N of Ribbonwood 00/24/08 02:25:11 32.55N 139.41E 30.0 0.0 * SOUTH OF HONSHU, JAPAN 00/24/08 02:13:41 34.44N 116.29W 11.4 2.0ml v 21.2 km SW of Landers 00/24/08 02:09:30 34.61N 116.26W 0.0 2.1ml v 8.7 km E of Stedman 00/23/08 21:23:24 34.35N 116.18W 0.1 2.0ml v 13.0 km S of Sunfair Heights +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ There are currently 5 events recorded by ANZA for the past 1 days. Last update: 08/24/2000 (237) 06:52:10.000 PDT
The qedd(1) program can be used to retrieve this bulletin.
The finger_quake script should be run as a background process. The output should be a stable product that the community can depend on. Format, number of events, or time period covered should not require frequent changes. Thus, you might want to make the finger_quake program part of your running rtexec if you have an operating real-time system. Alternatively, run finger_quake from the command line.
A css3.0 origin and event table are needed in order to produce a bulletin.
A places1.2 place table with "ppl" locations is needed if the use_place_name option is set to yes in the parameter file. These tables are produced from files downloaded from the GNIS website (http://mapping.usgs.gov) and converted with the gnis2db(1) script.
# Parameter file for ANZA's finger bulletin network ANZA # name of network place_name /data/placees/so_cal # gnis1.0 or places 1.2 database of locations # use -g option if gnis1.0 use_place_name yes # use the place_name database for comments/locations dist_gregion 5.0 # use gregion name if event is more than dist_gregion degrees # from any place in place table (irrelevant if use_place_name is "no") mag_pref &Tbl{ # Preferred magnitude to report ml mb ms } auth_pref &Arr{ # A table describing authors and letter codes # for associated and located origins # Perl regular expression matching can be used v vladik Q QED W QED_weekly C cit_ r rt j eakins f vernon } preface &Literal{ Welcome to the UCSD-SIO-IGPP Real-time Seismic Array Processing Group Automated locations of the Anza Real-time Broadband Array (ANZA) This is a list of automated locations for earthquakes recorded by the ANZA network. All seismic events processed/recorded by this network are included: this includes local, regional, and teleseismic earthquakes as well as other non-seismic events. Entries with a "*" have not been reviewed by a human. These origins are undergoing continuous review and thus can change, be removed, or deleted at any time. Note that location and magnitudes for EVENTS IN THIS LIST ARE SUBJECT TO CHANGE. These are not final solutions. All times are UTC (Greenwich Mean Time). Subtract 8 hours to determine Pacific Standard time, subtract 7 hours for Pacific Daylight time. Depths are in km. Magnitudes can be Mb, Ms, or Ml. The region associated with each teleseismic quake is the geographic region name as defined by Flinn, Engdahl and Hill (BSSA, 64, pp 771-992, 1974). Distances for most earthquakes are given from the nearest populated place. Instead of the typical quality factors (A, B, C, or D), we use the "Q" to report the author or the reported location. The codes used for this bulletin are as follows: f,j,v,r = UCSD location Q = USGS QED bulletin W = USGS PDE weekly bulletin C = SCSN bulletin For more information contact: Jennifer Eakins jeakins@ucsd.edu (858) 534-2869 or visit http://eqinfo.ucsd.edu The bulletin can be accessed on-line at: http://eqinfo.ucsd.edu }
The first part of the parameter file requires default values to be set.
The second part of the parameter file contains an introductory text message that will be placed at the head of the bulletin. This should be modified to include your specific local contact information as well as any information about the authors and external catalogs that may be used. No variable expansion is allowed and all embedded newlines, quotes and backslashes will appear as they are in the parameter file. See pf(5) for more information on the "Literal" value.
Please make sure that you modify this message. Although I do not mind answering questions about this program, I would rather not be the contact for the bulletin you are publishing.
The environment variable DBLOCKS may need to be set to "yes".
The following example will run the finger_quake program using the specific parameter file for the Anza network, finger_quake_anza.pf. The most recent 50 events found in the origin table of db/anza will be reported.
epicenter{quake}% finger_quake -p finger_quake_anza -e 50 db/anza
The bulletin can be retrieved remotely with the command:
"finger -l quake@epicenter.ucsd.edu"
Note that some systems will require the "-l" flag for the full bulletin to be displayed. (See finger(1)).
This example assumes that you want the most recent 7 days from the KNET catalog for all events with magnitudes greater than 1.0 and events within 5.0 degrees of station AAK (42.6333N 74.9444W).
epicenter{quake}% finger_quake -p finger_quake_knet -d 7 -t 1.0 -s "distance(lat,lon,42.6333,74.4944)<=5.0" db/knet
This example subsets the place table for places that are "schools" and reports all events over magnitude 5.0 for the past year. The program will only run once.
epicenter{quake}% finger_quake -p finger_quake_anza -d 365 -t 5.0 -o -s "distance(lat,lon,33.6,-116.5<='10.0')" -l "placetype=~/school/" db/anza
antelopeenv(5) finger(1) gnis2db(1) reflect(1) reflectd(1) rtexec(1) qedd(1)
See http://epicenter.ucsd.edu/ANZA/faq/rtcatalogs.html for information on setting up an rtexec.pf file that will run multiple bulletin retrieval and webpage update scripts.
You must have both an origin and event table with prefor set for each event.
I think I have it set up so that it won't die unpleasantly if you are asking for more events than exist in the database. However, I am quite sure that there are many situations for which I have not tested.
This program can be very slow if you have a large database of placenames.
The environment variable DBLOCKS may need to be set to "yes" if you are updating your database by the reflect/reflectd method. finger_quake will run without DBLOCKS set, but if the database is updated by reflect while you are in the middle of getting origin information, you will see an error message similar to:
and finger_quake will croak.No need for update. Sleeping for 300. perl: can't write to directory /opt/antelope/dev/data/site perl: Bad record id 4034 in db pointer perl: Bad record id 4035 in db pointer perl: Bad record id 4032 in db pointer perl: Bad record id 4025 in db pointer perl: Bad record id 4024 in db pointer perl: Bad record id 4026 in db pointer perl: Bad record id 4033 in db pointer perl: Bad record id 4028 in db pointer perl: Bad record id 4029 in db pointer perl: Bad record id 4030 in db pointer perl: Bad record id 4031 in db pointer perl: Bad record id 4037 in db pointer perl: Bad record id 4043 in db pointer perl: Bad record id 4042 in db pointer perl: Bad record id 4044 in db pointer perl: Bad record id 4034 in db pointer perl: Can't resolve db pointer in dbgetv: 26 43 10 3921
Jennifer Eakins jeakins@ucsd.edu (858)534-2869