NAME
iatrigger - monitor an orbserver for earthquakes, making requests for Internet Accelerometer data
SYNOPSIS
iatrigger [-v] [-a time_string] [-p pfname] [-c cmdorbname] [-t target] orbname
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
The
iatrigger program watches an orbserver for earthquakes of interest, usually identified by
an Antelope automatic real-time processing system. For earthquakes that match the trigger criteria specified
in the
iatrigger parameter file, requests are made to the
ia2orb(1) program to download
Internet Accelerometer data from all stations configured for on-demand waveform download (for further
details, see the man-page for
ia2orb(1)).
OPTIONS
-
-c cmdorbname
When iatrigger detects an earthquake of interest, it puts a command on an orbserver requesting that
the ia2orb(1) program download a range of waveform data for the earthquake. The cmdorbname
option specifies the default orbserver name on which to put these command packets. This command-line
option overrides the default value for cmdorbname given in the iatrigger parameter file.
-
-a time_string
By default, iatrigger starts processing packets at the most recent end of the orbserver to which
it connects. This option allows the user to begin processing at the first packet after a time string
in any format accepted by str2epoch(3), as implemented in the orbposition(3) command.
-
-p pfname
Specify a parameter file for iatrigger other than the default iatrigger.pf.
-
-t target
When iatrigger detects an earthquake of interest, it puts a command on an orbserver requesting that
the ia2orb(1) program download a range of waveform data for the earthquake. The target parameter
specifies the default target name of the ia2orb(1) instance which should service the waveform request.
This command-line option overrides the default value for target given in the iatrigger parameter
file.
-
-v
Be more verbose
PARAMETER FILE
Parameter File Parameters
-
cmdorbname
When iatrigger detects an earthquake of interest, it puts a command on an orbserver requesting that
the ia2orb(1) program download a range of waveform data for the earthquake. The cmdorbname
parameter specifies the default orbserver name on which to put these command packets. This parameter may be
overridden on the command-line.
-
end_expr
When iatrigger finds an earthquake of interest, a request is made for a range of waveforms
covering a time-span based on the origin time of the earthquake. The end_expr parameter
gives a Datascope database expression (see the man-page dbexpressions(5)) that calculates the end of the
requested time-window of waveforms based on the origin row of the earthquake in question. The actual data
return may end slightly after this specified time, to align with the blocks of data available on the
instruments.
-
select
The select parameter gives a default orb select expression (see the man page orbselect(3)) for packets
to retrieve from the orbserver named on the command line, in which to search for earthquakes of interest.
This parameter may be overridden on the command-line.
-
start_expr
When iatrigger finds an earthquake of interest, a request is made for a range of waveforms
covering a time-span based on the origin time of the earthquake. The start_expr parameter
gives a Datascope database expression (see the man-page dbexpressions(5)) that calculates the start of the
requested time-window of waveforms based on the origin row of the earthquake in question. The actual data
return may start slightly before this specified time, to align with the blocks of data available on the
instruments.
-
target
When iatrigger detects an earthquake of interest, it puts a command on an orbserver requesting that
the ia2orb(1) program download a range of waveform data for the earthquake. The target parameter
specifies the default target name of the ia2orb(1) instance which should service the waveform request.
This parameter may be overridden on the command line.
-
trigger_expression
This parameter gives a Datascope database expression (see the man-page dbexpressions(5)) to evaluate on
each incoming origin row. If the expression evaluates to true for the given earthquake, a waveform request
is made for that earthquake. If the trigger_expression evaluates to false, no request is made
for waveforms.
Parameter File Example
target ia2orb
cmdorbname :
select /db/origin|/pf/.*orb2dbt
trigger_expression ml > 0 || mb > 0
start_expr time
end_expr time + 600
EXAMPLE
Run
iatrigger in verbose mode with hypocenter packets taken from the default orbserver and
ia2orb acquisition commands also sent to the default orbserver:
% iatrigger -v -c : :
SEE ALSO
ia2orb(1), iarequest(1), rtexec(1)
BUGS AND CAVEATS
The
iatrigger program does not dynamically monitor its parameter file for changes. If the
parameter file changes,
iatrigger must be restarted for the changes to take effect. If
more automation is necessary, the user may consider putting the name of
iatrigger's
parameter-file in the
Pf_restart array of the
rtexec.pf file for the real-time
system under which
iatrigger is running (for more details on that feature
see the
rtexec(1) man-page).
AUTHOR
Kent Lindquist
Lindquist Consulting, Inc.
Antelope User Group Contributed Software