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

 

NAME

finger_quake - create a "finger quake" bulletin

SYNOPSIS

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

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

finger_quake creates and/or overwrites the users "$HOME/.plan" with a description of the bulletin to be reported and a listing of events. It is intended to be run on an operating real-time network. Remote users can run a finger command for "user@yourhost.xxx" to retrieve the real-time bulletin. Note that the finger command can be a security risk and is often disabled by sys-admins: check to see that it is enabled for users outside of your local network. Very often the "-l" option must be used. See finger(1).

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:


 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 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.

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.

OPTIONS

FILES

An ASCII file ".plan" is created in the users home directory. The file is overwritten if it already exists.

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

The following is an example finger_quake parameter file.

# 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.

ENVIRONMENT

The standard Antelope environment is required.

The environment variable DBLOCKS may need to be set to "yes".

EXAMPLE

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

SEE ALSO

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.

BUGS AND CAVEATS

Not fully tested. Use caution...

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:

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
and finger_quake will croak.

AUTHOR

Jennifer Eakins
jeakins@ucsd.edu
(858)534-2869

Antelope User Group Contributed Software
Printer icon