NAME
dbplotpicks - Make waveform plots with arrivals
SYNOPSIS
dbplotpicks
dbname
sta_expr
chan_expr
tstart
twinline
scale
[-f filter]
[-ps psfile]
[-display]
[-polygons polygondb]
[-places placesdb]
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
dbplotpicks
will make a PostScript output file that contains a helicorder
style display of one or more station(s)-channel(s) including arrivals. The output file
name begins with
dbplotpicks. and ends with
.ps and
is unique to avoid collisions with previously created PostScript
files.
OPTIONS
-
dbname
The name of the input database.
This argument is required.
-
sta_expr
A regular expression determining the station(s).
This argument is required.
-
chan_expr
A regular expression determining the channels(s).
This argument is required.
-
tstart
The start time for the display.
This argument is required.
-
twinline
The time window for each sta-chan line in the display in seconds.
This argument is required.
-
scale
The amplitude scale factor in data units per inch or -1, which indicates autoscaling.
This argument is required.
-
-f filter
A filter specification. This filter is applied to
the waveform before it is plotted.
The filter specification is a character string like
"BW 0.1 5 1.0 5" which would be a 5 order Butterworth filter
with a low corner frequency of 0.1 Hz and a high corner
frequency of 1.0 Hz. See trfilter(3). Note that specifications such as
this with embedded blanks must be quoted in the command line.
This argument is optional and if not specified, then
no filtering is done.
-
-ps psfile
The output PostScript file name.
This argument is optional and if not specified, then
a unique PostScript file name is created by the program.
-
-display
If this flag is given, the PostScript file will be displayed immediately.
This argument is optional.
-
-places dbplaces
Name of databases with places (in places1.2 schema). If this argument is specified and origin information associated to arrivals in the specified time-window is found in the database, then the place closest to the origin is displayed.
This argument is optional.
-
-polygons dbpolygons
Name of databases with polygons (in polygon1.2 schema). If this argument is specified and origin information associated to arrivals in the specified time-window is found in the database, then the name of the polygon surrounding the origin is displayed.
This argument is optional.
EXAMPLE
dbplotpicks db "ARSA|DAVA" "HHZ" "7/19/1999" 30 -1 -display
will display 30 seconds from all Z-channels for stations
ARSA and DAVA, starting from July 19th 1999 Midnight,
using autoscaling
dbplotpicks db "ARSA|DAVA" "HHZ" "7/19/1999" 30 500 -display \
-places /databases/places -polygons /databases/polygons \
-ps /tmp/testrun.ps
same as above, but with a fixed scale of 500nm/s/inch. The
place next to the preferred origin and the countryname are
also given. The filename is known.
SEE ALSO
dbheli(1)
trfilter(3)
dbe_dbplotpicks(1)
BUGS AND CAVEATS
Certainly a lot. This was the first program I wrote at ZAMG after we decided to use the Antelope Software. The calling could need some fixes.
AUTHOR
This is a modified version of dbheli by Danny Harvey.
Nikolaus Horn, 1998,2005
ZAMG / Vienna, Nikolaus.Horn@zamg.ac.at
Antelope User Group Contributed Software