NAME
dbrsec - Make record section plot of waveforms
SYNOPSIS
dbrsec db {-sc sta:chan | -orid orid:chan}
[-top top] [-bot bot]
[-tstart tstart]
[-twin twin]
[-filter filter]
[-sift sift]
[-clip {on|off}]
[-vred vred]
[-gain gain]
[-amp amp]
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
dbrsec
makes a PostScript output file that contains a record section
style display of either multiple channels for a single event
or multiple events for a single channel. The output file
name is automatically created and begins with
dbrsec. and ends with
.ps.
COMMAND LINE ARGUMENTS
-
db
The name of the input database.
This argument is required.
-
-sc sta:chan
The station and channel codes.
Either this argument or the -orid argument
is required. If this argument is specified, then
the record section is for a single channel over
multiple events.
-
-orid orid:chan
The event orid value and the channel code.
Either this argument or the -sc argument
is required. If this argument is specified, then
the record section is for a single event over
multiple stations.
chan may be either a single channel code (e.g., BHZ),
or a Datascope expression involving chan and surrounded by
parens (e.g., (chan =~/.*[1Z]/).
-
-top top
The distance in degrees at the top of the plot.
-
-bot bot
The distance in degrees at the bottom of the plot.
-
-tstart tstart
The start time for the display. This is in seconds relative to
the event origin time.
-
-twin twin
The time window in seconds for the display.
-
-filter 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. 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.
-
-sift sift
An optional Datascope sifting string.
-
-clip {on|off}
Apply plot clipping flag.
-
-vred vred
If specified, then apply time scale velocity reduction.
This is specified in km/sec.
-
-gain gain
This is a gain factor applied to the plot amplitude of
each trace. It defaults to 1.0.
-
-amp amp
The amplitude scale factor in data units per inch.
The data units are defined within the database and are
typically something like nm/sec.
EXAMPLE
% dbcp -d /opt/antelope/data/db/demo2/demo2 .
% dbrsec demo2 -orid 1940:BHZ -top 0.0 -bot 20 -twin 600
BUGS AND CAVEATS
The
options -
top, -
bot, -
twin are required.
The database should be in the current directory, otherwise
the program is not able to save the resulting postscript
file.
AUTHOR
Danny Harvey
Antelope User Group Contributed Software